애플리케이션 서버에 MobileFirst Server 설치

improve this page | report issue

개요

컴포넌트 설치는 Ant 태스크 또는 Server Configuration Tool을 사용하거나 수동으로 수행할 수 있습니다. 애플리케이션 서버에 컴포넌트를 성공적으로 설치할 수 있도록 설치 프로세스에 대한 전제조건 및 세부사항을 파악하십시오.

애플리케이션 서버에 대한 컴포넌트 설치를 계속 진행하기 전에 컴포넌트에 대한 데이터베이스 및 테이블을 사용할 준비가 되었는지 확인하십시오. 자세한 정보는 데이터베이스 설정을 참조하십시오.

컴포넌트를 설치할 서버 토폴로지도 정의해야 합니다. 토폴로지 및 네트워크 플로우를 참조하십시오.

다음으로 이동

애플리케이션 서버 전제조건

선택한 애플리케이션 서버에 따라 다음 주제 중 하나를 선택하여 MobileFirst Server 컴포넌트 설치 전에 이행해야 하는 전제조건을 파악하십시오.

Apache Tomcat 전제조건

MobileFirst Server에는 다음과 같은 주제에 자세히 설명되어 있는 Apache Tomcat 구성에 대한 일부 요구사항이 있습니다.
다음 기준을 충족하는지 확인하십시오.

  • 지원되는 Apache Tomcat 버전을 사용합니다. 시스템 요구사항을 참조하십시오.
  • Apache Tomcat은 JRE 7.0 이상과 함께 실행되어야 합니다.
  • 관리 서비스와 런타임 컴포넌트 사이의 통신을 허용하기 위해 JMX 구성을 사용할 수 있어야 합니다. 이 통신에서는 아래의 Apache Tomcat을 위한 JMX 연결 구성에 설명된 대로 RMI를 사용합니다.

Apache Tomcat 애플리케이션 서버를 위한 보안 JMX 연결을 구성해야 합니다.

Server Configuration Tool 및 Ant 태스크는 기본 보안 JMX 연결을 구성할 수 있으며 여기에는 JMX 원격 포트의 정의 및 인증 특성의 정의가 포함됩니다. 이들은 tomcat_install_dir/bin/setenv.battomcat_install_dir/bin/setenv.sh를 수정하여 이 옵션을 CATALINA_OPTS에 추가합니다.

-Djava.rmi.server.hostname=localhost
-Dcom.sun.management.jmxremote.port=8686
-Dcom.sun.management.jmxremote.authenticate=false
-Dcom.sun.management.jmxremote.ssl=false

참고: 8686이 기본값입니다. 컴퓨터에서 이 포트를 사용할 수 없으면 이 포트의 값을 변경할 수 있습니다.

  • tomcat_install_dir/bin/startup.bat 또는 tomcat_install_dir/bin/catalina.bat를 사용하여 Apache Tomcat을 시작하는 경우 setenv.bat 파일이 사용됩니다.
  • tomcatInstallDir/bin/startup.sh 또는 tomcat_install_dir/bin/catalina.sh를 사용하여 Apach Tomcat을 시작하는 경우 setenv.sh 파일이 사용됩니다.

다른 명령을 사용하여 Apache Tomcat을 시작하는 경우에는 이 파일이 사용되지 않습니다. Apache Tomcat Windows Service Installer를 설치한 경우에는 서비스 실행기가 setenv.bat를 사용하지 않습니다.

중요: 이 구성은 기본적으로 안전하지 않습니다. 구성에 보안을 설정하려면 다음 프로시저의 2단계 및 3단계를 수동으로 완료해야 합니다.

Apache Tomcat 수동 구성:

  1. 단순 구성의 경우에는 다음과 같은 옵션을 CATALINA_OPTS에 추가하십시오.
    -Djava.rmi.server.hostname=localhost
    -Dcom.sun.management.jmxremote.port=8686
    -Dcom.sun.management.jmxremote.authenticate=false
    -Dcom.sun.management.jmxremote.ssl=false
  2. 인증을 활성화하려면 Apache Tomcat 사용자 문서 SSL 지원 - BIO 및 NIOSSL 구성 방법을 참조하십시오.
  3. SSL이 사용으로 설정된 JMX 구성의 경우 다음과 같은 옵션을 추가하십시오.
    -Dcom.sun.management.jmxremote=true
    -Dcom.sun.management.jmxremote.port=8686
    -Dcom.sun.management.jmxremote.ssl=true
    -Dcom.sun.management.jmxremote.authenticate=false
    -Djava.rmi.server.hostname=localhost  
    -Djavax.net.ssl.trustStore=<key store location>
    -Djavax.net.ssl.trustStorePassword=<key store password>
    -Djavax.net.ssl.trustStoreType=<key store type>
    -Djavax.net.ssl.keyStore=<key store location>
    -Djavax.net.ssl.keyStorePassword=<key store password>
    -Djavax.net.ssl.keyStoreType=<key store type>
    참고: 포트 8686은 변경될 수 있습니다.
  4. Tomcat 인스턴스가 방화벽 뒤에서 실행 중인 경우에는 JMX 원격 라이프사이클 리스너를 구성해야 합니다. JMX 원격 라이프사이클 리스너에 대해서는 Apache Tomcat 문서를 참조하십시오.

    다음 예에서와 같이 다음과 같은 환경 특성도 server.xml 파일에서 관리 서비스 애플리케이션의 컨텍스트 섹션에 추가해야 합니다.

    <Context docBase="mfpadmin" path="/mfpadmin ">
        <Environment name="mfp.admin.rmi.registryPort" value="registryPort" type="java.lang.String" override="false"/>
        <Environment name="mfp.admin.rmi.serverPort" value="serverPort" type="java.lang.String" override="false"/>
    </Context>
    이전 예에서:
    • registryPort는 JMX 원격 라이프사이클 리스너의 rmiRegistryPortPlatform 속성과 동일한 값을 가져야 합니다.
    • serverPort는 JMX 원격 라이프사이클 리스너의 rmiServerPortPlatform 속성과 동일한 값을 가져야 합니다.
  5. CATALINA_OPTS에 옵션을 추가하는 대신 Apache Tomcat Windows Service Installer를 사용하여 Apache Tomcat을 설치한 경우에는 tomcat_install_dir/bin/Tomcat7w.exe를 실행하고 특성 창의 Java 탭에서 옵션을 추가하십시오. Apache Tomcat 7 특성

WebSphere Application Server Liberty 전제조건

IBM Mobile Foundation에는 다음과 같은 주제에 자세히 설명되어 있는 Liberty 서버의 구성에 대한 일부 요구사항이 있습니다.

다음 기준을 충족하는지 확인하십시오.

  • 지원되는 Liberty 버전을 사용합니다. 시스템 요구사항을 참조하십시오.
  • Liberty는 JRE 7.0 이상과 함께 실행되어야 합니다. JRE 6.0은 지원되지 않습니다.
  • 일부 Liberty 버전은 Java EE 6와 Java EE 7의 기능을 모두 지원합니다. 예를 들어, jdbc-4.0 Liberty 기능은 Java EE 6의 일부인 반면 jdbc-4.1 Liberty 기능은 Java EE 7의 일부입니다. MobileFirst Server V8.0.0은 Java EE 6 또는 Java EE 7 기능과 함께 설치될 수 있습니다. 하지만 MobileFirst Server의 이전 버전을 동일한 Liberty 서버에서 실행하려면 Java EE 6 기능을 사용해야 합니다. MobileFirst Server V7.1.0 이하는 Java EE 7 기능을 지원하지 않습니다.
  • JMX는 아래의 WebSphere Application Server Liberty 프로파일을 위한 JMX 연결 구성에 설명된 대로 구성해야 합니다.
  • 프로덕션 환경에서 설치의 경우에는 컴퓨터가 시작될 때 자동으로 MobileFirst Server 컴포넌트가 시작되도록 Liberty 서버를 Windows, Linux 또는 UNIX 시스템에서 서비스로 시작할 수 있습니다. Liberty 서버를 실행하는 프로세스는 프로세스를 시작한 사용자가 로그아웃할 때 중지되지 않습니다.
  • MobileFirst Server V8.0.0은 이전 버전의 배치된 MobileFirst Server 컴포넌트가 포함된 Liberty 서버에 배치할 수 없습니다.
  • Liberty Collective 환경에서 설치의 경우 Liberty Collective 제어기 및 Liberty Collective 클러스터 멤버를 Liberty Collective 구성에 설명된 대로 구성해야 합니다.

MobileFirst Server를 사용하려면 보안 JMX 연결을 구성해야 합니다.

  • Server Configuration Tool 및 Ant 태스크는 기본 보안 JMX 연결을 구성할 수 있으며 여기에는 유효 기간이 365일인 자체 서명된 SSL 인증서 생성이 포함됩니다. 이 구성은 프로덕션 용도가 아닙니다.
  • 프로덕션용으로 보안 JMX 연결을 구성하려면 Liberty 프로파일에 대한 보안 JMX 연결 구성에 설명된 대로 지시사항을 수행하십시오.
  • rest-connector는 WebSphere Application Server, Liberty Core 및 기타 Liberty 에디션에 사용할 수 있지만 Liberty 서버를 사용 가능한 기능의 서브세트와 함께 패키지할 수 있습니다. rest-connector 기능을 Liberty 설치에서 사용하려면 다음 명령을 입력하십시오.
                        
    liberty_install_dir/bin/productInfo featureInfo
    참고: 이 명령의 출력에 restConnector-1.0이 포함되는지 확인하십시오.

WebSphere Application Server 및 WebSphere Application Server Network Deployment 전제조건

MobileFirst Server에는 다음과 같은 주제에 자세히 설명되어 있는 WebSphere Application Server 및 WebSphere Application Server Network Deployment의 구성에 대한 일부 요구사항이 있습니다.
다음 기준을 충족하는지 확인하십시오.

  • 지원되는 WebSphere Application Server 버전을 사용합니다. 시스템 요구사항을 참조하십시오.
  • 애플리케이션 서버는 JRE 7.0과 함께 실행되어야 합니다. 기본적으로 WebSphere Application Server는 Java 6.0 SDK를 사용합니다. Java 7.0 SDK로 전환하려면 WebSphere Application Server에서 Java 7.0 SDK로 전환을 참조하십시오.
  • 관리 보안이 켜져 있어야 합니다. MobileFirst Operations Console, MobileFirst Server 관리 서비스 및 MobileFirst Server 구성 서비스는 보안 역할에 의해 보호됩니다. 자세한 정보는 보안 사용을 참조하십시오.
  • 관리 서비스와 런타임 컴포넌트 사이의 통신을 허용하기 위해 JMX 구성을 사용할 수 있어야 합니다. 이 통신에서는 SOAP를 사용합니다. WebSphere Application Server Network Deployment의 경우 RMI를 사용할 수 있습니다. 자세한 정보는 아래의 WebSphere Application Server 및 WebSphere Application Server Network Deployment를 위한 JMX 연결 구성을 참조하십시오.

MobileFirst Server를 사용하려면 보안 JMX 연결을 구성해야 합니다.

  • MobileFirst Server를 사용하려면 JMX 조작을 수행하기 위해 RMI 포트 또는 SOAP 포트에 액세스해야 합니다. 기본적으로 SOAP 포트는 WebSphere Application Server에서 활성 상태입니다. MobileFirst Server는 기본적으로 SOAP 포트를 사용합니다. SOAP 포트와 RMI 포트가 모두 비활성화되어 있으면 MobileFirst Server가 실행되지 않습니다.
  • RMI는 WebSphere Application Server Network Deployment에서만 지원됩니다. RMI는 독립형 프로파일 또는 WebSphere Application Server 서버 팜에서 지원되지 않습니다.
  • 관리 및 애플리케이션 보안을 활성화해야 합니다.

파일 시스템 전제조건

MobileFirst Server를 애플리케이션 서버에 설치하려면 특정 파일 시스템 권한을 가진 사용자가 MobileFirst 설치 도구를 실행해야 합니다.
설치 도구에는 다음이 포함됩니다.

  • IBM Installation Manager
  • Server Configuration Tool
  • MobileFirst Server를 배치하는 데 필요한 Ant 태스크

WebSphere Application Server Liberty 프로파일의 경우 다음과 같은 조치를 수행하기 위해 필요한 권한을 가지고 있어야 합니다.

  • Liberty 설치 디렉토리의 파일을 읽습니다.
  • Liberty 서버의 구성 디렉토리(일반적으로 usr/servers/server-name)에서 파일을 작성하여 백업 사본을 작성하고 server.xml 및 jvm.options를 수정합니다.
  • Liberty 공유 리소스 디렉토리(일반적으로 usr/shared)에서 파일 및 디렉토리를 작성합니다.
  • Liberty 서버 앱 디렉토리(일반적으로 usr/servers/server-name/apps)에서 파일을 작성합니다.

WebSphere Application Server 전체 프로파일 및 WebSphere Application Server Network Deployment의 경우 다음과 같은 조치를 수행하기 위해 필요한 권한을 가지고 있어야 합니다.

  • WebSphere Application Server 설치 디렉토리의 파일을 읽습니다.
  • 선택한 WebSphere Application Server 전체 프로파일 또는 Deployment Manager 프로파일의 구성 파일을 읽습니다.
  • wsadmin 명령을 실행합니다.
  • 프로파일 구성 디렉토리에서 파일을 작성합니다. 설치 도구는 공유 라이브러리 또는 JDBC 드라이버 등의 리소스를 해당 디렉토리에 배치합니다.

Apache Tomcat의 경우 다음과 같은 조치를 수행하기 위해 필요한 권한을 가지고 있어야 합니다.

  • 구성 디렉토리를 읽습니다.
  • 구성 디렉토리에서 백업 파일을 작성하고 파일을 수정합니다(예: server.xml 및 tomcat-users.xml).
  • bin 디렉토리에서 백업 파일을 작성하고 파일을 수정합니다(예: setenv.bat).
  • lib 디렉토리에서 파일을 작성합니다.
  • webapps 디렉토리에서 파일을 작성합니다.

이 모든 애플리케이션 서버의 경우 애플리케이션 서버를 실행하는 사용자는 MobileFirst 설치 도구를 실행한 사용자가 작성한 파일을 읽을 수 있어야 합니다.

Server Configuration Tool을 사용한 설치

Server Configuration Tool을 사용하여 MobileFirst Server 컴포넌트를 애플리케이션 서버에 설치하십시오.

Server Configuration Tool은 데이터베이스를 설정하고 컴포넌트를 애플리케이션 서버에 설치할 수 있습니다. 이 도구는 단일 사용자를 위한 것입니다. 구성 파일은 디스크에 저장됩니다. 구성 파일이 저장되는 디렉토리는 메뉴 파일 → 환경 설정을 사용하여 수정할 수 있습니다. 이 파일은 한 번에 하나의 Server Configuration Tool 인스턴스에서만 사용해야 합니다. 이 도구는 동일한 파일에 대한 동시 액세스를 관리하지 않습니다. 도구의 여러 인스턴스가 동일한 파일에 액세스하는 경우 데이터가 유실될 수 있습니다. 이 도구가 데이터베이스를 작성하고 설정하는 방법에 대한 자세한 정보는 Server Configuration Tool을 사용하여 데이터베이스 테이블 작성을 참조하십시오. 데이터베이스가 존재하는 경우 이 도구는 일부 테스트 테이블의 컨텐츠 및 존재를 테스트하여 데이터베이스를 발견할 수 있으며 이 데이터베이스 테이블을 수정하지 않습니다.

