MobileFirst Server 구성

개요

백업 및 복구 정책을 고려하여 MobileFirst Server Server 구성을 최적화하고 액세스 제한사항 및 보안 옵션을 적용합니다.

다음으로 이동

• MobileFirst Server 프로덕션 서버의 엔드포인트
• TLS V1.2를 사용할 수 있도록 MobileFirst Server 구성
• MobileFirst Server 관리용 사용자 인증 구성
• MobileFirst Server 웹 애플리케이션의 JNDI 특성 목록
• 데이터 소스 구성
• 로깅 및 모니터링 메커니즘 구성
• 복수 런타임 구성
• 라이센스 추적 구성
• WebSphere Application Server SSL 구성 및 HTTP 어댑터

MobileFirst Server 프로덕션 서버의 엔드포인트

IBM MobileFirst Server의 엔드포인트에 대해 화이트리스트 및 블랙리스트를 작성할 수 있습니다.

참고: Mobile Foundation에서 공개하는 URL 관련 정보는 가이드라인으로서 제공됩니다. 조직에서는 화이트리스트 및 블랙리스트에 포함된 항목을 기반으로 URL이 엔터프라이즈 인프라에서 테스트되었는지 확인해야 합니다.

TLS V1.2를 사용할 수 있도록 MobileFirst Server 구성

MobileFirst Server가 SSL 프로토콜 중에서 Transport Layer Security v1.2(TLS V1.2)만 지원하는 디바이스와 통신하도록 하려면 다음 지시사항을 완료해야 합니다.

Transport Layer Security(TLS) V1.2를 사용할 수 있도록 MobileFirst Server를 구성하는 단계는 MobileFirst Server가 디바이스에 연결하는 방법에 따라 다릅니다.

• 디바이스의 SSL 인코딩된 패킷을 복호화한 후 애플리케이션 서버에 패킷을 전달하는 리버스 프록시 뒤에 MobileFirst Server가 있는 경우, 리버스 프록시에서 TLS V1.2 지원을 사용 가능하게 설정해야 합니다. IBM HTTP Server를 리버스 프록시로 사용하는 경우 지시사항은 IBM HTTP Server 보안을 참조하십시오.
• MobileFirst Server가 디바이스와 직접 통신하는 경우, TLS V1.2를 사용 가능하게 설정하는 단계는 사용하는 애플리케이션 서버가 Apache Tomcat인지, WebSphere Application Server Liberty 프로파일인지 또는 WebSphere Application Server 전체 프로파일인지에 따라 다릅니다.

Apache Tomcat

1. JRE(Java Runtime Environment)에서 TLS V1.2를 지원하는지 확인하십시오. 다음 JRE 버전 중 하나가 있는지 확인하십시오.
   • Oracle JRE 1.7.0_75 이상
   • Oracle JRE 1.8.0_31 이상
2. conf/server.xml 파일을 편집하고 HTTPS 포트를 선언하는 Connector 요소를 수정하여 sslEnabledProtocols 속성이 다음 값을 갖도록 하십시오.sslEnabledProtocols="TLSv1.2,TLSv1.1,TLSv1,SSLv2Hello".

WebSphere Application Server Liberty 프로파일

1. JRE(Java Runtime Environment)에서 TLS V1.2를 지원하는지 확인하십시오.

   • IBM Java SDK를 사용하는 경우, IBM Java SDK에 POODLE 취약성에 대한 패치가 적용되었는지 확인하십시오. 사용하는 WebSphere Application Server 버전에 대한 패치가 포함된 최소 IBM Java SDK 버전은 Security Bulletin: Vulnerability in SSLv3 affects IBM WebSphere Application Server (CVE-2014-3566)에서 찾을 수 있습니다.

     참고: 이 보안 게시판에 나열된 버전 또는 이후 버전을 사용할 수 있습니다.

   • Oracle Java SDK를 사용하는 경우 다음 버전 중 하나가 있는지 확인하십시오.

     • Oracle JRE 1.7.0_75 이상
     • Oracle JRE 1.8.0_31 이상
2. IBM Java SDK를 사용하는 경우 server.xml 파일을 편집하십시오.
   • 다음 행을 추가하십시오. <ssl id="defaultSSLConfig" keyStoreRef="defaultKeyStore" sslProtocol="SSL_TLSv2"/>
   • sslProtocol="SSL_TLSv2" 속성을 기존 모든 <ssl> 요소에 추가하십시오.

WebSphere Application Server 전체 프로파일

1. JRE(Java Runtime Environment)에서 TLS V1.2를 지원하는지 확인하십시오.

   IBM Java SDK에 POODLE 취약성에 대한 패치가 적용되었는지 확인하십시오. 사용하는 WebSphere Application Server 버전에 대한 패치가 포함된 최소 IBM Java SDK 버전은 Security Bulletin: Vulnerability in SSLv3 affects IBM WebSphere Application Server (CVE-2014-3566)에서 찾을 수 있습니다.

   참고: 이 보안 게시판에 나열된 버전 또는 이후 버전을 사용할 수 있습니다.

2. WebSphere Application Server 관리 콘솔에 로그인하여 보안 → SSL 인증서 및 키 관리 → SSL 구성을 클릭하십시오.
3. 나열된 SSL 구성마다 TLS V1.2를 사용할 수 있도록 구성을 수정하십시오.
   • SSL 구성을 선택한 후, 추가 특성 아래에서 QoP(Quality of Protection) 설정을 클릭하십시오.
   • 프로토콜 목록에서 SSL_TLSv2를 선택하십시오.
   • 적용을 클릭하여 변경사항을 저장하십시오.

MobileFirst Server 관리용 사용자 인증 구성

MobileFirst Server 관리에는 사용자 인증이 필요합니다. 사용자 인증을 구성하고 인증 방법을 선택할 수 있습니다. 구성 프로시저는 사용하는 웹 애플리케이션 서버에 따라 다릅니다.

