설치 참조

개요

IBM MobileFirst Foundation Server, IBM MobileFirst Foundation Application Center 및 IBM MobileFirst Foundation Operational Analytics의 설치에 필요한 Ant 태스크 및 구성 샘플 파일에 대한 참조 정보입니다.

다음으로 이동

• Ant configuredatabase 태스크 참조
• MobileFirst Operations Console, MobileFirst Server 아티팩트, MobileFirst Server 관리 및 라이브 업데이트 서비스 설치를 위한 Ant 태스크
• MobileFirst Server 푸시 서비스 설치를 위한 Ant 태스크
• MobileFirst 런타임 환경 설치를 위한 Ant 태스크
• Application Center 설치를 위한 Ant 태스크
• MobileFirst Analytics 설치를 위한 Ant 태스크
• 내부 런타임 데이터베이스
• 샘플 구성 파일
• MobileFirst Analytics에 대한 샘플 구성 파일

Ant configuredatabase 태스크 참조

configuredatabase Ant 태스크에 대한 참조 정보입니다. 이 참조 정보는 관계형 데이터베이스에만 해당됩니다. Cloudant에는 적용되지 않습니다.

configuredatabase Ant 태스크는 MobileFirst Server 관리 서비스, MobileFirst Server 라이브 업데이트 서비스, MobileFirst Server 푸시 서비스, MobileFirst 런타임 및 Application Center 서비스에서 사용하는 관계형 데이터베이스를 작성합니다. 이 Ant 태스크는 다음과 같은 조치를 통해 관계형 데이터베이스를 구성합니다.

• MobileFirst 테이블이 있는지 확인하여 필요한 경우 해당 테이블을 작성합니다.
• Mobile Foundation의 이전 버전에 대해 해당 테이블이 존재하는 경우에는 해당 테이블을 현재 버전으로 마이그레이션합니다.
• Mobile Foundation의 현재 버전에 대해 해당 테이블이 존재하는 경우에는 아무것도 수행하지 않습니다.

또한 다음 조건 중 하나가 충족되는 경우:

• DBMS 유형이 Derby입니다.
• <dba> 내부 요소가 있습니다.
• DBMS 유형이 DB2이고 지정된 사용자에게 데이터베이스를 작성할 수 있는 권한이 있습니다.

이 태스크는 다음과 같은 영향을 미칠 수 있습니다.

• 필요한 경우 데이터베이스를 작성하십시오(Oracle 12c 및 Cloudant의 경우는 제외).
• 사용자를 작성하고 필요한 경우 해당 사용자에게 데이터베이스에 대한 액세스 권한을 부여하십시오.

참고: Cloudant와 함께 사용하는 경우 configuredatabase Ant 태스크는 영향을 미치지 않습니다.

configuredatabase 태스크에 대한 속성 및 요소

configuredatabase 태스크는 다음과 같은 속성을 가지고 있습니다.

kind

Mobile Foundation은 네 가지 유형의 데이터베이스를 지원합니다. MobileFirst 런타임은 MobileFirstRuntime 데이터베이스를 사용합니다. MobileFirst Server 관리 서비스는 MobileFirstAdmin 데이터베이스를 사용합니다. MobileFirst Server 라이브 업데이트 서비스는 MobileFirstConfig 데이터베이스를 사용합니다. 기본적으로 이는 MobileFirstAdmin 유형을 사용하여 작성됩니다. MobileFirst Server 푸시 서비스는 push 데이터베이스를 사용합니다. Application Center는 ApplicationCenter 데이터베이스를 사용합니다.

includeConfigurationTables

includeConfigurationTables 속성은 kind 속성이 MobileFirstAdmin인 경우에만 사용할 수 있습니다. 올바른 값은 true 또는 false입니다. 이 속성이 true로 설정되면 configuredatabase 태스크는 하나의 실행으로 관리 서비스 데이터베이스와 라이브 업데이트 서비스 데이터베이스 모두에서 데이터베이스 조작을 수행합니다. 이 속성이 false로 설정되면 configuredatabase 태스크는 관리 서비스 데이터베이스에서만 데이터베이스 조작을 수행합니다.

execute

execute 속성은 configuredatabase Ant 태스크의 실행을 사용 또는 사용 안함으로 설정합니다. 올바른 값은 true 또는 false입니다. 이 속성이 false로 설정되면 configuredatabase 태스크는 구성 또는 데이터베이스 조작을 수행하지 않습니다.

configuredatabase 태스크는 다음과 같은 요소를 지원합니다.

각 데이터베이스 유형에 대해 <property> 요소를 사용하여 데이터베이스에 액세스하는 데 필요한 JDBC 연결 특성을 지정할 수 있습니다. <property> 요소에는 다음 속성이 있습니다.

Apache Derby

<derby> 요소에는 다음 속성이 있습니다.

<derby> 요소는 다음 속성을 지원합니다.

사용 가능한 특성은 데이터베이스 연결 URL의 속성 설정을 참조하십시오.

DB2

<db2> 요소에는 다음 속성이 있습니다.

DB2 사용자 계정에 대한 자세한 정보는 DB2 보안 모델 개요를 참조하십시오.
<db2> 요소는 다음 요소를 지원합니다.

사용 가능한 특성은 IBM Data Server Driver for JDBC and SQLJ에 대한 특성을 참조하십시오.
<dba> 내부 요소는 데이터베이스 관리자의 인증 정보를 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<dba> 요소에 지정된 사용자는 SYSADM 또는 SYSCTRL DB2 권한이 있어야 합니다. 자세한 정보는 권한 개요를 참조하십시오.

<driverclasspath> 요소는 DB2 JDBC 드라이버 및 연관된 라이센스의 JAR 파일을 포함해야 합니다. 다음 방법 중 하나로 해당 파일을 검색할 수 있습니다.

• DB2 JDBC 드라이버 버전 페이지에서 DB2 JDBC 드라이버 다운로드
• 또는 DB2 서버의 DB2INSTALL_DIR/java** 디렉토리에서 **db2jcc4.jar** 파일 및 관련 **db2jcc_license*.jar 파일을 페치하십시오.

Ant 태스크를 사용하여 테이블스페이스 등의 테이블 할당에 대한 세부사항을 지정할 수 없습니다. 테이블스페이스를 제어하려면 DB2 데이터베이스 및 사용자 요구사항 절에 있는 수동 지시사항을 사용해야 합니다.

MySQL

<mysql> 요소에는 다음 속성이 있습니다.

MySQL 사용자 계정에 대한 자세한 정보는 MySQL 사용자 계정 관리를 참조하십시오.
<mysql> 요소는 다음 요소를 지원합니다.

사용 가능한 특성은 Connector/J에 대한 드라이버/데이터 소스 클래스 이름, URL 구문 및 구성 특성을 참조하십시오.
<dba> 내부 요소는 데이터베이스 관리자 인증 정보를 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<dba> 요소에 지정된 사용자는 MySQL 수퍼유저 계정이어야 합니다. 자세한 정보는 초기 MySQL 계정 보호를 참조하십시오.

각 <client> 내부 요소는 클라이언트 컴퓨터 또는 클라이언트 컴퓨터의 와일드카드를 지정합니다. 이 컴퓨터는 데이터베이스에 연결할 수 있습니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

hostname 구문에 대한 자세한 정보는 계정 이름 지정을 참조하십시오.

<driverclasspath> 요소는 MySQL Connector/J JAR 파일을 포함해야 합니다. Connector/J 다운로드 페이지에서 해당 파일을 다운로드할 수 있습니다.

또는 다음 속성이 있는 <mysql> 요소를 사용할 수 있습니다.

참고: 대체 속성을 사용하여 데이터베이스를 지정하는 경우에는 이 데이터베이스가 존재해야 하고 사용자 계정이 존재해야 하고 사용자가 이미 데이터베이스에 액세스할 수 있어야 합니다. 이 경우 configuredatabase 태스크는 데이터베이스 또는 사용자 작성을 시도하지 않고 사용자에 대한 액세스 권한 부여도 시도하지 않습니다. configuredatabase 태스크는 데이터베이스에 현재 MobileFirst Server 버전에 대한 필수 테이블이 있는지만 확인합니다. <dba> 또는 <client> 내부 요소를 지정하지 않아도 됩니다.

Oracle

<oracle> 요소에는 다음 속성이 있습니다.

