Ant를 통한 애플리케이션 관리

improve this page | report issue

개요

mfpadm Ant 태스크를 통해 MobileFirst 애플리케이션을 관리할 수 있습니다.

다음으로 이동

다른 기능과 비교

다음과 같은 방법으로 IBM Mobile Foundation을 사용해 관리 조작을 실행할 수 있습니다.

  • 대화식 MobileFirst Operations Console
  • mfpadm Ant 태스크
  • mfpadm 프로그램
  • MobileFirst 관리 REST 서비스

mfpadm Ant 태스크, mfpadm 프로그램, REST 서비스는 조작을 자동으로 실행하거나 무인 실행하는 경우 유용합니다. 예를 들면 다음과 같습니다.

  • 반복 조작에서 운영자 오류를 제거하는 경우 또는
  • 운영자의 정상 근무 시간 외에 조작하는 경우 또는
  • 테스트 또는 사전 프로덕션 서버와 동일한 설정을 사용하여 프로덕션 서버를 구성하는 경우

mfpadm Ant 태스크와 mfpadm 프로그램은 REST 서비스보다 사용이 간편하고 오류 보고 측면에서 우수합니다. mfpadm 프로그램에 비해 mfpadm Ant 태스크의 장점은 플랫폼이 독립적이고 Ant와의 통합을 이미 사용할 수 있는 경우 통합이 보다 쉽다는 점입니다.

전제조건

mfpadm 도구는 MobileFirst Server 설치 프로그램을 사용해 설치됩니다. 이 페이지의 나머지 부분에서 product_install_dir은 MobileFirst Server 설치 프로그램의 설치 디렉토리를 표시합니다.

mfpadm 태스크를 실행하려면 Apache Ant가 필요합니다. Ant의 최소 지원 버전에 대한 정보는 시스템 요구사항을 참조하십시오.

편의를 위해 Apache Ant 1.9.4가 MobileFirst Server에 포함되어 있습니다. product_install_dir/shortcuts/ 디렉토리에서 다음 스크립트가 제공됩니다.

  • UNIX/Linux의 경우 ant
  • Windows의 경우 ant.bat

이러한 스크립트는 실행할 준비가 되어 있으며, 특정 환경 변수가 필요하지 않음을 의미합니다. 환경 변수 JAVA_HOME이 설정된 경우 스크립트에서 이를 승인합니다.

MobileFirst Server가 설치된 컴퓨터가 아닌 다른 컴퓨터에서 mfpadm Ant 태스크를 사용할 수 있습니다.

  • product_install_dir/MobileFirstServer/mfp-ant-deployer.jar 파일을 컴퓨터에 복사하십시오.
  • 지원되는 버전의 Apache Ant와 JRE(Java Runtime Environment)가 컴퓨터에 설치되어 있는지 확인하십시오.

mfpadm Ant 태스크를 사용하려면 다음 초기화 명령을 Ant 스크립트에 추가하십시오.

<taskdef resource="com/ibm/mfp/ant/deployers/antlib.xml">
  <classpath>
    <pathelement location="product_install_dir/MobileFirstServer/mfp-ant-deployer.jar"/>
  </classpath>
</taskdef>

defaults.properties를 통한 초기화는 antlib.xml을 통해서도 내재적으로 수행되므로 동일한 mfp-ant-deployer.jar 파일을 참조하는 기타 초기화 명령은 중복됩니다. 다음은 중복되는 초기화 명령의 예 중 하나입니다.

<taskdef resource="com/ibm/mfp/ant/defaults.properties">
  <classpath>
    <pathelement location="product_install_dir/MobileFirstServer/mfp-ant-deployer.jar"/>
  </classpath>
</taskdef>

MobileFirst Server 설치 프로그램 실행에 대한 자세한 정보는 IBM Installation Manager 실행을 참조하십시오.

다음으로 이동

mfpadm Ant 태스크 호출

mfpadm Ant 태스크와 연관 명령을 사용해 MobileFirst 애플리케이션을 관리할 수 있습니다. 다음과 같이 mfpadm Ant 태스크를 호출하십시오.

<mfpadm url=... user=... password=...|passwordfile=... [secure=...]>
    some commands