중요: 독립형 WebSphere Application Server 전체 프로파일을 사용하는 경우, 글로벌 보안의 단순한 WebSphere 인증 방법(SWAM)이 아닌 다른 인증 방법을 사용하십시오. LTPA(Lightweight Third-Party Authentication)를 사용할 수 있습니다. SWAM을 사용하는 경우 예상치 못한 인증 실패가 발생할 수 있습니다.

설치 프로그램이 웹 애플리케이션 서버에서 MobileFirst Server 관리 웹 애플리케이션을 배치한 후에 인증을 구성해야 합니다.

MobileFirst Server 관리에는 다음과 같은 Java Platform, Enterprise Edition(Java EE) 보안 역할이 정의되어 있습니다.

• mfpadmin
• mfpdeployer
• mfpoperator
• mfpmonitor

역할을 해당 사용자 세트에 맵핑해야 합니다. mfpmonitor 역할은 데이터를 볼 수 있지만 변경할 수는 없습니다. 다음 표는 프로덕션 서버의 MobileFirst 역할 및 기능을 나열합니다.

배치

MobileFirst Server 관리

애플리케이션 관리

기본적으로 모든 역할이 GET 요청을 실행할 수 있고, mfpadmin, mfpdeployer 및 mfpmonitor 역할은 POST 및 PUT 요청도 실행할 수 있으며, mfpadmin 및 mfpdeployer 역할은 DELETE 요청도 실행할 수 있습니다.

푸시 알림과 관련된 요청

사용 안함

LDAP와 같은 사용자 저장소를 통한 인증 방법을 사용하도록 선택하는 경우, 사용자 저장소와 함께 사용자 및 그룹을 사용하여 MobileFirst Server 관리의 ACL(Access Control List)을 정의할 수 있도록 MobileFirst Server 관리를 구성할 수 있습니다. 이 프로시저는 사용하는 웹 애플리케이션 서버의 유형 및 버전에 따라 다릅니다.

MobileFirst Server 관리용 WebSphere Application Server 전체 프로파일 구성

MobileFirst Server 관리 Java EE 역할을 두 웹 애플리케이션의 사용자 세트에 맵핑하여 보안을 구성합니다.

WebSphere Application Server 콘솔에서 사용자 구성의 기본을 정의합니다. 일반적으로 다음 주소를 사용하여 콘솔에 액세스합니다. https://localhost:9043/ibm/console/

1. 보안 → 글로벌 보안을 선택하십시오.
2. 보안 구성 마법사를 선택하여 사용자를 구성하십시오. 사용자 및 그룹 → 사용자 관리를 선택하여 개별 사용자 계정을 관리할 수 있습니다.
3. mfpadmin, mfpdeployer, mfpmonitor 및 mfpoperator 역할을 사용자 세트에 맵핑하십시오.
   • 서버 → 서버 유형 → WebSphere Application Server를 선택하십시오.
   • 서버를 선택하십시오.
   • 구성 탭에서 애플리케이션 → 엔터프라이즈 애플리케이션을 선택하십시오.
   • MobileFirst_Administration_Service를 선택하십시오.
   • 구성 탭에서 세부사항 → 사용자/그룹으로의 보안 역할 맵핑을 선택하십시오.
   • 필요한 사용자 정의를 수행하십시오.
   • 확인을 클릭하십시오.
   • 단계를 반복하여 콘솔 웹 애플리케이션의 역할을 맵핑하십시오. 이번에는 MobileFirst_Administration_Console을 선택하십시오.
   • 저장을 클릭하여 변경사항을 저장하십시오.

MobileFirst Server 관리용 WebSphere Application Server Liberty 프로파일 구성

WebSphere Application Server Liberty 프로파일에서는 서버의 server.xml 구성 파일에 mfpadmin, mfpdeployer, mfpmonitor 및 mfpoperator의 역할을 구성합니다.

보안 역할을 구성하려면 server.xml 파일을 편집해야 합니다. 각 <application> 요소의 <application-bnd> 요소에서 <security-role> 요소를 작성하십시오. 각 <security-role> 요소는 각 역할(mfpadmin, mfpdeployer, mfpmonitor, mfpoperator)에 대한 것입니다. 이러한 역할을 적절한 사용자 그룹 이름(이 예에서는 mfpadmingroup, mfpdeployergroup, mfpmonitorgroup 또는 mfpoperatorgroup)에 맵핑하십시오. 이러한 그룹은 <basicRegistry> 요소를 통해 정의됩니다. 이 요소를 사용자 정의하거나 전체를 <ldapRegistry> 요소 또는 <safRegistry> 요소로 대체할 수 있습니다.

그런 다음, 다수의 애플리케이션(예를 들어, 80개의 애플리케이션)이 설치된 상태에서 양호한 응답 시간을 유지하기 위해 관리 데이터베이스에 대한 연결 풀을 구성해야 합니다.

1. server.xml 파일을 편집하십시오. 예를 들어, 다음과 같습니다.

   <security-role name="mfpadmin">
      <group name="mfpadmingroup"/>
   </security-role>
   <security-role name="mfpdeployer">
      <group name="mfpdeployergroup"/>
   </security-role>
   <security-role name="mfpmonitor">
      <group name="mfpmonitorgroup"/>
   </security-role>
   <security-role name="mfpoperator">
      <group name="mfpoperatorgroup"/>
   </security-role>
   
   <basicRegistry id="mfpadmin">
      <user name="admin" password="admin"/>
      <user name="guest" password="guest"/>
      <user name="demo" password="demo"/>
      <group name="mfpadmingroup">
        <member name="guest"/>
        <member name="demo"/>
      </group>
      <group name="mfpdeployergroup">
        <member name="admin" id="admin"/>
      </group>
      <group name="mfpmonitorgroup"/>
      <group name="mfpoperatorgroup"/>
   </basicRegistry>
   

2. AppCenterPool 크기를 정의하십시오.

   <connectionManager id="AppCenterPool" minPoolSize="10" maxPoolSize="40"/>
   

3. <dataSource> 요소에서 커넥터 관리자에 대한 참조를 정의하십시오.

   <dataSource id="MFPADMIN" jndiName="mfpadmin/jdbc/mfpAdminDS" connectionManagerRef="AppCenterPool">
   ...
   </dataSource>
   