참고: user 속성의 경우 대문자로 된 사용자 이름을 사용하는 것이 좋습니다. Oracle 사용자 이름은 일반적으로 대문자입니다. 다른 데이터베이스 도구와 달리 configuredatabase Ant 태스크는 사용자 이름의 소문자를 대문자로 변환하지 않습니다. configuredatabase Ant 태스크가 데이터베이스에 연결하는 데 실패하면 user 속성에 대한 값을 대문자로 입력하십시오.

Oracle 사용자 계정에 대한 자세한 정보는 인증 방법 개요를 참조하십시오.
<oracle> 요소는 다음 요소를 지원합니다.

사용 가능한 연결 특성에 대한 정보는 클래스 OracleDriver를 참조하십시오.
<dba> 내부 요소는 데이터베이스 관리자 인증 정보를 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<driverclasspath> 요소는 Oracle JDBC 드라이버 JAR 파일을 포함해야 합니다. JDBC, SQLJ, Oracle JPublisher 및 UCP(Universal Connection Pool)에서 Oracle JDBC 드라이버를 다운로드할 수 있습니다.

Ant 태스크를 사용하여 테이블스페이스 등의 테이블 할당에 대한 세부사항을 지정할 수 없습니다. 테이블스페이스를 제어하려면 Ant 태스크를 실행하기 전에 수동으로 사용자 계정을 작성하여 이 사용자 계정에 기본 테이블스페이스를 지정하십시오. 기타 세부사항을 제어하려면 Oracle 데이터베이스 및 사용자 요구사항 절에 있는 수동 지시사항을 사용해야 합니다.

참고: 대체 속성을 사용하여 데이터베이스를 지정하는 경우에는 이 데이터베이스가 존재해야 하고 사용자 계정이 존재해야 하고 사용자가 이미 데이터베이스에 액세스할 수 있어야 합니다. 이 경우 태스크는 데이터베이스 또는 사용자 작성을 시도하지 않고 사용자에 대한 액세스 권한 부여도 시도하지 않습니다. configuredatabase 태스크는 데이터베이스에 현재 MobileFirst Server 버전에 대한 필수 테이블이 있는지만 확인합니다. 내부 요소 <dba>를 지정하지 않아도 됩니다.

MobileFirst Operations Console, MobileFirst Server 아티팩트, MobileFirst Server 관리 및 라이브 업데이트 서비스 설치를 위한 Ant 태스크

installmobilefirstadmin, updatemobilefirstadmin 및 uninstallmobilefirstadmin Ant 태스크는 MobileFirst Operations Console, 아티팩트 컴포넌트, 관리 서비스 및 라이브 업데이트 서비스 설치를 위해 제공됩니다.

태스크 영향

installmobilefirstadmin

installmobilefirstadmin Ant 태스크는 관리 및 라이브 업데이트 서비스의 WAR 파일을 웹 애플리케이션으로 실행하고 선택적으로 MobileFirst Operations Console을 설치하도록 애플리케이션 서버를 구성합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 지정된 컨텍스트 루트(기본값 /mfpadmin)에서 관리 서비스 웹 애플리케이션을 선언합니다.
• 관리 서비스의 지정된 컨텍스트 루트에서 파생된 컨텍스트 루트에서 라이브 업데이트 서비스 웹 애플리케이션을 선언합니다. 기본값은 /mfpadminconfig입니다.
• 관계형 데이터베이스의 경우 데이터 소스를 선언하며 WebSphere Application Server 전체 프로파일에서는 관리 서비스에 대한 JDBC 제공자를 선언합니다.
• 관리 서비스 및 라이브 업데이트 서비스를 애플리케이션 서버에 배치합니다.
• 선택적으로 지정된 컨텍스트 루트(기본값은 /mfpconsole)에서 MobileFirst Operations Console을 웹 애플리케이션으로 선언합니다. MobileFirst Operations Console 인스턴스가 지정된 경우 Ant 태스크는 해당 관리 서비스와 통신하기 위해 적절한 JNDI 환경 항목을 선언합니다. 예를 들어, 다음과 같습니다.

<target name="adminstall">
  <installmobilefirstadmin servicewar="${mfp.service.war.file}">
    <console install="${mfp.admin.console.install}" warFile="${mfp.console.war.file}"/>

• 선택적으로 MobileFirst Operations Console이 설치된 경우 지정된 컨텍스트 루트 /mfp-dev-artifacts에서 MobileFirst Server 아티팩트 웹 애플리케이션을 선언합니다.
• JNDI 환경 항목을 사용하여 관리 서비스에 대한 구성 특성을 구성합니다. 이 JNDI 환경 항목은 애플리케이션 서버 토폴로지에 대한 일부 추가 정보도 제공합니다(예: 해당 토폴로지가 독립형 구성, 클러스터 또는 서버 팜인지 여부).
• 선택적으로 MobileFirst Operations Console과 관리 및 라이브 업데이트 서비스 웹 애플리케이션에서 사용하는 역할에 맵핑되는 사용자를 구성합니다.
• JMX 사용을 위해 애플리케이션 서버를 구성합니다.
• 선택적으로 MobileFirst Server 푸시 서비스와의 통신을 구성합니다.
• 선택적으로 MobileFirst JNDI 환경 항목을 설정하여 애플리케이션 서버를 MobileFirst Server 관리 파트의 서버 팜 멤버로 구성합니다.

updatemobilefirstadmin

updatemobilefirstadmin Ant 태스크는 애플리케이션 서버에서 이미 구성된 MobileFirst Server 웹 애플리케이션을 업데이트합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 관리 서비스 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.
• 라이브 업데이트 서비스 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.
• MobileFirst Operations Console WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다. 이 태스크는 웹 애플리케이션 구성, 데이터 소스, JNDI 환경 항목, 사용자 대 역할 맵핑 및 JMX 구성 등의 애플리케이션 서버 구성을 변경하지 않습니다.

uninstallmobilefirstadmin

uninstallmobilefirstadmin Ant 태스크는 installmobilefirstadmin의 이전 실행의 영향을 실행 취소합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 지정된 컨텍스트 루트를 가진 관리 서비스 웹 애플리케이션의 구성을 제거합니다. 그 결과 이 태스크는 해당 애플리케이션에 수동으로 추가된 설정도 제거합니다.
• MobileFirst Operations Console과 관리 및 라이브 업데이트 서비스의 WAR 파일을 옵션으로 애플리케이션 서버에서 제거합니다.
• 관계형 DBMS의 경우 데이터 소스를 제거하며 WebSphere Application Server 전체 프로파일에서는 관리 및 라이브 업데이트 서비스에 대한 JDBC 제공자를 제거합니다.
• 관계형 DBMS의 경우 관리 및 라이브 업데이트 서비스에서 사용한 데이터베이스 드라이버를 애플리케이션 서버에서 제거합니다.
• 연관된 JNDI 환경 항목을 제거합니다.
• WebSphere Application Server Liberty 및 Apache Tomcat의 경우 installmobilefirstadmin 호출에 의해 구성된 사용자를 제거합니다.
• JMX 구성을 제거합니다.

속성 및 요소

installmobilefirstadmin, updatemobilefirstadmin 및 uninstallmobilefirstadmin Ant 태스크는 다음과 같은 속성을 가지고 있습니다.

contextroot 및 id

contextroot 및 id 속성은 MobileFirst Operations Console 및 관리 서비스의 다른 배치를 구별합니다.

WebSphere Application Server Liberty 프로파일 및 Tomcat 환경에서는 contextroot 매개변수로도 이 용도를 충족합니다. WebSphere Application Server 전체 프로파일 환경에서는 id 속성이 대신 사용됩니다. 이 id 속성이 없으면 컨텍스트 루트가 동일한 두 개의 WAR 파일이 충돌하여 이들 파일이 배치되지 않습니다.

environmentId

독립적으로 작동해야 하는 MobileFirst Server 관리 서비스 및 MobileFirst 런타임 웹 애플리케이션으로 각각 구성된 여러 환경을 구별하려면 environmentId 속성을 사용하십시오. 예를 들어, 이 옵션을 사용하면 동일한 서버 또는 동일한 WebSphere Application Server Network Deployment 셀에서 테스트 환경, 사전 프로덕션 환경 및 프로덕션 환경을 호스팅할 수 있습니다. 이 environmentId 속성은 관리 서비스 및 MobileFirst 런타임 프로젝트가 JMX(Java Management Extensions)를 통해 통신할 때 사용하는 MBean 이름에 추가되는 접미부를 작성합니다.

servicewar

관리 서비스 WAR 파일에 대해 다른 디렉토리를 지정하려면 servicewar 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

shortcutsDir