지원되는 운영 체제

다음과 같은 운영 체제에 있는 경우 Server Configuration Tool을 사용할 수 있습니다.

  • Windows x86 또는 x86-64
  • macOS x86-64
  • Linux x86 또는 Linux x86-64

기타 운영 체제에서는 이 도구를 사용할 수 없습니다. Ant 태스크를 사용한 설치에 설명된 대로 MobileFirst Server 컴포넌트를 설치하려면 Ant 태스크를 사용해야 합니다.

Mac OS의 ServerConfigurationTool(SCT) 실행기는 레거시 Java SE 6 런타임 설치를 실행합니다. Mac OS에서 SCT 실행기를 시작하면 아래 메시지가 표시됩니다.

메시지 SCT - Mac OS

이 문제를 해결하려는 경우, Java SE 6 런타임을 설치하지 않고 SCT 실행 파일을 사용하여 다음 접근법 중 하나를 수행하고 SCT를 실행할 수 있습니다.

접근법 1

  • ServerConfigurationTool 실행기를 마우스 오른쪽 단추로 클릭합니다.
  • 패키지 컨텐츠 표시를 선택합니다.

    패키지 컨텐츠 표시

  • 컨텐츠 > MacOS를 클릭합니다.
  • ServerConfigurationTool 실행 파일을 클릭하여 SCT를 실행합니다.

접근법 2

Java SE 8와 Java SE6를 문제 없이 모두 컴퓨터에 설치할 수 있습니다.

  • SCT 실행기를 사용하는 동안 팝업 창이 표시되면 자세한 정보를 클릭합니다.
  • Apple 지원 사이트로 이동합니다. 여기서 Java SE 6 런타임을 가져오는 방법에 관한 추가 지시사항을 볼 수 있습니다.
  • 지시사항에 따라 Java SE 6 런타임을 설치하고 SCT 실행기를 시작합니다.

지원되는 토폴로지

Server Configuration Tool은 다음과 같은 토폴로지를 사용하여 MobileFirst Server 컴포넌트를 설치합니다.

  • 모든 컴포넌트(MobileFirst Operations Console, MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임)가 동일한 애플리케이션 서버에 있습니다. 하지만 WebSphere Application Server Network Deployment에서 클러스터에 설치할 때 관리 및 라이브 업데이트 서비스와 런타임에 대해 서로 다른 클러스터를 지정할 수 있습니다. Liberty Collective의 경우 MobileFirst Operations Console, 관리 서비스 및 라이브 업데이트 서비스는 Collective 제어기에서 설치되고 런타임은 Collective 멤버에서 설치됩니다.
  • MobileFirst Server 푸시 서비스가 설치되는 경우 해당 서비스도 동일한 서버에 설치됩니다. 하지만 WebSphere Application Server Network Deployment에서 클러스터에 설치할 때 푸시 서비스에 대해 다른 클러스터를 지정할 수 있습니다. Liberty Collective의 경우 푸시 서비스는 런타임이 설치될 때와 동일할 수 있는 Liberty 멤버에서 설치됩니다.
  • 모든 컴포넌트는 동일한 데이터베이스 시스템 및 사용자를 사용합니다. 또한 DB2의 경우 모든 컴포넌트는 동일한 스키마를 사용합니다.
  • Server Configuration Tool은 비대칭 배치를 위한 WebSphere Application Server Network Deployment 및 Liberty Collective의 경우를 제외하고 단일 서버를 위한 컴포넌트를 설치합니다. 다중 서버에 설치하는 경우에는 도구가 실행된 후 팜이 구성되어야 합니다. WebSphere Application Server Network Deployment에서는 서버 팜 구성이 필요하지 않습니다.

기타 토폴로지 또는 기타 데이터베이스 설정의 경우에는 대신 Ant 태스크를 사용하거나 수동으로 컴포넌트를 설치할 수 있습니다.

Server Configuration Tool 실행

Server Configuration Tool을 실행하기 전에 다음과 같은 요구사항이 충족되었는지 확인하십시오.

  1. Server Configuration Tool을 시작하십시오.
    • Linux의 경우 애플리케이션 바로 가기 애플리케이션 → IBM MobileFirst Platform Server → Server Configuration Tool에서
    • Windows의 경우 시작 → 프로그램 → IBM MobileFirst Platform Server → Server Configuration Tool을 클릭하십시오.
    • macOS의 경우 쉘 콘솔을 여십시오. mfp_server_install_dir/shortcuts로 이동한 후 ./configuration-tool.sh를 입력하십시오.
    • mfp_server_install_dir 디렉토리는 사용자가 MobileFirst Server를 설치한 디렉토리입니다.
  2. 파일 → 새 구성을 선택하여 MobileFirst Server 구성을 작성하십시오.
    • 구성 세부사항 패널에서 런타임 컴포넌트 및 관리 서비스의 컨텍스트 루트를 입력하십시오. 환경 ID를 입력할 수 있습니다. 환경 ID는 고급 유스 케이스에서 사용됩니다(예: MobileFirst Server의 여러 설치가 동일한 애플리케이션 서버 또는 동일한 WebSphere Application Server 셀에서 작성되는 경우).
    • 콘솔 설정 패널에서 MobileFirst Operations Console 설치 여부를 선택하십시오. 이 콘솔이 설치되지 않은 경우에는 명령행 도구(mfpdev 또는 mfpadm) 또는 REST API를 사용하여 MobileFirst Server 관리 서비스와 상호작용해야 합니다.
    • 데이터베이스 선택 패널에서 사용하려는 데이터베이스 관리 시스템을 선택하십시오. 모든 컴포넌트는 동일한 데이터베이스 유형 및 동일한 데이터베이스 인스턴스를 사용합니다. 데이터베이스 분할창에 대한 자세한 정보는 Server Configuration Tool을 사용하여 데이터베이스 테이블 작성을 참조하십시오.
    • 애플리케이션 서버 선택 패널에서 MobileFirst Server를 배치할 애플리케이션 서버의 유형을 선택하십시오.
  3. 애플리케이션 서버 설정 패널에서 애플리케이션 서버를 선택하고 다음과 같은 단계를 수행하십시오.
    • WebSphere Application Server Liberty에 설치의 경우:
      • Liberty의 설치 디렉토리 및 MobileFirst Server를 설치할 서버의 이름을 입력하십시오.
      • 콘솔에 로그인할 기본 사용자를 작성할 수 있습니다. 이 사용자는 Liberty Basic 레지스트리에서 작성됩니다. 프로덕션 설치의 경우 기본 사용자 작성 옵션을 선택 취소하고 설치 후에 사용자 액세스를 구성할 수 있습니다. 자세한 정보는 MobileFirst Server 관리를 위한 사용자 인증 구성을 참조하십시오.
      • 배치 유형 독립형 배치(기본값), 서버 팜 배치 또는 Liberty Collective 배치를 선택하십시오.
      Liberty Collective 배치 옵션을 선택한 경우 다음과 같은 단계를 수행하십시오.
      • Liberty Collective 서버 지정:
        • 관리 서비스, MobileFirst Operations Console 및 라이브 업데이트 서비스가 설치되는 위치. 서버는 Liberty Collective 제어기여야 합니다.
        • 런타임이 설치되는 위치. 서버는 Liberty Collective 멤버여야 합니다.
        • 푸시 서비스가 설치되는 위치. 서버는 Liberty Collective 멤버여야 합니다.
      • 멤버의 서버 ID를 입력하십시오. 이 ID는 집합의 멤버마다 서로 달라야 합니다.
      • 집합 멤버의 클러스터 이름을 입력하십시오.
      • 제어기 호스트 이름 및 HTTPS 포트 번호를 입력하십시오. 값은 Liberty Collective 제어기의 server.xml 파일에 있는 variable 요소에 정의되어 있는 값과 동일해야 합니다.
      • 제어기 관리자 이름 및 비밀번호를 입력하십시오.
    • WebSphere Application Server 또는 WebSphere Application Server Network Deployment에 설치의 경우:
      • WebSphere Application Server의 설치 디렉토리를 입력하십시오.
      • MobileFirst Server를 설치할 WebSphere Application Server 프로파일을 선택하십시오. WebSphere Application Server Network Deployment에 설치하는 경우 배치 관리자의 프로파일을 선택하십시오. 배치 관리자 프로파일에서 범위(서버 또는 클러스터)를 선택할 수 있습니다. 클러스터를 선택하는 경우 클러스터를 지정해야 합니다.
        • 런타임이 설치되는 위치.
        • 관리 서비스, MobileFirst Operations Console 및 라이브 업데이트 서비스가 설치되는 위치.
        • 푸시 서비스가 설치되는 위치.
      • 관리자 로그인 ID 및 비밀번호를 입력하십시오. 관리자는 보안 역할을 가지고 있어야 합니다.
      • MobileFirst Operations Console에서 WebSphere 관리자를 관리자로 선언 옵션을 선택하는 경우 MobileFirst Server를 설치하는 데 사용되는 사용자가 콘솔의 관리 보안 역할에 맵핑되고 관리자 권한으로 콘솔에 로그인할 수 있습니다. 이 사용자는 라이브 업데이트 서비스의 보안 역할에도 맵핑됩니다. 사용자 이름 및 비밀번호는 관리 서비스의 JNDI 특성(mfp.config.service.usermfp.config.service.password)으로 설정됩니다.
      • MobileFirst Operations Console에서 WebSphere 관리자를 관리자로 선언 옵션을 선택하지 않는 경우에는 MobileFirst Server를 사용하려면 먼저 다음과 같은 태스크를 수행해야 합니다.
        • 다음을 수행하여 관리 서비스와 라이브 업데이트 서비스 간 통신을 사용으로 설정:
          • 사용자를 라이브 업데이트 서비스의 보안 역할 configadmin에 맵핑
          • 관리 서비스의 JNDI 특성(mfp.config.service.usermfp.config.service.password)에서 이 사용자의 로그인 ID 및 비밀번호 추가
          • 한 명 이상의 사용자를 관리 서비스 및 MobileFirst Operations Console의 보안 역할에 맵핑하십시오. MobileFirst Server 관리를 위한 사용자 인증 구성을 참조하십시오.
    • Apache Tomcat에 설치의 경우:
      • Apache Tomcat의 설치 디렉토리를 입력하십시오.
      • RMI와의 JMX 통신에 사용되는 포트를 입력하십시오. 기본적으로 값은 8686입니다. Server Configuration Tool은 tomcat_install_dir/bin/setenv.bat 또는 tomcat_install_dir/bin/setenv.sh 파일을 수정하여 이 포트를 엽니다. 이 포트를 수동으로 열려고 하거나 setenv.bat 또는 setenv.sh에서 이 포트를 여는 일부 코드가 이미 있는 경우에는 이 도구를 사용하지 마십시오. 대신 Ant 태스크를 설치하십시오. Ant 태스크를 사용한 설치에 대해 RMI 포트를 수동으로 여는 옵션이 제공됩니다.
      • 콘솔에 로그인할 기본 사용자를 작성하십시오. 이 사용자는 tomcat-users.xml 구성 파일에서도 작성됩니다. 프로덕션 설치의 경우 기본 사용자 작성 옵션을 선택 취소하고 설치 후에 사용자 액세스를 구성할 수 있습니다. 자세한 정보는 MobileFirst Server 관리를 위한 사용자 인증 구성을 참조하십시오.
  4. 애플리케이션 서버에서 푸시 서비스를 설치하려면 푸시 서비스 설정 패널에서 푸시 서비스 설치 옵션을 선택하십시오. 컨텍스트 루트는 imfpush입니다. 푸시 서비스와 관리 서비스 사이의 통신을 사용으로 설정하려면 다음과 같은 매개변수를 정의해야 합니다.
    • 푸시 서비스의 URL 및 런타임의 URL을 입력하십시오. Liberty, Apache Tomcat 또는 독립형 WebSphere Application Server에 설치하는 경우 이 URL은 자동으로 계산될 수 있습니다. 이 URL은 로컬 서버의 컴포넌트(런타임 또는 푸시 서비스) URL을 사용합니다. WebSphere Application Server Network Deployment에 설치하거나 통신이 웹 프록시 또는 로드 밸런서를 통해 수행되는 경우에는 수동으로 URL을 입력해야 합니다.
    • 서비스 간 OAuth 통신에 대한 기밀 클라이언트 ID 및 본인확인정보를 입력하십시오. 그렇지 않으면 도구가 기본값 및 랜덤 비밀번호를 생성합니다.
  5. MobileFirst Analytics가 설치된 경우 Analytics 설정 패널에서 Analytics Server에 대한 연결 사용을 선택하십시오. 다음과 같은 연결 설정을 입력하십시오.
    • Analytics Console의 URL
    • Analytics Server의 URL(Analytics 데이터 서비스)
    • Analytics Server에 데이터를 공개하도록 허용되는 사용자 로그인 ID 및 비밀번호
    도구가 Analytics Server에 데이터를 전송하도록 런타임 및 푸시 서비스를 구성합니다.
  6. 배치를 클릭하여 설치를 계속하십시오.

Apache Tomcat 또는 Liberty 프로파일의 경우 설치가 완료된 후 애플리케이션 서버를 다시 시작하십시오.

Apache Tomcat이 서비스로 실행되면 RMI를 여는 데 필요한 명령문이 포함된 setenv.bat 또는 setenv.sh 파일을 읽지 않습니다. 결과적으로 MobileFirst Server가 올바르게 작동할 수 없습니다. 필수 변수를 설정하려면 Apache Tomcat을 위한 JMX 연결 구성을 참조하십시오.

WebSphere Application Server Network Deployment의 경우 애플리케이션은 설치되지만 시작되지 않습니다. 애플리케이션을 수동으로 시작해야 합니다. WebSphere Application Server 관리 콘솔에서 이를 수행할 수 있습니다.

Server Configuration Tool에서 구성 파일을 보존하십시오. 임시 수정사항을 설치하기 위해 재사용할 수 있습니다. 임시 수정사항을 적용하는 메뉴는 구성 >배치된 WAR 파일 바꾸기입니다.

Server Configuration Tool을 사용하여 수정팩 적용

구성 도구를 사용하여 MobileFirst Server를 설치할 때 구성 파일이 보존되는 경우 구성 파일을 재사용하여 임시 수정사항 또는 수정팩을 적용할 수 있습니다.

  1. Server Configuration Tool을 시작하십시오.
    • Linux의 경우 애플리케이션 바로 가기 애플리케이션 → IBM MobileFirst Platform Server → Server Configuration Tool에서
    • Windows의 경우 시작 → 프로그램 → IBM MobileFirst Platform Server → Server Configuration Tool을 클릭하십시오.
    • macOS의 경우 쉘 콘솔을 여십시오. mfp_server_install_dir/shortcuts로 이동하여 ./configuration-tool.sh를 입력하십시오.
    • mfp_server_install_dir 디렉토리는 MobileFirst Server를 설치한 디렉토리입니다.
  2. 구성 → 배치된 WAR 파일 바꾸기를 클릭한 후 기존 구성을 선택하여 수정팩 또는 임시 수정사항을 적용하십시오.

Ant 태스크를 사용하여 설치