MobileFirst Server 관리용 Apache Tomcat 구성

Apache Tomcat 웹 애플리케이션 서버에서 MobileFirst Server 관리용 Java EE 보안 역할을 구성해야 합니다.

1. MobileFirst Server 관리를 수동으로 설치한 경우, conf/tomcat-users.xml 파일에 다음 역할을 선언하십시오.

   <role rolename="mfpadmin"/>
   <role rolename="mfpmonitor"/>
   <role rolename="mfpdeployer"/>
   <role rolename="mfpoperator"/>
   

2. 선택된 사용자에 역할을 추가하십시오. 예를 들면, 다음과 같습니다.

   <user name="admin" password="admin" roles="mfpadmin"/>
   

3. Apache Tomcat 문서, 영역 구성 방법에 설명된 대로 사용자 세트를 정의할 수 있습니다.

MobileFirst Server 웹 애플리케이션의 JNDI 특성 목록

애플리케이션 서버에 배치되는 MobileFirst Server 웹 애플리케이션의 JNDI 특성을 구성합니다.

• MobileFirst Server 웹 애플리케이션의 JNDI 특성 설정
• MobileFirst Server 관리 서비스의 JNDI 특성 목록
• MobileFirst Server 라이브 업데이트 서비스의 JNDI 특성 목록
• MobileFirst 런타임의 JNDI 특성 목록
• MobileFirst Server 푸시 서비스의 JNDI 특성 목록

MobileFirst Server 웹 애플리케이션의 JNDI 특성 설정

애플리케이션 서버에 배치되는 MobileFirst Server 웹 애플리케이션을 구성하기 위해 JNDI 특성을 구성합니다.
다음 방법 중 하나로 JNDI 환경 항목을 설정하십시오.

• 서버 환경 항목을 구성하십시오. 서버 환경 항목을 구성하는 단계는 사용하는 애플리케이션 서버에 따라 다릅니다.

  • WebSphere Application Server:
    1. WebSphere Application Server 관리 콘솔에서 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션 → application_name → 웹 모듈의 환경 항목으로 이동하십시오.
    2. 값 필드에 서버 환경에 적절한 값을 입력하십시오.

    

  • WebSphere Application Server Liberty:

    liberty_install_dir/usr/servers/serverName에서 server.xml 파일을 편집하여 JNDI 특성을 다음과 같이 선언하십시오.

    <application id="app_context_root" name="app_context_root" location="app_war_name.war" type="war">
          ...
    </application>
    <jndiEntry jndiName="app_context_root/JNDI_property_name" value="JNDI_property_value" />
    

    컨텍스트 루트(앞의 예에서 app_context_root)는 JNDI 항목과 특정 MobileFirst 애플리케이션을 연결합니다. 동일한 서버에 다수의 MobileFirst 애플리케이션이 있는 경우, 컨텍스트 경로 접두부를 사용하여 각 애플리케이션에 고유한 JNDI 항목을 정의할 수 있습니다.

    참고: 일부 특성은 WebSphere Application Server Liberty에서 글로벌로 정의되고 특성 이름 앞에 컨텍스트 루트가 접두부로 추가되지 않습니다. 이러한 특성의 목록은 글로벌 JNDI 항목을 참조하십시오.

    다른 모든 JNDI 특성의 경우 이름 앞에 애플리케이션의 컨텍스트 루트가 접두부로 추가되어야 합니다.

    • 라이브 업데이트 서비스의 경우 컨텍스트 루트는 /[adminContextRoot]config여야 합니다. 예를 들어, 관리 서비스의 컨텍스트 루트가 /mfpadmin이면 라이브 업데이트 서비스의 컨텍스트 루트는 /mfpadminconfig여야 합니다.
    • 푸시 서비스의 경우 컨텍스트 루트를 /imfpush로 정의해야 합니다. 그렇지 않으면 컨텍스트 루트가 SDK에서 하드코딩되므로 클라이언트 디바이스가 여기에 연결될 수 없습니다.
    • MobileFirst Administration Service 애플리케이션, MobileFirst Operations Console 및 MobileFirst 런타임의 경우, 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 그러나 기본적으로 컨텍스트 루트는 MobileFirst Administration Service의 경우 /mfpadmin이고, MobileFirst Operations Console의 경우 /mfpconsole이며, MobileFirst 런타임의 경우 /mfp입니다.

    예를 들어, 다음과 같습니다.

    <application id="mfpadmin" name="mfpadmin" location="mfp-admin-service.war" type="war">
          ...
    </application>
    <jndiEntry jndiName="mfpadmin/mfp.admin.actions.prepareTimeout" value = "2400000" />
    

  • Apache Tomcat:

    tomcat_install_dir/conf에서 server.xml 파일을 편집하여 JNDI 특성을 다음과 같이 선언하십시오.

    <Context docBase="app_context_root" path="/app_context_root">
          <Environment name="JNDI_property_name" override="false" type="java.lang.String" value="JNDI_property_value"/>
    </Context>
    

    • JNDI 항목이 애플리케이션의 <Context> 요소 내부에 정의되므로 컨텍스트 경로 접두부가 필요하지 않습니다.
    • override="false"는 필수입니다.
    • type 속성은 해당 특성에 대해 다르게 지정하지 않는 한 항상 java.lang.String입니다.

    예를 들어, 다음과 같습니다.

    <Context docBase="app_context_root" path="/app_context_root">
          <Environment name="mfp.admin.actions.prepareTimeout" override="false" type="java.lang.String" value="2400000"/>
    </Context>
    