</mfpadm>

속성

mfpadm Ant 태스크의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
url 관리 서비스에 사용되는 MobileFirst 웹 애플리케이션의 기본 URL  
secure 보안 위험이 있는 조작을 수행하지 않을지 여부 아니오 true
user MobileFirst 관리 서비스에 액세스하는 데 사용되는 사용자 이름  
password 사용자의 비밀번호 하나는 필수임  
passwordfile 사용자의 비밀번호가 있는 파일 하나는 필수임  
timeout 전체 REST 서비스 액세스의 제한시간(초) 아니오  
connectTimeout 네트워크 연결 설정의 제한시간(초) 아니오  
socketTimeout 네트워크 연결 끊어짐을 발견할 제한시간(초) 아니오  
connectionRequestTimeout 연결 요청 풀에서 항목을 얻을 제한시간(초) 아니오  
lockTimeout 잠금 획득 제한시간 아니오  

url
기본 URL에서는 우선적으로 HTTPS 프로토콜을 사용합니다. 예를 들어, 기본 포트와 컨텍스트 루트를 사용하는 경우 다음 URL을 사용하십시오.

secure
기본값은 true입니다. secure=”false”를 설정하면 다음과 같은 영향을 미칩니다.

  • 암호화되지 않은 HTTP를 통해서도 사용자와 비밀번호가 안전하지 않은 방법으로 전송될 수 있습니다.
  • 서버의 SSL 인증서가 자체 서명되었거나 지정된 서버의 호스트 이름과 다른 호스트 이름에 대해 작성된 경우에도 해당 인증서가 허용됩니다.

password
password 속성을 통해 Ant 스크립트에서 또는 passwordfile 속성을 통해 전달하는 별도의 파일에서 비밀번호를 지정합니다. 비밀번호는 민감한 정보이므로 보호되어야 합니다. 동일한 컴퓨터의 다른 사용자가 이 비밀번호를 알지 못하게 해야 합니다. 비밀번호에 대한 보안을 설정하려면 파일에 비밀번호를 입력하기 전에 자신이 아닌 다른 사용자의 파일 읽기 권한을 제거하십시오. 예를 들어, 다음 명령 중 하나를 사용할 수 있습니다.

  • UNIX의 경우: chmod 600 adminpassword.txt
  • Windows의 경우: cacls adminpassword.txt /P Administrators:F %USERDOMAIN%\%USERNAME%:F

또한 비밀번호를 잠시라도 보이지 않도록 숨기기 위해 난독화할 수 있습니다. 이를 수행하려면 mfpadm config password 명령을 사용하여 구성 파일에 난독화된 비밀번호를 저장하십시오. 그런 다음 난독화된 비밀번호를 Ant 스크립트 또는 비밀번호 파일에 복사하여 붙여넣을 수 있습니다.

mfpadm 호출에는 내부 요소에서 인코딩되는 명령이 포함되어 있습니다. 이러한 명령은 나열되는 순서대로 실행됩니다. 명령 중 하나가 실패하면 나머지 명령이 실행되지 않으며 mfpadm 호출에 실패합니다.

요소

mfpadm 호출에서 다음 요소를 사용할 수 있습니다.

요소 설명 개수
show-info 사용자 정보와 구성 정보 표시 0..∞
show-global-config 글로벌 구성 정보 표시 0..∞
show-diagnostics 진단 정보 표시 0..∞
show-versions 버전 정보 표시 0..∞
unlock 일반용 잠금 해제 0..∞
list-runtimes 런타임 나열 0..∞
show-runtime 런타임에 대한 정보 표시 0..∞
delete-runtime 런타임 삭제 0..∞
show-user-config 런타임의 사용자 구성 표시 0..∞
set-user-config 런타임의 사용자 구성 지정 0..∞
show-confidential-clients 런타임의 기밀 클라이언트 구성 표시 0..∞
set-confidential-clients 런타임의 기밀 클라이언트 구성 지정 0..∞
set-confidential-clients-rule 런타임의 기밀 클라이언트 구성에 대한 규칙 지정 0..∞
list-adapters 어댑터 나열 0..∞
deploy-adapter 어댑터 배치 0..∞
show-adapter 어댑터에 대한 정보 표시 0..∞
delete-adapter 어댑터 삭제 0..∞
adapter 어댑터의 기타 조작 0..∞
list-apps 앱 나열 0..∞
deploy-app 앱 배치 0..∞
show-app 앱에 대한 정보 표시 0..∞
delete-app 앱 삭제 0..∞
show-app-version 앱 버전에 대한 정보 표시 0..∞
delete-app-version 앱의 버전 삭제 0..∞
app 앱의 기타 조작 0..∞
app-version 앱 버전의 기타 조작 0..∞
list-devices 디바이스 나열 0..∞
remove-device 디바이스 제거 0..∞
device 디바이스에 대한 기타 조작 0..∞
list-farm-members 서버 팜 멤버 나열 0..∞
remove-farm-member 서버 팜 멤버 제거 0..∞