Ant 태스크를 사용하여 MobileFirst Server 컴포넌트를 애플리케이션 서버에 설치하십시오.

mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에서 MobileFirst Server 설치에 필요한 샘플 구성 파일을 찾을 수 있습니다.

또한 Server Configuration Tool을 사용하여 구성을 작성한 후 파일 → 구성을 Ant 파일로 내보내기…를 사용하여 Ant 파일을 내보낼 수 있습니다. 샘플 Ant 파일은 Server Configuration Tool과 동일한 제한사항을 가지고 있습니다.

  • 모든 컴포넌트(MobileFirst Operations Console, MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스, MobileFirst Server 아티팩트 및 MobileFirst 런타임)는 동일한 애플리케이션 서버에 있습니다. 하지만 WebSphere Application Server Network Deployment에서 클러스터에 설치할 때 관리 및 라이브 업데이트 서비스와 런타임에 대해 서로 다른 클러스터를 지정할 수 있습니다.
  • MobileFirst Server 푸시 서비스가 설치되는 경우 해당 서비스도 동일한 서버에 설치됩니다. 하지만 WebSphere Application Server Network Deployment에서 클러스터에 설치할 때 푸시 서비스에 대해 다른 클러스터를 지정할 수 있습니다.
  • 모든 컴포넌트는 동일한 데이터베이스 시스템 및 사용자를 사용합니다. 또한 DB2의 경우 모든 컴포넌트는 동일한 스키마를 사용합니다.
  • Server Configuration Tool은 단일 서버를 위한 컴포넌트를 설치합니다. 다중 서버에 설치하는 경우에는 도구가 실행된 후 팜이 구성되어야 합니다. WebSphere Application Server Network Deployment에서는 서버 팜 구성이 지원되지 않습니다.

Ant 태스크를 사용하여 서버 팜에서 실행되도록 MobileFirst Server 서비스를 구성할 수 있습니다. 서버를 팜에 포함하려면 애플리케이션 서버를 적절하게 구성하는 일부 특정 속성을 지정해야 합니다. Ant 태스크를 사용한 서버 팜 구성에 대한 자세한 정보는 Ant 태스크를 사용한 서버 팜 설치를 참조하십시오.

토폴로지 및 네트워크 플로우에서 지원되는 기타 토폴로지의 경우 샘플 Ant 파일을 수정할 수 있습니다.

Ant 태스크에 대한 참조는 다음과 같습니다.

샘플 구성 파일 및 태스크를 사용한 설치에 대한 개요는 명령행 모드에서 MobileFirst Server 설치를 참조하십시오.

제품 설치의 일부인 Ant 배포를 사용하여 Ant 파일을 실행할 수 있습니다. 예를 들어, WebSphere Application Server Network Deployment 클러스터를 가지고 있고 데이터베이스가 IBM DB2인 경우 mfp_install_dir/MobileFirstServer/configuration-samples/configure-wasnd-cluster-db2.xml Ant 파일을 사용할 수 있습니다. 파일을 편집하고 모든 필수 특성을 입력한 후 mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에서 다음과 같은 명령을 실행할 수 있습니다.

  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml help - 이 명령은 일부 컴포넌트를 설치, 설치 제거 또는 업데이트하는 데 필요한 Ant 파일의 모든 가능한 대상의 목록을 표시합니다.
  • mfp_install_dir/shortcuts/ant -f configure-wasnd-cluster-db2.xml install - 이 명령은 Ant 파일의 특성에서 입력한 매개변수를 사용하여 DB2를 데이터 소스로 하여 MobileFirst Server를 WebSphere Application Server Network Deployment 클러스터에 설치합니다.


설치 후 수정팩을 적용하는 데 재사용할 수 있도록 Ant 파일의 사본을 작성하십시오.

Ant 파일을 사용하여 수정팩 적용

샘플 Ant 파일로 업데이트

mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에 제공된 샘플 Ant 파일을 사용하여 MobileFirst Server를 설치하는 경우 이 Ant 파일의 사본을 재사용하여 수정팩을 적용할 수 있습니다. 비밀번호 값에 대해 Ant 파일이 실행될 때 대화식으로 프롬프트에 표시될 12개의 별표(*)를 실제 값 대신 입력할 수 있습니다.

  1. Ant 파일에서 mfp.server.install.dir 특성의 값을 확인하십시오. 이 값은 수정팩이 적용된 제품이 포함된 디렉토리를 가리켜야 합니다. 이 값은 업데이트된 MobileFirst Server WAR 파일을 가져오는 데 사용됩니다.
  2. mfp_install_dir/shortcuts/ant -f your_ant_file update 명령을 실행하십시오.

자체 Ant 파일로 업데이트

자체 Ant 파일을 사용하는 경우 각각의 설치 태스크(installmobilefirstadmin, installmobilefirstruntimeinstallmobilefirstpush)에 대해 Ant 파일에 동일한 매개변수를 가진 해당 업데이트 태스크가 있는지 확인하십시오. 해당 업데이트 태스크는 updatemobilefirstadmin, updatemobilefirstruntimeupdatemobilefirstpush입니다.

  1. mfp-ant-deployer.jar 파일에 대한 taskdef 요소의 클래스 경로를 확인하십시오. 이 경로는 수정팩이 적용되는 MobileFirst Server 설치의 mfp-ant-deployer.jar 파일을 가리켜야 합니다. 기본적으로 업데이트된 MobileFirst Server WAR 파일은 mfp-ant-deployer.jar의 위치에서 가져옵니다.
  2. Ant 파일의 업데이트 태스크(updatemobilefirstadmin, updatemobilefirstruntimeupdatemobilefirstpush)를 실행하십시오.

샘플 Ant 파일 수정

mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에 제공된 샘플 Ant 파일을 수정하여 설치 요구사항에 적응할 수 있습니다.
다음 절에서는 사용자의 요구에 맞게 설치하도록 샘플 Ant 파일을 수정하는 방법에 대한 세부사항을 제공합니다.

  1. 추가 JNDI 특성 지정
  2. 기존 사용자 지정
  3. Liberty Java EE 레벨 지정
  4. 데이터 소스 JDBC 특성 지정
  5. MobileFirst Server가 설치되지 않은 컴퓨터에서 Ant 파일 실행
  6. WebSphere Application Server Network Deployment 대상 지정
  7. Apache Tomcat에서 RMI 포트 수동 구성

추가 JNDI 특성 지정

installmobilefirstadmin, installmobilefirstruntimeinstallmobilefirstpush Ant 태스크는 컴포넌트가 작동하기 위해 필요한 JNDI 특성에 대한 값을 선언합니다. 이 JNDI 특성은 JMX 통신과 다른 컴포넌트(예: 라이브 업데이트 서비스, 푸시 서비스, 분석 서비스 또는 권한 부여 서버)에 대한 링크를 정의하는 데 사용됩니다. 하지만 기타 JNDI 특성에 대한 값도 정의할 수 있습니다. 이러한 세 태스크에 대해 존재하는 <property> 요소를 사용하십시오. JNDI 특성의 목록은 다음을 참조하십시오.

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

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

기존 사용자 지정

기본적으로 installmobilefirstadmin Ant 태스크는 사용자를 작성합니다.

  • WebSphere Application Server Liberty에서는 JMX 통신을 위한 Liberty 관리자를 정의하기 위해
  • 애플리케이션 서버에서는 라이브 업데이트 서비스와 통신하는 데 사용되는 사용자를 정의하기 위해

새 사용자를 작성하는 대신 기존 사용자를 사용하려면 다음과 같은 조작을 수행하십시오.

  1. <jmx> 요소에서 사용자 및 비밀번호를 지정하고 createLibertyAdmin 속성의 값을 false로 설정하십시오. 예를 들어, 다음과 같습니다.

    <installmobilefirstadmin ...>
        <jmx libertyAdminUser="myUser" libertyAdminPassword="password" createLibertyAdmin="false" />
        ...
    
  2. <configuration> 요소에서 사용자 및 비밀번호를 지정하고 createConfigAdminUser 속성의 값을 false로 설정하십시오. 예를 들어, 다음과 같습니다.

     <installmobilefirstadmin ...>
         <configuration configAdminUser="myUser" configAdminPassword="password" createConfigAdminUser="false" />
         ...
    

또한 샘플 Ant 파일에 의해 작성되는 사용자는 관리 서비스 및 콘솔의 보안 역할에 맵핑됩니다. 이 설정을 통해 설치 후 이 사용자를 사용하여 MobileFirst Server에 로그온할 수 있습니다. 이 동작을 변경하려면 샘플 Ant 파일에서 <user> 요소를 제거하십시오. 또는 <user> 요소에서 password 속성을 제거할 수 있으며 사용자는 애플리케이션 서버의 로컬 레지스트리에서 작성되지 않습니다.

Liberty Java EE 레벨 지정

WebSphere Application Server Liberty의 일부 배포판에서는 Java EE 6 또는 Java EE 7의 기능을 지원합니다. 기본적으로 Ant 태스크는 설치할 기능을 자동으로 발견합니다. 예를 들어, jdbc-4.0 Liberty 기능은 Java EE 6의 경우 설치되고 jdbc-4.1 기능은 Java EE 7의 경우 설치됩니다. Liberty 설치에서 Java EE 6와 Java EE 7 모두의 기능을 지원하는 경우에는 기능의 특정 레벨을 강제 실행할 수 있습니다. MobileFirst Server V8.0.0과 V7.1.0을 동일한 Liberty 서버에서 실행하려는 경우가 하나의 예입니다. MobileFirst Server V7.1.0 이하에서는 Java EE 6 기능만 지원합니다.

Java EE 6 기능의 특정 레벨을 강제 실행하려면 <websphereapplicationserver> 요소의 jeeversion 속성을 사용하십시오. 예를 들어, 다음과 같습니다.

<installmobilefirstadmin execute="${mfp.process.admin}" contextroot="${mfp.admin.contextroot}">
    [...]
    <applicationserver>
      <websphereapplicationserver installdir="${appserver.was.installdir}"
        profile="Liberty" jeeversion="6">

데이터 소스 JDBC 특성 지정

JDBC 연결에 대한 특성을 지정할 수 있습니다. <database> 요소의 <property> 요소를 사용하십시오. 이 요소는 configureDatabase, installmobilefirstadmin, installmobilefirstruntimeinstallmobilefirstpush Ant 태스크에서 사용할 수 있습니다. 예를 들어, 다음과 같습니다.

<configuredatabase kind="MobileFirstAdmin">
    <db2 database="${database.db2.mfpadmin.dbname}"
        server="${database.db2.host}"
        instance="${database.db2.instance}"
        user="${database.db2.mfpadmin.username}"
        port= "${database.db2.port}"
        schema = "${database.db2.mfpadmin.schema}"
        password="${database.db2.mfpadmin.password}">

       <property name="commandTimeout" value="10"/>
    </db2>

MobileFirst Server가 설치되지 않은 컴퓨터에서 Ant 파일 실행

MobileFirst Server가 설치되지 않은 컴퓨터에서 Ant 태스크를 실행하려면 다음과 같은 항목이 필요합니다.

  • Ant 설치
  • 원격 컴퓨터에 대한 mfp-ant-deployer.jar 파일의 사본. 이 라이브러리에는 Ant 태스크의 정의가 포함되어 있습니다.
  • 설치될 리소스 지정. 기본적으로 WAR 파일은 mfp-ant-deployer.jar 근처에서 가져오지만 이 WAR 파일의 위치를 지정할 수 있습니다. 예를 들어, 다음과 같습니다.
<installmobilefirstadmin execute="true" contextroot="/mfpadmin" serviceWAR="/usr/mfp/mfp-admin-service.war">
  <console install="true" warFile="/usr/mfp/mfp-admin-ui.war"/>

자세한 정보는 설치 참조서에서 각 MobileFirst Server 컴포넌트를 설치하는 데 필요한 Ant 태스크를 참조하십시오.

WebSphere Application Server Network Deployment 대상 지정

WebSphere Application Server Network Deployment에 설치하려면 지정된 WebSphere Application Server 프로파일이 배치 관리자여야 합니다. 다음과 같은 구성에 배치할 수 있습니다.

  • 클러스터
  • 단일 서버
  • 셀(셀의 모든 서버)
  • 노드(노드의 모든 서버)

configure-wasnd-cluster-dbms-name.xml, configure-wasnd-server-dbms-name.xmlconfigure-wasnd-node-dbms-name.xml 등의 샘플 파일에는 각 유형의 대상에 배치할 선언이 포함되어 있습니다. 자세한 정보는 설치 참조서에 있는 각 MobileFirst Server 컴포넌트를 설치하는 데 필요한 Ant 태스크를 참조하십시오.

참고: V8.0.0부터 WebSphere Application Server Network Deployment 셀에 대한 샘플 구성 파일은 제공되지 않습니다.

Apache Tomcat에서 RMI 포트 수동 구성

기본적으로 Ant 태스크는 setenv.bat 파일 또는 setenv.sh 파일을 수정하여 RMI 포트를 엽니다. RMI 포트를 수동으로 여는 것을 선호하는 경우에는 값이 false인 tomcatSetEnvConfig 속성을 installmobilefirstadmin, updatemobilefirstadminuninstallmobilefirstadmin 태스크의 <jmx> 요소에 추가하십시오.

MobileFirst Server 컴포넌트 수동 설치

수동으로 MobileFirst Server 컴포넌트를 애플리케이션 서버에 설치할 수도 있습니다.
다음 주제에서는 프로덕션에서 지원되는 애플리케이션에 컴포넌트를 설치하는 프로세스에 대해 안내하는 완전한 정보를 제공합니다.

WebSphere Application Server Liberty에 수동 설치

WebSphere Application Server Liberty 전제조건에 설명된 대로 요구사항을 이행했는지도 확인하십시오.

토폴로지 제한조건

MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임은 동일한 애플리케이션 서버에 설치되어야 합니다. 라이브 업데이트 서비스의 컨텍스트 루트는 the-adminContextRootconfig로 정의되어야 합니다. 푸시 서비스의 컨텍스트 루트는 imfpush여야 합니다. 제한조건에 대한 자세한 정보는 MobileFirst Server 컴포넌트 및 MobileFirst Analytics에 대한 제한조건을 참조하십시오.

애플리케이션 서버 설정

서블릿을 즉시 로드하도록 webContainer 요소를 구성해야 합니다. 이 설정은 JMX를 통한 초기화의 경우 필수입니다. 예를 들어, <webContainer deferServletLoad="false"/>입니다.

선택적으로 일부 Liberty 버전에서 관리 서비스 및 런타임의 시작 시퀀스를 중단하는 제한시간 초과 문제를 방지하려면 기본 executor 요소를 변경하십시오. 큰 값을 coreThreadsmaxThreads 속성으로 설정하십시오. 예를 들어, 다음과 같습니다.

<executor id="default" name="LargeThreadPool"
  coreThreads="200" maxThreads="400" keepAlive="60s"
  stealPolicy="STRICT" rejectedWorkPolicy="CALLER_RUNS"/>

또한 tcpOptions 요소를 구성하고 soReuseAddr 속성을 true로 설정할 수 있습니다(<tcpOptions soReuseAddr="true"/>).

MobileFirst Server 애플리케이션에 필요한 Liberty 기능