• Ant 태스크를 사용하여 설치하는 경우, 설치 시 JNDI 특성 값을 설정할 수도 있습니다.

  mfp_install_dir/MobileFirstServer/configuration-samples에서 Ant 태스크용 구성 XML 파일을 편집하고 다음 태그 내부에 있는 특성 요소를 사용하여 JNDI 특성의 값을 선언하십시오.

  • <installmobilefirstadmin>(MobileFirst Server 관리, MobileFirst Operations Console 및 라이브 업데이트 서비스용). 자세한 정보는 MobileFirst Operations Console, MobileFirst Server 아티팩트, MobileFirst Server 관리 및 라이브 업데이트 서비스의 설치를 위한 Ant 태스크를 참조하십시오.
  • <installmobilefirstruntime>(MobileFirst 런타임 구성 특성용). 자세한 정보는 MobileFirst 런타임 환경의 설치를 위한 Ant 태스크를 참조하십시오.
  • <installmobilefirstpush>(푸시 서비스 구성용). 자세한 정보는 MobileFirst Server 푸시 서비스의 설치를 위한 Ant 태스크를 참조하십시오.

  예를 들어, 다음과 같습니다.

  <installmobilefirstadmin ..>
        <property name = "mfp.admin.actions.prepareTimeout" value = "2400000" />
  </installmobilefirstadmin>
  

MobileFirst Server 관리 서비스의 JNDI 특성 목록

사용하는 애플리케이션 서버에 적합하게 MobileFirst Server 관리 서비스 및 MobileFirst Operations Console을 구성하는 경우, 특히 JMX(Java Management Extensions)에 대해, 선택적 또는 필수 JNDI 특성을 설정합니다.

관리 서비스 웹 애플리케이션 mfp-admin-service.war에서는 다음 특성을 설정할 수 있습니다.

관리 서비스의 JNDI 특성: JMX

관리 서비스의 JNDI 특성: 제한시간

관리 서비스의 JNDI 특성: 로깅

관리 서비스의 JNDI 특성: 프록시

관리 서비스의 JNDI 특성: 토폴로지

관리 서비스의 JNDI 특성: 관계형 데이터베이스

관리 서비스의 JNDI 특성: 라이센싱

관리 서비스의 JNDI 특성: JNDI 구성

관리 서비스는 라이브 업데이트 서비스를 보조 기능으로 사용하여 다양한 구성을 저장합니다. 이러한 특성을 사용하여 라이브 업데이트 서비스에 도달하는 방법을 구성하십시오.

관리 서비스의 JNDI 특성: 라이브 업데이트 서비스

관리 서비스는 푸시 서비스를 보조 기능으로 사용하여 다양한 푸시 설정을 저장합니다. 이러한 특성을 사용하여 푸시 서비스에 도달하는 방법을 구성하십시오. 푸시 서비스는 OAuth 보안 모델에 의해 보호되므로 OAuth에서 기밀 클라이언트를 사용하려면 다양한 특성을 설정해야 합니다.

관리 서비스의 JNDI 특성: 푸시 서비스

MobileFirst Operations Console의 JNDI 특성

MobileFirst Operations Console의 웹 애플리케이션(mfp-admin-ui.war)에서 다음 특성을 설정할 수 있습니다.

MobileFirst Server 라이브 업데이트 서비스의 JNDI 특성 목록

사용하는 애플리케이션 서버에 적합하게 MobileFirst Server 라이브 업데이트 서비스를 구성하는 경우 다음 JNDI 특성을 설정할 수 있습니다. 다음 표에서는 IBM 관계형 데이터베이스 라이브 업데이트 서비스의 JNDI 특성을 나열합니다.

이러한 특성의 설정 방법에 대해서는 MobileFirst Server 웹 애플리케이션의 JNDI 특성 설정을 참조하십시오.

MobileFirst 런타임의 JNDI 특성 목록

사용하는 애플리케이션 서버에 적합하게 MobileFirst Server 런타임을 구성하는 경우 선택적 또는 필수 JNDI 특성을 설정해야 합니다.
다음 표에는 JNDI 항목으로 항상 사용할 수 있는 MobileFirst 특성을 나열합니다.

MobileFirst Server 푸시 서비스의 JNDI 특성 목록

데이터 소스 구성

지원되는 데이터베이스와 관련된 일부 데이터 소스 구성 세부사항에 대해 설명합니다.

• DB2 트랜잭션 로그 크기 관리
• MobileFirst Server 및 Application Center 데이터 소스에 대한 DB2 HADR 심리스(seamless) 장애 복구 구성
• 시간이 경과된(stale) 연결 처리
• MobileFirst Operations Console에서 앱 작성 또는 삭제 후 시간이 경과된(stale) 데이터

DB2 트랜잭션 로그 크기 관리

IBM MobileFirst Operations Console에서 40MB 이상의 애플리케이션을 배치하면 트랜잭션 로그 가득 참 오류를 수신할 수 있습니다.

다음 시스템 출력은 트랜잭션 로그 가득 참 오류 코드의 예입니다.

DB2 SQL Error: SQLCODE=-964, SQLSTATE=57011

각 애플리케이션의 컨텐츠는 MobileFirst 관리 데이터베이스에 저장됩니다.

활성 로그 파일의 수는 LOGPRIMARY 및 LOGSECOND 데이터베이스 구성 매개변수로 정의되고, 크기는 LOGFILSIZ 데이터베이스 구성 매개변수로 정의됩니다. 단일 트랜잭션은 LOGFILSZ * (LOGPRIMARY + LOGSECOND) * 4096KB보다 많은 로그 공간을 사용할 수 없습니다.

DB2 GET DATABASE CONFIGURATION 명령에는 로그 파일 크기와 1차 및 2차 로그 파일의 수에 대한 정보가 포함되어 있습니다.

배치되는 MobileFirst 애플리케이션의 최대 크기에 따라 DB2 로그 공간을 증가시켜야 할 수도 있습니다.

DB2 update db cfg 명령을 사용하여 LOGSECOND 매개변수를 늘리십시오. 데이터베이스가 활성화된 경우 공간이 할당되지 않습니다. 대신 필요한 경우에만 공간이 할당됩니다.

MobileFirst Server 및 Application Center 데이터 소스에 대한 DB2 HADR 심리스(seamless) 장애 복구 구성