XML 형식

대부분 명령의 출력은 XML 형식이고 특정 명령에 대한 입력(예: <set-accessrule>)도 XML 형식입니다. product_install_dir/MobileFirstServer/mfpadm-schemas/ 디렉토리에 이러한 XML 형식의 XML 스키마가 있습니다. 서버에서 XML 응답을 받는 명령은 이 응답이 특정 스키마를 준수하는지 확인합니다. xmlvalidation=”none” 속성을 지정하여 이 검사를 사용 안함으로 설정할 수 있습니다.

출력 문자 세트

mfpadm Ant 태스크의 일반 출력은 현재 로케일의 인코딩 형식으로 인코딩됩니다. Windows에서는 이 인코딩 형식을 “ANSI 코드 페이지”라고 합니다. 영향은 다음과 같습니다.

  • 이 문자 세트 외부의 문자는 출력 시 물음표로 변환됩니다.
  • 출력이 Windows 명령 프롬프트 창(cmd.exe)으로 이동하는 경우 해당 창에서는 문자가 “OEM 코드 페이지”에서 인코딩된다고 가정하므로 비ASCII 문자가 올바르지 않게 표시됩니다.

이 제한사항의 임시 해결책은 다음과 같습니다.

  • Windows 이외의 운영 체제에서 인코딩이 UTF-8인 로케일을 사용하십시오. 이 로케일은 Red Hat Linux와 macOS의 기본 로케일입니다. 기타 여러 운영 체제에는 en_US.UTF-8 로케일이 있습니다.
  • 또는 output=”some file name” 속성을 사용하여 mfpadm 명령의 출력 경로를 파일로 재지정하십시오.

일반 구성에 대한 명령

mfpadm Ant 태스크를 호출할 때 IBM MobileFirst Server 또는 런타임의 글로벌 구성에 액세스하는 여러 명령을 포함할 수 있습니다.

show-global-config 명령

show-global-config 명령은 글로벌 구성을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-global-config/>

이 명령은 Global Configuration (GET) REST 서비스를 기반으로 합니다.


show-user-config 명령

<adapter> 요소와 <app-version> 요소 외부의 show-user-config 명령은 런타임의 사용자 구성을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
format 출력 형식을 지정합니다. json 또는 xml입니다. 사용할 수 없음
output 출력을 저장할 파일 이름입니다. 아니오 적용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 아니오 적용할 수 없음

예제

<show-user-config runtime="mfp" format="xml"/>

이 명령은 Runtime Configuration (GET) REST 서비스를 기반으로 합니다.


set-user-config 명령

<adapter> 요소와 <app-version> 요소 외부의 show-user-config 명령은 런타임의 사용자 구성을 지정합니다. 이 명령에는 전체 구성 설정에 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
file 새 구성이 포함된 JSON 또는 XML 파일의 이름입니다. 사용할 수 없음

set-user-config 명령에는 구성에서 단일 특성을 설정하는 데 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
property JSON 특성의 이름입니다. 중첩된 특성의 경우 구문 prop1.prop2…..propN을 사용하십시오. JSON 배열 요소의 경우 특성 이름 대신 색인을 사용하십시오. 사용할 수 없음
value 특성의 값입니다. 사용할 수 없음