Java EE 6 또는 Java EE 7의 경우 다음과 같은 기능을 사용할 수 있습니다.

MobileFirst Server 관리 서비스

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • appSecurity-2.0
  • restConnector-1.0
  • usr:MFPDecoderFeature-1.0

MobileFirst Server 푸시 서비스

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • servlet-3.0(Java EE 7의 경우 servlet-3.1)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

MobileFirst 런타임

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • servlet-3.0(Java EE 7의 경우 servlet-3.1)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

글로벌 JNDI 항목

런타임과 관리 서비스 사이의 JMX 통신을 구성하려면 다음과 같은 글로벌 JNDI 항목이 필요합니다.

  • mfp.admin.jmx.host
  • mfp.admin.jmx.port
  • mfp.admin.jmx.user
  • mfp.admin.jmx.pwd
  • mfp.topology.platform
  • mfp.topology.clustermode

이 글로벌 JNDI 항목은 이 구문을 사용하여 설정되며 컨텍스트 루트가 접두부로 사용되지 않습니다. 예를 들어, <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>입니다.

참고: 075가 61로 변환되거나 31.500이 31.5로 변환되지 않도록 JNDI 값의 자동 변환에 대해 보호하려면 값을 정의할 때 이 구문 ‘“075”‘를 사용하십시오.

관리 서비스의 JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

팜 구성의 경우 다음과 같은 주제도 참조하십시오.

클래스 로더

모든 애플리케이션에 대해 클래스 로더에 상위 마지막 위임이 있어야 합니다. 예를 들어, 다음과 같습니다.

<application id="mfpadmin" name="mfpadmin" location="mfp-admin-service.war" type="war">
  [...]
  <classloader delegation="parentLast">
  </classloader>
</application>

비밀번호 디코더 사용자 기능

비밀번호 디코더 사용자 기능을 Liberty 프로파일에 복사하십시오. 예를 들어, 다음과 같습니다.

  • UNIX 및 Linux 시스템의 경우:

    mkdir -p LIBERTY_HOME/wlp/usr/extension/lib/features
    cp product_install_dir/features/com.ibm.websphere.crypto_1.0.0.jar LIBERTY_HOME/wlp/usr/extension/lib/
    cp product_install_dir/features/MFPDecoderFeature-1.0.mf LIBERTY_HOME/wlp/usr/extension/lib/features/
    
  • Windows 시스템의 경우:

    mkdir LIBERTY_HOME\wlp\usr\extension\lib
    copy /B product_install_dir\features\com.ibm.websphere.crypto_1.0.0.jar
    LIBERTY_HOME\wlp\usr\extension\lib\com.ibm.websphere.crypto_1.0.0.jar
    mkdir LIBERTY_HOME\wlp\usr\extension\lib\features
    copy /B product_install_dir\features\MFPDecoderFeature-1.0.mf
    LIBERTY_HOME\wlp\usr\extension\lib\features\MFPDecoderFeature-1.0.mf
    

구성 세부사항

관리 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 관리 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-service.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpadmin입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 관리 서비스의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.admin.push.url을 선언하여 관리 서비스가 /mfpadmin을 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

푸시 서비스가 설치되면 다음과 같은 JNDI 특성을 구성해야 합니다.

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

구성 서비스와의 통신을 위한 JNDI 특성은 다음과 같습니다.

  • mfp.config.service.user
  • mfp.config.service.password

JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

데이터 소스

관리 서비스에 대한 데이터 소스의 JNDI 이름은 jndiName=the-contextRoot/jdbc/mfpAdminDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mfpadmin을 사용하여 관리 서비스가 설치되고 이 서비스가 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

애플리케이션의 application-bnd 요소에서 다음과 같은 역할을 선언하십시오.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

라이브 업데이트 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

라이브 업데이트 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-live-update.war에 있습니다. 라이브 업데이트 서비스의 컨텍스트 루트는 다음과 같은 방식으로 정의되어야 합니다. /the-adminContextRootconfig. 예를 들어, 관리 서비스의 컨텍스트 루트가 /mfpadmin인 경우 라이브 업데이트 서비스의 컨텍스트 루트는 /mfpadminconfig여야 합니다.

데이터 소스

라이브 업데이트 서비스에 대한 데이터 소스의 JNDI 이름은 the-contextRoot/jdbc/ConfigDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mfpadminconfig를 사용하여 라이브 업데이트 서비스가 설치되고 이 서비스가 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

애플리케이션의 application-bnd 요소에서 configadmin 역할을 선언하십시오. 한 명 이상의 사용자가 이 역할에 맵핑되어야 합니다. 관리 서비스의 다음과 같은 JNDI 특성에 사용자 및 해당 비밀번호가 제공되어야 합니다.

  • mfp.config.service.user
  • mfp.config.service.password

콘솔은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

콘솔 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpconsole입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 콘솔의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.admin.endpoint를 선언하여 콘솔이 /mfpconsole을 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint 특성의 일반적인 값은 *://*:*/the-adminContextRoot입니다.
JNDI 특성에 대한 자세한 정보는 MobileFirst Operations Console의 JNDI 특성을 참조하십시오.

보안 역할

애플리케이션의 application-bnd 요소에서 다음과 같은 역할을 선언하십시오.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
콘솔의 보안 역할에 맵핑되는 사용자는 관리 서비스의 동일한 보안 역할에도 맵핑되어야 합니다.

런타임은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

런타임 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-server.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 기본적으로는 /mfp입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 런타임의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.analytics.url을 선언하여 런타임이 /mobilefirst를 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

mobilefirst/mfp.authorization.server 특성을 정의해야 합니다. 예를 들어, 다음과 같습니다.

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

MobileFirst Analytics가 설치된 경우 다음과 같은 JNDI 특성을 정의해야 합니다.

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

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

데이터 소스

런타임에 대한 데이터 소스의 JNDI 이름은 jndiName=the-contextRoot/jdbc/mfpDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mobilefirst를 사용하여 런타임이 설치되고 이 런타임이 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

푸시 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

푸시 서비스 WAR 파일은 mfp_install_dir/PushService/mfp-push-service.war에 있습니다. 컨텍스트 루트를 /imfpush로 정의해야 합니다. 그렇지 않으면 컨텍스트 루트가 SDK에서 하드코딩되므로 클라이언트 디바이스가 여기에 연결될 수 없습니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 푸시 서비스의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.push.analytics.user를 선언하여 푸시 서비스가 /imfpush를 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>
다음과 같은 특성을 정의해야 합니다.
  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - 값은 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin이어야 합니다.
  • mfp.push.db.type - 관계형 데이터베이스의 경우 값은 DB여야 합니다.
MobileFirst Analytics가 구성된 경우 다음과 같은 JNDI 특성을 정의하십시오.
  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - 값은 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin이어야 합니다.
JNDI 특성에 대한 자세한 정보는 MobileFirst Server 푸시 서비스의 JNDI 특성 목록을 참조하십시오.

아티팩트 컴포넌트는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

이 컴포넌트에 대한 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war에 있습니다. 컨텍스트 루트를 /mfp-dev-artifacts로 정의해야 합니다.

WebSphere Application Server Liberty Collective에 수동 설치

WebSphere Application Server Liberty 전제조건에 설명된 대로 요구사항을 이행했는지도 확인하십시오.

토폴로지 제한조건

MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst Operations Console은 Liberty Collective 제어기에서 설치해야 합니다. MobileFirst 런타임 및 MobileFirst Server 푸시 서비스는 Liberty Collective 클러스터의 모든 멤버에서 설치해야 합니다.

라이브 업데이트 서비스의 컨텍스트 루트는 the-adminContextRootconfig로 정의되어야 합니다. 푸시 서비스의 컨텍스트 루트는 imfpush여야 합니다. 제한조건에 대한 자세한 정보는 MobileFirst Server 컴포넌트 및 MobileFirst Analytics에 대한 제한조건을 참조하십시오.

애플리케이션 서버 설정

서블릿을 즉시 로드하도록 webContainer 요소를 구성해야 합니다. 이 설정은 JMX를 통한 초기화의 경우 필수입니다. 예를 들어, <webContainer deferServletLoad="false"/>입니다.

선택적으로 일부 Liberty 버전에서 관리 서비스 및 런타임의 시작 시퀀스를 중단하는 제한시간 초과 문제를 방지하려면 기본 executor 요소를 변경하십시오. 큰 값을 coreThreadsmaxThreads 속성으로 설정하십시오. 예를 들어, 다음과 같습니다.

<executor id="default" name="LargeThreadPool"
  coreThreads="200" maxThreads="400" keepAlive="60s"
  stealPolicy="STRICT" rejectedWorkPolicy="CALLER_RUNS"/>

또한 tcpOptions 요소를 구성하고 soReuseAddr 속성을 true로 설정할 수 있습니다(<tcpOptions soReuseAddr="true"/>).

MobileFirst Server 애플리케이션에 필요한 Liberty 기능

Java EE 6 또는 Java EE 7의 경우 다음과 같은 기능을 추가해야 합니다.

MobileFirst Server 관리 서비스

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • appSecurity-2.0
  • restConnector-1.0
  • usr:MFPDecoderFeature-1.0

MobileFirst Server 푸시 서비스

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • servlet-3.0(Java EE 7의 경우 servlet-3.1)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

MobileFirst 런타임

  • jdbc-4.0(Java EE 7의 경우 jdbc-4.1)
  • servlet-3.0(Java EE 7의 경우 servlet-3.1)
  • ssl-1.0
  • usr:MFPDecoderFeature-1.0

글로벌 JNDI 항목

런타임과 관리 서비스 사이의 JMX 통신을 구성하려면 다음과 같은 글로벌 JNDI 항목이 필요합니다.

  • mfp.admin.jmx.host
  • mfp.admin.jmx.port
  • mfp.admin.jmx.user
  • mfp.admin.jmx.pwd
  • mfp.topology.platform
  • mfp.topology.clustermode
  • mfp.admin.serverid

이 글로벌 JNDI 항목은 이 구문을 사용하여 설정되며 컨텍스트 루트가 접두부로 사용되지 않습니다. 예를 들어, <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>입니다.

참고: 075가 61로 변환되거나 31.500이 31.5로 변환되지 않도록 JNDI 값의 자동 변환에 대해 보호하려면 값을 정의할 때 이 구문 ‘“075”‘를 사용하십시오.

클래스 로더

모든 애플리케이션에 대해 클래스 로더에 상위 마지막 위임이 있어야 합니다. 예를 들어, 다음과 같습니다.

<application id="mfpadmin" name="mfpadmin" location="mfp-admin-service.war" type="war">
  [...]
  <classloader delegation="parentLast">
  </classloader>
</application>

비밀번호 디코더 사용자 기능

비밀번호 디코더 사용자 기능을 Liberty 프로파일에 복사하십시오. 예를 들어, 다음과 같습니다.

  • UNIX 및 Linux 시스템의 경우:

    mkdir -p LIBERTY_HOME/wlp/usr/extension/lib/features
    cp product_install_dir/features/com.ibm.websphere.crypto_1.0.0.jar LIBERTY_HOME/wlp/usr/extension/lib/
    cp product_install_dir/features/MFPDecoderFeature-1.0.mf LIBERTY_HOME/wlp/usr/extension/lib/features/
    
  • Windows 시스템의 경우:

    mkdir LIBERTY_HOME\wlp\usr\extension\lib
    copy /B product_install_dir\features\com.ibm.websphere.crypto_1.0.0.jar
    LIBERTY_HOME\wlp\usr\extension\lib\com.ibm.websphere.crypto_1.0.0.jar
    mkdir LIBERTY_HOME\wlp\usr\extension\lib\features
    copy /B product_install_dir\features\MFPDecoderFeature-1.0.mf
    LIBERTY_HOME\wlp\usr\extension\lib\features\MFPDecoderFeature-1.0.mf
    

    구성 세부사항

관리 서비스는 사용자가 Liberty Collective 제어기에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. Liberty Collective 제어기의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server Liberty Collective에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

관리 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-service-collective.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpadmin입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 관리 서비스의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.admin.push.url을 선언하여 관리 서비스가 /mfpadmin을 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mfpadmin/mfp.admin.push.url" value="http://localhost:9080/imfpush"/>

푸시 서비스가 설치되면 다음과 같은 JNDI 특성을 구성해야 합니다.

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

구성 서비스와의 통신을 위한 JNDI 특성은 다음과 같습니다.

  • mfp.config.service.user
  • mfp.config.service.password

JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

데이터 소스

관리 서비스에 대한 데이터 소스의 JNDI 이름은 jndiName=the-contextRoot/jdbc/mfpAdminDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mfpadmin을 사용하여 관리 서비스가 설치되고 이 서비스가 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mfpadmin/jdbc/mfpAdminDS" transactional="false">
  [...]
</dataSource>

보안 역할

애플리케이션의 application-bnd 요소에서 다음과 같은 역할을 선언하십시오.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

라이브 업데이트 서비스는 사용자가 Liberty Collective 제어기에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. Liberty Collective 제어기의 server.xml 파일에서 이 애플리케이션의 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server Liberty Collective에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

라이브 업데이트 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-live-update.war에 있습니다. 라이브 업데이트 서비스의 컨텍스트 루트는 다음과 같은 방식으로 정의되어야 합니다. /the-adminContextRootconfig. 예를 들어, 관리 서비스의 컨텍스트 루트가 /mfpadmin인 경우 라이브 업데이트 서비스의 컨텍스트 루트는 /mfpadminconfig여야 합니다.

데이터 소스

라이브 업데이트 서비스에 대한 데이터 소스의 JNDI 이름은 the-contextRoot/jdbc/ConfigDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mfpadminconfig를 사용하여 라이브 업데이트 서비스가 설치되고 이 서비스가 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mfpadminconfig/jdbc/ConfigDS" transactional="false">
  [...]
</dataSource>

보안 역할

애플리케이션의 application-bnd 요소에서 configadmin 역할을 선언하십시오. 한 명 이상의 사용자가 이 역할에 맵핑되어야 합니다. 관리 서비스의 다음과 같은 JNDI 특성에 사용자 및 해당 비밀번호가 제공되어야 합니다.

  • mfp.config.service.user
  • mfp.config.service.password

콘솔은 사용자가 Liberty Collective 제어기에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. Liberty Collective 제어기의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

콘솔 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpconsole입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 콘솔의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.admin.endpoint를 선언하여 콘솔이 /mfpconsole을 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mfpconsole/mfp.admin.endpoint" value="*://*:*/mfpadmin"/>

mfp.admin.endpoint 특성의 일반적인 값은 *://*:*/the-adminContextRoot입니다.
JNDI 특성에 대한 자세한 정보는 MobileFirst Operations Console의 JNDI 특성을 참조하십시오.

보안 역할

애플리케이션의 application-bnd 요소에서 다음과 같은 역할을 선언하십시오.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
콘솔의 보안 역할에 맵핑되는 사용자는 관리 서비스의 동일한 보안 역할에도 맵핑되어야 합니다.

런타임은 사용자가 Liberty Collective 클러스터 멤버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 모든 Liberty Collective 클러스터 멤버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server Liberty Collective에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

런타임 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-server.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 기본적으로는 /mfp입니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 런타임의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.analytics.url을 선언하여 런타임이 /mobilefirst를 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="mobilefirst/mfp.analytics.url" value="http://localhost:9080/analytics-service/rest"/>

