AdminTask 오브젝트의 Utility 명령 그룹
wsadmin 도구를 사용하여 서버를 관리하는 데 Jython 또는 Jacl 스크립트 언어를 사용할 수 있습니다. Utility 그룹의 명령 및 매개변수를 사용하여 노드의 호스트 이름을 변경하고 배치 관리자의 이름을 조회하며 시스템이 단일 서버인지 또는 Network Deployment인지 여부를 판별할 수 있습니다.
AdminTask 오브젝트의 Utility 명령 그룹에는 다음 명령이 포함됩니다.
changeHostName
changeHostName 명령을 사용하여 노드의 호스트 이름을 변경하십시오.
대상 오브젝트
없음
매개변수 및 리턴값
- -hostName
- 새 호스트 이름입니다. (문자열, 필수)
- -nodeName
- 호스트 이름이 변경된 노드의 이름입니다(문자열, 필수).
선택적 매개변수:
- -systemName
- 이 노드가 실행되는 z/OS 시스템의 이름입니다. 이 필드는 노드를 한 시스템에서 다른 시스템으로,
예를 들어, 시스템 SYSA에서 시스템 SYSB로 이동하는 경우에만 필요합니다. 이 매개변수에 대해 지정해야 하는
값이 확실하지 않으면, z/OS 시스템에서 IPLINFO 명령을 실행하고, 이 매개변수 값으로
Sysname= 필드에 표시되는 이름을 사용하십시오.
참고: changeHostName 명령을 대화식으로 실행하는 경우, systemName 매개변수가 표시되지만 z/OS 시스템에 대해서만 사용됩니다. systemName 매개변수는 server.xml 파일에 정의된 z/OS 시스템 이름을 was.ConfiguredSystemName 특성의 값으로 표시합니다. systemName 매개변수를 선택하면 이 특성이 변경됩니다.
- -regenDefaultCert
- 기본 인증서 재생성 요청입니다. 기본 인증서를 재생성하려는 경우 이 매개변수에 올바른 유일한 값은
"true"입니다. 다른 모든 값은 기본 인증서를 재생성하지 않는 것으로 추정됩니다. 문자열 인수는
부울로 처리됩니다. 리턴된 부울은 문자열 인수가 널이 아니고 대소문자에 관계없이 "true" 문자열과 같은
경우 true 값을 나타냅니다. regenDefaultCert 매개변수는
AdminTask.createChainedCertificate와 같이 동작하며 기본값은 다음과 같습니다.
- -keyStoreName "NodeDefaultKeyStore"
- -keyStoreScope "(node):" + nodeName
- -certificateAlias" "default_" + hostName
- -certificateCommonName" nodeName
- -certificateOrganization" "IBM"
- -certificateOrganizationalUnit" nodeName
- -certificateCountry "US"
참고: AdminTask.createChainedCertificate 및 regenDefaultCert 매개변수 모두, 배치 관리자 노드를 사용하는 경우 -keyStoreName 값이 -keyStoreName "CellDefaultKeyStore"로 변경되고 -keyStoreScope 값이 -keyStoreScope "(cell):" + cellname으로 변경됩니다.스위치는 인증서 매개변수의 기본값에 대해 가정하는 편의 스위치입니다. 기본값이 사용되지 않는 경우, 대신 AdminTask.createChainedCertificate 또는 regenDefaultCert를 사용해야 합니다.
다음과 같은 기능상의 세부사항에 주의하십시오.- keyStoreName 및 keyStoreScope은 regenDefaultCert 매개변수에 유효하지 않습니다.
- changeHostName 명령을 실행할 때 certificateCommonName(새 인증의 CN)을 지정할 수 없습니다. 새 호스트 이름을 CN으로 지정하려면 AdminTask.createChainedCertificate를 사용해야 합니다.
예
일괄처리 모드 사용법 예제:
Jacl 사용:
$AdminTask changeHostName {-hostName host_name -nodeName node_name -systemName system_name}
Jython 문자열 사용:
AdminTask.changeHostName('-hostName host_name -nodeName node_name -systemName system_name')
Jython 목록 사용:
AdminTask.changeHostName(['-hostName', 'host_name', '-nodeName', 'node_name', '-systemName', 'system_name'])
대화식 모드 사용법 예제:
Jacl 사용:
$AdminTask changeHostName {-interactive}
Jython 문자열 사용:
AdminTask.changeHostName ('[-interactive]')
Jython 목록 사용:
AdminTask.changeHostName (['-interactive'])
getDmgrProperties
getDmgrProperties 명령을 사용하여 배치 관리자의 이름을 리턴하십시오.
대상 오브젝트
없음
매개변수 및 리턴값
- 매개변수: 없음
- 리턴: Network Deployment 시스템의 배치 관리자 이름. 시스템이 단일 서버인 경우 비어 있는 문자열을 리턴합니다.
예
일괄처리 모드 사용법 예제:
Jacl 사용:
$AdminTask getDmgrProperties {}
Jython 사용:
AdminTask.getDmgrProperties()
isFederated
isFederated 명령을 사용하여 시스템이 단일 서버인지 또는 Network Deployment인지 여부를 확인하십시오.
대상 오브젝트
없음
매개변수 및 리턴값
- 매개변수: 없음
- 리턴: 부울. 시스템이 Network Deployment 시스템인 경우 true. 그렇지 않으면 false를 리턴합니다.
예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask isFederated {}
- Jython 문자열 사용:
AdminTask.isFederated ()
renameCell