shortcutsDir 속성은 MobileFirst Operations Console에 대한 바로 가기를 배치할 위치를 지정합니다. 이 속성을 설정하는 경우에는 다음과 같은 파일을 해당 디렉토리에 추가할 수 있습니다.

• mobilefirst-console.url - 이 파일은 Windows 바로 가기입니다. 이 파일은 브라우저에서 MobileFirst Operations Console을 엽니다.
• mobilefirst-console.sh- 이 파일은 UNIX 쉘 스크립트이며 브라우저에서 MobileFirst Operations Console을 엽니다.
• mobilefirst-admin-service.url - 이 파일은 Windows 바로 가기입니다. 이 파일은 브라우저에서 열리며 JSON 형식으로 관리될 수 있는 MobileFirst 프로젝트의 목록을 리턴하는 REST 서비스를 호출합니다. 나열된 각각의 MobileFirst 프로젝트에 대해 해당 아티팩트에 대한 일부 세부사항(예: 애플리케이션 수, 어댑터 수, 활성 디바이스 수, 해제된 디바이스 수)도 확인할 수 있습니다. 목록에는 MobileFirst 프로젝트 런타임이 실행 중인지 아니면 유휴 상태인지도 표시됩니다.
• mobilefirst-admin-service.sh - 이 파일은 mobilefirst-admin-service.url 파일과 동일한 출력을 제공하는 UNIX 쉘 스크립트입니다.

wasStartingWeight

WebSphere Application Server에서 사용되는 값을 가중치로 지정하여 시작 순서를 존중하게 하려면 wasStartingWeight 속성을 사용하십시오. 시작 순서 값의 결과로 다른 MobileFirst 런타임 프로젝트보다 먼저 관리 서비스 웹 애플리케이션이 배치되고 시작됩니다. 웹 애플리케이션보다 먼저 MobileFirst 프로젝트가 배치되거나 시작되면 JMX 통신이 설정되지 않고 런타임이 관리 서비스 데이터베이스와 동기화할 수 없어 서버 요청을 처리할 수 없습니다.

installmobilefirstadmin, updatemobilefirstadmin 및 uninstallmobilefirstadmin Ant 태스크는 다음과 같은 요소를 지원합니다.

MobileFirst Operations Console 지정

<console> 요소는 MobileFirst Operations Console의 설치를 사용자 정의하기 위한 정보를 수집합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<console> 요소는 다음 속성을 지원합니다.

<artifacts> 요소에는 다음 속성이 있습니다.

이 요소를 사용하면 자체 JNDI 특성을 정의하거나 MobileFirst Operations Console WAR 파일 및 관리 서비스에서 제공하는 JNDI 특성의 기본값을 대체할 수 있습니다.

<property> 요소는 애플리케이션 서버에서 정의할 배치 특성을 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

이 요소를 사용하면 자체 JNDI 특성을 정의하거나 MobileFirst Operations Console WAR 파일 및 관리 서비스에서 제공하는 JNDI 특성의 기본값을 대체할 수 있습니다.

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

애플리케이션 서버 지정

<applicationserver> 요소를 사용하여 기본 애플리케이션 서버에 따라 달라지는 매개변수를 정의하십시오. <applicationserver> 요소는 다음 요소를 지원합니다.

이 요소의 속성 및 내부 요소가 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블에 설명되어 있습니다.
그러나 Liberty Collective에 대한 <was> 요소의 내부 요소는 다음 테이블을 참조하십시오.

<collectiveController> 요소에는 다음 속성이 있습니다.

라이브 업데이트 서비스 구성 지정

<configuration> 요소를 사용하여 라이브 업데이트 서비스에 따라 달라지는 매개변수를 정의하십시오. <configuration> 요소에는 다음 속성이 있습니다.

<configuration> 요소는 다음 요소를 지원합니다.

<user> 요소는 애플리케이션의 특정 보안 역할에 포함할 사용자에 대한 매개변수를 수집합니다.

<user> 요소를 사용하여 사용자를 정의한 다음 MobileFirst Operations Console에서 인증을 위해 configadmin 역할에 해당 사용자를 맵핑할 수 있습니다.

특정 역할이 의미하는 권한에 대한 자세한 정보는 MobileFirst Server 관리에 대한 사용자 인증 구성을 참조하십시오.

팁: 사용자가 외부 LDAP 디렉토리에 있는 경우에는 role 및 name 속성만 설정하고 비밀번호는 정의하지 마십시오.

<property> 요소는 애플리케이션 서버에서 정의할 배치 특성을 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

이 요소를 사용하면 자체 JNDI 특성을 정의하거나 MobileFirst Operations Console WAR 파일 및 관리 서비스에서 제공하는 JNDI 특성의 기본값을 대체할 수 있습니다. JNDI 특성에 대한 자세한 정보는 MobileFirst Server 관리 서비스의 JNDI 특성 목록을 참조하십시오.

애플리케이션 서버 지정

<applicationserver> 요소를 사용하여 기본 애플리케이션 서버에 따라 달라지는 매개변수를 정의하십시오. <applicationserver> 요소는 다음 요소를 지원합니다.

이 요소의 속성 및 내부 요소가 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블에 설명되어 있습니다.
하지만 Liberty Collective에 대한 요소의 내부 요소에 대해서는 다음 테이블을 참조하십시오.

<collectiveMember> 요소에는 다음 속성이 있습니다.

참고: 푸시 서비스와 런타임 컴포넌트가 동일한 Collective 멤버에 설치되는 경우 이들은 동일한 클러스터 이름을 가지고 있어야 합니다. 이 컴포넌트가 동일한 Collective의 구별되는 멤버에 설치되는 경우 클러스터 이름은 다를 수 있습니다.

Analytics 지정

<analytics> 요소는 MobileFirst 푸시 서비스를 이미 설치된 MobileFirst Analytics 서비스에 연결하려 함을 나타냅니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

install
이 푸시 서비스가 연결되어야 하고 이벤트를 MobileFirst Analytics에 전송해야 함을 표시하려면 install 속성을 사용하십시오. 올바른 값은 true 또는 false입니다.

analyticsURL
수신되는 Analytics 데이터를 수신하는 MobileFirst Analytics에 의해 노출되는 URL을 지정하려면 analyticsURL 속성을 사용하십시오.

예를 들어, http://<hostname>:<port>/analytics-service/rest입니다.

username
MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 사용자 이름을 지정하려면 username 속성을 사용하십시오.

비밀번호
MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 비밀번호를 지정하려면 password 속성을 사용하십시오.

validate
MobileFirst Analytics Console에 액세스 가능한지 여부를 유효성 검증하고 비밀번호를 사용하여 사용자 이름 인증을 확인하려면 validate 속성을 사용하십시오. 가능한 값은 true 또는 false입니다.

푸시 서비스 데이터베이스에 대한 연결 지정

<database> 요소는 애플리케이션 서버에서 데이터 소스 선언을 지정하는 매개변수를 수집하여 푸시 서비스 데이터베이스에 액세스합니다.

단일 데이터베이스를 선언해야 합니다: <database kind="Push">. <database> 요소에 <dba> 및 <client> 요소가 없음을 제외하고 configuredatabase Ant와 유사하게 <database> 요소를 지정합니다. 여기에는 <property> 요소가 있을 수 있습니다.

<database> 요소에는 다음 속성이 있습니다.

<database> 요소는 다음 요소를 지원합니다. 관계형 DBMS에 대한 이 데이터베이스 요소의 구성에 대한 자세한 정보는 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블을 참조하십시오.

참고: <cloudant> 요소의 속성은 런타임과 약간 다릅니다. 자세한 정보는 다음 테이블을 참조하십시오.

MobileFirst Server 푸시 서비스 설치를 위한 Ant 태스크

installmobilefirstpush, updatemobilefirstpush 및 uninstallmobilefirstpush Ant 태스크는 푸시 서비스 설치를 위해 제공됩니다.

태스크 영향

installmobilefirstpush

installmobilefirstpush Ant 태스크는 푸시 서비스 WAR 파일을 웹 애플리케이션으로 실행하도록 애플리케이션 서버를 구성합합니다. 이 태스크는 다음과 같은 영향을 미칩니다. /imfpush 컨텍스트 루트에서 푸시 서비스 웹 애플리케이션을 선언합니다. 컨텍스트 루트는 변경할 수 없습니다. 관계형 데이터베이스의 경우 데이터 소스를 선언하며 WebSphere Application Server 전체 프로파일에서는 푸시 서비스에 대한 JDBC 제공자를 선언합니다. JNDI 환경 항목을 사용하여 푸시 서비스에 대한 구성 특성을 구성합니다. 이 JNDI 환경 항목은 MobileFirst 권한 부여 서버 및 MobileFirst Analytics와의 OAuth 통신(Cloudant가 사용되는 경우에는 Cloudant와의 OAuth 통신)을 구성합니다.