mobilefirst/mfp.authorization.server 특성을 정의해야 합니다. 예를 들어, 다음과 같습니다.

<jndiEntry jndiName="mobilefirst/mfp.authorization.server" value="embedded"/>

MobileFirst Analytics가 설치된 경우 다음과 같은 JNDI 특성을 정의해야 합니다.

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

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

데이터 소스

런타임에 대한 데이터 소스의 JNDI 이름은 jndiName=the-contextRoot/jdbc/mfpDS로 정의되어야 합니다. 다음 예에서는 컨텍스트 루트 /mobilefirst를 사용하여 런타임이 설치되고 이 런타임이 관계형 데이터베이스를 사용하는 경우를 보여줍니다.

<dataSource jndiName="mobilefirst/jdbc/mfpDS" transactional="false">
  [...]
</dataSource>

푸시 서비스는 사용자가 Liberty Collective 클러스터 멤버 또는 Liberty 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. Liberty 서버에서 푸시 서비스를 설치하는 경우에는 WebSphere Application Server Liberty에 수동 설치 아래의 MobileFirst Server 푸시 서비스 구성 세부사항을 참조하십시오.

MobileFirst Server 푸시 서비스가 Liberty Collective에서 설치되는 경우 이는 런타임의 경우와 동일한 클러스터 또는 다른 클러스터에서 설치될 수 있습니다.

모든 Liberty Collective 클러스터 멤버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty Collective에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

푸시 서비스 WAR 파일은 mfp_install_dir/PushService/mfp-push-service.war에 있습니다. 컨텍스트 루트를 /imfpush로 정의해야 합니다. 그렇지 않으면 컨텍스트 루트가 SDK에서 하드코딩되므로 클라이언트 디바이스가 여기에 연결될 수 없습니다.

필수 JNDI 특성

JNDI 특성을 정의할 때 푸시 서비스의 컨텍스트 루트가 JNDI 이름의 접두부가 되어야 합니다. 다음 예에서는 mfp.push.analytics.user를 선언하여 푸시 서비스가 /imfpush를 컨텍스트 루트로 사용하여 설치되는 경우를 보여줍니다.

<jndiEntry jndiName="imfpush/mfp.push.analytics.user" value="admin"/>
다음과 같은 특성을 정의해야 합니다.
  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - 값은 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin이어야 합니다.
  • mfp.push.db.type - 관계형 데이터베이스의 경우 값은 DB여야 합니다.
MobileFirst Analytics가 구성된 경우 다음과 같은 JNDI 특성을 정의하십시오.
  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - 값은 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin이어야 합니다.
JNDI 특성에 대한 자세한 정보는 MobileFirst Server 푸시 서비스의 JNDI 특성 목록을 참조하십시오.

아티팩트 컴포넌트는 사용자가 Liberty Collective 제어기에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. Liberty Collective 제어기의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server Liberty에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

이 컴포넌트에 대한 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war에 있습니다. 컨텍스트 루트를 /mfp-dev-artifacts로 정의해야 합니다.

Apache Tomcat에 수동 설치

Apache Tomcat 전제조건에 설명된 대로 요구사항을 이행했는지 확인하십시오.

토폴로지 제한조건

MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임은 동일한 애플리케이션 서버에 설치되어야 합니다. 라이브 업데이트 서비스의 컨텍스트 루트는 the-adminContextRootconfig로 정의되어야 합니다. 푸시 서비스의 컨텍스트 루트는 imfpush여야 합니다. 제한조건에 대한 자세한 정보는 MobileFirst Server 컴포넌트 및 MobileFirst Analytics에 대한 제한조건을 참조하십시오.

애플리케이션 서버 설정

싱글 사인온 밸브를 활성화해야 합니다. 예를 들어, 다음과 같습니다.

<Valve className="org.apache.catalina.authenticator.SingleSignOn"/>

사용자가 tomcat-users.xml에서 정의된 경우 선택적으로 메모리 영역을 활성화할 수 있습니다. 예를 들어, 다음과 같습니다.

<Realm className="org.apache.catalina.realm.MemoryRealm"/>

구성 세부사항

관리 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

관리 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-service.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpadmin입니다.

필수 JNDI 특성

JNDI 특성은 애플리케이션 컨텍스트의 Environment 요소에서 정의됩니다. 예를 들어, 다음과 같습니다.

<Environment name="mfp.admin.push.url" value="http://localhost:8080/imfpush" type="java.lang.String" override="false"/>

런타임과의 JMX 통신을 사용하려면 다음과 같은 JNDI 특성을 정의하십시오.

  • mfp.topology.platform
  • mfp.topology.clustermode

푸시 서비스가 설치되면 다음과 같은 JNDI 특성을 구성해야 합니다.

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

구성 서비스와의 통신을 위한 JNDI 특성은 다음과 같습니다.

  • mfp.config.service.user
  • mfp.config.service.password

JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

데이터 소스

데이터 소스(jdbc/mfpAdminDS)는 **Context** 요소에서 리소스로 선언됩니다. 예를 들어, 다음과 같습니다.

<Resource name="jdbc/mfpAdminDS" type="javax.sql.DataSource" .../>

보안 역할

관리 서비스 애플리케이션에 사용 가능한 보안 역할은 다음과 같습니다.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

라이브 업데이트 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

라이브 업데이트 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-live-update.war에 있습니다. 라이브 업데이트 서비스의 컨텍스트 루트는 다음과 같은 방식으로 정의되어야 합니다. /the-adminContextRoot/config. 예를 들어, 관리 서비스의 컨텍스트 루트가 /mfpadmin인 경우 라이브 업데이트 서비스의 컨텍스트 루트는 /mfpadminconfig여야 합니다.

데이터 소스

라이브 업데이트 서비스에 대한 데이터 소스의 JNDI 이름은 jdbc/ConfigDS로 정의되어야 합니다. Context 요소에서 리소스로 선언하십시오.

보안 역할

라이브 업데이트 서비스 애플리케이션에 사용 가능한 보안 역할은 configadmin입니다.

한 명 이상의 사용자가 이 역할에 맵핑되어야 합니다. 관리 서비스의 다음과 같은 JNDI 특성에 사용자 및 해당 비밀번호가 제공되어야 합니다.

  • mfp.config.service.user
  • mfp.config.service.password

콘솔은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

콘솔 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpconsole입니다.

필수 JNDI 특성

mfp.admin.endpoint 특성을 정의해야 합니다. 이 특성의 일반적인 값은 *://*:*/the-adminContextRoot입니다.

JNDI 특성에 대한 자세한 정보는 MobileFirst Operations Console의 JNDI 특성을 참조하십시오.

보안 역할

애플리케이션에 사용 가능한 보안 역할은 다음과 같습니다.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

런타임은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

런타임 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-server.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 기본적으로는 /mfp입니다.

필수 JNDI 특성

mfp.authorization.server 특성을 정의해야 합니다. 예를 들어, 다음과 같습니다.

<Environment name="mfp.authorization.server" value="embedded" type="java.lang.String" override="false"/>

관리 서비스와의 JMX 통신을 사용하려면 다음과 같은 JNDI 특성을 정의하십시오.

  • mfp.topology.platform
  • mfp.topology.clustermode

MobileFirst Analytics가 설치된 경우 다음과 같은 JNDI 특성을 정의해야 합니다.

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

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

데이터 소스

런타임에 대한 데이터 소스의 JNDI 이름은 jdbc/mfpDS로 정의되어야 합니다. Context 요소에서 리소스로 선언하십시오.

푸시 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

푸시 서비스 WAR 파일은 mfp_install_dir/PushService/mfp-push-service.war에 있습니다. 컨텍스트 루트를 /imfpush로 정의해야 합니다. 그렇지 않으면 컨텍스트 루트가 SDK에서 하드코딩되므로 클라이언트 디바이스가 여기에 연결될 수 없습니다.

필수 JNDI 특성

다음과 같은 특성을 정의해야 합니다.

  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - 값은 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin이어야 합니다.
  • mfp.push.db.type - 관계형 데이터베이스의 경우 값은 DB여야 합니다.

MobileFirst Analytics가 구성된 경우 다음과 같은 JNDI 특성을 정의하십시오.

  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - 값은 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin이어야 합니다.
JNDI 특성에 대한 자세한 정보는 MobileFirst Server 푸시 서비스의 JNDI 특성 목록을 참조하십시오.

아티팩트 컴포넌트는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 Apache Tomcat에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

이 컴포넌트에 대한 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war에 있습니다. 컨텍스트 루트를 /mfp-dev-artifacts로 정의해야 합니다.

WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치

WebSphere Application Server 및 WebSphere Application Server Network Deployment 전제조건에 설명된 대로 요구사항을 이행했는지 확인하십시오.

토폴로지 제한조건

독립형 WebSphere Application Server의 경우
MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임은 동일한 애플리케이션 서버에 설치되어야 합니다. 라이브 업데이트 서비스의 컨텍스트 루트는 the-adminContextRootConfig로 정의되어야 합니다. 푸시 서비스의 컨텍스트 루트는 imfpush여야 합니다. 제한조건에 대한 자세한 정보는 MobileFirst Server 컴포넌트 및 MobileFirst Analytics에 대한 제한조건을 참조하십시오.

WebSphere Application Server Network Deployment의 경우
MobileFirst Server가 실행 중인 동안 배치 관리자가 실행 중이어야 합니다. 배치 관리자는 런타임과 관리 서비스 사이의 JMX 통신에 사용됩니다. 관리 서비스 및 라이브 업데이트 서비스는 동일한 애플리케이션 서버에 설치되어야 합니다. 런타임은 관리 서비스와 다른 서버에 설치될 수 있지만 동일한 셀에 있어야 합니다.

애플리케이션 서버 설정

관리 보안 및 애플리케이션 보안이 사용 가능해야 합니다. WebSphere Application Server 관리 콘솔에서 애플리케이션 보안을 사용으로 설정할 수 있습니다.

  1. WebSphere Application Server 관리 콘솔에 로그인하십시오.
  2. 보안 → 글로벌 보안을 클릭하십시오. 관리 보안 사용이 선택되어 있는지 확인하십시오.
  3. 또한 애플리케이션 보안 사용이 선택되어 있는지 확인하십시오. 애플리케이션 보안은 관리 보안이 사용으로 설정된 경우에만 사용으로 설정할 수 있습니다.
  4. 확인을 클릭하십시오.
  5. 변경사항을 저장하십시오.

자세한 정보는 WebSphere Application Server 문서에서 보안 사용을 참조하십시오.

서버 클래스 로더 정책은 상위 마지막 위임을 지원해야 합니다. MobileFirst Server WAR 파일은 상위 마지막 클래스 로더 모드로 설치되어야 합니다. 클래스 로더 정책을 검토하십시오.

  1. WebSphere Application Server 관리 콘솔에 로그인하십시오.
  2. 서버 → 서버 유형 → WebSphere Application Server를 클릭한 후 Mobile Foundation에 사용되는 서버를 클릭하십시오.
  3. 클래스 로더 정책이 다중으로 설정된 경우에는 아무것도 수행하지 마십시오.
  4. 클래스 로더 정책이 단일로 설정되고 클래스 로드 모드가 로컬 클래스 로더로 로드된 클래스 먼저(상위 마지막)로 설정된 경우에는 아무것도 수행하지 마십시오.
  5. 클래스 로더 정책이 단일로 설정되고 클래스 로드 모드가 상위 클래스 로더로 로드된 클래스 먼저(상위 먼저)로 설정된 경우에는 클래스 로더 정책을 다중으로 변경하십시오. 또한 MobileFirst Server 애플리케이션 이외의 모든 애플리케이션의 클래스 로더 순서를 상위 클래스 로더로 로드된 클래스 먼저(상위 먼저)로 설정하십시오.

클래스 로더

모든 MobileFirst Server 애플리케이션에 대해 클래스 로더에 상위 마지막 위임이 있어야 합니다.

애플리케이션이 설치된 후 클래스 로더 위임을 상위 마지막으로 설정하려면 다음의 단계를 수행하십시오.

  1. 애플리케이션 관리 링크를 클릭하거나 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션을 클릭하십시오.
  2. MobileFirst Server 애플리케이션을 클릭하십시오. 기본적으로 애플리케이션의 이름은 WAR 파일의 이름입니다.
  3. 세부사항 특성 섹션에서 클래스 로드 및 업데이트 발견 링크를 클릭하십시오.
  4. 클래스 로더 순서 분할창에서 로컬 클래스 로더로 로드된 클래스(상위 마지막) 옵션을 선택하십시오.
  5. 확인을 클릭하십시오.
  6. 모듈 섹션에서 모듈 관리 링크를 클릭하십시오.
  7. 모듈을 클릭하십시오.
  8. 클래스 로더 순서 필드에 대해 로컬 클래스 로더로 로드된 클래스(상위 마지막) 옵션을 선택하십시오.
  9. 확인을 두 번 클릭하여 선택사항을 확인하고 애플리케이션의 구성 패널로 돌아가십시오.
  10. 저장을 클릭하여 변경사항을 지속시키십시오.

구성 세부사항

관리 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

관리 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-service.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpadmin입니다.

필수 JNDI 특성

WebSphere Application Server 관리 콘솔을 사용하여 JNDI 특성을 설정할 수 있습니다. 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션 → application_name → 웹 모듈용 환경 항목으로 이동하여 항목을 설정하십시오.

런타임과의 JMX 통신을 사용하려면 다음과 같은 JNDI 특성을 정의하십시오.

WebSphere Application Server Network Deployment의 경우
  • mfp.admin.jmx.dmgr.host
  • mfp.admin.jmx.dmgr.port - 배치 관리자의 SOAP 포트입니다.
  • mfp.topology.platform - 값을 WAS로 설정하십시오.
  • mfp.topology.clustermode - 값을 Cluster로 설정하십시오.
  • mfp.admin.jmx.connector - 값을 SOAP로 설정하십시오.
독립형 WebSphere Application Server의 경우
  • mfp.topology.platform - 값을 WAS로 설정하십시오.
  • mfp.topology.clustermode - 값을 Standalone으로 설정하십시오.
  • mfp.admin.jmx.connector - 값을 SOAP로 설정하십시오.

푸시 서비스가 설치되면 다음과 같은 JNDI 특성을 구성해야 합니다.

  • mfp.admin.push.url
  • mfp.admin.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.admin.authorization.client.id
  • mfp.admin.authorization.client.secret

구성 서비스와의 통신을 위한 JNDI 특성은 다음과 같습니다.

  • mfp.config.service.user
  • mfp.config.service.password

JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

데이터 소스

관리 서비스에 대한 데이터 소스를 작성하여 jdbc/mfpAdminDS에 맵핑하십시오.

시작 순서

런타임 애플리케이션보다 먼저 관리 서비스 애플리케이션을 시작해야 합니다. 시작 동작 섹션에서 순서를 설정할 수 있습니다. 예를 들어, 관리 서비스의 경우 시작 순서를 1로 설정하고 런타임의 경우 시작 순서를 2로 설정하십시오.

보안 역할

관리 서비스 애플리케이션에 사용 가능한 보안 역할은 다음과 같습니다.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator

라이브 업데이트 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

