wsadmin 스크립트를 사용하는 관리 작업 유형
유연한 관리 환경에서 wsadmin 도구를 사용하여 관리 작업을 작업 관리자에 제출할 수 있습니다. 이 주제에서는 관리 작업, 작업 매개변수 및 샘플 명령 구문에 대한 자세한 정보를 제공합니다.
유연한 관리 환경에서 구성에 있는 여러 대상 또는 대상 그룹에 작업을 제출하도록 관리 에이전트 및 작업 관리자를 구성할 수 있습니다. 그런 다음, 관리 환경 간에 작업을 큐잉하는 관리 작업을 제출할 수 있습니다. 각 관리 작업에는 작업을 제출하는 데 필요한 매개변수를 정의하는 해당 작업 유형이 있습니다. AdministrativeJobs 명령 그룹에 있는 명령을 사용하여 관리 작업을 작업 관리자에 제출할 수 있습니다.
애플리케이션을 관리하는 관리 작업을 제출할 수 있습니다.
모든 작업 유형의 공통 매개변수
- 필수 매개변수
- 각 submitJob 명령에는 최소한 jobType 매개변수가 필요합니다.
또한 여러 submitJob 명령에는 targetList 또한 jobParams 매개변수도 필요합니다.
표 1. submitJob 필수 매개변수 설명. submitJob 명령에 해당 필수 매개변수를 지정하여 실행하십시오. 매개변수 설명 유형 jobType 수행할 작업 유형을 지정합니다. 애플리케이션 관리, 제품 유지보수, 구성 및 애플리케이션 서버 런타임 제어 작업을 포함하여 많은 작업 유형이 유연한 관리 환경에 있습니다. String targetList 작업이 실행되는 하나 이상의 관리 대상을 지정합니다. String jobParams 작업을 실행하기 위해 작업 유형 및 대상을 비롯한 구성 정보를 지정합니다. 작업 매개변수는 각 작업 유형에 따라 다릅니다. String - 선택사항 일반 매개변수
- 작업별 매개변수 외에도 다음과 같은 선택적 매개변수를 작업 제출에
포함시킬 수 있습니다.
표 2. submitJob 선택사항 일반 매개변수 설명. submitJob 명령에 해당 필수 매개변수 및 상황에 맞는 선택적 매개변수를 지정하여 실행하십시오. 매개변수 설명 유형 group 작업이 실행되는 관리 대상의 그룹 수를 지정합니다. String 사용자 이름 작업 실행 시 대상에서 사용할 사용자 이름을 지정합니다. 사용자 이름 및 비밀번호가 지정되지 않고 보안이 사용 가능으로 설정된 경우, 작업 관리자에 있는 사용자 ID가 사용됩니다. String 비밀번호 작업 실행 시 대상에서 사용할 사용자 이름의 비밀번호를 지정합니다. 사용자 이름 및 비밀번호가 지정되지 않고 보안이 사용 가능으로 설정된 경우, 작업 관리자에 있는 사용자 ID가 사용됩니다. String privateKeyFile 작업 실행 시 대상에서 사용할 완전한 개인 키 파일을 지정합니다. 키 저장소의 전체 경로를 지정합니다. String passphrase 작업 실행 시 대상에서 사용할 완전한 비밀번호 문구를 지정합니다. 키 저장소에 비밀번호 문구가 필요한 경우, 비밀번호 문구를 지정하십시오. String useSudo 대체 사용자를 사용하여 대상 호스트에서 명령을 수행하도록 지정합니다. 기본값은 sudo를 사용하지 않는 것입니다. sudo 옵션은 AIX, HP-UX, Linux 및 Solaris 운영 체제에서만 지원됩니다. useSudo가 작업 실행 전에 사용자를 변경할 수 있게 한 다음 필요에 따라 대체 사용자의 사용자 이름 및 비밀번호를 지정하십시오. sudo는 "substitute user do"를 의미합니다. 대상 호스트에 비밀번호가 필요하지 않은 경우, 비밀번호 필드를 공백으로 두십시오. 다음은 올바른 선택 조합입니다.
- useSudo를 사용 가능하게 설정하고 sudoUsername 및 sudoPassword의 값을 지정하지 마십시오. 이러한 선택사항에서는 /etc/sudoers 파일에 설정된 기본 사용자와, 연결 사용자의 비밀번호를 사용합니다.
- useSudo를 사용 가능하게 설정하고, sudoUsername의 값을 지정하고, sudoPassword의 값을 지정하지 마십시오. 이러한 선택사항에서는 지정된 사용자와, 연결 사용자의 비밀번호를 사용합니다.
- useSudo를 사용 가능하게 설정하고, sudoUsername의 값 및 sudoPassword의 값을 지정하십시오. 이러한 선택사항에서는 지정된 사용자 및 sudo 비밀번호를 사용합니다.
부울 sudoUsername 대체 사용자의 사용자 이름을 지정합니다. sudoUsername 값을 지정하는 시기에 대한 정보는 useSudo 설명을 참조하십시오. String sudoPassword 대체 사용자의 비밀번호를 지정합니다. sudoPassword 값을 지정하는 시기에 대한 정보는 useSudo 설명을 참조하십시오. String description 작업에 대한 설명을 지정합니다. String activationDateTime 2006-05-03T10:30:45-0000 형식으로 작업을 활성화할 날짜 및 시간을 지정합니다. activationDateTime 매개변수 값의 -0000 섹션은 RFC 822 형식을 나타냅니다. GMT(Greenwich Mean Time)의 단축키로 Z를 지정할 수 있습니다(예: 2006-05-03T10:30:45Z. 시간대를 지정하지 않으면 시스템이 작업 관리자의 시간대를 사용합니다. String expirationDateTime 2006-05-03T10:30:45-0000 형식으로 작업의 만기 날짜를 지정합니다. activationDateTime 매개변수 값의 -0000 섹션은 RFC 822 형식을 나타냅니다. GMT(Greenwich Mean Time)의 단축키로 Z를 지정할 수 있습니다(예: 2006-05-03T10:30:45Z. 시간대를 지정하지 않으면 시스템이 작업 관리자의 시간대를 사용합니다. String executionWindow 해당 경우, 작업의 반복 간격을 지정합니다. String executionWindowUnit 반복 간격의 측정 단위를 지정합니다. 올바른 값은 HOURS, DAYS, WEEKS, MONTHS, CONNECT 및 ONCE입니다. 기본값은 HOURS입니다. String email 시스템이 작업 알림을 전송하는 이메일 주소를 지정합니다. String
작업 관리자 프로파일의 bin 디렉토리에서 wsadmin 명령을 입력하십시오. 이 주제에는 Jython 스크립트 언어로 작성된 예제가 표시됩니다.
사용 예제:
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp] -email admin@company.com ')
대화식 모드 사용법 예제:
AdminTask.submitJob('-interactive')
작업 결과 사용 예제:
submitJob 명령을 실행하면 124231200726586682와 같은 작업 토큰이 리턴됩니다. 작업 토큰에 대한 정보를 보려면 getJobTargetStatus 명령을 실행하십시오.
AdminTask.getJobTargetStatus('[-jobToken 124231200726586682]')
- NOT_ATTEMPTED 값은 시스템이 작업 완료를 시도하지 않았음을 지정합니다.
- DISTRIBUTED 값은 대상에 대해 에이전트가 작업을 수신했지만 작업이 완료되지 않았음을 지정합니다.
- ASYNC_IN_PROGRESS 값은 대상이 다른 작업과 동시에 작업을 실행 중임을 지정합니다.
- FAILED 값은 작업이 실패했음을 지정합니다.
- REJECTED 값은 대상이 작업 유형을 지원하지 않는 등의 이유로 대상이 작업을 거부했음을 지정합니다.
- SUCCEEDED 값은 작업이 성공적으로 완료되었음을 지정합니다.
- PARTIALLY_SUCCEEDED 값은 작업이 부분적으로 완료되었음을 지정합니다. 예를 들어, 부분적 성공은 대상 하나가 여러 서버를 나타내고 대상에 있는 일부 서버만 작업을 완료하는 경우에 발생할 수 있습니다.
일반적으로 작업 상태 결과는 DISTRIBUTED에서 ASYNC_IN_PROGRESS로 그리고 SUCCEEDED로 진행됩니다. 결과가 FAILED, REJECTED 또는 SUCCEEDED가 될 때까지 getJobTargetStatus 명령을 두 번 이상 실행해야 할 수도 있습니다.
기본적으로 작업은 하루(24시간) 동안 계속 활성화됩니다.
인벤토리 수집 작업 제출
인벤토리 관리 작업은 대상에서 인벤토리 데이터를 수집합니다. 이 인벤토리 데이터에는 사용 가능한 작업 유형 및 관리 자원(예: 각 대상에 대한 애플리케이션 및 서버)의 상태가 포함되어 있습니다.
대상이 호스트인 경우, 인벤토리 데이터에는 운영 체제 이름, 버전, Installation Manager, 패키지 그룹, 패키지, 프로파일 및 기타 자원에 대한 정보가 포함됩니다.
인벤토리 작업이 Liberty 자원을 찾게 하려면, WLP_WORKING_DIR, WLP_SHARED_DIR 또는 WLP_ADDITIONAL_DIRS 변수를 정의해야 합니다. Liberty 서버의 변수 설정을 참조하십시오.
![[IBM i]](../images/iseries.gif)
작업 매개변수
없음.사용법 예제
AdminTask.submitJob('-jobType inventory -targetList [Target1 Target2 Target3]')
대상 상태 수집 작업 제출
상태 관리 작업은 대상에서 상태 데이터를 수집합니다. 관리 자원(예: 각 대상에 대한 애플리케이션 및 서버)에서 데이터만 새로 고치려면 인벤토리 작업 대신 이 작업을 사용하십시오.
Liberty 서버가 대상이면, 이 작업은 Liberty 서버 자원의 서버 상태만 업데이트합니다. 새 서버 자원을 발견하거나 삭제된 서버 자원을 제거하지 않습니다. 새 서버 자원을 발견하려면 대신 인벤토리 작업을 제출하십시오.
작업 매개변수
없음.사용법 예제
AdminTask.submitJob('-jobType status -targetList [Target1 Target2 Target3]')
파일 관리 작업 제출
파일 관리 작업을 사용하여 파일을 수집, 분배 및 제거할 수 있습니다. 예를 들어, 파일을 작업 관리자에 전송하도록 collectFile 작업을 제출할 수 있습니다. distributeFile 작업은 작업 관리자에서 작업의 대상으로 파일을 전송합니다. removeFile 작업은 이전에 대상으로 분배된 파일을 제거합니다.
원격 호스트 대상에 파일 관리 작업을 사용할 수 있습니다. distributeFile을 사용하여 원격 호스트로 파일을 보내고, collectFile을 사용하여 원격 호스트에서 파일을 수집하고, removeFile을 사용하여 원격 호스트에서 파일을 삭제하십시오.
collectFile
collectFile 관리 작업은 대상 파일을 수집하여 작업 관리자에 전송합니다. 소스 위치가 파일이 아니라 디렉토리인 경우, 작업은 디렉토리 컨텐츠를 반복적으로 압축하여 압축된 zip 파일을 전송합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
source | 원하는 파일 또는 디렉토리의 소스 위치를 지정합니다. 시스템은 파일 위치가 대상의 profile_root 디렉토리에 상대적인지를 판별합니다. | String |
대상 | 대상 위치를 지정합니다. 이 값은 profile_root/config/temp/JobManagerName/jobToken/targetName 디렉토리에 상대적입니다. | String |
distributionProvider | 선택적으로 분배 프로바이더의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType collectFile -targetList [Target1]
-jobParams [[source logs][destination targetLocationOfFile]]]')
distributeFile
distributeFile 관리 작업은 작업 관리자에서 작업의 대상으로 파일을 전송합니다. 시스템은 파일을 사용할 후속 작업에 대비하여 파일을 대상에 저장합니다. installApplication 및 updateApplication 관리 작업은 대상에 있는 애플리케이션 컨텐츠의 위치로 distributeFile 작업에 제공하는 목적지를 참조합니다. 또한 이 작업을 사용하여 스크립트 파일 및 특성 기반 구성 파일을 분배할 수 있습니다.
처음에 작업 관리자에서 분배할 파일은 작업 관리자 프로파일의 /config/temp/JobManager 디렉토리에 있어야 합니다. 그러면, 시스템이 관리 에이전트 또는 배치 관리자 프로파일의 downloadedContent 디렉토리로 파일을 이동시킵니다. 대상 매개변수는 downloadedContent 디렉토리에 상대적이며, 파일 이름이거나 상대 경로 이름입니다. 별도의 서브디렉토리를 downloadedContent 디렉토리 아래 작성하여 다운로드한 파일을 구성하는 데 상대 경로를 사용할 수 있습니다.
- *ALLOBJ 및 *SECADM 권한이 있는 관리 사용자를 사용하여 명령 프롬프트에서 디렉토리를 profile_root/JobManagerName/config/temp로 변경하십시오.
- 다음 명령을 입력하십시오. mkdir JobManager
- 다음 명령을 입력하십시오. chown -R QEJBSVR JobManager
- 분배할 파일을 JobManager 디렉토리로 복사하십시오.
- 관리 콘솔에서 distributeFile 작업을 제출하십시오.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
source | 분배할 컨텐츠의 소스 위치를 지정합니다. | String |
대상 | 시스템이 컨텐츠를 저장하는 대상에 있는 대상 위치를 지정합니다. | String |
distributionProvider | 선택적으로 분배 프로바이더의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType distributeFile -targetList [Target1 Target2 Target3]
-jobParams [[source file:/MyApp.ear][destination MyApp.ear]]')
removeFile
removeFile 관리 작업은 이전에 대상으로 분배된 파일을 제거합니다. 위치 매개변수는 downloadedContent 디렉토리에 상대적이며, 파일이 분배될 때 대상 매개변수에 지정된 위치와 동일한 위치여야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
location | 대상에서 제거할 파일의 위치를 지정합니다. distributeFile 작업에서 대상 값을 사용하십시오. | String |
distributionProvider | 선택적으로 분배 프로바이더의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType removeFile -targetList [Target1 Target2 Target3]
-jobParams [location MyApp.ear]')
wsadmin 스크립트를 실행하는 작업 제출
작업을 제출하여 작업 관리자의 관리 대상에서 wsadmin 스크립트를 실행할 수 있습니다. 관리 대상은 배치 관리자 또는 연합되지 않은 애플리케이션 서버입니다. 관리 대상에서 wsadmin 스크립트를 실행하기 전에, distributeFile 작업을 사용하여 wsadmin 스크립트 및 스크립트 프로파일을 작업 관리자에서 관리 대상으로 전송하십시오. 파일 분배 시 지정한 대상 값을 모두 기억해두십시오. 그런 다음, 다음 작업을 사용하여 wsadmin 스크립트를 실행하십시오. scriptFileLocation 매개변수의 대상 값을 사용하십시오. 프로파일 대상 값을 지정한 경우, 선택적으로 profileLocation 매개변수의 프로파일 대상 값을 사용하십시오.
runWsadminScript 작업의 상태 결과는 스크립트의 리턴 코드에 따라 다릅니다. 리턴 코드가 0이면 작업이 성공한 것입니다. 리턴 코드가 0이 아닌 값이면 작업이 실패한 것입니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
scriptFileLocation | 관리 대상에서 실행할 스크립트 파일의 위치를 지정합니다. 위치는 파일이 대상에 분배될 때 제공된 목적지입니다. | String |
profileLocation | 선택적으로 wsadmin 스크립트를 사용하여 실행할 프로파일 스크립트의 위치를 지정합니다. 이 매개변수는 wsadmin의 -profile 프로파일에 해당합니다. 위치는 파일이 대상에 분배될 때 지정된 목적지입니다. | String |
scriptParameters | 선택적으로 wsadmin 스크립트에 제공할 매개변수를 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType runWsadminScript -targetList [DmgrManagedNodeName]
-jobParams [ [scriptFileLocation myScript.py] [profileLocation scriptProfile.py] [scriptParameters [param1 param2]] ]]')
명령 매개변수(예: argv[] 명령 매개변수)에 대한 여러 키워드-값 쌍을 처리하는 wsadmin 스크립트의 경우, scriptParameters를 사용하여 키워드 및 값을 지정하십시오.
AdminTask.submitJob('[-jobType runWsadminScript -targetList [myNode01]
-jobParams [ [scriptFileLocation myScript.py] [scriptParameters [-keyword1 value1 -keyword2 value2]] ]]')
애플리케이션 관리 작업 제출
애플리케이션 관리 작업을 사용하여 애플리케이션 서버에서 애플리케이션을 설치, 업데이트, 제거 및 제어할 수 있습니다. 예를 들어, 사용자 환경에서 애플리케이션을 배치하는 distributeFile, installApplication 및 startApplication 작업을 제출할 수 있습니다. 사용자 환경에서 애플리케이션을 제거하려면 stopApplication, uninstallApplication 및 removeFile 작업을 제출하십시오. 다음 애플리케이션 관리 작업을 사용하여 애플리케이션 구성을 관리하십시오.
installApplication
installApplication 관리 작업은 애플리케이션 또는 애플리케이션 요소를 설치하여 대상 환경으로 바인드합니다. 애플리케이션을 설치하려면 distributeFile 작업을 실행하고 배치 가능한 컨텐츠를 대상으로 분배해야 합니다.
installApplication 작업은 바인딩 정보를 제공하기 위한 수단이나 기타 배치 속성을 제공하지 않습니다. 해당 성능이 필요한 경우, runWsadminScript 또는 configureProperties 작업을 사용할 수 있습니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
applicationName | 설치할 애플리케이션을 식별하는 데 사용할 애플리케이션 이름을 지정합니다. 종종 이 이름은 엔터프라이즈 애플리케이션의 기본 파일 이름(예: MyApp.ear의 경우 MyApp)이지만 사용자가 원하는 이름을 선택할 수 있습니다. | String |
appLocation | 선택적으로 설치할 애플리케이션 파일의 위치를 지정합니다.
기본적으로 installApplication 작업은 .ear 파일 형식 표기법을
애플리케이션 이름에 추가하며, 기본 대상 위치에서 애플리케이션을
검색합니다. 따라서 applicationName에 대해 MyApp를 지정한 경우, 기본적으로 appLocation은 관리 대상의 downloadedContent/MyApp.ear입니다. appLocation에 값을 지정하는 경우, 애플리케이션을 분배할 때 지정한 대상 값을 사용하십시오. |
String |
serverName | 선택적으로 시스템이 애플리케이션을 설치하는 서버의 이름을 지정합니다. | String |
nodeName | 선택적으로, WebSphere Application Server, Network Deployment 셀에 있는 서버를 식별하는 원하는 노드를 지정합니다. | String |
clusterName | 선택적으로 애플리케이션이 설치된 클러스터의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp]]')
또는
AdminTask.submitJob('-jobType installApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')
startApplication
startApplication 관리 작업은 대상에서 이전에 설치된 애플리케이션을 시작합니다. 시스템은 애플리케이션 상태를 활성 또는 실행 중으로 변경하고, 실행 시 애플리케이션을 로드하며, 클라이언트 요청을 수신하도록 애플리케이션을 엽니다. 이는 애플리케이션 배치 프로세스의 마지막 단계입니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
applicationName | 시작할 애플리케이션의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType startApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
stopApplication
stopApplication 관리 작업은 대상에 있는 애플리케이션을 중지시킵니다. 시스템은 애플리케이션 상태를 중지됨으로 변경하고, 클라이언트 요청을 더 이상 수신하지 않습니다. startApplication 작업을 사용하여 애플리케이션을 다시 시작할 수 있습니다. 이는 애플리케이션 제거 프로세스의 첫 번째 단계입니다.
매개변수 | 설명 | 유형 |
---|---|---|
applicationName | 중지할 애플리케이션의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType stopApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
updateApplication
updateApplication 관리 작업은 대상 환경에서 애플리케이션 또는 애플리케이션 요소를 업데이트합니다. 애플리케이션을 업데이트하려면 distributeFile 작업을 실행하고 배치 가능한 컨텐츠를 대상으로 분배해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
applicationName | 업데이트할 애플리케이션을 식별하는 데 사용할 애플리케이션 이름을 지정합니다. 종종 이 이름은 엔터프라이즈 애플리케이션의 기본 파일 이름(예: MyApp.ear의 경우 MyApp)이지만 사용자가 원하는 이름을 선택할 수 있습니다. | String |
appLocation | 선택적으로 설치할 애플리케이션 파일의 위치를 지정합니다.
기본적으로 updateApplication 작업은 .ear 파일 형식 표기법을
애플리케이션 이름에 추가하며, 기본 대상 위치에서 애플리케이션을
검색합니다. 따라서 applicationName에 대해 MyApp를 지정한 경우, 기본적으로 appLocation은 관리 대상의 downloadedContent/MyApp.ear입니다. appLocation에 값을 지정하는 경우, 애플리케이션을 분배할 때 지정한 대상 값을 사용하십시오. |
String |
serverName | 선택적으로 시스템이 애플리케이션을 업데이트하는 서버의 이름을 지정합니다. | String |
nodeName | 선택적으로, WebSphere Application Server, Network Deployment 셀에 있는 서버를 식별하는 원하는 노드를 지정합니다. | String |
clusterName | 선택적으로 애플리케이션이 업데이트되는 클러스터의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp]]')
또는
AdminTask.submitJob('-jobType updateApplication -targetList [Target1 Target2 Target3]
-jobParams [[applicationName MyApp][appLocation MyApp.ear][clusterName TestCluster]]')
uninstallApplication
uninstallApplication 관리 작업은 대상에서 애플리케이션을 설치 제거합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
applicationName | 제거할 애플리케이션의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType uninstallApplication -targetList [Target1 Target2 Target3]
-jobParams [applicationName MyApp]')
서버 관리 작업 제출
시스템 관리자는 애플리케이션 서버 구성 작업을 사용하여 원격 및 로컬 애플리케이션 서버에 대한 구성을 수정할 수 있습니다.
createApplicationServer
createApplicationServer 관리 작업은 대상 환경에서 애플리케이션 서버를 작성합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 작성할 애플리케이션 서버의 이름을 지정합니다. 서버 이름은 대상 노드에서 고유해야 합니다. | String |
nodeName | 대상이 WebSphere Application Server, Network Deployment 셀인 경우, 서버를 작성할 셀의 노드를 표시하도록 노드 이름을 지정해야 합니다. 기본 노드에 대한 노드 이름은 지정할 필요가 없습니다. | String |
templateName | 선택적으로 서버 템플리트를 지정합니다. | String |
templateLocation | 선택적으로 템플리트가 저장되는 위치를 지정합니다. 템플리트 위치를 지정할 필요가 없는 경우 기본 시스템 정의 위치를 사용하십시오. | String |
genUniquePorts | 선택적으로 서버에 대한 고유 HTTP 포트를 생성하도록 지정합니다. 기본적으로 제품은 고유 포트 번호를 생성합니다. | 부울 |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
사용법 예제
AdminTask.submitJob('-jobType createApplicationServer -targetList
[Node1 Node2 Node3] -jobParams [serverName AppServer01]')
deleteApplicationServer
deleteApplicationServer 관리 작업은 대상 환경에서 애플리케이션 서버를 제거합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 삭제할 애플리케이션 서버의 이름을 지정합니다. | String |
nodeName | 대상이 WebSphere Application Server, Network Deployment 셀인 경우, 서버를 삭제할 셀의 노드를 표시하도록 노드 이름을 지정해야 합니다. 기본 노드에 대한 노드 이름은 지정할 필요가 없습니다. | String |
사용법 예제
AdminTask.submitJob('-jobType deleteApplicationServer -targetList
[Node1 Node2 Node3] -jobParams [serverName AppServer01]')
createProxyServer
createProxyServer 관리 작업은 작업 관리자의 관리 대상인 배치 관리자 셀에서 프록시 서버를 작성합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 작성할 프록시 서버의 이름을 지정합니다. | String |
nodeName | 프록시 서버가 상주할 노드를 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType createProxyServer -jobParams [[serverName
testServer1][nodeName testNode1]] ]')
deleteProxyServer
deleteProxyServer는 작업 관리자의 관리 대상인 배치 관리자 셀에서 프록시 서버를 삭제합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 삭제할 프록시 서버의 이름을 지정합니다. | String |
nodeName | 프록시 서버가 상주하는 노드를 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType deleteProxyServer -jobParams [[serverName
testServer1][nodeName testNode1]] ]')
createCluster
createCluster 관리 작업은 클러스터를 작성합니다. 셀에서 클러스터를 작성하려면 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterConfig.clusterName | 서버 클러스터의 이름을 지정합니다. | String |
clusterConfig.preferLocal | 선택적으로 클러스터의 노드 범위 라우팅 최적화를 사용 가능으로 설정합니다. | String |
clusterConfig.clusterType | 선택적으로 서버 클러스터의 유형을 지정합니다. | String |
![]() |
![]() |
![]() |
replicationDomain.createDomain | 선택적으로 새 클러스터의 이름으로 설정된 이름의 복제 도메인을 작성합니다. | String |
convertServer.serverNode | 선택적으로 클러스터의 첫 번째 멤버로 변환할 기본 서버의 노드 이름을 지정합니다. | String |
convertServer.serverName | 선택적으로 클러스터의 첫 번째 멤버로 변환할 기존 서버의 이름을 지정합니다. | String |
convertServer.memberWeight | 선택적으로 새 클러스터 멤버의 가중치 값을 지정합니다. | String |
convertServer.nodeGroup | 선택적으로 모든 클러스터 멤버 노드가 속해야 하는 노드 그룹의 이름을 지정합니다. | String |
convertServer.replicatorEntry | 선택적으로 이 멤버에 대한 복제자 항목이 클러스터 복제 도메인에서 작성되도록 지정합니다. 복제자 항목은 HTTP 세션 데이터 복제에 사용됩니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterConfig.clusterName newCluster1]]')
createCluster 명령에 추가 매개변수를 지정하는 경우, 매개변수의 -jobParams 목록에서 [stepName.parameterName parameterValue] 형식을 사용하십시오.
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterConfig.clusterName newCluster1] [clusterConfig.clusterType PROXY_SERVER] ]]')
deleteCluster
deleteCluster 관리 작업은 클러스터를 삭제합니다. 셀에 있는 클러스터를 삭제하려면 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterName | 삭제할 서버 클러스터의 이름을 지정합니다. | String |
replicationDomain.deleteRepDomain | 선택적으로 클러스터가 삭제되면 클러스터 복제 도메인이 삭제되도록 표시하는 데 사용됩니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType deleteCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterName newCluster1] [replicationDomain.deleteRepDomain true] ]]')
createClusterMember
createClusterMember 관리 작업은 셀에 있는 클러스터에서 클러스터 멤버를 작성합니다. 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterName | 새 클러스터 멤버가 속하는 서버 클러스터의 이름을 지정합니다. | String |
memberConfig.memberNode | 새 클러스터 멤버가 상주할 노드의 이름을 지정합니다. | String |
memberConfig.memberName | 새 클러스터 멤버의 이름을 지정합니다. | String |
memberConfig.memberWeight | 선택적으로 새 클러스터 멤버의 가중치를 지정합니다. | String |
memberConfig.memberUUID | 선택적으로 새 클러스터 멤버의 UUID(Universal Unique Identifier)를 지정합니다. | String |
memberConfig.genUniquePorts | 선택적으로 서버에 정의된 HTTP 전송에 대한 고유 포트 번호를 생성합니다. | String |
memberConfig.replicatorEntry | 선택적으로 이 멤버에 대한 복제자 항목이 클러스터 복제 도메인에서 작성되도록 지정합니다. 복제자 항목은 HTTP 세션 데이터 복제에 사용됩니다. | String |
![]() |
![]() |
![]() |
firstMember.templateName | 선택적으로 새 클러스터 멤버의 모델로 사용할 애플리케이션 서버 템플리트의 이름을 지정합니다. | String |
firstMember.templateServerNode | 선택적으로 새 클러스터 멤버의 템플리트로 사용할 기존 서버의 노드 이름을 지정합니다. | String |
firstMember.templateServerName | 선택적으로 새 클러스터 멤버의 모델로 사용할 서버의 이름을 지정합니다. | String |
firstMember.nodeGroup | 선택적으로 모든 클러스터 멤버 노드가 속해야 하는 노드 그룹의 이름을 지정합니다. | String |
firstMember.coreGroup | 선택적으로 모든 클러스터 멤버가 속해야 하는 코어 그룹의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType createClusterMember
-targetList [DmgrManagedNodeName]
-jobParams [ [memberConfig.memberName newCluster1mem1]
[memberConfig.memberNode FederatedNode] [clusterName newCluster1] ]]')
deleteClusterMember
deleteClusterMember 관리 작업은 셀에 있는 클러스터에서 클러스터 멤버를 삭제합니다. 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다. 클러스터는 연합 노드에 하나 이상의 클러스터 멤버가 있어야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterName | 삭제될 클러스터 멤버가 속하는 서버 클러스터의 이름을 지정합니다. | String |
memberNode | 클러스터 멤버가 상주하는 노드의 이름을 지정합니다. | String |
memberName | 삭제될 클러스터 멤버의 서버 이름을 지정합니다. | String |
replicatorEntry.deleteEntry | 선택적으로 이 클러스터 멤버의 서버 이름을 가진 복제자 항목을 클러스터의 복제 도메인에서 삭제하도록 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType deleteClusterMember -targetList
[DmgrManagedNodeName] -jobParams [ [memberName newCluster1mem1]
[memberNode FederatedNode] [clusterName newCluster1] ]]')
configureProperties
configureProperties 관리 작업은 특성 파일을 애플리케이션 서버 구성에 적용합니다. 이 작업은 AdminTask 오브젝트에 대한 PropertiesBasedConfiguration 명령 그룹에서 applyConfigProperties 명령을 사용하여 대상에 대한 특성을 구성합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
propertiesFileLocation | 대상 애플리케이션 서버에 적용할 특성 파일의
위치를 지정합니다. 이 매개변수에 지정된 경로는 배치 관리자의 profile_root/downloadedContent 디렉토리에서 상대적인 경로입니다. configureProperties 관리 작업을 시작하기 전에 이 디렉토리가 없으면 작성해야 합니다. |
String |
variableMapLocation | 선택적으로 특성 파일에 포함시킬 변수 맵 파일의 위치를 지정합니다. | String |
사용법 예제
AdminTask.submitJob('-jobType configureProperties -targetList
[Target1 Target2 Target3] -jobParams [propertiesFileLocation myProperties.props]')
서버 런타임 관리 작업 제출
시스템 관리자는 애플리케이션 서버 런타임 제어 작업을 사용하여 애플리케이션 서버를 시작 및 중지할 수 있습니다.
startServer
startServer 관리 작업은 원하는 애플리케이션 서버를 실행 및 초기화합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 시작할 애플리케이션 서버를 지정합니다. | String |
nodeName | 작업 대상이 배치 관리자 노드인 경우, 서버가 있는 연합 노드의 이름을 지정하십시오. | String |
사용법 예제
AdminTask.submitJob('-jobType startServer -targetList [Target1 Target2 Target3]
-jobParams [serverName AppServer01]')
stopServer
stopServer 관리 작업은 원하는 애플리케이션 서버를 중지합니다. 애플리케이션 서버를 다시 시작하려면 startServer 작업을 사용하십시오.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 중지할 애플리케이션 서버를 지정합니다. | String |
nodeName | 작업 대상이 배치 관리자 노드인 경우, 서버가 있는 연합 노드의 이름을 지정하십시오. | String |
사용법 예제
AdminTask.submitJob('-jobType stopServer -targetList [Target1 Target2 Target3]
-jobParams [serverName AppServer01]')
startCluster
startCluster 관리 작업은 클러스터를 시작합니다. 셀에 있는 클러스터를 시작하려면 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterName | 시작할 클러스터의 이름을 지정합니다. | String |
rippleStart | 선택적으로 클러스터가 반복 시작으로 시작되는지 여부를 지정합니다. 기본값은 false입니다. | String |
사용법 예제
다음 예제는 클러스터를 시작합니다.
AdminTask.submitJob('[-jobType startCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterName newCluster1]]')
다음 예제는 클러스터를 반복 시작합니다.
AdminTask.submitJob('[-jobType createCluster -targetList [DmgrManagedNodeName]
-jobParams [ [clusterName newCluster1] [rippleStart true] ]]')
stopCluster
stopCluster 관리 작업은 클러스터를 중지합니다. 셀에 있는 클러스터를 중지하려면 작업 관리자를 사용하여 셀의 배치 관리자를 등록해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
clusterName | 중지할 클러스터의 이름을 지정합니다. | String |
사용법 예제
AdminTask.submitJob('[-jobType stopCluster -targetList [DmgrManagedNodeName]
-jobParams [clusterName newCluster1]]')
명령 실행 작업 제출
시스템 관리자는 작업 관리자의 runCommand 작업을 사용하여 원격 호스트에서 명령을 실행할 수 있습니다. 명령은 app_server_root/bin 디렉토리에 있는 startServer와 같은 명령행 유틸리티, wsadmin 명령 또는 운영 체제 명령일 수 있습니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
command | 실행할 명령의 이름을 지정합니다. | String |
workingDir | 원격 호스트에서 명령 파일의 위치를 지정합니다. 기본값의 원격 호스트의 app_server_root 디렉토리입니다. | String |
사용법 예제
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command ./versionInfo.sh]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password ******* -jobParams [[command versionInfo.bat]]')
![[Linux]](../images/linux.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "./java -version"][workingDir /opt/IBM/WebSphere/AppServer/java/bin]]')
![[Windows]](../images/windows.gif)
AdminTask.submitJob('-jobType runCommand -targetList Target1
-username user1 -password *******
-jobParams [[command "java -version"][workingDir C:/WAS_v800/IBM/WebSphere/AppServer/java/bin]]')
프로파일 관리 작업 제출
시스템 관리자는 작업 관리자의 manageprofiles 작업을 사용하여 WebSphere Application Server 프로파일을 작성, 기능 보강 또는 삭제할 수 있습니다. 이 작업은 manageprofiles 관리 명령을 실행합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
wasHome | WebSphere Application Server 설치의 위치를 지정합니다. 이는 원격 호스트의 app_server_root 경로입니다. | String |
responseFile | 작업 관리자에 상주하는 manageprofiles 응답 파일의 위치를 지정합니다. | String |
사용자 이름 | 작업 실행 시 대상에서 사용할 사용자 이름을 지정합니다. 사용자 이름 및 비밀번호가 지정되지 않고 보안이 사용 가능으로 설정된 경우, 작업 관리자에 있는 사용자 ID가 사용됩니다. | String |
비밀번호 | 작업 실행 시 대상에서 사용할 사용자 이름의 비밀번호를 지정합니다. 사용자 이름 및 비밀번호가 지정되지 않고 보안이 사용 가능으로 설정된 경우, 작업 관리자에 있는 사용자 ID가 사용됩니다. | String |
사용법 예제
AdminTask.submitJob('-jobType manageprofiles -targetList Target1 -username user1 -password *******
-jobParams [[wasHome /WAS80GA][responseFile /temp/mp1.txt]]')
Installation Manager 작업 제출
시스템 관리자는 Installation Manager 작업을 사용하여 Installation Manager 인스턴스를 설치하고, Installation Manager를 저장소로 업데이트하고, Installation Manager 오퍼링을 관리하며, WebSphere Application Server 제품을 설치할 수 있습니다.

installIM
installIM 관리 작업에서는 작업 관리자에서 호스트로 설치 킷을 보내서 Installation Manager의 새 인스턴스를 설치합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
kitPath | Installation Manager 킷의 위치를 지정합니다. 이 매개변수를 지정하지 않는 경우, 작업은 기본 위치에서 최신 IM 설치 킷을 찾습니다. | String |
dataPath | Installation Manager 데이터의 위치를 지정합니다. | String |
installPath | 대상 호스트에 Installation Manager를 설치할 위치를 지정합니다. 동일한 호스트의 현재 셀 내에 여러 설치 위치가 있는 경우에만 이 매개변수를 지정하십시오. | String |
skipPrereqCheck | true로 설정하면,
Installation Manager 설치 시 필수 소프트웨어 검사를 수행하지
않도록 그리고 Installation Manager 디스크 공간 검사를 사용할 수 없도록
선택적으로 지정합니다. 기본값은 false입니다. . true 값을 지정하지 않으면 필수 소프트웨어 검사 및 디스크 공간 검사가 수행됩니다. |
부울 |
acceptLicense | true로 설정해야 합니다. 이 매개변수를 지정하지 않는 경우, 작업이 실패합니다. | 부울 |
사용법 예제
AdminTask.submitJob('-jobType installIM -targetList [Host1 Host2 Host3]
-jobParams [acceptLicense TRUE] [kitPath /IM/agent.installer.zip] -username user1 -password pw')
IBM Installation Manager 설치 킷 경로를 지정하지 않는 경우, installIM 작업이 작업 관리자의 설치 킷 저장소에서 대상 플랫폼에 적합한 최신 IBM Installation Manager 설치 킷을 검색합니다. 기본적으로, 설치 킷 저장소는 app_server_root/IMKits입니다. 작업 관리자에서 위치를 변경할 수 있습니다. 을 클릭한 후 Installation Manager 설치 킷 위치를 다른 위치로 변경하십시오.
updateIM
updateIM 관리 작업은 작업 관리자의 설치 킷을 보내지 않고 저장소의 기존 Installation Manager를 업데이트합니다. 이 updateIM 명령을 실행하려면 Installation Manager 버전 1.4 이상이 있어야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
저장소(repository) | Installation Manager를 업데이트할 저장소의 위치를 지정합니다. 경로는 작업 관리자 컴퓨터의 로컬 파일에 대한 경로이거나 원격 파일을 가리키는 URL입니다. | String |
installPath | Installation Manager 설치의 위치를 지정합니다. | String |
keyringFile | 응답 파일에 지정된 오퍼링 저장소에 로그인해야 하는 경우, 사용할 키 링 파일의 위치를 지정합니다. 저장소에 로그인하지 않아도 되는 경우, 이 매개변수를 지정하지 마십시오. | String |
keyringPassword | 선택적으로, 키 링 파일의 비밀번호를 지정합니다. 키 링 파일에 비밀번호가 필요하지 않은 경우, 이 매개변수를 지정하지 마십시오. | String |
acceptLicense | true로 설정해야 합니다. 이 매개변수를 지정하지 않는 경우, 작업이 실패합니다. | 부울 |
사용법 예제
AdminTask.submitJob('-jobType updateIM -targetList [Host1]
-jobParams [acceptLicense TRUE][ [repository /IM/repository] [installPath /IM] ]')
manageOfferings
manageOfferings 관리 작업은 Installation Manager의 오퍼링을 설치, 업데이트, 수정, 롤백 또는 설치 제거할 수 있습니다. Installation Manager 응답 파일을 사용하는 작업 및 선택적으로 키 링 파일을 제출하여 원격 저장소를 사용하는 오퍼링을 관리하십시오.
경로는 드라이브 이름으로 시작해야 합니다.
경로는 /로 시작해야 합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
responseFile | Installation Manager 오퍼링을 업데이트, 수정, 롤백 또는 설치 제거할 응답 파일의 위치를 지정합니다. 경로는 작업 관리자 컴퓨터의 로컬 파일에 대한 경로이거나 원격 파일을 가리키는 URL입니다. | String |
IMPath | Installation Manager 설치의 위치를 지정합니다. 이 매개변수가 지정되지 않으면, 작업은 대상 호스트에서 기본 Installation Manager의 경로를 발견한 후 사용하려고 시도합니다. Installation Manager가 없거나 둘 이상의 Installation Manager가 있는 경우, 작업이 실패합니다. 이 상황에서, submitJob manageOfferings 명령은 Installation Manager 경로를 지정해야 합니다. | String |
keyringFile | 응답 파일에 지정된 오퍼링 저장소에 로그인해야 하는 경우, 사용할 키 링 파일의 위치를 지정합니다. 응답 파일에 로그인하지 않아도 되는 경우, 이 매개변수를 지정하지 마십시오. | String |
keyringPassword | 선택적으로, 키 링 파일의 비밀번호를 지정합니다. 키 링 파일에 비밀번호가 필요하지 않은 경우, 이 매개변수를 지정하지 마십시오. | String |
사용법 예제
AdminTask.submitJob('-jobType manageOfferings -targetList [Host1 Host2 Host3]
-jobParams [responseFile /IM/agent.installer.zip] -username user1 -password pw')
findIMDataLocation
findIMDataLocation 관리 작업은 Installation Manager 데이터 위치를 추가하거나 검색할 수 있습니다.
- 추가 IM 데이터 위치 필드에 지정된 데이터 위치와 검색 중(시스템 검색이 true로 설정된 경우)에 작업에서 발견한 데이터 위치의 유효성을 검증합니다.
- 향후 사용을 위해 올바른 데이터 위치를 기존 데이터 위치 목록에 추가합니다.
- 중복 데이터 위치 제거
- 인벤토리 작업 실행
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
targetList | 작업의 대상 시스템 위치를 지정합니다. | String |
searchSystem | Installation Manager 데이터 위치에 대한 전체 대상 시스템을 검색할 CIM을 지정합니다. | String |
dataLocations | 사용 가능한 Installation Manager 데이터의 위치를 지정합니다. 작업은 관리 콘솔에 등록된 현재 대상 사용자가 사용할 수 있는 Installation Manager 데이터 위치만 나열합니다. | String |
사용법 예제
AdminTask.submitJob ('[-jobType findDataLocation -targetList targetList -jobParams [[searchSystem true]
[datalocations path_to_data_locations_separated_by_semicolon] ]]')
Liberty 작업 제출
Liberty 자원을 설치 및 설치 제거하고, Liberty 서버를 시작 및 중지하는 작업을 제출할 수 있습니다. Liberty 서버는 기능을 손쉽게 추가하고 기존 XML 구성 파일을 편집하여 관리하는 빨리 시작할 수 있는 동적 애플리케이션 서버입니다.
- JAVA_HOME 특성을 server.env 파일의 JDK 또는 JRE 위치로 설정하십시오.
작업은 JAVA_HOME 특성을 읽고 명령을 실행하기 전에 대상 환경에서 설정하여 서버를 시작
또는 중지시킵니다. 그러나 서버를 직접 시작 또는 중지하는 경우 Liberty 서버 명령에서
이 특성을 사용하지 않습니다.
server.env 파일은 EBCDIC 인코딩 형식이어야 합니다.
JAVA_HOME 특성을 사용자 .bashrc 파일에 있는 JDK 또는 JRE 위치로 설정하십시오.
JDK 또는 JRE 경로를 PATH 환경 변수에 추가하십시오.
JAVA_HOME 특성을 시스템 환경 변수로서 JDK 또는 JRE 위치로 설정하십시오.
JDK 또는 JRE 경로를 PATH 시스템 변수에 추가하십시오.
JAVA_HOME이 server.env 또는 사용자 환경에서 지정되지 않으면, 작업 관리자는 사용자 검색 경로에서 JDK 또는 JRE를 검색합니다.
installLibertyProfileResources
installLibertyProfileResources 작업은 Liberty 이미지에 있는 자원을 루트 디렉토리와 관련된 대상 디렉토리로 추출합니다. 이 작업을 실행하기 전에, 다음 조건이 존재해야 합니다.
- 호스트 컴퓨터를 작업 관리자에 등록해야 합니다.
- 이미지인 압축 zip 파일에는 작업 관리자 규칙에 맞는 디렉토리 구조로 된 Liberty 자원이 있어야 합니다. Liberty 자원 패키징을 참조하십시오.
- 대상 호스트에 자원을 설치할 루트 디렉토리를 정의해야 합니다. 최소한 대상 호스트에 있는 올바른 디렉토리로 WLP_WORKING_DIR 변수를 설정하십시오. 대상 호스트의 공유 디렉토리에 자원을 설치하려면 WLP_SHARED_DIR 변수를 올바른 디렉토리로 설정해야 합니다. Liberty 서버의 변수 설정을 참조하십시오.
자원 배치 중 제품은 각 Liberty 서버 내의 bootstrap.properties 파일에 변수 대체를 적용합니다.
server.env 파일은 EBCDIC 인코딩 형식이어야 합니다.
- 호스트에서 unzip 유틸리티를 사용하십시오.
- 인벤토리 작업으로 발견된 SDK(Software Development Kit)의 jar 유틸리티를 포함한 jar 유틸리티를 호스트에 사용하십시오.
특별히 관리자가 사용 불가능하게 설정하지 않으면 작업하는 동안 원격 호스트에 복사되는 unzip 유틸리티를 사용하십시오. 작업 완료 후에는 unzip 유틸리티가 삭제됩니다.
- 작업 관리자에서 zip 파일의 압축을 풀고 대상 호스트에 한 번에 하나씩 파일을 복사하십시오. 이 방법은 Liberty 서버 이미지가 작업 관리자에 있는 경우에만 적용됩니다.
자원 인스턴스가 이미 대상 디렉토리에 있는 경우 자원을 설치하지 않으면 작업이 실패합니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
image | Liberty 이미지를 제공하는 압축 파일이 작업 관리자 호스트에 있는 경우,
압축 파일의 전체 경로 이름을 지정합니다. 예: ![]() ![]() ![]() ![]()
![]()
|
String |
url | Liberty 자원을 제공하는 압축 파일이 작업 관리자 호스트에 없는 경우,
압축 파일의 URL 경로를 지정합니다. URL(Universal Resource Locator)의 지원되는
스킴 이름에는 http, https, ftp 및
file이 포함됩니다. 제한사항: file 이외의 URL 프로토콜을 지정하려면,
대상 호스트에 wget 유틸리티가 있어야 합니다. 대상 호스트의 wget
유틸리티가 지원하는 http, https 또는 ftp 원격 다운로드
프로토콜을 선택하십시오. wget 유틸리티가 선택한 프로토콜을 지원하지
않으면, 작업이 자원을 설치할 수 없습니다.
예를 들어, 자원 파일 my_liberty_server.zip에 다음 URL 중 하나를 지정하십시오. Liberty 서버 자원이 HTTP 또는 HTTPS 서버에 있는 경우:
자원이 FTP 서버에 있는 경우:
자원이 대상 호스트 컴퓨터에 있는 경우, URL이 파일 스킴을 사용하여 압축 파일의 경로 및 이름을 설명할 수 있습니다. ![]() ![]() ![]() ![]()
![]()
URL이 비밀번호로 보호되는 경우, urluser 및 urlpassword의 값도 지정해야 합니다. |
String |
share | 공유 디렉토리에 Liberty 자원을 설치하는지 여부를 지정합니다. true로 설정하면,
자원이 WLP_SHARED_DIR 변수로 정의된 위치에 설치됩니다. WLP_SHARED_DIR 변수가 정의되지
않았거나 올바른 디렉토리를 지정하지 않는 경우, 제품은
오류를 리턴하고 이미지에서 자원을 추출하지 않습니다. 기본값인 false로 설정하면, 작업은 WLP_WORKING_DIR 변수로 정의된 위치에 자원을 설치합니다. |
부울 |
urluser | URL의 사용자 이름을 지정합니다. URL을 지정했고 URL이 비밀번호로 보호되는 경우, 사용자 이름을 지정해야 합니다. 그렇지 않으면, urluser에 값을 제공하지 마십시오. | String |
urlpassword | urluser가 URL에 액세스하는 데 필요한 비밀번호를 지정합니다. URL을 지정했고 URL이 비밀번호로 보호되는 경우, 비밀번호를 지정해야 합니다. 그렇지 않으면, urlpassword에 값을 제공하지 마십시오. | String |
사용법 예제
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [image /tmp/liberty/wlpwithjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [url file://c:/LibertyWorking/LibertyWorkingwjava.zip] [share FALSE] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword ftp_pwd] [url ftp://www.mycompany.com/projects/liberty/image-0111003.zip]
[share FALSE] [urluser ftp_user] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword http_pwd] [url http://www.mycompany.com/projects/liberty/image-0111003.zip]
[share FALSE] [urluser http_user] ]]')
AdminTask.submitJob('[-jobType installLibertyProfileResources -targetList [host_name]
-description installLibertyProfileResources
-jobParams [ [urlpassword http_pwd] [url https://www.mycompany.com/projects/liberty/image-0111003.zip]
[share TRUE] [urluser http_user] ]]')
uninstallLibertyProfileResources
uninstallLibertyProfileResources 작업에서는 작업 관리자에 의한 관리에서 자원을 제거합니다. 이전에 자원은 installLibertyProfileResources 작업에 의해 호스트의 대상 디렉토리에 설치되었고, Liberty 이미지를 압축 해제하는 수동 설치 후에는 인벤토리 작업에 의해 발견되었습니다.
- 명령은 둘 이상의 자원 유형을 제거하도록 지정합니다.
- 자원 이름은 동일한 이름의 둘 이상의 자원으로 해석됩니다.
- 작업 관리자가 액세스하고 검색할 수 있는 디렉토리에 자원이 없습니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
projectName | 제거할 프로젝트의 이름 또는 자원 ID를 지정합니다. 제품은 프로젝트에 대한 서버를 모두 검색합니다. 실행 중인 식별된 각 서버의 경우, 제품은 자원을 제거하기 전에 서버를 중지시킵니다. | String |
runtimeName | 제거할 Liberty 런타임의 이름 또는 자원 ID를 지정합니다. 제품은 런타임에 대한 서버를 모두 검색합니다. 실행 중인 식별된 각 서버의 경우, 제품은 자원을 제거하기 전에 서버를 중지시킵니다. | String |
sdkName | 제거할 SDK(Software Development Kit)의 이름 또는 자원 ID를 지정합니다. | String |
serverName | 제거할 서버의 이름 또는 자원 ID를 지정합니다. 서버가 실행 중인 경우, 제품은 자원을 제거하기 전에 서버를 중지시킵니다. | String |
applicationBinaryName | 제거할 애플리케이션 2진의 이름 또는 자원 ID를 지정합니다. | String |
forceDelete | 선택사항으로서, 상태를 발견할 수 없는 경우라도 자원을 삭제하는지 여부를 지정합니다. 기본값은 false로서 자원을 삭제하지 않는 것입니다. 값이 true인 경우, 서버 자원의 상태를 발견할 수 없거나 서버를 중지할 수 없는 경우에도 서버 자원을 삭제합니다. 서버의 상태를 발견할 수 없는 경우, 이 forceDelete 옵션이 지정된 경우가 아니면 uninstallLibertyProfileResources 작업에 실패합니다. | 부울 |
사용법 예제
다음 예제는 작업 관리자 관리에서 DefaultWebApplication.war 애플리케이션 2진을 제거합니다.
AdminTask.submitJob('[-jobType uninstallLibertyProfileResources -targetList [host_name]
-description uninstallLibertyProfileResources
-jobParams [ [applicationBinaryName DefaultWebApplication.war] ]]')
startLibertyProfileServer
startLibertyProfileServer 작업은 하나 이상의 Liberty 서버 자원을 시작합니다. 서버 자원의 상태는 중지됨에서 시작됨으로 변경됩니다.
- JAVA_HOME 특성을 server.env 파일의 JDK 또는 JRE 위치로 설정하십시오.
작업은 JAVA_HOME 특성을 읽고 명령을 실행하기 전에 대상 환경에서 설정하여 서버를 시작합니다.
그러나 이 특성은 서버를 직접 시작하는 경우 Liberty 서버 명령에서
사용되지 않습니다.
server.env 파일은 EBCDIC 인코딩 형식이어야 합니다.
JAVA_HOME 특성을 사용자 .bashrc 파일에 있는 JDK 또는 JRE 위치로 설정하십시오.
JDK 또는 JRE 경로를 PATH 환경 변수에 추가하십시오.
JAVA_HOME 특성을 시스템 환경 변수로서 JDK 또는 JRE 위치로 설정하십시오.
JDK 또는 JRE 경로를 PATH 시스템 변수에 추가하십시오.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
startResource | 시작할 Liberty 서버 자원의 경로 이름을 지정합니다. | String |
사용법 예제
다음 예제는 Liberty 서버 자원 server1을 시작합니다.
AdminTask.submitJob('-jobType startLibertyProfileServer -targetList host_name
-description startLibertyProfileServer
-jobParams [[startResource runtime/wlp/liberty_server/server1 ]]')
stopLibertyProfileServer
stopLibertyProfileServer 작업은 하나 이상의 실행 중인 Liberty 서버 자원을 중지합니다. 서버 자원의 상태는 시작됨에서 중지됨으로 변경됩니다.
Liberty 서버에서 이 작업을 실행하려면 JDK(Java development kit) 또는 JRE(Java runtime environment)가 필요합니다. JDK 또는 JRE 위치가 대상에서 설정되었는지 확인하십시오. JDK 또는 JRE 위치 설정에 대한 정보는 startLibertyProfileServer의 내용을 참조하십시오.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
stopResource | 중지시킬 Liberty 서버 자원의 경로 이름을 지정합니다. | String |
사용법 예제
다음 예제는 Liberty 서버 자원을 중지시킵니다.
AdminTask.submitJob('-jobType stopLibertyProfileServer -targetList host_name
-description stopLibertyProfileServer
-jobParams [[stopResource project/proj1/runtime/wlp/liberty_server/defaultServer]]')
generateMergedPluginConfigForLibertyProfileServers
generateMergedPluginConfigForLibertyProfileServers 작업은 대상 호스트에서 Liberty 서버에 의해 생성된 plugin-cfg.xml 파일 모두를 병합하여 하나의 plugin-cfg.xml 파일을 작성합니다.
이 작업의 경우 여러 대상 호스트에서 Liberty 서버를 지정할 수 있습니다. Liberty 서버를 찾으면, 해당 서버에서 plugin-cfg.xml 파일이 생성되고 작업 관리자로 다시 복사됩니다. 대상 Liberty 서버 모두에 대해 모든 plugin-cfg.xml 파일이 생성되면, 이들은 하나의 plugin-cfg.xml 파일로 병합됩니다. 이 병합된 파일은 작업 관리자 디렉토리 app_server_root/profiles/job_manager_profile/config/temp/JobManager/job_ID/_mergedPluginDir/에 배치됩니다.
<featureManager>
<feature>localConnector-1.0</feature>
<feature>restConnector-1.0</feature>
...
</featureManager>
HTTP/REST 커넥터를 사용하는 경우, 작업을 제출할 때
JMX 연결에 대한 사용자 이름 및 비밀번호를 지정해야 합니다. - 대상 Liberty 서버가 실행되지 않습니다.
- 대상 Liberty 서버에 대해 구성된 JMX 커넥터가 없습니다.
- 명령에서 JMX 연결에 대해 유효한 신임 정보를 지정하지 않았습니다.
작업 매개변수
매개변수 | 설명 | 유형 |
---|---|---|
serverName | 대상 호스트에서 plugin-cfg.xml 파일을 생성하는 서버의 이름 또는 자원 ID를 지정합니다. Liberty 서버는 대상 호스트에서 실행되고 있어야 합니다. | String |
jmxuser | JMX 연결의 사용자 이름을 지정합니다. JMX 연결에 대해 HTTP/REST 커넥터를 사용하는 경우 이 매개변수를 지정하십시오. | String |
jmxpassword | JMX 연결의 비밀번호를 지정합니다. JMX 연결에 대해 HTTP/REST 커넥터를 사용하는 경우 이 매개변수를 지정하십시오. | String |
사용법 예제
다음 예제에서는 대상 호스트 host1 및 host2에서 liberty 서버 defaultServer에 대해 병합된 plugin-cfg.xml 파일을 생성합니다.
AdminTask.submitJob('[-jobType generateMergedPluginConfigForLibertyProfileServers
-targetList [host1 host2] -description generateMergedPluginConfigForLibertyProfileServers
-jobParams [[jmxpassword ********][serverName runtime/wlp/liberty_server/defaultServer][jmxuser c]]]')