예제

<set-user-config runtime="mfp" file="myconfig.json"/>
<set-user-config runtime="mfp" property="timeout" value="240"/>

이 명령은 Runtime configuration (PUT) REST 서비스를 기반으로 합니다.


show-confidential-clients 명령

show-confidential-clients 명령은 런타임에 액세스할 수 있는 기밀 클라이언트의 구성을 표시합니다. 기밀 클라이언트에 대한 자세한 정보는 기밀 클라이언트를 참조하십시오. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
format 출력 형식을 지정합니다. json 또는 xml입니다. 사용할 수 없음
output 출력을 저장할 파일 이름입니다. 아니오 적용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 아니오 적용할 수 없음

예제

<show-confidential-clients runtime="mfp" format="xml" output="clients.xml"/>

이 명령은 Confidential Clients (GET) REST 서비스를 기반으로 합니다.


set-confidential-clients 명령

set-confidential-clients 명령은 런타임에 액세스할 수 있는 기밀 클라이언트의 구성을 지정합니다. 기밀 클라이언트에 대한 자세한 정보는 기밀 클라이언트를 참조하십시오. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
file 새 구성이 포함된 JSON 또는 XML 파일의 이름입니다. 사용할 수 없음

예제

<set-confidential-clients runtime="mfp" file="clients.xml"/>

이 명령은 Confidential Clients (PUT) REST 서비스를 기반으로 합니다.


set-confidential-clients-rule 명령

set-confidential-clients-rule 명령은 런타임에 액세스할 수 있는 기밀 클라이언트의 구성에 규칙을 지정합니다. 기밀 클라이언트에 대한 자세한 정보는 기밀 클라이언트를 참조하십시오. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
id 규칙 ID입니다. 사용할 수 없음
displayName 규칙의 표시 이름입니다. 사용할 수 없음
secret 규칙의 시크릿입니다. 사용할 수 없음
allowedScope 규칙의 범위입니다. 공백으로 구분된 토큰 목록입니다. 사용할 수 없음

예제

<set-confidential-clients-rule runtime="mfp" id="push" displayName="Push" secret="lOa74Wxs" allowedScope="**"/>

이 명령은 Confidential Clients (PUT) REST 서비스를 기반으로 합니다.

어댑터에 대한 명령

mfpadm Ant 태스크를 호출할 때 어댑터에 대한 여러 명령을 포함할 수 있습니다.

list-adapters 명령

list-adapters 명령은 지정된 런타임 동안 배치된 어댑터 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<list-adapters runtime="mfp"/>

이 명령은 Adapter (GET) REST 서비스를 기반으로 합니다.


deploy-adapter 명령

deploy-adapter 명령은 런타임에 어댑터를 배치합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
file 2진 어댑터 파일입니다(.adapter). 사용할 수 없음

예제

<deploy-adapter runtime="mfp" file="MyAdapter.adapter"/>

이 명령은 Adapter (POST) REST 서비스를 기반으로 합니다.


show-adapter 명령

show-adapter 명령은 어댑터에 대한 세부사항을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 어댑터의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-adapter runtime="mfp" name="MyAdapter"/>

이 명령은 Adapter (GET) REST 서비스를 기반으로 합니다.


delete-adapter 명령

delete-adapter 명령은 런타임에서 어댑터를 제거(배치 취소)합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 어댑터의 이름입니다. 사용할 수 없음

예제

<delete-adapter runtime="mfp" name="MyAdapter"/>

이 명령은 Adapter (DELETE) REST 서비스를 기반으로 합니다.


adapter 명령 그룹

adapter 명령 그룹의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 어댑터의 이름입니다. 사용할 수 없음

adapter 명령은 다음 요소를 지원합니다.

요소 설명 개수
get-binary 2진 데이터를 가져옵니다. 0..∞
show-user-config 사용자 구성을 표시합니다. 0..∞
set-user-config 사용자 구성을 지정합니다. 0..∞


get-binary 명령

<adapter> 요소 내부의 get-binary 명령은 2진 어댑터 파일을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
tofile 출력 파일의 이름입니다. 사용할 수 없음

예제