라이브 업데이트 서비스 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-live-update.war에 있습니다. 라이브 업데이트 서비스의 컨텍스트 루트는 다음과 같은 방식으로 정의되어야 합니다. /the-adminContextRoot/config. 예를 들어, 관리 서비스의 컨텍스트 루트가 /mfpadmin인 경우 라이브 업데이트 서비스의 컨텍스트 루트는 /mfpadminconfig여야 합니다.

데이터 소스

라이브 업데이트 서비스에 대한 데이터 소스를 작성하여 jdbc/ConfigDS에 맵핑하십시오.

보안 역할

이 애플리케이션에 대해 configadmin 역할이 정의됩니다.

한 명 이상의 사용자가 이 역할에 맵핑되어야 합니다. 관리 서비스의 다음과 같은 JNDI 특성에 사용자 및 해당 비밀번호가 제공되어야 합니다.

  • mfp.config.service.user
  • mfp.config.service.password

콘솔은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

콘솔 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-admin-ui.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 일반적으로는 /mfpconsole입니다.

필수 JNDI 특성

WebSphere Application Server 관리 콘솔을 사용하여 JNDI 특성을 설정할 수 있습니다. 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션 → application_name → 웹 모듈용 환경 항목으로 이동하여 항목을 설정하십시오.

mfp.admin.endpoint 특성을 정의해야 합니다. 이 특성의 일반적인 값은 *://*:*/the-adminContextRoot입니다.

JNDI 특성에 대한 자세한 정보는 MobileFirst Operations Console의 JNDI 특성을 참조하십시오.

보안 역할

애플리케이션에 사용 가능한 보안 역할은 다음과 같습니다.

  • mfpadmin
  • mfpdeployer
  • mfpmonitor
  • mfpoperator
콘솔의 보안 역할에 맵핑되는 사용자는 관리 서비스의 동일한 보안 역할에도 맵핑되어야 합니다.

런타임은 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다.

계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

런타임 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-server.war에 있습니다. 원하는 대로 컨텍스트 루트를 정의할 수 있습니다. 하지만 기본적으로는 /mfp입니다.

필수 JNDI 특성

WebSphere Application Server 관리 콘솔을 사용하여 JNDI 특성을 설정할 수 있습니다. 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션 → application_name → 웹 모듈용 환경 항목으로 이동하여 항목을 설정하십시오.

값이 임베드된 mfp.authorization.server 특성을 정의해야 합니다.
또한 다음과 같은 JNDI 특성을 정의하여 관리 서비스와의 JMX 통신을 사용으로 설정하십시오.

WebSphere Application Server Network Deployment의 경우
  • mfp.admin.jmx.dmgr.host - 배치 관리자의 호스트 이름입니다.
  • mfp.admin.jmx.dmgr.port - 배치 관리자의 SOAP 포트입니다.
  • mfp.topology.platform - 값을 WAS로 설정하십시오.
  • mfp.topology.clustermode - 값을 Cluster로 설정하십시오.
  • mfp.admin.jmx.connector - 값을 SOAP로 설정하십시오.
독립형 WebSphere Application Server의 경우
  • mfp.topology.platform - 값을 WAS로 설정하십시오.
  • mfp.topology.clustermode - 값을 Standalone으로 설정하십시오.
  • mfp.admin.jmx.connector - 값을 SOAP로 설정하십시오.

MobileFirst Analytics가 설치된 경우 다음과 같은 JNDI 특성을 정의해야 합니다.

  • mfp.analytics.url
  • mfp.analytics.console.url
  • mfp.analytics.username
  • mfp.analytics.password

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

시작 순서

관리 서비스 애플리케이션 이후에 런타임 애플리케이션을 시작해야 합니다. 시작 동작 섹션에서 순서를 설정할 수 있습니다. 예를 들어, 관리 서비스의 경우 시작 순서를 1로 설정하고 런타임의 경우 시작 순서를 2로 설정하십시오.

데이터 소스

런타임에 대한 데이터 소스를 작성한 후 jdbc/mfpDS에 맵핑하십시오.

푸시 서비스는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

푸시 서비스 WAR 파일은 mfp_install_dir/PushService/mfp-push-service.war에 있습니다. 컨텍스트 루트를 /imfpush로 정의해야 합니다. 그렇지 않으면 컨텍스트 루트가 SDK에서 하드코딩되므로 클라이언트 디바이스가 여기에 연결될 수 없습니다.

필수 JNDI 특성

WebSphere Application Server 관리 콘솔을 사용하여 JNDI 특성을 설정할 수 있습니다. 애플리케이션 > 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션 → application_name → 웹 모듈용 환경 항목으로 이동하여 항목을 설정하십시오.

다음과 같은 특성을 정의해야 합니다.

  • mfp.push.authorization.server.url
  • mfp.push.authorization.client.id
  • mfp.push.authorization.client.secret
  • mfp.push.services.ext.security - 값은 com.ibm.mfp.push.server.security.plugin.OAuthSecurityPlugin이어야 합니다.
  • mfp.push.db.type - 관계형 데이터베이스의 경우 값은 DB여야 합니다.

MobileFirst Analytics가 구성된 경우 다음과 같은 JNDI 특성을 정의하십시오.

  • mfp.push.analytics.endpoint
  • mfp.analytics.username
  • mfp.analytics.password
  • mfp.push.services.ext.analytics - 값은 com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin이어야 합니다.

JNDI 특성에 대한 자세한 정보는 MobileFirst Server 푸시 서비스의 JNDI 특성 목록을 참조하십시오.

데이터 소스

푸시 서비스에 대한 데이터 소스를 작성하여 jdbc/imfPushDS에 맵핑하십시오.

아티팩트 컴포넌트는 사용자가 애플리케이션 서버에 배치할 수 있도록 WAR 애플리케이션으로 패키지됩니다. 애플리케이션 서버의 server.xml 파일에서 이 애플리케이션에 대한 일부 특정 구성을 작성해야 합니다. 계속 진행하기 전에 WebSphere Application Server 및 WebSphere Application Server Network Deployment에 수동 설치에서 모든 서비스에 공통인 구성 세부사항을 검토하십시오.

이 컴포넌트에 대한 WAR 파일은 mfp_install_dir/MobileFirstServer/mfp-dev-artifacts.war에 있습니다. 컨텍스트 루트를 /mfp-dev-artifacts로 정의해야 합니다.

서버 팜 설치

Ant 태스크를 실행하거나 Server Configuration Tool을 사용하거나 수동으로 서버 팜을 설치할 수 있습니다.

서버 팜의 구성 계획

서버 팜의 구성을 계획하려면 애플리케이션 서버를 선택하고 MobileFirst 데이터베이스를 구성하고 팜의 각 서버에서 MobileFirst Server 컴포넌트의 WAR 파일을 배치하십시오. Server Configuration Tool, Ant 태스크 또는 수동 조작을 사용하여 서버 팜을 구성하는 옵션이 있습니다.

서버 팜 설치를 계획하려는 경우에는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임에 대한 제한조건을 먼저 참조하십시오(특히 서버 팜 토폴로지 참조).

Mobile Foundation에서 서버 팜은 애플리케이션 서버의 컴포넌트를 관리하여 관리 또는 연합되지 않는 여러 독립형 애플리케이션 서버로 구성됩니다. MobileFirst Server는 서버 팜의 일부가 될 수 있도록 애플리케이션 서버를 개선하는 수단으로 팜 플러그인을 내부적으로 제공합니다.

서버 팜 선언 시기

**다음과 같은 경우 서버 팜을 선언하십시오. **

  • MobileFirst Server가 여러 Tomcat 애플리케이션 서버에 설치됩니다.
  • MobileFirst Server가 여러 WebSphere Application Server 서버에 설치되지만 WebSphere Application Server Network Deployment에는 설치되지 않습니다.
  • MobileFirst Server가 여러 WebSphere Application Server Liberty 서버에 설치됩니다.

**다음과 같은 경우에는 서버 팜을 선언하지 마십시오. **

  • 애플리케이션 서버가 독립형입니다.
  • 여러 애플리케이션 서버가 WebSphere Application Server Network Deployment에 의해 연합됩니다.

팜 선언이 필수인 이유

MobileFirst Operations Console 또는 MobileFirst Server 관리 서비스 애플리케이션을 통해 관리 조작이 수행될 때마다 런타임 환경의 모든 인스턴스에 조작을 복제해야 합니다. 이러한 관리 조작의 예는 앱 또는 어댑터의 새 버전을 업로드하는 것입니다. 복제는 조작을 처리하는 관리 서비스 애플리케이션 인스턴스가 수행하는 JMX 호출을 통해 수행됩니다. 관리 서비스는 클러스터의 모든 런타임 인스턴스에 접속해야 합니다. 위의 서버 팜 선언 시기 아래에 나열된 환경에서는 팜이 구성된 경우에만 JMX를 통해 런타임에 접속할 수 있습니다. 팜을 적절하게 구성하지 않고 서버를 클러스터에 추가하는 경우 해당 서버의 런타임은 각각의 관리 조작 후 다시 시작될 때까지 불일치 상태에 있습니다.

Server Configuration Tool을 사용한 서버 팜 설치

Server Configuration Tool을 사용하여 서버 팜의 각 멤버에 사용되는 단일 애플리케이션 서버 유형의 요구사항에 따라 팜의 각 서버를 구성하십시오.

Server Configuration Tool을 사용하여 서버 팜을 계획할 때는 먼저 독립형 서버를 작성한 후 안전한 방식으로 서로 통신할 수 있도록 독립형 서버 각각의 신뢰 저장소를 구성하십시오. 그런 다음 다음과 같은 조작을 수행하는 도구를 실행하십시오.

  • MobileFirst Server 컴포넌트가 공유하는 데이터베이스 인스턴스를 구성하십시오.
  • MobileFirst Server 컴포넌트를 각 서버에 배치하십시오.
  • 서버 팜의 멤버가 되도록 해당 서버의 구성을 수정하십시오.

MobileFirst Server를 사용하려면 보안 JMX 연결을 구성해야 합니다.

  1. 서버 팜 멤버로 구성해야 하는 애플리케이션 서버를 준비하십시오.
    • 서버 팜의 멤버를 구성하기 위해 사용할 애플리케이션 서버의 유형을 선택하십시오. Mobile Foundation은 서버 팜에 있는 다음과 같은 애플리케이션 서버를 지원합니다.
      • WebSphere Application Server 전체 프로파일
        참고: 팜 토폴로지에서는 RMI JMX 커넥터를 사용할 수 없습니다. 이 토폴로지에서는 Mobile Foundation이 SOAP 커넥터만 지원합니다.
      • WebSphere Application Server Liberty 프로파일
      • Apache Tomcat
      지원되는 애플리케이션 서버 버전을 확인하려면 시스템 요구사항을 참조하십시오.
      중요: Mobile Foundation은 동종 서버 팜만 지원합니다. 서버 팜은 동일한 유형의 애플리케이션 서버에 연결되는 경우 동종 서버 팜입니다. 서로 다른 유형의 애플리케이션 서버를 연관시키면 런타임 시 예측할 수 없는 동작이 발생합니다. 예를 들어, Apache Tomcat 서버와 WebSphere Application Server 전체 프로파일 서버의 혼합을 가진 팜은 올바르지 않은 구성입니다.
    • 팜에서 원하는 멤버 수만큼 독립형 서버를 설정하십시오.
      • 이 독립형 서버는 각각 동일한 데이터베이스와 통신해야 합니다. 이 서버가 사용하는 포트를 동일한 호스트에서 구성된 다른 서버가 사용하지 않는지 확인해야 합니다. 이 제한조건은 HTTP, HTTPS, REST, SOAP 및 RMI 프로토콜에서 사용하는 포트에 적용됩니다.
      • 이 서버 각각에는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 하나 이상의 MobileFirst 런타임이 배치되어 있어야 합니다.
      • 서버 설정에 대한 자세한 정보는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임에 대한 제한조건을 참조하십시오.
    • 각각의 신뢰 저장소에 있는 모든 서버 사이에서 서명자 인증서를 교환하십시오.

      참고: 보안이 사용으로 설정되어야 하므로 이 단계는 WebSphere Application Server 전체 프로파일 또는 Liberty를 사용하는 팜의 경우 필수입니다. 또한 Liberty 팜의 경우 싱글 사인온 기능을 보장하기 위해 각 서버에서 동일한 LTPA 구성을 복제해야 합니다. 이 구성을 수행하려면 수동으로 서버 팜 구성의 6단계에 있는 가이드라인을 따르십시오.
  2. 팜의 각 서버에 대해 Server Configuration Tool을 실행하십시오. 모든 서버는 동일한 데이터베이스를 공유해야 합니다. 애플리케이션 서버 설정 패널에서 배치 유형 서버 팜 배치를 선택해야 합니다. 이 도구에 대한 자세한 정보는 Server Configuration Tool 실행을 참조하십시오.

Ant 태스크를 사용한 서버 팜 설치

Ant 태스크를 사용하여 서버 팜의 각 멤버에 사용되는 단일 애플리케이션 서버 유형의 요구사항에 따라 팜의 각 서버를 구성하십시오.

Ant 태스크를 사용하여 서버 팜을 계획할 때는 먼저 독립형 서버를 작성한 후 안전한 방식으로 서로 통신할 수 있도록 독립형 서버 각각의 신뢰 저장소를 구성하십시오. 그런 다음 Ant 태스크를 실행하여 MobileFirst Server 컴포넌트가 공유하는 데이터베이스 인스턴스를 구성하십시오. 마지막으로 Ant 태스크를 실행하여 MobileFirst Server 컴포넌트를 각 서버에 배치하고 서버 팜의 멤버가 되도록 해당 서버의 구성을 수정하십시오.