WebSphere Application Server Liberty 프로파일 및 WebSphere Application Server에서 심리스(seamless) 장애 복구 기능을 사용 가능하게 설정해야 합니다. 이 기능을 사용하면 데이터베이스가 장애 복구되고 DB2 JDBC 드라이버에 의해 경로 재지정되는 경우 예외를 관리할 수 있습니다.

참고: Apache Tomcat에 대해서는 DB2 HADR 장애 복구가 지원되지 않습니다.

DB2 HADR을 사용하는 경우, 기본적으로 DB2 JDBC 드라이버는 기존 연결을 다시 사용하기 위한 첫 번째 시도 중 데이터베이스가 장애 복구되었음을 발견한 후 클라이언트 경로 재지정을 수행할 때 ERRORCODE=-4498 및 SQLSTATE=08506과 함께 com.ibm.db2.jcc.am.ClientRerouteException을 트리거합니다. WebSphere Application Server는 이 예외를, 애플리케이션이 수신하기 전에, com.ibm.websphere.ce.cm.StaleConnectionException에 맵핑합니다.

이 경우, 애플리케이션은 이 예외를 발견하여 트랜잭션을 다시 실행해야 합니다. MobileFirst 및 Application Center 런타임 환경에서는 이 예외를 관리하지는 않지만 심리스(seamless) 장애 복구라는 기능을 활용합니다. 이 기능을 사용하려면 enableSeamlessFailover JDBC 특성을 “1”로 설정해야 합니다.

WebSphere Application Server Liberty 프로파일 구성

server.xml 파일을 편집하고 MobileFirst 및 Application Center 데이터 소스의 properties.db2.jcc 요소에 enableSeamlessFailover 특성을 추가해야 합니다. 예를 들어, 다음과 같습니다.

<dataSource jndiName="jdbc/WorklightAdminDS" transactional="false">
  <jdbcDriver libraryRef="DB2Lib"/>
  <properties.db2.jcc databaseName="WLADMIN"  currentSchema="WLADMSC"
                      serverName="db2server" portNumber="50000"
                      enableSeamlessFailover= "1"
                      user="worklight" password="worklight"/>
</dataSource>

WebSphere Application Server 구성

각 MobileFirst 및 Application Center 데이터 소스의 WebSphere Application Server 관리 콘솔에서 다음을 수행하십시오.

1. 리소스 → JDBC → 데이터 소스 → 데이터 소스 이름으로 이동하십시오.
2. 새로 작성을 선택하여 다음 사용자 정의 특성을 추가하거나, 이 특성이 이미 있는 경우 값을 업데이트하십시오. enableSeamlessFailover : 1
3. 적용을 클릭하십시오.
4. 구성을 저장합니다.

HADR 사용 DB2 데이터베이스로의 연결을 구성하는 방법에 대한 자세한 정보는 HADR 사용 DB2 데이터베이스로의 연결 설정을 참조하십시오.

시간이 경과된(stale) 연결 처리

데이터베이스 제한시간 초과 문제가 발생하지 않도록 애플리케이션 서버를 구성합니다.

StaleConnectionException은 JDBC 드라이버가 연결 요청 또는 조작에서 복구 불가능한 오류를 리턴할 때 Java 애플리케이션 서버 프로파일 데이터베이스 연결 코드에 의해 생성되는 예외입니다. 데이터베이스 공급업체가 현재 연결 풀에 있는 연결이 더 이상 유효하지 않음을 나타내는 예외를 발행하면 StaleConnectionException이 발생합니다. 이 예외는 여러 가지 이유로 발생할 수 있습니다. StaleConnectionException의 가장 일반적인 원인은 데이터베이스 연결 풀에서 연결을 검색한 결과 오랜 시간 동안 사용하지 않아 연결이 제한시간을 초과했거나 삭제된 것으로 판명되었기 때문입니다.

이 예외가 발생하지 않도록 애플리케이션 서버를 구성할 수 있습니다.

Apache Tomcat 구성

MySQL
MySQL 데이터베이스는 연결이 일정 기간 비활성 상태이면 해당 연결을 닫습니다. 이러한 제한시간은 wait_timeout이라는 시스템 변수에 의해 정의됩니다. 기본값은 28000초(8시간)입니다.

MySQL이 연결을 닫은 후 애플리케이션에서 데이터베이스에 연결하려고 시도하는 경우 다음 예외가 생성됩니다.

com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: No operations allowed after statement closed.

server.xml 및 context.xml 파일을 편집하고 각 <Resource> 요소에 다음 특성을 추가하십시오.

• testOnBorrow=”true”
• validationQuery=”select 1”

예를 들어, 다음과 같습니다.

<Resource name="jdbc/AppCenterDS"
  type="javax.sql.DataSource"
  driverClassName="com.mysql.jdbc.Driver"
  ...
  testOnBorrow="true"
  validationQuery="select 1"
/>

WebSphere Application Server Liberty 프로파일 구성

server.xml 파일을 편집하고 각 <dataSource> 요소(런타임 및 Application Center 데이터베이스)에 agedTimeout 특성이 지정된 <connectionManager> 요소를 추가하십시오.

<connectionManager agedTimeout="timeout_value"/>

제한시간 값은 주로 동시에 열려 있는 연결 수에 따라 달라지지만 풀에 있는 최소 및 최대 연결 수에 따라서도 달라집니다. 따라서 다양한 connectionManager 속성을 조정하여 가장 적합한 값을 식별해야 합니다. connectionManager 요소에 대한 자세한 정보는 Liberty: server.xml 파일의 구성 요소를 참조하십시오.

참고: MySQL과 WebSphere Application Server Liberty 프로파일 또는 WebSphere Application Server 전체 프로파일의 조합은 지원되는 구성으로 분류되지 않습니다. 자세한 정보는 WebSphere Application Server Support Statement를 참조하십시오. IBM DB2를 사용하거나 WebSphere Application Server에서 지원하는 다른 데이터베이스를 사용하여 IBM 지원 센터에서 완전하게 지원하는 구성의 이점을 활용할 수 있습니다.

MobileFirst Operations Console에서 앱 작성 또는 삭제 후 시간이 경과된(stale) 데이터