updatemobilefirstpush

updatemobilefirstpush Ant 태스크는 애플리케이션 서버에서 이미 구성된 MobileFirst Server 웹 애플리케이션을 업데이트합니다. 이 태스크는 푸시 서비스 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.

uninstallmobilefirstpush

uninstallmobilefirstpush Ant 태스크는 이전 installmobilefirstpush 실행의 영향을 실행 취소합니다. 이 태스크는 다음과 같은 영향을 미칩니다. 지정된 컨텍스트 루트를 가진 푸시 서비스 웹 애플리케이션의 구성을 제거합니다. 그 결과 이 태스크는 해당 애플리케이션에 수동으로 추가된 설정도 제거합니다. 옵션으로 애플리케이션 서버에서 푸시 서비스 WAR 파일을 제거합니다. 관계형 DBMS의 경우 데이터 소스를 제거하며 WebSphere Application Server 전체 프로파일에서는 푸시 서비스에 대한 JDBC 제공자를 제거합니다. 연관된 JNDI 환경 항목을 제거합니다.

속성 및 요소

installmobilefirstpush, updatemobilefirstpush 및 uninstallmobilefirstpush Ant 태스크는 다음과 같은 속성을 가지고 있습니다.

Id

id 속성은 동일한 WebSphere Application Server 셀에서 푸시 서비스의 서로 다른 배치를 구별합니다. 이 id 속성이 없으면 컨텍스트 루트가 동일한 두 개의 WAR 파일이 충돌하여 이들 파일이 배치되지 않습니다.

warFile

푸시 서비스 WAR 파일에 대해 다른 디렉토리를 지정하려면 warFile 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

installmobilefirstpush, updatemobilefirstpush 및 uninstallmobilefirstpush Ant 태스크는 다음과 같은 요소를 지원합니다.

권한 부여 서버 지정

<authorization> 요소는 정보를 수집하여 다른 MobileFirst Server 컴포넌트와의 인증 통신을 위한 권한 부여 서버를 구성합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

auto

값이 true로 설정되면 로컬 애플리케이션 서버에서 런타임의 컨텍스트 루트를 사용하여 자동으로 권한 부여 서버의 URL이 계산됩니다. WebSphere Application Server Network Deployment의 클러스터에 배치하는 경우 auto 모드는 지원되지 않습니다.

authorizationURL

권한 부여 서버의 URL입니다. 권한 부여 서버가 MobileFirst 런타임인 경우 이 URL은 런타임의 URL입니다. 예를 들어, http://myHost:9080/mfp입니다.

runtimeContextRoot

자동 모드에서 권한 부여 서버의 URL을 계산하는 데 사용되는 런타임의 컨텍스트 루트입니다.

pushClientID

권한 부여 서버의 기밀 클라이언트로서 이 푸시 서비스 인스턴스의 ID입니다. ID 및 본인확인정보를 권한 부여 서버에 대해 등록해야 합니다. installmobilefirstadmin Ant 태스크를 사용하거나 MobileFirst Operations Console에서 등록할 수 있습니다.

pushClientSecret

권한 부여 서버의 기밀 클라이언트로서 이 푸시 서비스 인스턴스의 본인확인정보 키입니다. ID 및 본인확인정보를 권한 부여 서버에 대해 등록해야 합니다. installmobilefirstadmin Ant 태스크를 사용하거나 MobileFirst Operations Console에서 등록할 수 있습니다.

<property> 요소는 애플리케이션 서버에서 정의할 배치 특성을 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

이 요소를 사용하면 자체 JNDI 특성을 정의하거나 푸시 서비스 WAR 파일이 제공하는 JNDI 특성의 기본값을 대체할 수 있습니다.

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

애플리케이션 서버 지정

<applicationserver> 요소를 사용하여 기본 애플리케이션 서버에 따라 달라지는 매개변수를 정의하십시오. <applicationserver> 요소는 다음 요소를 지원합니다.

이 요소의 속성 및 내부 요소가 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블에 설명되어 있습니다.

그러나 Liberty Collective에 대한 <was> 요소의 내부 요소는 다음 테이블을 참조하십시오.

<collectiveMember> 요소에는 다음 속성이 있습니다.

참고: 푸시 서비스와 런타임 컴포넌트가 동일한 Collective 멤버에 설치되는 경우 이들은 동일한 클러스터 이름을 가지고 있어야 합니다. 이 컴포넌트가 동일한 Collective의 구별되는 멤버에 설치되는 경우 클러스터 이름은 다를 수 있습니다.

Analytics 지정

<analytics> 요소는 MobileFirst 푸시 서비스를 이미 설치된 MobileFirst Analytics 서비스에 연결하려 함을 나타냅니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

install

이 푸시 서비스가 연결되어야 하고 이벤트를 MobileFirst Analytics에 전송해야 함을 표시하려면 install 속성을 사용하십시오. 올바른 값은 true 또는 false입니다.

analyticsURL

수신되는 Analytics 데이터를 수신하는 MobileFirst Analytics에 의해 노출되는 URL을 지정하려면 analyticsURL 속성을 사용하십시오.
예를 들어, http://<hostname>:<port>/analytics-service/rest입니다.

username

MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 사용자 이름을 지정하려면 username 속성을 사용하십시오.

password

MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 비밀번호를 지정하려면 password 속성을 사용하십시오.

validate

MobileFirst Analytics Console에 액세스 가능한지 여부를 유효성 검증하고 비밀번호를 사용하여 사용자 이름 인증을 확인하려면 validate 속성을 사용하십시오. 가능한 값은 true 또는 false입니다.

푸시 서비스 데이터베이스에 대한 연결 지정

<database> 요소는 애플리케이션 서버에서 데이터 소스 선언을 지정하는 매개변수를 수집하여 푸시 서비스 데이터베이스에 액세스합니다.

단일 데이터베이스를 선언해야 합니다: <database kind="Push">. <database> 요소에 <dba> 및 <client> 요소가 없음을 제외하고 configuredatabase Ant와 유사하게 <database> 요소를 지정합니다. 여기에는 <property> 요소가 있을 수 있습니다.

<database> 요소에는 다음 속성이 있습니다.

<database> 요소는 다음 요소를 지원합니다. 관계형 DBMS에 대한 이 데이터베이스 요소의 구성에 대한 자세한 정보는 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블을 참조하십시오.

참고: <cloudant> 요소의 속성은 런타임과 약간 다릅니다. 자세한 정보는 다음 테이블을 참조하십시오.

MobileFirst 런타임 환경 설치를 위한 Ant 태스크

installmobilefirstruntime, updatemobilefirstruntime 및 uninstallmobilefirstruntime Ant 태스크에 대한 참조 정보입니다.

태스크 영향

installmobilefirstruntime

installmobilefirstruntime Ant 태스크는 MobileFirst 런타임 WAR 파일을 웹 애플리케이션으로 실행하도록 애플리케이션 서버를 구성합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 지정된 컨텍스트 루트(기본값은 /mfp)에서 MobileFirst 웹 애플리케이션을 선언합니다.
• 애플리케이션 서버에 런타임 WAR 파일을 배치합니다.
• 데이터 소스를 선언하고 WebSphere Application Server 전체 프로파일에서는 런타임에 대한 JDBC 제공자를 선언합니다.
• 애플리케이션 서버에서 데이터베이스 드라이버를 배치합니다.
• JNDI 환경 항목을 통해 MobileFirst 구성 특성을 설정합니다.
• 선택적으로 MobileFirst JNDI 환경 항목을 설정하여 애플리케이션 서버를 런타임에 대한 서버 팜 멤버로 구성합니다.

updatemobilefirstruntime

updatemobilefirstruntime Ant 태스크는 이미 애플리케이션 서버에서 구성된 MobileFirst 런타임을 업데이트합니다. 이 태스크는 런타임 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 런타임 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다. 그 외에 이 태스크는 웹 애플리케이션 구성, 데이터 소스 및 JNDI 환경 항목 등의 애플리케이션 서버 구성을 변경하지 않습니다.

uninstallmobilefirstruntime