MobileFirst Server를 사용하려면 보안 JMX 연결을 구성해야 합니다.

  1. 서버 팜 멤버로 구성해야 하는 애플리케이션 서버를 준비하십시오.
    • 서버 팜의 멤버를 구성하기 위해 사용할 애플리케이션 서버의 유형을 선택하십시오. Mobile Foundation은 서버 팜에 있는 다음과 같은 애플리케이션 서버를 지원합니다.
      • WebSphere Application Server 전체 프로파일 참고: 팜 토폴로지에서는 RMI JMX 커넥터를 사용할 수 없습니다. 이 토폴로지에서는 Mobile Foundation이 SOAP 커넥터만 지원합니다.
      • WebSphere Application Server Liberty 프로파일
      • Apache Tomcat
      지원되는 애플리케이션 서버 버전을 확인하려면 시스템 요구사항을 참조하십시오.
      중요: Mobile Foundation은 동종 서버 팜만 지원합니다. 서버 팜은 동일한 유형의 애플리케이션 서버에 연결되는 경우 동종 서버 팜입니다. 서로 다른 유형의 애플리케이션 서버를 연관시키면 런타임 시 예측할 수 없는 동작이 발생합니다. 예를 들어, Apache Tomcat 서버와 WebSphere Application Server 전체 프로파일 서버의 혼합을 가진 팜은 올바르지 않은 구성입니다.
    • 팜에서 원하는 멤버 수만큼 독립형 서버를 설정하십시오.

      이 독립형 서버는 각각 동일한 데이터베이스와 통신해야 합니다. 이 서버가 사용하는 포트를 동일한 호스트에서 구성된 다른 서버가 사용하지 않는지 확인해야 합니다. 이 제한조건은 HTTP, HTTPS, REST, SOAP 및 RMI 프로토콜에서 사용하는 포트에 적용됩니다.

      이 서버 각각에는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 하나 이상의 MobileFirst 런타임이 배치되어 있어야 합니다.

      서버 설정에 대한 자세한 정보는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 MobileFirst 런타임에 대한 제한조건을 참조하십시오.
    • 각각의 신뢰 저장소에 있는 모든 서버 사이에서 서명자 인증서를 교환하십시오.

      참고: 보안이 사용으로 설정되어야 하므로 이 단계는 WebSphere Application Server 전체 프로파일 또는 Liberty를 사용하는 팜의 경우 필수입니다. 또한 Liberty 팜의 경우 싱글 사인온 기능을 보장하기 위해 각 서버에서 동일한 LTPA 구성을 복제해야 합니다. 이 구성을 수행하려면 수동으로 서버 팜 구성
      의 6단계에 있는 가이드라인을 따르십시오.
  2. 관리 서비스, 라이브 업데이트 서비스 및 런타임에 대한 데이터베이스를 구성하십시오.
    • 사용할 데이터베이스를 결정하고 Ant 파일을 선택하여 mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에서 데이터베이스를 작성하고 구성하십시오.
      • DB2의 경우 create-database-db2.xml을 사용하십시오.
      • MySQL의 경우 create-database-mysql.xml을 사용하십시오.
      • Oracle의 경우 create-database-oracle.xml을 사용하십시오.
      참고: Derby 데이터베이스는 한 번에 하나의 연결만 허용하므로 팜 토폴로지에서 Derby 데이터베이스를 사용하지 마십시오.
    • Ant 파일을 편집하고 데이터베이스에 필요한 모든 특성을 입력하십시오.

      MobileFirst Server 컴포넌트가 사용하는 데이터베이스의 구성을 사용으로 설정하려면 다음과 같은 특성의 값을 설정하십시오.
      • mfp.process.admintrue로 설정하십시오. 관리 서비스 및 라이브 업데이트 서비스에 대한 데이터베이스를 구성하기 위해서입니다.
      • mfp.process.runtimetrue로 설정하십시오. 런타임에 대한 데이터베이스를 구성하기 위해서입니다.
    • mfp_install_dir/MobileFirstServer/configuration-samples 디렉토리에서 mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml admdatabasesmfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases 명령을 실행하십시오(create-database-ant-file.xml을 선택한 실제 Ant 파일 이름으로 바꿔야 함).

      MobileFirst Server 데이터베이스는 팜의 애플리케이션 서버 사이에서 공유되므로 이 두 명령은 팜에 있는 서버의 수에 관계없이 한 번만 실행해야 합니다.
    • 선택적으로 다른 런타임을 설치하려면 다른 데이터베이스 이름 또는 스키마를 가진 다른 데이터베이스를 구성해야 합니다. 이를 위해서는 Ant 파일을 편집하고 특성을 수정하고 팜에 있는 서버의 수에 관계없이 mfp_install_dir/shortcuts/ant -f create-database-ant-file.xml rtmdatabases 명령을 한 번 실행하십시오.
  3. 관리 서비스, 라이브 업데이트 서비스 및 런타임을 서버에 배치하고 이 서버를 서버 팜의 멤버로 구성하십시오.
    • mfp\_install\_dir/MobileFirstServer/configuration-samples 디렉토리에서 사용자의 애플리케이션 서버 및 데이터베이스에 해당하는 Ant 파일을 선택하여 관리 서비스, 라이브 업데이트 서비스 및 런타임을 서버에 배치하십시오.

      예를 들어, DB2 데이터베이스를 가진 Liberty 서버에 배치의 경우 configure-liberty-db2.xml 파일을 선택하십시오. 팜에서 원하는 멤버 수만큼 이 파일의 사본을 작성하십시오.

      참고: 이 파일은 이미 배치된 MobileFirst Server 컴포넌트의 업그레이드 또는 팜의 각 멤버에서 이들 컴포넌트의 설치 제거에 재사용할 수 있으므로 구성 후 보존하십시오.
    • Ant 파일의 각 사본을 편집하고 2단계에서 사용되는 데이터베이스에 대해 동일한 특성을 입력하고 애플리케이션 서버에 대해 필요한 기타 특성도 입력하십시오.

      서버를 서버 팜 멤버로 구성하려면 다음과 같은 특성의 값을 설정하십시오.
      • mfp.farm.configure를 true로 설정하십시오.
      • mfp.farm.server.id: 이 팜 멤버에 대해 정의하는 ID입니다. 팜의 각 서버가 자체 고유 ID를 가지고 있는지 확인하십시오. 팜에 있는 두 서버가 동일한 ID를 가지고 있는 경우 팜은 예측할 수 없는 방식으로 작동합니다.
      • mfp.config.service.user: 라이브 업데이트 서비스에 액세스하는 데 사용되는 사용자 이름입니다. 이 사용자 이름은 팜의 모든 멤버에 대해 동일해야 합니다.
      • mfp.config.service.password: 라이브 업데이트 서비스에 액세스하는 데 사용되는 비밀번호입니다. 이 비밀번호는 팜의 모든 멤버에 대해 동일해야 합니다.
      서버에 MobileFirst Server 컴포넌트의 WAR 파일 배치를 사용하려면 다음과 같은 특성의 값을 설정하십시오.
      • mfp.process.admintrue로 설정하십시오. 관리 서비스 및 라이브 업데이트 서비스의 WAR 파일을 배치하기 위해서입니다.
      • mfp.process.runtimetrue로 설정하십시오. 런타임의 WAR 파일을 배치하기 위해서입니다.

      참고: 팜의 서버에 둘 이상의 런타임을 설치하려는 경우에는 속성 ID를 지정하고 installmobilefirstruntime, updatemobilefirstruntimeuninstallmobilefirstruntime Ant 태스크에서 각 런타임에 대해 고유해야 하는 값을 설정하십시오.
      예:
      <target name="rtminstall">
          <installmobilefirstruntime execute="true" contextroot="/runtime1" id="rtm1">
    • 각 서버에 대해 mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml adminstallmfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file.xml rtminstall 명령을 실행하십시오(configure-appserver-database-ant-file.xml을 선택한 실제 Ant 파일 이름으로 바꿔야 함).

      이 명령은 installmobilefirstadmininstallmobilefirstruntime Ant 태스크를 실행합니다. 이 태스크에 대한 자세한 정보는 MobileFirst Operations Console, MobileFirst Server 아티팩트, MobileFirst Server 관리 및 라이브 업데이트 서비스 설치를 위한 Ant 태스크MobileFirst 런타임 환경 설치를 위한 Ant 태스크를 참조하십시오.
    • 선택적으로 다른 런타임을 설치하려면 다음의 단계를 수행하십시오.
      • 3.b단계에서 구성한 Ant 파일의 사본을 작성하십시오.
      • 사본을 편집하고 다른 런타임 구성과는 다른 installmobilefirstruntime, updatemobilefirstruntimeuninstallmobilefirstruntimeid 속성 값과 고유 컨텍스트 루트를 설정하십시오.
      • 팜의 각 서버에서 mfp_install_dir/shortcuts/ant -f configure-appserver-database-ant-file2.xml rtminstall 명령을 실행하십시오(configure-appserver-database-ant-file2.xml을 편집되는 Ant 파일의 실제 이름으로 바꿔야 함).
      • 팜의 각 서버에 대해 이 단계를 반복하십시오.
  4. 모든 서버를 다시 시작하십시오.

수동으로 서버 팜 구성

서버 팜의 각 멤버에 사용되는 단일 애플리케이션 서버 유형의 요구사항에 따라 팜의 각 서버를 구성해야 합니다.

서버 팜을 계획하는 경우에는 먼저 동일한 데이터베이스 인스턴스와 통신하는 독립형 서버를 작성하십시오. 그런 다음 이 서버의 구성을 수정하여 이 서버를 서버 팜의 멤버로 만드십시오.

  1. 서버 팜의 멤버를 구성하기 위해 사용할 애플리케이션 서버의 유형을 선택하십시오. Mobile Foundation은 서버 팜에 있는 다음과 같은 애플리케이션 서버를 지원합니다.
    • WebSphere Application Server 전체 프로파일
      참고: 팜 토폴로지에서는 RMI JMX 커넥터를 사용할 수 없습니다. 이 토폴로지에서는 Mobile Foundation이 SOAP 커넥터만 지원합니다.
    • WebSphere Application Server Liberty 프로파일
    • Apache Tomcat
    지원되는 애플리케이션 서버 버전을 확인하려면 시스템 요구사항을 참조하십시오.
    중요: Mobile Foundation은 동종 서버 팜만 지원합니다. 서버 팜은 동일한 유형의 애플리케이션 서버에 연결되는 경우 동종 서버 팜입니다. 서로 다른 유형의 애플리케이션 서버를 연관시키면 런타임 시 예측할 수 없는 동작이 발생합니다. 예를 들어, Apache Tomcat 서버와 WebSphere Application Server 전체 프로파일 서버의 혼합을 가진 팜은 올바르지 않은 구성입니다.
  2. 사용할 데이터베이스를 결정하십시오. 다음 중에서 선택할 수 있습니다.
    • DB2
    • MySQL
    • Oracle
    MobileFirst Server 데이터베이스는 팜의 애플리케이션 서버 사이에서 공유되며 이는 다음을 의미합니다.
    • 팜에 있는 서버의 수에 관계없이 데이터베이스를 한 번만 작성합니다.
    • Derby 데이터베이스는 한 번에 하나의 연결만 허용하므로 팜 토폴로지에서 Derby 데이터베이스를 사용할 수 없습니다.
    데이터베이스에 대한 자세한 정보는 데이터베이스 설정을 참조하십시오.
  3. 팜에서 원하는 멤버 수만큼 독립형 서버를 설정하십시오.
    • 이 독립형 서버는 각각 동일한 데이터베이스와 통신해야 합니다. 이 서버가 사용하는 포트를 동일한 호스트에서 구성된 다른 서버가 사용하지 않는지 확인해야 합니다. 이 제한조건은 HTTP, HTTPS, REST, SOAP 및 RMI 프로토콜에서 사용하는 포트에 적용됩니다.
    • 이 서버 각각에는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스 및 하나 이상의 MobileFirst 런타임이 배치되어 있어야 합니다.
    • 독립형 토폴로지에서 이 서버 각각이 제대로 작동하는 경우 이 서버를 서버 팜의 멤버로 변환할 수 있습니다.
  4. 팜의 멤버가 되도록 되어 있는 모든 서버를 중지하십시오.
  5. 애플리케이션 서버의 유형에 맞게 적절하게 각 서버를 구성하십시오.
    일부 JNDI 특성을 올바르게 설정해야 합니다. 서버 팜 토폴로지에서 mfp.config.service.user 및 mfp.config.service.password JNDI 특성은 팜의 모든 멤버에 대해 동일한 값을 가지고 있어야 합니다. Apache Tomcat의 경우에는 JVM 인수가 제대로 정의되어 있는지도 확인해야 합니다.
    • WebSphere Application Server Liberty 프로파일
      server.xml 파일에서 다음 샘플 코드에 표시된 JNDI 특성을 설정하십시오.
      <jndiEntry jndiName="mfp.topology.clustermode" value="Farm"/>
      <jndiEntry jndiName="mfp.admin.serverid" value="farm_member_1"/>
      <jndiEntry jndiName="mfp.admin.jmx.user" value="myRESTConnectorUser"/>
      <jndiEntry jndiName="mfp.admin.jmx.pwd" value="password-of-rest-connector-user"/>
      <jndiEntry jndiName="mfp.admin.jmx.host" value="93.12.0.12"/>
      <jndiEntry jndiName="mfp.admin.jmx.port" value="9443"/>
      이러한 특성은 적절한 값을 사용하여 설정해야 합니다.
      • mfp.admin.serverid: 이 팜 멤버에 대해 정의된 ID입니다. 이 ID는 모든 팜 멤버에서 고유해야 합니다.
      • mfp.admin.jmx.usermfp.admin.jmx.pwd: 이 값은 administrator-role 요소에서 선언된 대로 사용자의 인증 정보와 일치해야 합니다.
      • mfp.admin.jmx.host: 이 매개변수를 이 서버에 액세스하기 위해 원격 멤버가 사용하는 호스트 이름 또는 IP로 설정하십시오. 따라서 이를 localhost로 설정하지 마십시오. 이 호스트 이름은 팜의 기타 멤버에 의해 사용되며 모든 팜 멤버에 액세스할 수 있어야 합니다.
      • mfp.admin.jmx.port: 이 매개변수를 JMX REST 연결에 사용되는 서버 HTTPS 포트로 설정하십시오. server.xml 파일의 httpEndpoint 요소에서 값을 찾을 수 있습니다.
    • Apache Tomcat
      conf/server.xml 파일을 수정하여 모든 런타임 컨텍스트 및 관리 서비스 컨텍스트에서 다음과 같은 JNDI 특성을 설정하십시오.
      <Environment name="mfp.topology.clustermode" value="Farm" type="java.lang.String" override="false"/>
      <Environment name="mfp.admin.serverid" value="farm_member_1" type="java.lang.String" override="false"/>
      mfp.admin.serverid 특성을 이 팜 멤버에 정의한 ID로 설정해야 합니다. 이 ID는 모든 팜 멤버에서 고유해야 합니다.
      -Djava.rmi.server.hostname JVM 인수가 이 서버에 액세스하기 위해 원격 멤버가 사용하는 호스트 이름 또는 IP로 설정되는지 확인해야 합니다. 따라서 이를 localhost로 설정하지 마십시오. 또한 -Dcom.sun.management.jmxremote.port JVM 인수가 JMX RMI 연결을 사용으로 설정하기 위해 아직 사용되고 있지 않은 포트를 사용하여 설정되어 있는지 확인해야 합니다. 두 인수 모두 CATALINA_OPTS 환경 변수에서 설정됩니다.
    • WebSphere Application Server 전체 프로파일
      서버에 배치된 모든 런타임 애플리케이션 및 관리 서비스에서 다음과 같은 JNDI 특성을 선언해야 합니다.
      • mfp.topology.clustermode
      • mfp.admin.serverid
      WebSphere Application Server 콘솔에서
      • 애플리케이션 → 애플리케이션 유형 → WebSphere 엔터프라이즈 애플리케이션을 선택하십시오.
      • 관리 서비스 애플리케이션을 선택하십시오.
      • 웹 모듈 특성에서 웹 모듈용 환경 항목을 클릭하여 JNDI 특성을 표시하십시오.
      • 다음과 같은 특성의 값을 설정하십시오.
        • mfp.topology.clustermodeFarm으로 설정하십시오.
        • mfp.admin.serverid를 이 팜 멤버에 대해 선택한 ID로 설정하십시오. 이 ID는 모든 팜 멤버에서 고유해야 합니다.
        • mfp.admin.jmx.user를 SOAP 커넥터에 대한 액세스 권한을 가진 사용자 이름으로 설정하십시오.
        • mfp.admin.jmx.pwdmfp.admin.jmx.user에서 선언된 대로 사용자의 비밀번호로 설정하십시오.
        • mfp.admin.jmx.port를 SOAP 포트의 값으로 설정하십시오.
      • mfp.admin.jmx.connectorSOAP로 설정되어 있는지 확인하십시오.
      • 확인을 클릭하고 구성을 저장하십시오.
      • 서버에 배치된 모든 MobileFirst 런타임 애플리케이션에 대해 유사한 변경을 수행하십시오.
  6. 팜의 모든 멤버 사이에서 신뢰 저장소의 서버 인증서를 교환하십시오. WebSphere Application Server 전체 프로파일 및 WebSphere Application Server Liberty 프로파일을 사용하는 팜에서는 서버 간 통신이 SSL로 보호되므로 이러한 팜의 경우 신뢰 저장소의 서버 인증서 교환은 필수입니다.
    • WebSphere Application Server Liberty 프로파일
      IBM 유틸리티(예: Keytool 또는 iKeyman)를 사용하여 신뢰 저장소를 구성할 수 있습니다.
      • Keytool에 대한 자세한 정보는 IBM SDK, Java Technology Edition의 Keytool을 참조하십시오.
      • iKeyman에 대한 자세한 정보는 IBM SDK, Java Technology Edition의 iKeyman을 참조하십시오.
      키 저장소 및 신뢰 저장소의 위치는 server.xml 파일에서 정의됩니다. SSL 구성 속성에서 keyStoreReftrustStoreRef 속성을 참조하십시오. 기본적으로 Liberty 프로파일의 키 저장소는 ${server.config.dir}/resources/security/key.jks에 있습니다. 신뢰 저장소 참조가 누락되었거나 server.xml 파일에 정의되지 않은 경우 keyStoreRef에 의해 지정된 키 저장소가 사용됩니다. 서버는 기본 키 저장소를 사용하며 파일은 서버가 처음으로 실행될 때 작성됩니다. 이 경우에는 유효 기간이 365일인 기본 인증서가 작성됩니다. 프로덕션의 경우에는 사용자의 자체 인증서(필요한 경우 중간 인증서 포함)를 사용하거나 생성된 인증서의 만기 날짜를 변경해 볼 수 있습니다.
      참고: 신뢰 저장소의 위치를 확인하려는 경우에는 다음 선언을 server.xml 파일에 추가하여 확인할 수 있습니다.
      <logging traceSpecification="SSL=all:SSLChannel=all"/>
      마지막으로 서버를 시작한 후 ${wlp.install.dir}/usr/servers/server_name/logs/trace.log 파일에서 com.ibm.ssl.trustStore가 포함된 행을 찾으십시오.
      • 팜에 있는 다른 서버의 공용 인증서를 서버의 server.xml 구성 파일이 참조하는 신뢰 저장소로 가져오십시오. 그래픽 모드에서 MobileFirst Server 설치 튜토리얼에서는 팜에 있는 두 Liberty 서버 사이에서 인증서를 교환하는 데 필요한 지시사항을 제공합니다. 자세한 정보는 MobileFirst Server를 실행하는 두 개의 Liberty 서버로 구성된 팜 작성 섹션의 5단계를 참조하십시오.
      • WebSphere Application Server Liberty 프로파일의 각 인스턴스를 다시 시작하여 보안 구성을 적용하십시오. 싱글 사인온(SSO)이 작동하려면 다음의 단계가 필요합니다.
      • 각각의 신뢰 저장소에 있는 모든 서버 사이에서 서명자 인증서를 교환하십시오.

        참고: 보안이 사용으로 설정되어야 하므로 이 단계는 WebSphere Application Server 전체 프로파일 또는 Liberty를 사용하는 팜의 경우 필수입니다. 또한 Liberty 팜의 경우 싱글 사인온 기능을 보장하기 위해 각 서버에서 동일한 LTPA 구성을 복제해야 합니다. 이 구성을 수행하려면 다음 단계를 완료하십시오.
      • 팜의 한 멤버를 시작하십시오. 기본 LTPA 구성에서는 Liberty 서버가 정상적으로 시작되면 LTPA 키 저장소가 ${wlp.user.dir}/servers/server_name/resources/security/ltpa.keys로 생성됩니다.
      • ltpa.keys 파일을 각 팜 멤버의 ${wlp.user.dir}/servers/server_name/resources/security 디렉토리에 복사하여 팜 멤버 사이에서 LTPA 키 저장소를 복제하십시오. LTPA 구성에 대한 자세한 정보는 Liberty 프로파일에서 LTPA 구성을 참조하십시오.
    • WebSphere Application Server 전체 프로파일
      WebSphere Application Server 관리 콘솔에서 신뢰 저장소를 구성하십시오.
      • WebSphere Application Server 관리 콘솔에 로그인하십시오.
      • 보안 → SSL 인증서 및 키 관리를 선택하십시오.
      • 관련 항목에서 키 저장소 및 인증서를 선택하십시오.
      • 키 저장소 사용법 필드에서 SSL 키 저장소가 선택되어 있는지 확인하십시오. 이제 팜의 다른 모든 서버에서 인증서를 가져올 수 있습니다.
      • NodeDefaultTrustStore를 클릭하십시오.
      • 추가 특성에서 서명자 인증서를 선택하십시오.
      • 포트에서 검색을 클릭하십시오. 이제 팜에 있는 각각의 기타 서버에 대한 통신 및 보안 세부사항을 입력할 수 있습니다. 각각의 기타 팜 멤버에 대해 다음의 단계를 수행하십시오.
      • 호스트 필드에 서버 호스트 이름 또는 IP 주소를 입력하십시오.
      • 포트 필드에 HTTPS 전송(SSL) 포트를 입력하십시오.
      • 아웃바운드 연결의 SSL 구성에서 NodeDefaultSSLSettings를 선택하십시오.
      • 별명 필드에 이 서명자 인증서의 별명을 입력하십시오.
      • 서명자 정보 검색을 클릭하십시오.
      • 원격 서버에서 검색된 정보를 검토한 후 확인을 클릭하십시오.
      • 저장을 클릭하십시오.
      • 서버를 다시 시작하십시오.

