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을 사용하십시오.
- WebSphere Application Server의 경우: https://server:9443/worklightadmin
- Tomcat의 경우: https://server:8443/worklightadmin
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.