Liberty for Java의 스크립트를 사용하여 IBM Cloud에서 MobileFirst Server 설정

improve this page | report issue

개요

아래의 지시사항에 따라 IBM Cloud에서 Liberty for Java 런타임에 MobileFirst Server 인스턴스를 구성하십시오. 이를 달성하기 위해 다음 단계를 수행합니다.

  • 필요한 도구(Cloud Foundry CLI)를 사용하여 호스트 컴퓨터 설정
  • IBM Cloud 계정 설정
  • MobileFirst Server를 빌드하여 IBM Cloud에 Cloud Foundry 애플리케이션으로 푸시

마지막으로 모바일 앱을 등록하고 어댑터를 배치합니다.

참고:

  • Windows OS는 현재 이와 같은 스크립트 실행에 지원되지 않습니다.
  • IBM Cloud에 배치하는 데 MobileFirst Server 구성 도구를 사용할 수 없습니다.

다음으로 이동:

IBM Cloud에 계정 등록

아직 계정이 없는 경우 IBM Cloud 웹 사이트를 방문하여 무료로 시작하기 또는 등록을 클릭하십시오. 다음 단계로 이동하려면 먼저 등록 양식에 입력해야 합니다.

IBM Cloud 대시보드

IBM Cloud에 로그인하면 활성 IBM Cloud 영역의 개요를 제공하는 IBM Cloud 대시보드가 표시됩니다. 기본적으로 이 작업 영역의 이름은 “dev”입니다. 필요한 경우 여러 작업 영역/영역을 작성할 수 있습니다.

호스트 시스템 설정

IBM Cloud Cloud Foundry 앱을 관리하려면 Cloud Foundry CLI를 설치해야 합니다.
macOS Terminal.app 또는 Linux bash 쉘을 사용하여 스크립트를 실행할 수 있습니다.

Cloud Foundry CLI를 설치하십시오.

ibm-mfpf-container-8.0.0.0 아카이브 다운로드

Liberty on Java에서 Mobile Foundation을 설정하려면 나중에 IBM Cloud에 푸시할 파일 레이아웃을 먼저 작성해야 합니다.
이 페이지의 지시사항을 수행하여 IBM Containers의 MobileFirst Server 8.0 아카이브(.zip 파일, CNBL0EN 검색)를 다운로드하십시오.

아카이브 파일에는 파일 레이아웃을 빌드하는 데 필요한 파일(dependencies, mfpf-libs), MobileFirst Analytics Container를 빌드하고 배치하는 데 필요한 파일(mfpf-analytics), MobileFirst Server Cloud Foundry 앱을 구성하는 데 필요한 파일(mfpf-server-libertyapp)이 들어 있습니다.

아카이브 파일의 파일 시스템 구조를 표시하는 이미지

dependencies 폴더

Mobile Foundation 런타임과 IBM Java JRE 8을 포함합니다.

mfpf-libs 폴더

MobileFirst 제품 컴포넌트 라이브러리와 CLI를 포함합니다.