팜 구성 확인

이 태스크의 용도는 팜 멤버의 상태를 확인하고 팜이 제대로 구성되었는지 확인하는 것입니다.

  1. 팜의 모든 서버를 시작하십시오.
  2. MobileFirst Operations Console에 액세스하십시오. 예를 들어, HTTPS의 https://hostname:secure_port/mfpconsole 또는 http://server_name:port/mfpconsole입니다. 콘솔 사이드바에 서버 팜 노드로 레이블 지정된 추가 메뉴가 표시됩니다.
  3. 서버 팜 노드를 클릭하여 등록된 팜 멤버 및 해당 상태의 목록에 액세스하십시오. 다음 예에서 FarmMember2로 식별되는 노드는 중지되었다고 간주되며 이는 이 서버에 장애가 발생했을 수 있으며 일부 유지보수가 필요함을 나타냅니다.

MobileFirst Operations Console에 있는 팜 노드의 상태

서버 팜 노드의 라이프사이클

영향받는 노드의 상태 변경을 트리거하여 팜 멤버 사이의 가능한 서버 문제점을 표시하기 위해 하트비트 비율 및 제한시간 값을 구성할 수 있습니다.

팜 노드로 서버 등록 및 모니터링

팜 노드로 구성된 서버가 시작되면 해당 서버의 관리 서비스가 자동으로 해당 서버를 새 팜 멤버로 등록합니다. 팜 멤버가 종료되면 팜 멤버는 자동으로 팜에서 등록 해제됩니다.

응답할 수 없게 되는(예: 정전 또는 서버 장애로 인해) 팜 멤버를 추적하기 위해 하트비트 메커니즘이 존재합니다. 이 하트비트 메커니즘에서 MobileFirst 런타임은 지정된 비율로 주기적으로 MobileFirst 관리 서비스에 하트비트를 전송합니다. MobileFirst 관리 서비스에서 팜 멤버가 하트비트를 전송한 이후 너무 오랜 시간이 경과했음을 등록하는 경우 팜 멤버는 중지된 것으로 간주됩니다.

중지된 것으로 간주되는 팜 멤버는 모바일 애플리케이션에 추가 요청을 제공하지 않습니다.

하나 이상의 노드가 중지되어도 다른 팜 멤버는 모바일 애플리케이션에 올바르게 요청을 제공하며 MobileFirst Operations Console을 통해 트리거되는 새 관리 조작을 승인합니다.

하트비트 비율 및 제한시간 값 구성

다음과 같은 JNDI 특성을 정의하여 하트비트 비율 및 제한시간 값을 구성할 수 있습니다.

  • mfp.admin.farm.heartbeat
  • mfp.admin.farm.missed.heartbeats.timeout


JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

Mobile Foundation 런타임 스케줄러

Mobile Foundation 런타임은 스케줄된 일부 활동을 수행하기 위해 Quartz 스케줄러를 사용합니다.

Mobile Foundation 런타임의 스케줄러는 다음 활동을 수행합니다.

  1. 라이센스 추적
  2. 감사 로그 작성

스케줄러 실행은 다음 두 가지 JNDI 특성으로 제어합니다.

  • mfp.licenseTracking.enabled
  • mfp.purgedata.enabled(iFix 레벨 8.0.0.0-MFPF-IF201812191602-CDUpdate-04에서 도입됨)

이러한 JNDI 특성은 지원되는 모든 애플리케이션 서버에 기본적으로 사용됩니다.

참고: WebSphere Application Server에서 실행 중인 Mobile Foundation의 경우, JNDI 특성 mfp.licenseTracking.enabled는 WAS 콘솔의 런타임 환경 항목에서 해당 값을 true로 설정하여 사용으로 설정되어야 합니다.

라이센스 추적

라이센스 추적은 활성 클라이언트 디바이스, 주소 지정 가능한 디바이스 및 설치된 앱과 같이 라이센싱 정책과 관련된 메트릭을 추적합니다. 이 정보는 Mobile Foundation의 현재 사용량이 라이센스 부여 레벨 내에 있는지 여부를 판별하는 데 도움이 되며 잠재적인 라이센스 위반을 방지할 수 있습니다. 라이센스 추적은 더 이상 Mobile Foundation Server에 액세스하지 않는 디바이스를 해제하고 MFP_PERSISTENT_DATA의 이전 레코드를 아카이브하고 삭제하는 데 도움이 됩니다.

다음 표는 라이센스 추적과 관련된 JNDI 특성을 나열합니다.

JNDI 특성 설명
mfp.device.decommissionProcessingInterval 해제 태스크가 실행되는 빈도(초)를 정의합니다. 기본값: 86400(1일).
mfp.device.decommission.when 클라이언트 디바이스가 디바이스 해제 태스크에 의해 해제될 때까지의 비활성 일 수입니다. 기본값: 90 days.
mfp.device.archiveDecommissioned.when 해제된 클라이언트 디바이스가 아카이브될 때까지의 비활성 일 수입니다.
이 태스크는 해제된 클라이언트 디바이스를 아카이브 파일에 기록합니다. 아카이브된 클라이언트 디바이스는 Mobile Foundation Server home\devices_archive 디렉토리에 있는 파일에 기록됩니다. 이 파일의 이름에는 아카이브 파일 작성 시의 시간소인이 포함됩니다. 기본값: 90 days.
mfp.licenseTracking.enabled IBM Mobile Foundation에서 디바이스 추적을 사용 또는 사용 안함으로 설정하는 데 사용되는 값입니다.
성능상의 이유로, IBM Mobile Foundation이 B2C(Business-to-Consumer) 앱만 실행하는 경우 디바이스 추적을 사용 안함으로 설정할 수 있습니다. 디바이스 추적이 사용되지 않는 경우, 라이센스 보고서도 사용되지 않고 라이센스 메트릭이 생성되지 않습니다.
가능한 값은 true(기본값) 및 false입니다.

라이센스 추적에 대한 자세한 내용은 아래 주제를 참조하십시오.

스케줄러는 서버 시작 후 8시간 후에 실행됩니다. 즉, 오늘 오후 11시에 서버가 시작된 경우 스케줄러는 그 다음날 오전 1시(기본 스케줄러 실행 시간)에 실행되지 않고 다음 다음날 오전 1시부터 실행을 시작합니다. 서버 시작과 스케줄러 실행 사이의 간격은 8시간입니다.

iFix 레벨 8.0.0.0-MFPF-IF201907091643부터 서버 시작과 스케줄러 실행 사이의 간격은 8시간이 아닌 4시간입니다. 또한 새 특성 mfp.scheduler.startHour가 도입되었습니다. 이 특성을 사용하면 기본값 오전 1시가 아닌 고객이 선택한 시간으로 스케줄러 실행을 설정할 수 있습니다. 이 특성은 1에서 23 사이의 값을 가질 수 있습니다. 이 특성은 고객이 트래픽이 적은 시간에 스케줄러가 시작하도록 구성할 수 있게 하며, 매일 서버가 시작되더라도 스케줄러가 실행되도록 할 수 있습니다. 매일 밤 오전 1시에 서버를 다시 시작하는 고객의 경우 mfp.scheduler.startHour의 값을 5로 설정할 수 있습니다. 이렇게 하면 서버 다시 시작과 스케줄러가 실행되는 오전 5시에 사이에 4시간 간격이 보장됩니다.

라이센스 추적 활동이 데이터베이스를 많이 사용하므로 라이센스 추적을 사용하지 않는 것이 좋습니다. Mobile Foundation 주소 지정 가능 디바이스 라이센싱 모델을 사용하는 고객만 라이센스 추적을 실행해야 합니다.

라이센스 추적을 사용하지 않는 고객은 제거 기능을 사용하여 이전 레코드를 정리하고 MFP_PERSISTENT_DATAMFP_TRANSIENT_DATA 테이블을 유지보수할 수 있습니다.

감사 로그 작성

라이센스 추적은 최신 실행 및 라이센스 데이터를 Mobile Foundation 런타임 테이블 LICENSE_TERMS에 저장합니다. 감사 로그는 이 테이블의 최신 보고서 항목을 기반으로 로그를 작성합니다. 보고서는 서버 설치 디렉토리의 logs 폴더에 있는 .slmtag 파일로 사용 가능합니다.

Quartz 업데이트 사용 안함

Mobile Foundation 런타임은 일부 서드파티 라이브러리를 포함하여 필수 라이브러리를 번들합니다. Mobile Foundation은 Quartz 작업 스케줄러를 사용하며 quartz2.2.0.jar를 포함합니다.

Quartz에는 서버에 연결하는 업데이트 검사 기능이 포함되어 있습니다. 이 검사는 비동기식으로 실행되며 Quartz의 구동/초기화 시간에 영향을 미치지 않으며 연결할 수 없는 경우 단계적으로 실패합니다. 검사가 실행되고 업데이트가 발견되면 Quartz의 로그에 사용 가능한 것으로 보고됩니다.

업데이트 검사는 플래그 org.quartz.scheduler.skipUpdateCheck = true를 사용하여 사용 안함으로 설정될 수 있습니다. Mobile Foundation의 Liberty 배치는 jvm.options 파일을 작성하며 배치 중에 서버 구성 도구를 통해 새로 작성된 jvm.options 파일에는 iFix 레벨 8.0.0.0-MFPF-IF201909190904 이상의 이 특성이 포함됩니다. 이전 iFix 레벨의 경우 고객은 이 특성을 jvm.options 파일에 추가할 수 있습니다. WAS(WebSphere Application Server) 배치의 경우, 위의 JNDI 특성을 WAS 관리 콘솔에서 Mobile Foundation 애플리케이션의 환경 특성에 추가해야 합니다.

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on May 13, 2020