uninstallmobilefirstruntime Ant 태스크는 이전 installmobilefirstruntime 실행의 영향을 실행 취소합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 지정된 컨텍스트 루트를 가진 MobileFirst 웹 애플리케이션 구성을 제거합니다. 이 태스크는 해당 애플리케이션에 수동으로 추가되는 설정도 제거합니다.
• 애플리케이션 서버에서 런타임 WAR 파일을 제거합니다.
• 데이터 소스를 제거하며 WebSphere Application Server 전체 프로파일에서는 런타임에 대한 JDBC 제공자를 제거합니다.
• 연관된 JNDI 환경 항목을 제거합니다.

속성 및 요소

installmobilefirstruntime, updatemobilefirstruntime 및 uninstallmobilefirstruntime Ant 태스크는 다음과 같은 속성을 가지고 있습니다.

contextroot 및 id

contextroot 및 id 속성은 다른 MobileFirst 프로젝트를 구별합니다.

WebSphere Application Server Liberty 프로파일 및 Tomcat 환경에서는 contextroot 매개변수로도 이 용도를 충족합니다. WebSphere Application Server 전체 프로파일 환경에서는 id 속성이 대신 사용됩니다.

environmentId

독립적으로 작동해야 하는 MobileFirst Server 관리 서비스 및 MobileFirst 런타임 웹 애플리케이션으로 각각 구성된 여러 환경을 구별하려면 environmentId 속성을 사용하십시오. 관리 서비스 애플리케이션의 경우 호출에서 설정된 것과 동일한 런타임 애플리케이션의 값으로 이 속성을 설정해야 합니다.

warFile

MobileFirst 런타임 WAR 파일에 대해 다른 디렉토리를 지정하려면 warFile 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

wasStartingWeight

WebSphere Application Server에서 사용되는 값을 가중치로 지정하여 시작 순서를 존중하게 하려면 wasStartingWeight 속성을 사용하십시오. 시작 순서 값의 결과로 MobileFirst 런타임 프로젝트보다 먼저 MobileFirst Server 관리 서비스 웹 애플리케이션이 배치되고 시작됩니다. 웹 애플리케이션보다 먼저 MobileFirst 프로젝트가 배치되거나 시작되는 경우에는 JMX 통신이 설정되지 않으며 MobileFirst 프로젝트를 관리할 수 없습니다.

installmobilefirstruntime, updatemobilefirstruntime 및 uninstallmobilefirstruntime 태스크는 다음과 같은 요소를 지원합니다.

<property> 요소는 애플리케이션 서버에서 정의할 배치 특성을 지정합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<applicationserver> 요소는 MobileFirst 애플리케이션이 배치되는 애플리케이션 서버를 설명합니다. 이 요소는 다음 요소 중 하나의 컨테이너입니다.

<websphereapplicationserver> 요소(또는 줄여서 <was>)는 WebSphere Application Server 인스턴스를 나타냅니다. WebSphere Application Server 전체 프로파일(Base 및 Network Deployment)이 지원되므로 WebSphere Application Server Liberty Core 및 WebSphere Application Server Liberty Network Deployment도 지원됩니다. <websphereapplicationserver> 요소에는 다음 속성이 있습니다.

이 요소는 단일 서버 배치를 위해 다음 요소를 지원합니다.

이 컨텍스트에서 사용되는 요소는 다음과 같은 속성을 가지고 있습니다.

이 요소는 Liberty Collective를 위해 다음과 같은 요소를 지원합니다.

<collectiveMember> 요소에는 다음 속성이 있습니다.

이 요소는 Network Deployment를 위해 다음과 같은 요소를 지원합니다.

<cell> 요소에 속성이 없습니다.

<cluster> 요소에는 다음 속성이 있습니다.

<node> 요소에는 다음 속성이 있습니다.

Network Deployment 컨텍스트에서 사용되는 <server> 요소에는 다음 속성이 있습니다.

<tomcat> 요소는 Apache Tomcat 서버를 나타냅니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

<database> 요소는 특정 데이터베이스에 액세스하는 데 필요한 정보를 지정합니다. <dba> 및 <client> 요소가 없음을 제외하고 <database> 요소는 configuredatabase Ant 태스크와 같이 지정됩니다. 그러나 여기에는 <property> 요소가 있을 수 있습니다. <database> 요소에는 다음 속성이 있습니다.

<database> 요소는 다음 요소를 지원합니다.

<analytics> 요소는 MobileFirst 런타임을 이미 설치된 MobileFirst Analytics Console 및 서비스에 연결하려 함을 나타냅니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

install

이 MobileFirst 런타임이 연결되어야 하고 이벤트를 MobileFirst Analytics에 전송해야 함을 표시하려면 install 속성을 사용하십시오. 올바른 값은 true 또는 false입니다.

analyticsURL

수신되는 Analytics 데이터를 수신하는 MobileFirst Analytics에 의해 노출되는 URL을 지정하려면 analyticsURL 속성을 사용하십시오.
예를 들어, http://<hostname>:<port>/analytics-service/rest입니다.

consoleURL

MobileFirst Analytics Console에 링크되는 MobileFirst Analytics에 의해 노출되는 URL에 대해 consoleURL 속성을 사용하십시오.
예를 들어, http://<hostname>:<port>/analytics/console입니다.

username

MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 사용자 이름을 지정하려면 username 속성을 사용하십시오.

password

MobileFirst Analytics에 대한 데이터 시작점이 기본 인증으로 보호되는 경우 사용되는 비밀번호를 지정하려면 password 속성을 사용하십시오.

validate

MobileFirst Analytics Console에 액세스 가능한지 여부를 유효성 검증하고 비밀번호를 사용하여 사용자 이름 인증을 확인하려면 validate 속성을 사용하십시오. 가능한 값은 true 또는 false입니다.

tenant

이 속성에 대한 자세한 정보는 구성 특성을 참조하십시오.

Apache Derby 데이터베이스 지정

<derby> 요소에는 다음 속성이 있습니다.

<derby> 요소는 다음 속성을 지원합니다.

사용 가능한 특성에 대한 자세한 정보는 클래스 EmbeddedDataSource40에 대한 문서를 참조하십시오. 클래스 EmbeddedConnectionPoolDataSource40에 대한 문서도 참조하십시오.

Liberty 서버에 대해 사용 가능한 특성에 대한 자세한 정보는 Liberty 프로파일: server.xml 파일의 구성 요소에 있는 properties.derby.embedded에 대한 문서를 참조하십시오.

mfp-ant-deployer.jar 파일을 Mobile Foundation 설치 디렉토리에서 사용하는 경우 <driverclasspath> 요소가 필요하지 않습니다.

DB2 데이터베이스 지정

<db2> 요소에는 다음 속성이 있습니다.

DB2 사용자 계정에 대한 자세한 정보는 DB2 보안 모델 개요를 참조하십시오.
<db2> 요소는 다음 속성을 지원합니다.

사용 가능한 특성에 대한 자세한 정보는 IBM Data Server Driver for JDBC and SQLJ에 대한 특성을 참조하십시오.

Liberty 서버에 대해 사용 가능한 특성에 대한 자세한 정보는 Liberty 프로파일: server.xml 파일의 구성 요소에서 properties.db2.jcc 절을 참조하십시오.

<driverclasspath> 요소는 DB2 JDBC 드라이버 및 연관된 라이센스의 JAR 파일을 포함해야 합니다. DB2 JDBC 드라이버 버전에서 DB2 JDBC 드라이버를 다운로드할 수 있습니다.

MySQL 데이터베이스 지정

<mysql> 요소에는 다음 속성이 있습니다.

database, server 및 port 대신 URL을 지정할 수도 있습니다. 이 경우에는 다음과 같은 속성을 사용하십시오.

MySQL 사용자 계정에 대한 자세한 정보는 MySQL 사용자 계정 관리를 참조하십시오.

<mysql> 요소는 다음 속성을 지원합니다.

사용 가능한 특성에 대한 자세한 정보는 Connector/J에 대한 드라이버/데이터 소스 클래스 이름, URL 구문 및 구성 특성에 있는 문서를 참조하십시오.

Liberty 서버에 대해 사용 가능한 특성에 대한 자세한 정보는 Liberty 프로파일: server.xml 파일의 구성 요소에서 특성 절을 참조하십시오.

<driverclasspath> 요소는 MySQL Connector/J JAR 파일을 포함해야 합니다. Connector/J 다운로드에서 다운로드할 수 있습니다.

Oracle 데이터베이스 지정

<oracle> 요소에는 다음 속성이 있습니다.