대상 오브젝트
없음
매개변수 및 리턴값
- -newCellName
- 새 셀 이름입니다. (문자열, 필수)
- -dmgr_host
- 배치 관리자 컴퓨터의 호스트 이름 또는 IP 주소입니다. (문자열, 명령을 연합 노드에서 실행하는 경우 필수)
- -dmgr_port
- JMX(Java Management Extensions) 연결 포트입니다. (문자열, 연합 노드에서 명령을 실행하는 경우 필수입니다. 지정되지 않으면 기본값 "8879"가 사용됩니다)
- -connType
- 배치 관리자에 연결하는 데 사용할 JMX 커넥터 유형입니다. 이 명령의 기본 JMX 커넥터 유형은 SOAP입니다. 기타 유효한 유형은 JSR160RMI 또는 RMI(Remote Method Invocation)입니다.(문자열, 연합 노드에서 명령을 실행하는 경우 필요합니다. 지정되지 않으면 기본값 "SOAP"가 사용됩니다.)
- -userName
- 보안이 사용되는 경우 인증을 위한 사용자 이름입니다. (문자열, 명령을 연합 노드에서 실행하고 보안이 사용되는 경우 필수)
- -password
- 보안이 사용되는 경우 인증을 위한 비밀번호입니다. (문자열, 명령을 연합 노드에서 실행하고 보안이 사용되는 경우 필수)
선택적 매개변수:
- -regenCerts
- 셀의 모든 노드에 대해 SSL(Secure Sockets Layer) 인증서를 재생성할지 여부를 결정합니다. 기본 키 저장소에 대한 인증서만 다시 생성됩니다. z/OS 운영 체제의 셀에는 이 매개변수가 적용되지 않습니다. 인증서를 다시 생성하면 서버에 액세스하는 클라이언트가 새 인증서를 확보하여 서버와의 신뢰를 재설정함을 기억하십시오. 기본값은 false입니다. 셀의 노드에 대해 SSL 인증서를 재생성하려면 true로 설정하십시오.(부울, 선택적)
- -updateJaccContextID
- JACC(Java Authorization Contract for Containers) 제공자에서 사용하는 애플리케이션의 보안 컨텍스트 ID를 업데이트할지 여부를 결정합니다. 기본값은 false입니다. 보안 컨텍스트 ID를 업데이트하려면 true로 설정하십시오. (부울, 선택적)
일괄처리 모드 사용법 예제:
- Jython 문자열 사용:
AdminTask.renameCell('-newCellName new_cell_name')
- Jython 목록 사용:
AdminTask.renameCell(['-newCellName', 'new_cell_name'])
대화식 모드 사용법 예제:
- Jython 문자열 사용:
AdminTask.renameCell ('[-interactive]')
- Jython 목록 사용:
AdminTask.renameCell (['-interactive'])
renameCell을 사용하는 시나리오 예제
- 독립형 애플리케이션 서버의 셀 이름 바꾸기:
- 독립형 서버를 중지합니다.
- 로컬 모드에서 wsadmin을 사용하여 셀의 이름을 바꿉니다.
AdminTask.renameCell('-newCellName new_cell_name')
- 배치 관리자 및 연합 노드의 셀 이름 바꾸기:
네트워크 배치 토폴로지의 셀 이름을 바꾸려면 배치 관리자 노드/프로파일과 모든 연합 노드/프로파일에서 명령을 실행해야 합니다.
참고: 셀이 다중 셀 토폴로지의 일부이면, 이 단계를 수행하기 전에 다른 셀에서 셀의 링크를 제거하고 이 단계 수행 후 다시 링크하십시오.- 배치 관리자 서버, 노드 에이전트 서버, 모든 애플리케이션 서버를 포함하여 셀에 있는 모든 서버를 중지하십시오.
- 배치 관리자 노드/프로파일의 셀 이름 바꾸기: 로컬 노드에서 wsadmin을 사용하여 아래 명령을 실행하십시오.
dmgr 마스터 저장소에서 SSL 인증서가 변경되고 셀 이름도 변경됩니다.
AdminTask.renameCell('[-newCellName new_cell_name]')
- 셀에 있는 모든 연합 노드/프로파일에 대해 셀 이름 바꾸기 명령을 실행하십시오.
- 배치 관리자 서버를 시작하십시오.
- 각 노드 에이전트와 배치 관리자 노드가 아닌 모든 노드의 프로파일에서,
로컬 모드로 wsadmin을 시작하고 아래 표시된 명령을 실행하십시오.
AdminTask.renameCell('[-newCellName new_cell_name –dmgr_host dmgr_hostname –dmgrPort dmgr_connector_port –connType SOAP –username my_user –password my_password]')
- 관리 에이전트 서버의 셀 이름 바꾸기:
- 관리 에이전트 서버를 중지하십시오.
- 로컬 모드로 wsadmin을 사용하여 셀의 이름을 바꾸십시오.
AdminTask.renameCell('-newCellName new_cell_name')
참고: 관리 에이전트 서버에 등록된 독립형 애플리케이션 서버의 셀 이름을 바꾸려면, 먼저 해당 관리 서버에서 해당 독립형 노드의 등록을 해제해야 합니다. 관리 서버가 계속해서 해당 독립형 노드를 관리하도록 하려면 셀 이름 바꾸기 명령을 실행한 후 다시 관리 서버에 노드를 등록해야 합니다.
- 작업 관리자 서버의 셀 이름 바꾸기:
- 작업 관리자 서버를 중지하십시오.
- 로컬 모드에서 wsadmin을 사용하여 셀의 이름을 바꿉니다.
AdminTask.renameCell('-newCellName new_cell_name')
참고: 이것은 독립형 작업 관리자 프로파일만을 위한 것입니다. 작업 관리자로 작용하는 배치 관리자에 대해서는 이를 사용하지 마십시오.
- 다중 셀 토폴로지에서 셀 이름 바꾸기:
스타 토폴로지와 같은 다중 셀 토폴로지에서 셀의 이름을 바꾸려면 이름 바꾸기 이전에 셀을 다른 셀에서 분리해야 합니다. 셀의 이름을 바꾼 후 셀을 다시 다른 셀과 연결시켜야 합니다.