mfpf-server-libertyapp 폴더

  • scripts 폴더: 이 폴더에는 구성 파일 세트가 포함된 args 폴더가 들어 있습니다. 또한 IBM Cloud에 로그인하고 IBM Cloud에 푸시할 Mobile Foundation 앱을 빌드하며 IBM Cloud에서 서버를 실행하기 위해 실행할 스크립트가 들어 있습니다. 스크립트를 대화식으로 실행하거나 구성 파일을 현상태대로 사전 구성하여 실행할 수 있습니다(나중에 자세히 설명함). 사용자 정의할 수 있는 args/*.properties 파일 외에는 이 폴더의 요소를 수정하지 마십시오. 스크립트 사용법 도움말을 보려면 -h 또는 --help 명령행 인수를 사용하십시오(예: scriptname.sh --help).
  • usr 폴더:
    • config 폴더: MobileFirst Server에서 사용되는 서버 구성 단편(키 저장소, 서버 특성, 사용자 레지스트리)이 들어 있습니다.
    • keystore.xml - SSL 암호화에 사용되는 보안 인증서 저장소의 구성입니다. 나열된 파일을 ./usr/security 폴더에서 참조해야 합니다.
    • mfpfproperties.xml - MobileFirst Server의 구성 특성입니다. 다음 문서 주제에 나열된 지원되는 특성을 참조하십시오.
    • registry.xml - 사용자 레지스트리 구성입니다. basicRegistry(기본 XML 기반 사용자 레지스트리) 구성이 기본값으로 제공됩니다. basicRegistry에 사용할 사용자 이름과 비밀번호를 구성하거나 ldapRegistry를 구성할 수 있습니다.
  • env 폴더: 서버 초기화에 사용되는 환경 특성(server.env)과 사용자 정의 JVM 옵션(jvm.options)이 들어 있습니다.
  • security 폴더: 키 저장소, 신뢰 저장소, LTPA 키 파일(ltpa.keys)을 저장하는 데 사용됩니다.

MobileFirst Server 및 MobileFirst Application Center 설정

스크립트를 대화식으로 또는 구성 파일을 사용하여 실행할 수 있습니다. 스크립트를 대화식으로 한 번 실행하여 시작하는 것이 좋습니다. 그러면 인수도 기록됩니다(recorded-args). 나중에 args 파일을 사용하여 비대화식 모드에서 스크립트를 실행할 수 있습니다.

참고: 비밀번호는 기록되지 않으므로 인수 파일에 수동으로 비밀번호를 추가해야 합니다.

  • 구성 파일 사용 - 스크립트를 실행하고 각 구성 파일을 인수로 전달합니다.
  • 대화식 - 인수 없이 스크립트를 실행합니다.

스크립트를 대화식으로 실행할 경우 구성을 건너뛸 수 있지만 적어도 제공해야 하는 인수에 대해 읽고 이해해야 합니다.

MobileFirst Application Center

참고: 설치 프로그램과 DB 도구는 사내 구축형 MobileFirst Application Center 설치 폴더(installer 및 tools folders)에서 다운로드할 수 있습니다.

args 폴더에는 스크립트를 실행하는 데 필요한 인수가 포함된 구성 파일 세트가 들어 있습니다. args 폴더에서 비어 있는 템플리트 파일과 인수에 대한 설명을 찾거나 recorded-args 폴더에 대화식 스크립트 실행한 후에 게시할 수 있습니다. 파일은 다음과 같습니다.

initenv.properties

이 파일에는 환경 초기화를 실행하는 데 사용되는 특성이 포함되어 있습니다.

prepareappcenterdbs.properties

MobileFirst Application Center에는 외부 dashDB Enterprise Transactional 데이터베이스 인스턴스(OLTP 또는 트랜잭션으로 표시된 모든 플랜)가 필요합니다.
참고: dashDB Enterprise Transactional 플랜의 배치는 "종량과금제"로 표시된 플랜의 경우 즉각적입니다. Enterprise for Transactions High Availability 2.8.500(종량과금제)과 같은 적절한 플랜 중 하나를 선택하십시오.

dashDB 인스턴스를 설정한 후 다음과 같은 필수 인수를 제공하십시오.

prepareappcenter.properties

이 파일은 prepareappcenter.sh 스크립트에 사용됩니다. 이 파일은 Application Center 파일 레이아웃을 준비하여 IBM Cloud에 Cloud Foundry 앱으로 푸시합니다.

startappcenter.properties

이 파일은 서버의 런타임 속성과 시작을 구성합니다. 최소한 1024MB(SERVER_MEM=1024)와 고가용성을 위해 3개의 노드(INSTANCES=3)를 사용해야 합니다.

다음 지시사항은 구성 파일을 사용하여 스크립트를 실행하는 방법을 보여줍니다. 대화식 모드에서 실행하는 데 사용하지 않는 명령행 인수의 목록도 사용 가능합니다.

  1. initenv.sh – IBM Cloud에 로그인
    initenv.sh 스크립트를 실행하여 IBM Cloud에 로그인하십시오. dashDB 서비스가 바인드되는 조직과 영역에 대해 다음을 실행하십시오. 
    ./initenv.sh args/initenv.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    initenv.sh --user IBM_Cloud_user_ID --password IBM_Cloud_password --org IBM_Cloud_organization_name --space IBM_Cloud_space_name
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./initenv.sh --help
  2. prepareappcenterdbs.sh - MobileFirst Application Center 데이터베이스 준비
    prepareappcenterdbs.sh 스크립트는 dashDB 데이터베이스 서비스 또는 액세스 가능한 DB2 데이터베이스 서버를 사용해서 MobileFirst Application Center를 구성하는 데 사용됩니다. DB2 옵션은 특히 DB2 서버가 설치된 동일한 데이터 센터에서 IBM Cloud Local을 실행 중인 경우 사용 가능합니다. dashDB 서비스를 사용하는 경우 1단계에서 로그인한 조직과 영역에서 dashDB 서비스의 서비스 인스턴스를 사용할 수 있어야 합니다. 다음을 실행하십시오. 
    ./prepareappcenterdbs.sh args/prepareappcenterdbs.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    prepareappcenterdbs.sh --acdb MFPAppCenterDashDBService
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./prepareappcenterdbs.sh --help
  3. initenv.sh(선택사항) – IBM Cloud에 로그인
    이 단계는 dashDB 서비스 인스턴스를 사용할 수 있는 조직과 영역 이외의 조직과 영역에서 서버를 작성해야 하는 경우에만 필수입니다. 값이 예인 경우에는 컨테이너가 작성되고 시작되어야 하는 새 조직과 영역으로 initenv.properties를 업데이트하고 initenv.sh 스크립트를 다시 실행하십시오. 
    ./initenv.sh args/initenv.properties
  4. prepareappcenter.sh - MobileFirst Application Center 준비
    MobileFirst Application Center를 빌드하여 IBM Cloud에 Cloud Foundry 애플리케이션으로 푸시하려면 prepareappcenter.sh 스크립트를 실행하십시오. 로그인한 조직과 영역에서 모든 Cloud Foundry 애플리케이션과 해당 URL을 보려면 cf apps를 실행하십시오.
    ./prepareappcenter.sh args/prepareappcenter.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    prepareappcenter.sh --name APP_NAME
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./prepareappcenter.sh --help
  5. startappcenter.sh - MobileFirst Application Center 시작
    startappcenter.sh 스크립트는 Liberty for Java Cloud Foundry 애플리케이션에서 MobileFirst Application Center를 시작하는 데 사용됩니다. 다음을 실행하십시오.

    ./startappcenter.sh args/startappcenter.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    ./startappcenter.sh --name APP_NAME
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./startappcenter.sh --help

MobileFirst Application Center 콘솔을 실행하려면 URL http://APP_HOST.mybluemix.net/appcenterconsole 을 로드하십시오. 실행하는 데 몇 분 정도 걸릴 수 있습니다.

IBM Cloud에서 MobileFirst Application Center가 실행되면 이제 모바일 앱을 Application Center로 업로드할 수 있습니다.

MobileFirst Server

args 폴더에는 스크립트를 실행하는 데 필요한 인수가 포함된 구성 파일 세트가 들어 있습니다. args 폴더에서 비어 있는 템플리트 파일과 인수에 대한 설명을 찾거나 recorded-args 폴더에 대화식 스크립트 실행한 후에 게시할 수 있습니다. 파일은 다음과 같습니다.

initenv.properties

이 파일에는 환경 초기화를 실행하는 데 사용되는 특성이 포함되어 있습니다.

prepareserverdbs.properties

Mobile Foundation 서비스에는 외부 dashDB Enterprise Transactional 데이터베이스 인스턴스(OLTP 또는 트랜잭션으로 표시된 모든 플랜)가 필요합니다.
참고: dashDB Enterprise Transactional 플랜의 배치는 "종량과금제"로 표시된 플랜의 경우 즉각적입니다. Enterprise for Transactions High Availability 2.8.500(종량과금제)과 같은 적절한 플랜 중 하나를 선택하십시오.

dashDB 인스턴스를 설정한 후 다음과 같은 필수 인수를 제공하십시오.

prepareserver.properties

이 파일은 prepareserver.sh 스크립트에 사용됩니다. 이 파일은 서버 파일 레이아웃을 준비하여 IBM Cloud에 Cloud Foundry 앱으로 푸시합니다.

startserver.properties

이 파일은 서버의 런타임 속성과 시작을 구성합니다. 최소한 1024MB(SERVER_MEM=1024)와 고가용성을 위해 3개의 노드(INSTANCES=3)를 사용해야 합니다.

다음 지시사항은 구성 파일을 사용하여 스크립트를 실행하는 방법을 보여줍니다. 대화식 모드에서 실행하는 데 사용하지 않는 명령행 인수의 목록도 사용 가능합니다.

  1. initenv.sh – IBM Cloud에 로그인
    initenv.sh 스크립트를 실행하여 IBM Cloud에 로그인하십시오. dashDB 서비스가 바인드되는 조직과 영역에 대해 다음을 실행하십시오. 
    ./initenv.sh args/initenv.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    initenv.sh --user IBM_Cloud_user_ID --password IBM_Cloud_password --org IBM_Cloud_organization_name --space IBM_Cloud_space_name
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./initenv.sh --help
  2. prepareserverdbs.sh - MobileFirst Server 데이터베이스 준비
    prepareserverdbs.sh 스크립트는 dashDB 데이터베이스 서비스 또는 액세스 가능한 DB2 데이터베이스 서버를 사용해서 MobileFirst Server를 구성하는 데 사용됩니다. DB2 옵션은 특히 DB2 서버가 설치된 동일한 데이터 센터에서 IBM Cloud Local을 실행 중인 경우 사용 가능합니다. dashDB 서비스를 사용하는 경우 1단계에서 로그인한 조직과 영역에서 dashDB 서비스의 서비스 인스턴스를 사용할 수 있어야 합니다. 다음을 실행하십시오. 
    ./prepareserverdbs.sh args/prepareserverdbs.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    prepareserverdbs.sh --admindb MFPDashDBService
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./prepareserverdbs.sh --help
  3. initenv.sh(선택사항) – IBM Cloud에 로그인
    이 단계는 dashDB 서비스 인스턴스를 사용할 수 있는 조직과 영역 이외의 조직과 영역에서 서버를 작성해야 하는 경우에만 필수입니다. 값이 예인 경우에는 컨테이너가 작성되고 시작되어야 하는 새 조직과 영역으로 initenv.properties를 업데이트하고 initenv.sh 스크립트를 다시 실행하십시오. 
    ./initenv.sh args/initenv.properties
  4. prepareserver.sh - MobileFirst Server 준비
    MobileFirst Server를 빌드하여 IBM Cloud에 Cloud Foundry 애플리케이션으로 푸시하려면 prepareappcenter.sh 스크립트를 실행하십시오. 로그인한 조직과 영역에서 모든 Cloud Foundry 애플리케이션과 해당 URL을 보려면 cf apps를 실행하십시오.
    ./prepareserver.sh args/prepareserver.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    prepareserver.sh --name APP_NAME
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./prepareserver.sh --help
  5. startserver.sh - 서버 시작
    startserver.sh 스크립트는 Liberty for Java Cloud Foundry 애플리케이션에서 MobileFirst Server를 시작하는 데 사용됩니다. 다음을 실행하십시오.

    ./startserver.sh args/startserver.properties
    명령행에 매개변수를 전달할 수도 있습니다. 
    ./startserver.sh --name APP_NAME
    지원되는 모든 매개변수와 해당 문서에 대해 자세히 알아보려면 도움말 옵션을 실행하십시오. 
    ./startserver.sh --help

http://APP_HOST.mybluemix.net/mfpconsole URL을 로드하여 MobileFirst Operations Console을 실행하십시오. 실행하는 데 몇 분 정도 걸릴 수 있습니다.
MobileFirst CLI를 사용하여 MobileFirst 아티팩트 관리 학습서의 지시사항을 수행하여 원격 서버를 추가하십시오.

IBM Cloud에서 MobileFirst Server가 실행되면 애플리케이션 개발을 시작할 수 있습니다.

변경사항 적용

서버를 배치한 후 서버 레이아웃에 변경사항을 적용해야 할 수 있습니다. 예를 들면, /usr/config/mfpfproperties.xml에서 Analytics URL을 업데이트할 수 있습니다. 변경한 후 동일한 인수 세트를 사용해서 다음 스크립트를 다시 실행하십시오.

  1. ./prepareserver.sh
  2. ./startserver.sh

MobileFirst Server에 Analytics Server 구성 추가

Analytics Server를 설정했으며 이를 이 MobileFirst Server에 연결하려는 경우에는 아래에 지정된 것처럼 package_root/mfpf-server-libertyapp/usr/config 폴더에 있는 mfpfproperties.xml 파일을 편집하십시오. 배치에서 올바른 값으로 <> 표시가 있는 토큰을 대체하십시오.

<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.url" value='"https://<AnalyticsContainerGroupRoute>:443/analytics-service/rest"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.console.url" value='"https://<AnalyticsContainerPublicRoute>:443/analytics/console"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.username" value='"<AnalyticsUserName>"'/>
<jndiEntry jndiName="${env.MFPF_RUNTIME_ROOT}/mfp.analytics.password" value='"<AnalyticsPassword>"'/>


<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.endpoint" value='"https://<AnalyticsContainerGroupRoute>:443/analytics-service/rest"'/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.services.ext.analytics" value="com.ibm.mfp.push.server.analytics.plugin.AnalyticsPlugin"/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.user" value='"<AnalyticsUserName>"'/>
<jndiEntry jndiName="${env.MFPF_PUSH_ROOT}/mfp.push.analytics.password" value='"<AnalyticsPassword>"'/>

MobileFirst Server 수정사항 적용

IBM Fix Central에서 MobileFirst Serveron IBM Cloud에 대한 임시 수정사항을 얻을 수 있습니다.
임시 수정사항을 적용하기 전에 기존 구성 파일을 백업하십시오. 구성 파일은 다음 폴더에 있습니다.

  • MobileFirst Analytics: package_root/mfpf-analytics/usr
  • MobileFirst Server Liberty Cloud Foundry 애플리케이션: package_root/mfpf-server-libertyapp/usr
  • Application Center: package_root/mfp-appcenter-libertyapp/usr

iFix 적용 단계:

  1. 임시 수정사항 아카이브를 다운로드하고 기존 설치 폴더에 컨텐츠의 압축을 풀어 기존 파일을 겹쳐쓰십시오.
  2. 백업한 구성 파일을 package_root/mfpf-analytics/usr, package_root/mfpf-server-libertyapp/usr 및 package_root/mfp-appcenter-libertyapp/usr 폴더에 복원하여 새로 설치된 구성 파일을 겹쳐쓰십시오.
  3. 편집기에서 package_root/mfpf-server/usr/env/jvm.options 파일을 편집하고 다음 행이 있는 경우 제거하십시오. 
    -javaagent:/opt/ibm/wlp/usr/servers/mfp/newrelic/newrelic.jar

    이제 업데이트된 서버를 빌드하고 배치할 수 있습니다. 동일한 인수 세트를 사용해서 다음 스크립트를 다시 실행하십시오.

    a. 업데이트된 아티팩트를 IBM Cloud로 업로드하려면 ./prepareserver.sh를 실행하십시오.

    b. 업데이트된 서버를 시작하려면 ./startserver.sh를 실행하십시오.

    이전 배치에서 사용한 인수 사본은 recorded-args/ 디렉토리에 저장되었습니다. 배치에 이러한 특성을 사용할 수 있습니다.

IBM Cloud에서 데이터베이스 서비스 구성 제거

MobileFirst Server 이미지 구성 중에 prepareserverdbs.sh 스크립트를 실행한 경우 MobileFirst Server에 필요한 구성과 데이터베이스 테이블이 작성됩니다. 이 스크립트는 MobileFirst Server의 데이터베이스 스키마도 작성합니다.

IBM Cloud에서 데이터베이스 서비스 구성을 제거하려면 IBM Cloud 대시보드를 사용하여 다음 프로시저를 수행하십시오.

  1. IBM Cloud 대시보드에서 사용한 dashDB 서비스를 선택하십시오. prepareserverdbs.sh 스크립트를 실행하는 동안 매개변수로 제공한 dashDB 서비스 이름을 선택하십시오.
  2. dashDB 콘솔을 실행하여 선택한 dashDB 서비스 인스턴스의 스키마와 데이터베이스 오브젝트에 대한 작업을 수행하십시오.
  3. IBM MobileFirst Server 구성과 관련된 스키마를 선택하십시오. 스키마 이름은 prepareserverdbs.sh 스크립트를 실행하는 동안 매개변수로 제공한 이름입니다.
  4. 스키마 이름과 그 아래의 오브젝트를 신중히 검사한 후 각 스키마를 삭제하십시오. IBM Cloud에서 데이터베이스 구성이 제거됩니다.

마찬가지로 MobileFirst Application Center 구성 중에 prepareappcenterdbs.sh를 실행한 경우에도 위 단계에 따라 IBM Cloud에서 데이터베이스 서비스 구성을 제거하십시오.

▲
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