<adapter runtime="mfp" name="MyAdapter">
  <get-binary tofile="/tmp/MyAdapter.adapter"/>
</adapter>

이 명령은 Adapter (GET) REST 서비스를 기반으로 합니다.


show-user-config 명령

<adapter> 요소 내부의 show-user-config 명령은 어댑터의 사용자 구성을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
format 출력 형식을 지정합니다. json 또는 xml입니다. 사용할 수 없음
output 출력을 저장할 파일 이름입니다. 아니오 적용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 아니오 적용할 수 없음

예제

<adapter runtime="mfp" name="MyAdapter">
  <show-user-config format="xml"/>
</adapter>

이 명령은 Adapter Configuration (GET) REST 서비스를 기반으로 합니다.


set-user-config 명령

<adapter> 요소 내부의 show-user-config 명령은 어댑터의 사용자 구성을 지정합니다. 이 명령에는 전체 구성 설정에 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
file 새 구성이 포함된 JSON 또는 XML 파일의 이름입니다. 사용할 수 없음

명령에는 구성에서 단일 특성을 설정하는 데 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
property JSON 특성의 이름입니다. 중첩된 특성의 경우 구문 prop1.prop2…..propN을 사용하십시오. JSON 배열 요소의 경우 특성 이름 대신 색인을 사용하십시오. 사용할 수 없음
value 특성의 값입니다. 사용할 수 없음

예제

<adapter runtime="mfp" name="MyAdapter">
  <set-user-config file="myconfig.json"/>
</adapter>
<adapter runtime="mfp" name="MyAdapter">
  <set-user-config property="timeout" value="240"/>
</adapter>

이 명령은 Application Configuration (PUT) REST 서비스를 기반으로 합니다.

앱에 대한 명령

mfpadm Ant 태스크를 호출할 때 앱에 대한 여러 명령을 포함할 수 있습니다.

list-apps 명령

list-apps 명령은 런타임에 배치되는 앱의 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<list-apps runtime="mfp"/>

이 명령은 Application (GET) REST 서비스를 기반으로 합니다.


deploy-app 명령

deploy-app 명령은 런타임에 앱 버전을 배치합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
file 애플리케이션 디스크립터입니다(JSON 파일). 사용할 수 없음

예제

<deploy-app runtime="mfp" file="MyApp/application-descriptor.json"/>

이 명령은 Application (POST) REST 서비스를 기반으로 합니다.


show-app 명령

show-app 명령은 런타임에 배치되는 앱 버전 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-app runtime="mfp" name="MyApp"/>

이 명령은 Application (GET) REST 서비스를 기반으로 합니다.


delete-app 명령

delete-app 명령은 런타임에서 애플리케이션이 배치된 모든 환경의 앱(모든 해당 앱 버전 포함)을 제거(배치 취소)합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음

예제

<delete-app runtime="mfp" name="MyApp"/>

이 명령은 Application Version (DELETE) REST 서비스를 기반으로 합니다.


show-app-version 명령

show-app-version 명령은 런타임에 앱 버전에 대한 세부사항을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음
environment 모바일 플랫폼입니다. 사용할 수 없음
version 앱의 버전 번호입니다. 사용할 수 없음

예제

<show-app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1"/>

이 명령은 Application Version (GET) REST 서비스를 기반으로 합니다.


delete-app-version 명령

delete-app-version 명령은 런타임에서 애플리케이션 버전을 제거(배치 취소)합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음
environment 모바일 플랫폼입니다. 사용할 수 없음
version 앱의 버전 번호입니다. 사용할 수 없음

예제

<delete-app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1"/>

이 명령은 Application Version (DELETE) REST 서비스를 기반으로 합니다.


app 명령 그룹

app 명령 그룹의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음

app 명령 그룹은 다음 요소를 지원합니다.

요소 설명 개수
show-license-config 토큰 라이센스 구성을 표시합니다. 0..
set-license-config 토큰 라이센스 구성을 지정합니다. 0..
delete-license-config 토큰 라이센스 구성을 제거합니다. 0..


show-license-config 명령

show-license-config 명령은 앱의 토큰 라이센스 구성을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력을 저장할 파일의 이름입니다. 사용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <show-license-config output="/tmp/MyApp-license.xml"/>
</app-version>