참고: user 속성의 경우 대문자로 된 사용자 이름을 사용하는 것이 좋습니다. Oracle 사용자 이름은 일반적으로 대문자입니다. 다른 데이터베이스 도구와 달리 installmobilefirstruntime Ant 태스크는 사용자 이름의 소문자를 대문자로 변환하지 않습니다. installmobilefirstruntime Ant 태스크가 데이터베이스에 연결하는 데 실패하면 user 속성의 값을 대문자로 입력하십시오.

database, server 및 port 대신 URL을 지정할 수도 있습니다. 이 경우에는 다음과 같은 속성을 사용하십시오.

참고: user 속성의 경우 대문자로 된 사용자 이름을 사용하는 것이 좋습니다. Oracle 사용자 이름은 일반적으로 대문자입니다. 다른 데이터베이스 도구와 달리 installmobilefirstruntime Ant 태스크는 사용자 이름의 소문자를 대문자로 변환하지 않습니다. installmobilefirstruntime Ant 태스크가 데이터베이스에 연결하는 데 실패하면 user 속성의 값을 대문자로 입력하십시오.

Oracle 사용자 계정에 대한 자세한 정보는 인증 방법 개요를 참조하십시오.

Oracle 데이터베이스 연결 URL에 대한 자세한 정보는 데이터 소스 및 URL에 있는 데이터베이스 URL 및 데이터베이스 지정자 절을 참조하십시오.

이 요소는 다음과 같은 요소를 지원합니다.

사용 가능한 특성에 대한 자세한 정보는 데이터 소스 및 URL에 있는 데이터 소스 및 URL 절을 참조하십시오.

Liberty 서버에 대해 사용 가능한 특성에 대한 자세한 정보는 Liberty 프로파일: server.xml 파일의 구성 요소에 있는 properties.oracle 절을 참조하십시오.

<driverclasspath> 요소는 Oracle JDBC 드라이버 JAR 파일을 포함해야 합니다. JDBC, SQLJ, Oracle JPublisher 및 UCP(Universal Connection Pool)에서 Oracle JDBC 드라이버를 다운로드할 수 있습니다.

<derby>, <db2>, <mysql> 또는 <oracle> 요소 내에서 사용할 수 있는 <property> 요소에는 다음 속성이 있습니다.

Application Center 설치를 위한 Ant 태스크

<installApplicationCenter>, <updateApplicationCenter>, <uninstallApplicationCenter> Ant 태스크는 Application Center 콘솔 및 서비스의 설치에 대해 제공됩니다.

태스크 영향

installApplicationCenter

<installApplicationCenter> 태스크는 Application Center 서비스 WAR 파일을 웹 애플리케이션으로 실행하고 Application Center 콘솔을 설치하도록 애플리케이션 서버를 구성합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• /applicationcenter 컨텍스트 루트에서 Application Center 서비스 웹 애플리케이션을 선언합니다.
• 데이터 소스를 선언하며 WebSphere Application Server 전체 프로파일에서는 Application Center 서비스에 대한 JDBC 제공자도 선언합니다.
• 애플리케이션 서버에 Application Center 서비스 웹 애플리케이션을 배치합니다.
• /appcenterconsole 컨텍스트 루트에서 Application Center 콘솔을 웹 애플리케이션으로 선언합니다.
• 애플리케이션 서버에 Application Center 콘솔 WAR 파일을 배치합니다.
• JNDI 환경 항목을 사용하여 Application Center 서비스에 대한 구성 특성을 구성합니다. 엔드포인트 및 프록시와 관련된 JNDI 환경 항목은 주석 처리됩니다. 일부 경우에는 해당 항목을 주석 해제해야 합니다.
• Application Center 콘솔 및 서비스 웹 애플리케이션에서 사용하는 역할에 맵핑되는 사용자를 구성합니다.
• WebSphere Application Server의 경우 웹 컨테이너에 필요한 사용자 정의 특성을 구성합니다.

updateApplicationCenter

<updateApplicationCenter> 태스크는 애플리케이션 서버에서 이미 구성된 Application Center 애플리케이션을 업데이트합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• Application Center 서비스 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.
• Application Center 콘솔 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 해당 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.

이 태스크는 웹 애플리케이션 구성, 데이터 소스, JNDI 환경 항목 및 사용자 대 역할 맵핑 등의 애플리케이션 서버 구성을 변경하지 않습니다. 이 태스크는 이 주제에 설명된 태스크를 사용하여 수행되는 설치에만 적용됩니다.

참고: WebSphere Application Server Liberty 프로파일의 경우 이 태스크는 기능을 변경하지 않고 설치된 애플리케이션에 대한 기능의 잠재적인 최소가 아닌 목록을 server.xml 파일에 남겨 둡니다.

uninstallApplicationCenter

<uninstallApplicationCenter> Ant 태스크는 이전 <installApplicationCenter> 실행의 영향을 실행 취소합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• /applicationcenter 컨텍스트 루트를 가진 Application Center 서비스 웹 애플리케이션의 구성을 제거합니다. 그 결과 이 태스크는 해당 애플리케이션에 수동으로 추가된 설정도 제거합니다.
• 애플리케이션 서버에서 Application Center 서비스 및 콘솔 WAR 파일을 모두 제거합니다.
• 데이터 소스를 제거하며 WebSphere Application Server 전체 프로파일에서는 Application Center 서비스에 대한 JDBC 제공자도 제거합니다.
• 애플리케이션 서버에서 Application Center 서비스가 사용한 데이터베이스 드라이버를 제거합니다.
• 연관된 JNDI 환경 항목을 제거합니다.
• <installApplicationCenter> 호출을 통해 구성되는 사용자를 제거합니다.

속성 및 요소

<installApplicationCenter>, <updateApplicationCenter>, <uninstallApplicationCenter> 태스크에는 다음 속성이 있습니다.

id

WebSphere Application Server 전체 프로파일 환경에서 id 속성은 Application Center 콘솔 및 서비스의 서로 다른 배치를 구별하는 데 사용됩니다. 이 id 속성을 사용하지 않으면 동일한 컨텍스트 루트를 가진 두 개의 WAR 파일은 충돌하므로 배치되지 않습니다.

servicewar

Application Center 서비스 WAR 파일에 대해 다른 디렉토리를 지정하려면 servicewar 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

shortcutsDir

shortcutsDir 속성은 Application Center 콘솔에 대한 바로 가기를 배치할 위치를 지정합니다. 이 속성을 설정하면 다음과 같은 파일이 이 디렉토리에 추가됩니다.

• appcenter-console.url: 이 파일은 Windows 바로 가기입니다. 이 파일은 브라우저에서 Application Center 콘솔을 엽니다.
• appcenter-console.sh: 이 파일은 UNIX 쉘 스크립트입니다. 이 파일은 브라우저에서 Application Center 콘솔을 엽니다.

aaptDir

aapt 프로그램은 Mobile Foundation 배포의 일부입니다. product_install_dir/ApplicationCenter/tools/android-sdk.
이 속성이 설정되지 않은 경우 apk 애플리케이션 업로드 중에 Application Center는 제한이 있는 자체 코드를 사용하여 해당 애플리케이션을 구문 분석합니다.

<installApplicationCenter>, <updateApplicationCenter>, <uninstallApplicationCenter> 태스크는 다음 요소를 지원합니다.

Application Center 콘솔 지정

<console> 요소는 정보를 수집하여 Application Center 콘솔의 설치를 사용자 정의합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

애플리케이션 서버 지정

<applicationserver> 요소를 사용하여 기본 애플리케이션 서버에 따라 달라지는 매개변수를 정의하십시오. <applicationserver> 요소는 다음 요소를 지원합니다.

이 요소의 속성 및 내부 요소가 MobileFirst 런타임 환경 설치를 위한 Ant 태스크 페이지의 테이블에 설명되어 있습니다.

서비스 데이터베이스에 대한 연결 지정

<database> 요소는 애플리케이션 서버에서 데이터 소스 선언을 지정하는 매개변수를 수집하여 서비스 데이터베이스에 액세스합니다.

단일 데이터베이스를 선언해야 합니다: <database kind="ApplicationCenter">. <database> 요소에 <dba> 및 <client> 요소가 없음을 제외하고 <configuredatabase> Ant 태스크와 유사하게 <database> 요소를 지정합니다. 여기에는 <property> 요소가 있을 수 있습니다.

<database> 요소에는 다음 속성이 있습니다.

<database> 요소는 다음 요소를 지원합니다. 이 데이터베이스 요소의 구성에 대한 자세한 정보는 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블을 참조하십시오.

사용자 및 보안 역할 지정