Tomcat 8 애플리케이션 서버에서 MySQL 데이터베이스를 사용하는 경우, MobileFirst Operations Console에서 서비스를 호출할 때 일부 호출에서 404 오류를 리턴합니다.

Tomcat 8 애플리케이션 서버에서 MySQL 데이터베이스를 사용하여 작업하는 경우, MobileFirst Operations Console을 사용하여 앱을 삭제하거나 새 앱을 추가하고 콘솔을 여러 번 새로 고칠 때 시간이 경과된(stale) 데이터가 표시될 수 있습니다. 예를 들어, 이미 삭제된 앱이 목록에 표시될 수 있습니다.

이러한 문제점이 발생하지 않도록 하려면, 데이터 소스 또는 데이터베이스 관리 시스템에서 격리 레벨을 READ_COMMITTED로 변경하십시오.

READ_COMMITTED의 의미에 대해서는 http://dev.mysql.com/doc/refman/5.7/en/innodb-transaction-isolation-levels.html에 있는 MySQL 문서를 참조하십시오.

• 데이터 소스에서 격리 레벨을 READ_COMMITTED로 변경하려면 server.xml Tomcat 구성 파일을 다음과 같이 수정하십시오. <Resource name=”jdbc/mfpAdminDS” …/> 섹션에서 defaultTransactionIsolation=”READ_COMMITTED” 속성을 추가하십시오.
• 데이터베이스 관리 시스템에서 글로벌로 격리 레벨을 READ_COMMITTED로 변경하려면 http://dev.mysql.com/doc/refman/5.7/en/set-transaction.html에 있는 MySQL 문서의 SET TRANSACTION 구문 페이지를 참조하십시오.

WebSphere Application Server 전체 프로파일 구성

DB2 또는 Oracle
시간이 경과된(stale) 연결 문제를 최소화하려면 WebSphere Application Server 관리 콘솔에서 각 데이터 소스의 연결 풀 구성을 검사하십시오.

1. WebSphere Application Server 관리 콘솔에 로그인하십시오.
2. 리소스 → JDBC 제공자 → database_jdbc_provider → 데이터 소스 → your_data_source → 연결 풀 특성을 선택하십시오.
3. 최소 연결 수 값을 0으로 설정하십시오.
4. 립(Reap) 시간 값을 미사용 제한시간 값 미만으로 설정하십시오.
5. 영구 제거 정책 특성이 EntirePool(기본값)로 설정되어 있는지 확인하십시오.

자세한 정보는 연결 풀 설정을 참조하십시오.

MySQL

1. WebSphere Application Server 관리 콘솔에 로그인하십시오.
2. 리소스 → JDBC → 데이터 소스를 선택하십시오.
3. 각 MySQL 데이터 소스에 대해 다음을 수행하십시오.
   • 데이터 소스를 클릭하십시오.
   • 추가 특성 아래의 연결 풀 특성을 선택하십시오.
   • 경과된 제한시간 특성의 값을 수정하십시오. MySQL이 연결을 닫기 전에 이러한 연결이 제거되도록 하려면 이 값이 MySQL wait_timeout 시스템 변수보다 낮아야 합니다.
   • 확인을 클릭하십시오.

참고: MySQL과 WebSphere Application Server Liberty 프로파일 또는 WebSphere Application Server 전체 프로파일의 조합은 지원되는 구성으로 분류되지 않습니다. 자세한 정보는 WebSphere Application Server Support Statement를 참조하십시오. IBM DB2를 사용하거나 WebSphere Application Server에서 지원하는 다른 데이터베이스를 사용하여 IBM 지원 센터에서 완전하게 지원하는 구성의 이점을 활용할 수 있습니다.

로깅 및 모니터링 메커니즘 구성

Mobile Foundation은 오류, 경고 및 정보 메시지를 로그 파일에 기록합니다. 기본 로깅 메커니즘은 애플리케이션에 따라 다릅니다.

MobileFirst Server

Mobile Foundation(줄여서 MobileFirst Server)는 표준 java.util.logging 패키지를 사용합니다. 기본적으로 모든 MobileFirst 로깅은 애플리케이션 서버 로그 파일로 이동합니다. 각 애플리케이션 서버에서 사용 가능한 표준 도구를 사용하여 MobileFirst Server 로깅을 제어할 수 있습니다. 예를 들어, WebSphere Application Server Liberty에서 추적 로깅을 활성화하려는 경우 server.xml 파일에 추적 요소를 추가하십시오. WebSphere Application Server에서 추적 로깅을 활성화하려면 콘솔의 로깅 화면을 사용하여 MobileFirst 로그의 추적을 사용 가능하게 설정하십시오.

MobileFirst 로그는 모두 com.ibm.mfp로 시작합니다.
Application Center 로그는 com.ibm.puremeap로 시작합니다.

로그 파일의 위치를 포함하여 각 애플리케이션 서버의 로깅 모델에 대한 자세한 정보는 다음 표에 표시된 관련 애플리케이션 서버에 대한 문서를 참조하십시오.

로그 레벨 맵핑

MobileFirst Server에서는 java.util.logging API를 사용합니다. 로깅 레벨은 다음 레벨에 맵핑됩니다.

• WL.Logger.debug: FINE
• WL.Logger.info: INFO
• WL.Logger.warn: WARNING
• WL.Logger.error: SEVERE

로그 모니터링 도구

Apache Tomcat의 경우, IBM Operations Analytics - Log Analysis 또는 다른 업계 표준 로그 파일 모니터링 도구를 사용하여 로그를 모니터하고 오류 및 경고를 강조표시할 수 있습니다.

WebSphere Application Server의 경우, IBM Knowledge Center에 설명된 로그 보기 기능을 사용하십시오. URL은 이 페이지의 MobileFirst Server 절에 있는 표에 나열되어 있습니다.

백엔드 연결

백엔드 연결을 모니터하기 위해 추적을 사용하려면 이 페이지의 MobileFirst Server 절에 있는 표에서 특정 애플리케이션 서버 플랫폼에 대한 문서를 참조하십시오. com.ibm.mfp.server.js.adapter 패키지를 사용하고 로그 레벨을 FINEST로 설정하십시오.