이 명령은 Application license configuration (GET) REST 서비스를 기반으로 합니다.


set-license-config 명령

set-license-config 명령은 앱의 토큰 라이센스 구성을 지정합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
appType 앱의 유형입니다(B2C 또는 B2E). 사용할 수 없음
licenseType 애플리케이션의 유형입니다(APPLICATION, ADDITIONAL_BRAND_DEPLOYMENT 또는 NON_PRODUCTION). 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-license-config appType="B2E" licenseType="APPLICATION"/>
</app-version>

이 명령은 Application License Configuration (POST) REST 서비스를 기반으로 합니다.


delete-license-config 명령

delete-license-config 명령은 앱의 토큰 라이센스 구성을 재설정하여 초기 상태로 되돌립니다.

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <delete-license-config/>
</app-version>

이 명령은 License configuration (DELETE) REST 서비스를 기반으로 합니다.


app-version 명령 그룹

app-version 명령 그룹의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
name 앱의 이름입니다. 사용할 수 없음
environment 모바일 플랫폼입니다. 사용할 수 없음
version 앱의 버전입니다. 사용할 수 없음

app-version 명령 그룹은 다음 요소를 지원합니다.

요소 설명 개수
get-descriptor 디스크립터를 가져옵니다. 0..
get-web-resources 웹 자원을 가져옵니다. 0..
set-web-resources 웹 자원을 지정합니다. 0..
get-authenticity-data 인증 데이터를 가져옵니다. 0..
set-authenticity-data 인증 데이터를 지정합니다. 0..
delete-authenticity-data 인증 데이터를 삭제합니다. 0..
show-user-config 사용자 구성을 표시합니다. 0..
set-user-config 사용자 구성을 지정합니다. 0..


get-descriptor 명령

<app-version> 요소 내부의 get-descriptor 명령은 앱 버전의 애플리케이션 디스크립터를 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력을 저장할 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 아니오 적용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <get-descriptor output="/tmp/MyApp-application-descriptor.json"/>
</app-version>

이 명령은 Application Descriptor (GET) 서비스를 기반으로 합니다.


get-web-resources 명령

<app-version> 요소 내부의 get-web-resources 명령은 앱 버전의 웹 자원을 .zip 파일로 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
tofile 출력 파일의 이름입니다. 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <get-web-resources tofile="/tmp/MyApp-web.zip"/>
</app-version>

이 명령은 Retrieve Web Resource (GET) REST 서비스를 기반으로 합니다.


set-web-resources 명령

<app-version> 요소 내부의 set-web-resources 명령은 앱 버전에 대한 웹 자원을 지정합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
file 입력 파일의 이름입니다(.zip 파일이어야 함). 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-web-resources file="/tmp/MyApp-web.zip"/>
</app-version>

이 명령은 Deploy a web resource (POST) REST 서비스를 기반으로 합니다.


get-authenticity-data 명령

<app-version> 요소 내부의 get-authenticity-data 명령은 앱 버전의 인증 데이터를 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력을 저장할 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력을 저장할 Ant 특성의 이름입니다. 아니오 적용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <get-authenticity-data output="/tmp/MyApp.authenticity_data"/>
</app-version>

이 명령은 Export runtime resources (GET) REST 서비스를 기반으로 합니다.


set-authenticity-data 명령

<app-version> 요소 내부의 set-authenticity-data 명령은 앱 버전에 대한 인증 데이터를 지정합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
file 입력 파일의 이름입니다.<ul><li>authenticity_data 파일</li><li>또는 디바이스 파일(.ipa, .apk 또는 .appx 파일)이며 여기에서 인증 데이터를 추출합니다.</li></ul> 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-authenticity-data file="/tmp/MyApp.authenticity_data"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-authenticity-data file="MyApp.ipa"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="android" version="1.1">
  <set-authenticity-data file="MyApp.apk"/>
</app-version>

이 명령은 Deploy Application Authenticity Data (POST) REST 서비스를 기반으로 합니다.


delete-authenticity-data 명령