<user> 요소는 애플리케이션의 특정 보안 역할에 포함할 사용자에 대한 매개변수를 수집합니다.

MobileFirst Analytics 설치를 위한 Ant 태스크

installanalytics, updateanalytics 및 uninstallanalytics Ant 태스크는 MobileFirst Analytics 설치를 위해 제공됩니다.

이 Ant 태스크의 용도는 애플리케이션 서버에서 데이터에 대해 적절한 스토리지를 사용하여 MobileFirst Analytics Console 및 MobileFirst Analytics 서비스를 구성하는 것입니다. 이 태스크는 마스터 및 데이터 역할을 수행하는 MobileFirst Analytics 노드를 설치합니다. 자세한 정보는 클러스터 관리 및 Elasticsearch를 참조하십시오.

태스크 영향

installanalytics

installanalytics Ant 태스크는 IBM MobileFirst Analytics를 실행하도록 애플리케이션 서버를 구성합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 애플리케이션 서버에 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console WAR 파일을 배치합니다.
• 지정된 컨텍스트 루트 /analytics-service에서 MobileFirst Analytics 서비스 웹 애플리케이션을 선언합니다.
• 지정된 컨텍스트 루트 /analytics에서 MobileFirst Analytics Console 웹 애플리케이션을 선언합니다.
• JNDI 환경 항목을 통해 MobileFirst Analytics Console 및 MobileFirst Analytics 서비스 구성 특성을 설정합니다.
• WebSphere Application Server Liberty 프로파일에서 웹 컨테이너를 구성합니다.
• 선택적으로 MobileFirst Analytics Console을 사용할 사용자를 작성합니다.

updateanalytics

updateanalytics Ant 태스크는 애플리케이션 서버에서 이미 구성된 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console 웹 애플리케이션 WAR 파일을 업데이트합니다. 이 파일은 이전에 배치된 프로젝트 WAR 파일과 동일한 기본 이름을 가지고 있어야 합니다.

이 태스크는 웹 애플리케이션 구성 및 JNDI 환경 항목 등의 애플리케이션 서버 구성을 변경하지 않습니다.

uninstallanalytics

uninstallanalytics Ant 태스크는 이전 installanalytics 실행의 영향을 실행 취소합니다. 이 태스크는 다음과 같은 영향을 미칩니다.

• 각각의 컨텍스트 루트를 가진 MobileFirst Analytics 서비스와 MobileFirst Analytics Console 웹 애플리케이션 모두의 구성을 제거합니다.
• 애플리케이션 서버에서 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console WAR 파일을 제거합니다.
• 연관된 JNDI 환경 항목을 제거합니다.

속성 및 요소

installanalytics, updateanalytics 및 uninstallanalytics 태스크는 다음과 같은 속성을 가지고 있습니다.

serviceWar

MobileFirst Analytics 서비스 WAR 파일에 대해 다른 디렉토리를 지정하려면 serviceWar 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

<installanalytics>, <updateanalytics>, <uninstallanalytics> 태스크는 다음 요소를 지원합니다.

MobileFirst Analytics Console 지정

<console> 요소는 MobileFirst Analytics Console의 설치를 사용자 정의하기 위한 정보를 수집합니다. 이 요소는 다음과 같은 속성을 가지고 있습니다.

warFile

MobileFirst Analytics Console WAR 파일에 대해 다른 디렉토리를 지정하려면 warFile 속성을 사용하십시오. 절대 경로 또는 상대 경로를 사용하여 이 WAR 파일의 이름을 지정할 수 있습니다.

shortcutsDir

shortcutsDir 속성은 MobileFirst Analytics Console에 대한 바로 가기를 배치할 위치를 지정합니다. 이 속성을 설정하는 경우에는 다음과 같은 파일을 해당 디렉토리에 추가할 수 있습니다.

• analytics-console.url: 이 파일은 Windows 바로 가기입니다. 이 파일은 브라우저에서 MobileFirst Analytics Console을 엽니다.
• analytics-console.sh: 이 파일은 UNIX 쉘 스크립트입니다. 이 파일은 브라우저에서 MobileFirst Analytics Console을 엽니다.

참고: 이 바로 가기는 ElasticSearch 테넌트 매개변수를 포함하지 않습니다.

<console> 요소는 다음 중첩 요소를 지원합니다.

이 요소를 사용하면 자체 JNDI 특성을 정의할 수 있습니다.

<property> 요소에는 다음 속성이 있습니다.

사용자 및 보안 역할 지정

<user> 요소는 애플리케이션의 특정 보안 역할에 포함할 사용자에 대한 매개변수를 수집합니다.

<user> 요소를 사용하여 사용자를 정의한 다음 MobileFirst Operations Console에서 인증을 위해 다음 역할에 해당 사용자를 맵핑할 수 있습니다.

• mfpmonitor
• mfpoperator
• mfpdeployer
• mfpadmin

MobileFirst Analytics에 대한 스토리지 유형 지정

<storage> 요소는 MobileFirst Analytics에서 수집하는 정보 및 데이터를 저장하기 위해 사용하는 기본 스토리지 유형을 나타냅니다.

이 요소는 다음과 같은 요소를 지원합니다.

<elasticsearch> 요소는 ElasticSearch 클러스터에 대한 매개변수를 수집합니다.

clusterName

ElasticSearch 클러스터에 대해 사용자가 선택한 이름을 지정하려면 clusterName 속성을 사용하십시오.

ElasticSearch 클러스터는 동일한 클러스터 이름을 공유하는 하나 이상의 노드로 구성되므로 여러 노드를 구성하는 경우 clusterName 속성에 대해 동일한 값을 지정합니다.

nodeName

ElasticSearch 클러스터에서 구성할 노드에 대해 사용자가 선택한 이름을 지정하려면 nodeName 속성을 사용하십시오. 노드가 여러 머신에 걸쳐 있는 경우에도 각 노드 이름은 ElasticSearch 클러스터에서 고유해야 합니다.

mastersList

ElasticSearch 클러스터에 있는 마스터 노드의 쉼표로 구분된 목록을 제공하려면 mastersList 속성을 사용하십시오. 이 목록의 각 마스터 노드는 해당 호스트 이름 및 ElasticSearch 노드 간 통신 포트에 의해 식별되어야 합니다. 이 포트는 기본값인 9600이거나 해당 마스터 노드를 구성할 때 transportPort 속성을 사용하여 지정한 포트 번호입니다.

예: hostname1:transport-port1, hostname2:transport-port2.

참고:

• 기본값인 9600과 다른 transportPort를 지정하는 경우에는 transportPort 속성을 사용하여 이 값도 설정해야 합니다. 기본적으로 mastersList 속성이 생략되면 지원되는 모든 애플리케이션 서버에서 호스트 이름 및 ElasticSearch 전송 포트를 발견하려고 시도합니다.
• 대상 애플리케이션 서버가 WebSphere Application Server Network Deployment 클러스터인 경우 나중에 이 클러스터에서 서버를 추가하거나 제거하는 경우에는 ElasticSearch 클러스터와 동기화 상태를 유지하기 위해 수동으로 이 목록을 편집해야 합니다.

dataPath

ElasticsSearch 데이터를 저장할 다른 디렉토리를 지정하려면 dataPath 속성을 사용하십시오. 절대 경로 또는 상대 경로를 지정할 수 있습니다.

dataPath 속성이 지정되지 않은 경우 ElasticSearch 클러스터 데이터는 analyticsData라는 기본 디렉토리(애플리케이션 서버에 따라 위치가 다름)에 저장됩니다.

• WebSphere Application Server Liberty 프로파일의 경우 위치는 ${wlp.user.dir}/servers/serverName/analyticsData입니다.
• Apache Tomcat의 경우 위치는 ${CATALINA_HOME}/bin/analyticsData입니다.
• WebSphere Application Server 및 WebSphere Application Server Network Deployment의 경우 위치는 ${was.install.root}/profiles/<profileName>/analyticsData입니다.

MobileFirst Analytics 서비스 컴포넌트가 이벤트를 수신할 때 analyticsData 디렉토리 및 이 디렉토리에 포함된 서브디렉토리 및 파일의 계층 구조가 없으면 런타임 시 이들이 자동으로 작성됩니다.

shards

ElasticSearch 클러스터에서 작성할 샤드 수를 지정하려면 shards 속성을 사용하십시오.

replicasPerShard

ElasticSearch 클러스터에서 각 샤드에 대해 작성할 복제본의 수를 지정하려면 replicasPerShard 속성을 사용하십시오.