관리 조작의 감사 로그

MobileFirst Operations Console은 로그인, 로그아웃 및 모든 관리 조작(앱 또는 어댑터 배치, 앱 잠금 등)에 대한 감사 로그를 저장합니다. 감사 로그는 MobileFirst 관리 서비스의 웹 애플리케이션(mfp-admin-service.war)에서 JNDI 특성 mfp.admin.audit를 false로 설정하여 사용 불가능하게 설정할 수 있습니다.

감사 로그가 사용되는 경우, 페이지 푸터에서 감사 로그 링크를 클릭하여 MobileFirst Operations Console에서 감사 로그를 다운로드할 수 있습니다.

로그인 및 인증 문제

로그인 및 인증 문제를 진단하려면 com.ibm.mfp.server.security 패키지에서 추적을 사용 가능하게 설정하고 로그 레벨을 FINEST로 설정하십시오.

복수 런타임 구성

복수의 런타임을 포함하도록 MobileFirst Server를 구성하고 MobileFirst Operations Console 콘솔에서 애플리케이션 “유형” 간에 시각적 차이를 둘 수 있습니다.

참고: Mobile Foundation IBM Cloud 서비스에 의해 작성된 Mobile Foundation 서버 인스턴스에서는 복수 런타임이 지원되지 않습니다. IBM Cloud 서비스에서는 대신 복수 서비스 인스턴스를 작성해야 합니다.

다음으로 이동

• WebSphere Liberty 프로파일에서 복수 런타임 구성
• 애플리케이션 등록 및 서로 다른 런타임에 어댑터 배치
• 런타임 구성 내보내기 및 가져오기

WebSphere Liberty 프로파일에서 복수 런타임 구성

1. 애플리케이션 서버의 server.xml 파일을 여십시오. 일반적으로 [application-server]/usr/servers/server-name/ 폴더에 있습니다. 예를 들어, MobileFirst Developer Kit에서는 [installation-folder]/mfp-server/usrs/servers/mfp/server.xml에서 이 파일을 찾을 수 있습니다.

2. 두 번째 application 요소를 추가하십시오.

   <application id="second-runtime" name="second-runtime" location="mfp-server.war" type="war">
        <classloader delegation="parentLast">
            </classloader>
   </application>
   

3. 두 번째 JNDI 항목 세트를 추가하십시오.

   <jndiEntry jndiName="second-runtime/mfp.analytics.url" value='"http://localhost:9080/analytics-service/rest"'/>
   <jndiEntry jndiName="second-runtime/mfp.analytics.console.url" value='"http://localhost:9080/analytics/console"'/>
   <jndiEntry jndiName="second-runtime/mfp.analytics.username" value='"admin"'/>
   <jndiEntry jndiName="second-runtime/mfp.analytics.password" value='"admin"'/>
   <jndiEntry jndiName="second-runtime/mfp.authorization.server" value='"embedded"'/>
   

4. 두 번째 dataSource 요소를 추가하십시오.

   <dataSource jndiName="second-runtime/jdbc/mfpDS" transactional="false">
        <jdbcDriver libraryRef="DerbyLib"/>
        <properties.derby.embedded databaseName="${wlp.install.dir}/databases/second-runtime" user='"MFPDATA"'/>
   </dataSource>
   

   참고:

   • dataSource가 다른 데이터베이스 스키마를 가리키는지 확인하십시오.
   • 새 런타임을 위한 다른 데이터베이스 인스턴스를 작성했는지 확인하십시오.
   • 개발 환경에서 properties.derby.embedded 하위 요소에 createDatabase="create"를 추가하십시오.

5. 애플리케이션 서버를 다시 시작하십시오.

애플리케이션 등록 및 서로 다른 런타임에 어댑터 배치

MobileFirst Server가 복수 런타임을 포함하도록 구성된 경우 애플리케이션 등록과 어댑터 배치가 약간 다릅니다.

• MobileFirst Operations Console에서 등록 및 배치
• 명령행에서 등록 및 배치

MobileFirst Operations Console에서 등록 및 배치

MobileFirst Operations Console에서 이러한 조치를 수행하는 경우 등록 또는 배치할 런타임을 선택해야 합니다.

명령행에서 등록 및 배치

mfpdev 명령행 도구를 사용하여 이러한 조치를 수행하는 경우 등록 또는 배치할 런타임 이름을 추가해야 합니다.

애플리케이션을 등록하는 경우: mfpdev app register <server-name> <runtime-name>.

mfpdev app register local second-runtime

어댑터를 배치하는 경우: mfpdev adapter deploy <server-name> <runtime-name>.

mfpdev adapter deploy local second-runtime

• local은 MobileFirst CLI에서 기본 서버 정의의 이름입니다. local을 등록 또는 배치해야 할 서버 정의 이름으로 대체하십시오.
• runtime-name은 등록 또는 배치할 런타임의 이름입니다.

자세한 정보를 보려면 다음 CLI help 명령을 사용하십시오.

• mfpdev help server add
• mfpdev help app register
• mfpdev help adapter deploy

런타임 구성 내보내기 및 가져오기

MobileFirst Server 관리 서비스의 REST API를 사용하여 런타임 구성을 내보내고 다른 MobileFirst Server로 가져올 수 있습니다.

예를 들어, 개발 환경에서 런타임 구성을 설정하여 해당 구성을 내보낸 후, 빠른 설정을 위한 테스트 환경으로 가져와 테스트 환경의 특정 요구에 따라 추가 구성을 수행할 수 있습니다.

API 참조서에서 사용 가능한 모든 REST API를 찾으십시오.

라이센스 추적 구성

라이센스 추적은 기본적으로 사용 가능합니다. 라이센스 추적을 구성할 수 있는 방법을 알아보려면 다음 주제를 읽으십시오. 라이센스 추적에 대한 자세한 정보는 라이센스 추적을 참조하십시오.