<app-version> 요소 내부의 delete-authenticity-data 명령은 앱 버전의 인증 데이터를 삭제합니다. 이 명령에는 속성이 없습니다.

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <delete-authenticity-data/>
</app-version>

이 명령은 Application Authenticity (DELETE) REST 서비스를 기반으로 합니다.


show-user-config 명령

<app-version> 요소 내부의 show-user-config 명령은 앱 버전의 사용자 구성을 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
format 출력 형식을 지정합니다. json 또는 xml입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <show-user-config format="json" output="/tmp/MyApp-config.json"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <show-user-config format="xml" output="/tmp/MyApp-config.xml"/>
</app-version>

이 명령은 Application Configuration (GET) REST 서비스를 기반으로 합니다.


set-user-config 명령

<app-version> 요소 내부의 set-user-config 명령은 앱 버전에 대한 사용자 구성을 지정합니다. 이 명령에는 전체 구성 설정에 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
file 새 구성이 포함된 JSON 또는 XML 파일의 이름입니다. 사용할 수 없음

set-user-config 명령에는 구성에서 단일 특성을 설정하는 데 필요한 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
property JSON 특성의 이름입니다. 중첩된 특성의 경우 구문 prop1.prop2…..propN을 사용하십시오. JSON 배열 요소의 경우 특성 이름 대신 색인을 사용하십시오. 사용할 수 없음
value 특성의 값입니다. 사용할 수 없음

예제

<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-user-config file="/tmp/MyApp-config.json"/>
</app-version>
<app-version runtime="mfp" name="MyApp" environment="iphone" version="1.1">
  <set-user-config property="timeout" value="240"/>
</app-version>

디바이스에 대한 명령

mfpadm Ant 태스크를 호출할 때 디바이스에 대한 여러 명령을 포함할 수 있습니다.

list-devices 명령

list-devices 명령은 런타임의 앱에 접속한 디바이스의 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값  
runtime 런타임의 이름입니다. 사용할 수 없음  
query 검색할 친숙한 이름 또는 사용자 ID입니다. 이 매개변수는 검색할 문자열을 지정합니다. 이 문자열(대소문자 구분 없이 일치)을 포함하는 친숙한 이름 또는 사용자 ID를 사용하는 모든 디바이스가 리턴됩니다. 아니오 적용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음  
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음  

예제

<list-devices runtime="mfp"/>
<list-devices runtime="mfp" query="john"/>

이 명령은 Devices (GET) REST 서비스를 기반으로 합니다.


remove-device 명령

remove-device 명령은 런타임의 앱에 접속한 디바이스에 대한 레코드를 지웁니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
id 고유 디바이스 ID입니다. 사용할 수 없음

예제

<remove-device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6"/>

이 명령은 Device (DELETE) REST 서비스를 기반으로 합니다.


device 명령 그룹

device 명령 그룹의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
id 고유 디바이스 ID입니다. 사용할 수 없음

device 명령은 다음 요소를 지원합니다.

요소 설명 개수
set-status 상태를 변경합니다. 0..∞
set-appstatus 앱의 상태를 변경합니다. 0..∞


set-status 명령

set-status 명령은 런타임의 범위에서 디바이스의 상태를 변경합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
status 새 상태입니다. 사용할 수 없음

상태의 값은 다음 중 하나입니다.

  • ACTIVE
  • LOST
  • STOLEN
  • EXPIRED
  • DISABLED

예제

<device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6">
  <set-status status="EXPIRED"/>
</device>

이 명령은 Device Status (PUT) REST 서비스를 기반으로 합니다.


set-appstatus 명령

set-appstatus 명령은 런타임에 애플리케이션과 관련하여 디바이스의 상태를 변경합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
app 앱의 이름입니다. 사용할 수 없음
status 새 상태입니다. 사용할 수 없음

상태의 값은 다음 중 하나입니다.

  • ENABLED
  • DISABLED

예제

<device runtime="mfp" id="496E974CCEDE86791CF9A8EF2E5145B6">
  <set-appstatus app="MyApp" status="DISABLED"/>
</device>

이 명령은 Device Application Status (PUT) REST 서비스를 기반으로 합니다.

문제점 해결에 대한 명령