각각의 샤드는 0개 이상의 복제본을 가질 수 있습니다. 기본적으로 각각의 샤드는 하나의 복제본을 가지지만 복제본 수는 MobileFirst Analytics의 기존 색인에서 동적으로 변경될 수 있습니다. 복제본 샤드는 해당 샤드와 동일한 노드에서 시작될 수 없습니다.

transportPort

이 노드와 통신할 때 ElasticSearch 클러스터의 다른 노드가 사용해야 하는 포트를 지정하려면 transportPort 속성을 사용하십시오. 이 노드가 프록시 또는 방화벽 뒤에 있으면 이 포트가 사용 가능하고 액세스 가능한지 확인해야 합니다.

애플리케이션 서버 지정

<applicationserver> 요소를 사용하여 기본 애플리케이션 서버에 따라 달라지는 매개변수를 정의하십시오. <applicationserver> 요소는 다음 요소를 지원합니다.

참고: 이 요소의 속성 및 내부 요소가 MobileFirst 런타임 환경 설치를 위한 Ant 태스크의 테이블에 설명되어 있습니다.

사용자 정의 JNDI 특성 지정

<installanalytics>, <updateanalytics>, <uninstallanalytics> 요소는 다음 요소를 지원합니다.

이 요소를 사용하면 자체 JNDI 특성을 정의할 수 있습니다.

이 요소는 다음과 같은 속성을 가지고 있습니다.

내부 런타임 데이터베이스

런타임 데이터베이스 테이블, 해당 용도 및 각 테이블에 저장된 데이터의 크기 정도에 대해 학습하십시오. 관계형 데이터베이스에서 엔티티는 데이터베이스 테이블에서 구성됩니다.

MobileFirst Server 런타임에서 사용하는 데이터베이스

다음 테이블에는 런타임 데이터베이스 테이블, 해당 설명 및 관계형 데이터베이스에서 해당 테이블 사용 방법의 목록이 제공됩니다.

MobileFirst Server 관리 서비스에서 사용하는 데이터베이스

다음 테이블에는 관리 데이터베이스 테이블, 해당 설명 및 관계형 데이터베이스에서 해당 테이블 사용 방법의 목록이 제공됩니다.

MobileFirst Server 라이브 업데이트 서비스에서 사용하는 데이터베이스

다음 테이블에는 라이브 업데이트 서비스 데이터베이스 테이블, 해당 설명 및 관계형 데이터베이스에서 해당 테이블 사용 방법의 목록이 제공됩니다.

MobileFirst Server 푸시 서비스에서 사용하는 데이터베이스

다음 테이블에는 푸시 서비스 데이터베이스 테이블, 해당 설명 및 관계형 데이터베이스에서 해당 테이블 사용 방법의 목록이 제공됩니다.

데이터베이스 설정에 대한 자세한 정보는 데이터베이스 설정을 참조하십시오.

샘플 구성 파일

Mobile Foundation에는 MobileFirst Server를 설치하기 위해 Ant 태스크를 시작하는 데 도움이 되는 다수의 샘플 구성 파일이 포함되어 있습니다.

이 Ant 태스크를 시작하는 가장 쉬운 방법은 MobileFirst Server 배포의 MobileFirstServer/configuration-samples/ 디렉토리에 제공된 샘플 구성 파일을 사용하여 작업하는 것입니다. Ant 태스크를 사용한 MobileFirst Server 설치에 대한 자세한 정보는 Ant 태스크를 사용한 설치를 참조하십시오.

샘플 구성 파일 목록

적절한 샘플 구성 파일을 선택하십시오. 다음과 같은 파일이 제공됩니다.

MySQL에 대한 참고: WebSphere Application Server Liberty 프로파일 또는 WebSphere Application Server 전체 프로파일과 조합된 MySQL은 지원되는 구성으로 분류되지 않습니다. 자세한 정보는 WebSphere Application Server 지원 설명서를 참조하십시오. IBM DB2 또는 WebSphere Application Server에서 지원하는 다른 데이터베이스를 사용하여 IBM 지원 센터에서 완전히 지원하는 구성을 활용해 보십시오.

WebSphere Application Server Network Deployment용 구성 파일에 대한 참고: wasnd에 대한 구성 파일에는 cluster, node, server 또는 cell로 설정할 수 있는 범위가 포함되어 있습니다. 예를 들어, configure-wasnd-cluster-derby.xml의 경우 범위는 cluster입니다. 이 범위 유형은 다음과 같이 배치 대상을 정의합니다.

• cluster: 클러스터에 배치합니다.
• server: 배치 관리자가 관리하는 단일 서버에 배치합니다.
• node: 노드에서 실행 중이지만 클러스터에 속하지 않는 모든 서버에 배치합니다.
• cell: 셀의 모든 서버에 배치합니다.

MobileFirst Analytics에 대한 샘플 구성 파일

Mobile Foundation에는 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console을 설치하기 위해 Ant 태스크를 시작하는 데 도움이 되는 다수의 샘플 구성 파일이 포함되어 있습니다.

<installanalytics>, <updateanalytics>, <uninstallanalytics> Ant 태스크를 시작하는 가장 쉬운 방법은 MobileFirst Server 배포의 Analytics/configuration-samples/ 디렉토리에서 제공된 샘플 구성 파일을 사용하여 작업하는 것입니다.

1단계

적절한 샘플 구성 파일을 선택하십시오. 다음과 같은 XML 파일이 제공됩니다. 이 파일을 다음 단계에서는 configure-file.xml이라고 합니다.

WebSphere Application Server Network Deployment의 구성 파일에 대한 참고:
wasnd에 대한 구성 파일에는 cluster, node, server 또는 cell로 설정될 수 있는 범위가 포함되어 있습니다. 예를 들어, configure-wasnd-cluster-analytics.xml의 경우 범위는 cluster입니다. 이 범위 유형은 다음과 같이 배치 대상을 정의합니다.

• cluster: 클러스터에 배치합니다.
• server: 배치 관리자가 관리하는 단일 서버에 배치합니다.
• node: 노드에서 실행 중이지만 클러스터에 속하지 않는 모든 서버에 배치합니다.
• cell: 셀의 모든 서버에 배치합니다.

2단계

샘플 파일의 파일 액세스 권한을 가능하면 제한적으로 변경하십시오. 3단계에서는 일부 비밀번호를 제공해야 합니다. 동일한 컴퓨터의 다른 사용자가 이러한 비밀번호를 모르게 하려면 본인 외의 사용자에 대해 파일의 읽기 권한을 제거해야 합니다. 다음 예와 같이 명령을 사용할 수 있습니다.

UNIX의 경우: chmod 600 configure-file.xml Windows의 경우: cacls configure-file.xml /P Administrators:F %USERDOMAIN%\%USERNAME%:F

3단계

마찬가지로 애플리케이션 서버가 WebSphere Application Server Liberty 프로파일 또는 Apache Tomcat인 경우 사용자 계정에서만 서버가 시작되도록 되어 있으면 다음과 같은 파일에서 본인 이외의 사용자에 대한 읽기 권한도 제거해야 합니다.

• WebSphere Application Server Liberty 프로파일의 경우: wlp/usr/servers/<server>/server.xml
• Apache Tomcat의 경우: conf/server.xml

4단계

파일의 시작 부분에 있는 특성의 플레이스홀더 값을 바꾸십시오.

참고:
다음과 같은 특수문자는 Ant XML 스크립트의 값에서 사용될 때 이스케이프해야 합니다.

• Apache Ant 매뉴얼의 특성 절에 설명된 대로 ${variable} 구문을 통해 Ant 변수를 명시적으로 참조하려는 경우가 아니면 달러 부호($)는 $$로 써야 합니다.
• XML 엔티티를 명시적으로 참조하려는 경우가 아니면 앰퍼샌드 문자(&)는 &로 써야 합니다.
• 작은따옴표로 묶인 문자열에 있는 경우를 제외하고 큰따옴표(")는 "로 써야 합니다.

5단계

ant -f configure-file.xml install 명령을 실행하십시오.

이 명령은 애플리케이션 서버에서 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console 컴포넌트를 설치합니다. 업데이트된 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console 컴포넌트를 설치하려면(예: MobileFirst Server 수정팩을 적용하는 경우) ant -f configure-file.xml minimal-update 명령을 실행하십시오.

설치 단계를 되돌리려면 ant -f configure-file.xml uninstall 명령을 실행하십시오.

이 명령은 MobileFirst Analytics 서비스 및 MobileFirst Analytics Console 컴포넌트를 설치 제거합니다.