• 클라이언트 디바이스 및 주소 지정 가능한 디바이스에 대한 라이센스 추적 구성
• IBM License Metric Tool 로그 파일 구성

클라이언트 디바이스 및 주소 지정 가능한 디바이스에 대한 라이센스 추적 구성

클라이언트 디바이스 및 주소 지정 가능한 디바이스에 대한 라이센스 추적은 기본적으로 사용 가능합니다. 라이센스 보고서는 MobileFirst Operations Console에서 사용 가능합니다. 다음 JNDI 특성을 지정하여 라이센스 추적에 대한 기본 설정을 변경할 수 있습니다.

참고: 토큰 라이센싱 사용을 정의하는 계약이 있는 경우에는 토큰 라이센싱을 위한 설치 및 구성도 참조하십시오.

다음 JNDI 특성을 지정하여 라이센스 추적에 대한 기본 설정을 변경할 수 있습니다.

mfp.device.decommission.when
디바이스 해제 태스크에 의해 디바이스가 해제될 때까지의 비활성 일 수입니다. 라이센스 보고서는 해제된 디바이스를 활성 디바이스로 간주하지 않습니다. 특성의 기본값은 90일입니다. 클라이언트 디바이스나 주소 지정 가능한 디바이스에 의해 라이센스가 부여된 소프트웨어를 사용하는 경우에는 30일 미만의 값을 설정하지 마십시오. 30일 미만의 값을 설정하면 라이센스 보고서가 규제 준수를 증명하기에 충분하지 않을 수 있습니다.

mfp.device.archiveDecommissioned.when
해제 태스크가 실행될 때 해제된 디바이스가 아카이브 파일에 저장되는 시기를 정의하는 값(일)입니다. 아카이브된 디바이스는 IBM MobileFirst Server home\devices_archive 디렉토리에 있는 파일에 기록됩니다. 이 파일의 이름에는 아카이브 파일 작성 시의 시간소인이 포함됩니다. 기본값은 90일입니다.

mfp.device.decommissionProcessingInterval
해제 태스크가 실행되는 빈도(초)를 정의합니다. 기본값: 86400(1일). 해제 태스크는 다음 조치를 수행합니다.

• mfp.device.decommission.when 설정에 따라 비활성 디바이스를 해제합니다.
• 선택적으로, mfp.device.archiveDecommissioned.when 설정에 따라 해제된 디바이스 중 오래된 것을 아카이브합니다.
• 라이센스 추적 보고서를 생성합니다.

mfp.licenseTracking.enabled
Mobile Foundation에서 라이센스 추적을 사용 가능 또는 사용 불가능하게 설정하는 데 사용되는 값입니다. 기본적으로 라이센스 추적은 사용 가능합니다. 성능상의 이유로, 클라이언트 디바이스 또는 주소 지정 가능한 디바이스에 의해 Mobile Foundation에 라이센스가 부여되지 않은 경우 이 플래그를 사용 불가능하게 설정할 수 있습니다. 디바이스 추적이 사용되지 않는 경우, 라이센스 보고서도 사용되지 않고 라이센스 메트릭이 생성되지 않습니다. 이 경우, 애플리케이션 수에 대한 IBM License Metric Tool 레코드만 생성됩니다.

JNDI 특성 지정에 대한 자세한 정보는 MobileFirst 런타임의 JNDI 특성 목록을 참조하십시오.

IBM License Metric Tool 로그 파일 구성

Mobile Foundation은 IBM Software License Metric Tag(SLMT) 파일을 생성합니다. IBM Software License Metric Tag를 지원하는 IBM License Metric Tool 버전은 라이센스 이용 보고서를 생성할 수 있습니다. 여기서는 생성되는 파일의 위치 및 최대 크기를 구성하는 방법에 대해 설명합니다.

기본적으로 IBM Software License Metric Tag 파일은 다음 디렉토리에 있습니다.

• Windows의 경우: %ProgramFiles%\ibm\common\slm
• UNIX 및 UNIX 유사 운영 체제의 경우: /var/ibm/common/slm

디렉토리가 쓰기 불가능한 경우, MobileFirst 런타임 환경을 실행하는 애플리케이션 서버의 로그 디렉토리에 파일이 작성됩니다.

다음 특성을 사용하여 이러한 파일의 위치 및 관리를 구성할 수 있습니다.

• license.metric.logger.output.dir: IBM Software License Metric Tag 파일의 위치
• license.metric.logger.file.size: 순환이 수행되기 전 SLMT 파일의 최대 크기. 기본 크기는 1MB입니다.
• license.metric.logger.file.number: 순환 시 보관할 최대 SLMT 아카이브 파일 수. 기본 수는 10입니다.

기본값을 변경하려면 key=value 형식으로 Java 특성 파일을 작성하고 license_metric_logger_configuration JVM 특성을 통해 특성 파일에 대한 경로를 제공해야 합니다.

IBM License Metric Tool 보고서에 대한 자세한 정보는 IBM License Metric Tool과의 통합을 참조하십시오.

WebSphere Application Server SSL 구성 및 HTTP 어댑터

특성을 설정하면 HTTP 어댑터에서 WebSphere SSL 구성을 활용할 수 있습니다.

기본적으로 HTTP 어댑터는 JRE(Java Runtime Environment) 신뢰 저장소와 MobileFirst Server 키 저장소를 연결하여(MobileFirst Server 키 저장소 구성 참조) WebSphere SSL을 사용하지 않습니다. 자체 서명 인증서를 사용하여 어댑터와 백엔드 서버 간의 SSL 구성도 참조하십시오.

HTTP 어댑터에서 WebSphere SSL 구성을 사용하도록 하려면 ssl.websphere.config JNDI 특성을 true로 설정하십시오. 설정은 우선 순위에 다음과 같은 영향을 미칩니다.

1. WebSphere에서 실행 중인 어댑터는 MobileFirst Server 키 저장소가 아니라 WebSphere 키 저장소를 사용합니다.
2. ssl.websphere.alias 특성이 설정된 경우, 어댑터는 이 특성에 설정된 별명과 연관된 SSL 구성을 사용합니다.