Ant 태스크 명령을 사용하여 MobileFirst Server 웹 애플리케이션 관련 문제점을 조사할 수 있습니다.

show-info 명령

show-info 명령은 런타임 또는 데이터베이스에 액세스하지 않고 리턴할 수 있는 MobileFirst 관리 서비스에 대한 기본 정보를 표시합니다. 이 명령을 사용하여 MobileFirst 관리 서비스가 실행 중인지 여부를 테스트합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-info/>


show-versions 명령

show-versions 명령은 여러 컴포넌트의 MobileFirst 버전을 표시합니다.

  • mfpadmVersion: mfp-ant-deployer.jar 파일을 가져온 정확한 MobileFirst Server 버전 번호입니다.
  • productVersion: mfp-admin-service.war 파일을 가져온 정확한 MobileFirst Server 버전 번호입니다.
  • mfpAdminVersion: mfp-admin-service.war의 정확한 빌드 버전 번호입니다.

명령의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-versions/>


show-diagnostics 명령

show-diagnostics 명령은 MobileFirst 관리 서비스의 올바른 조작에 필요한 여러 컴포넌트의 상태를 표시합니다(예: 데이터베이스와 보조 서비스의 사용 가능성). 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-diagnostics/>


unlock 명령

unlock 명령은 일반 용도의 잠금을 해제합니다. 일부 안전하지 않은 조작에서는 동일한 구성 데이터가 동시에 수정되지 않도록 하기 위해 이 잠금을 사용합니다. 드물게 해당 조작이 인터럽트되는 경우 안전하지 않은 조작을 더 이상 수행할 수 없도록 잠금이 잠금 상태로 유지됩니다. 이런 경우 unlock 명령을 사용하여 잠금을 해제하십시오. 이 명령에는 속성이 없습니다.

예제

<unlock/>


list-runtimes 명령

list-runtimes 명령은 배치된 런타임 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<list-runtimes/>
<list-runtimes inDatabase="true"/>

이 명령은 Runtime (GET) REST 서비스를 기반으로 합니다.


show-runtime 명령

show-runtime 명령은 주어진 배치된 런타임에 대한 정보를 표시합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<show-runtime runtime="mfp"/>

이 명령은 Runtime (GET) REST 서비스를 기반으로 합니다.


delete-runtime 명령

delete-runtime 명령은 데이터베이스에서 해당 앱과 어댑터를 비롯한 런타임을 삭제합니다. 해당 웹 애플리케이션이 중지된 경우에만 런타임을 삭제할 수 있습니다. 명령의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
condition 삭제 조건입니다(empty 또는 always). 주의: always 옵션은 위험합니다. 아니오 적용할 수 없음

예제

<delete-runtime runtime="mfp" condition="empty"/>

이 명령은 Runtime (DELETE) REST 서비스를 기반으로 합니다.


list-farm-members 명령

list-farm-members 명령은 주어진 런타임이 배치되는 팜 멤버 서버의 목록을 리턴합니다. 이 명령에는 다음과 같은 속성이 있습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
output 출력 파일의 이름입니다. 아니오 적용할 수 없음
outputproperty 출력의 Ant 특성 이름입니다. 아니오 적용할 수 없음

예제

<list-farm-members runtime="mfp"/>

이 명령은 Farm topology members (GET) REST 서비스를 기반으로 합니다.


remove-farm-member 명령

remove-farm-member 명령은 주어진 런타임이 배치된 팜 멤버의 목록에서 서버를 제거합니다. 서버를 사용할 수 없거나 연결이 끊어진 경우 이 명령을 사용하십시오. 명령의 속성은 다음과 같습니다.

속성 설명 필수 여부 기본값
runtime 런타임의 이름입니다. 사용할 수 없음
serverId 서버의 ID입니다. 적용할 수 없음
force 사용 가능하거나 연결되어 있는 경우에도 팜 멤버의 제거를 강제 실행합니다. 아니오 false

예제

<remove-farm-member runtime="mfp" serverId="srvlx15"/>

이 명령은 Farm topology members (DELETE) REST 서비스를 기반으로 합니다.

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 June 29, 2020