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.createChainedCertificateregenDefaultCert 매개변수 모두, 배치 관리자 노드를 사용하는 경우 -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

새 기능 새 기능:
renameCell 명령을 사용하여 독립형 애플리케이션 서버, 배치 관리자, 관리 에이전트, 작업 관리자, 연합 노드 프로파일의 셀 이름을 변경하십시오. 이 명령은 wsadmin 로컬 모드 즉, wsadmin -conntype none로만 실행될 수 있습니다.newfeat
참고: 셀에 서로 다른 WebSphere Application Server 버전이 설치되어 있는 노드가 있는 혼합 셀 환경에서는 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을 사용하는 시나리오 예제

참고: renameCell 명령을 사용하여 해당 노드의 셀 이름을 변경하기 전에 profile_root/bin 디렉토리에서 backupConfig 도구로 노드 구성을 백업하는 것이 좋습니다. renameCell 명령 결과에 만족하지 않고 renameCell 명령 실행이 예상치 못하게 실패한 경우, restoreConfig 도구를 사용하여 백업 구성을 복원하십시오.
참고: renameCell 명령을 실행하기 전에 profile_root/bin/setupCmdLine 스크립트 파일을 백업하십시오. 명령은 이 파일에서 셀 이름을 새 셀 이름으로 업데이트하지만 사용자가 이 명령 실행으로 인한 구성 변경을 버리도록 결정하면 이를 다시 원래대로 변경할 수 없습니다. 이렇게 수행하도록 결정하면, 구성 변경사항을 제거한 후 파일을 복원해야 합니다. 그렇지 않으면 이 프로파일에서 서버를 시작할 수 없습니다.
독립형 애플리케이션 서버의 셀 이름 바꾸기:
  • 독립형 서버를 중지합니다.
  • 로컬 모드에서 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')
    참고: 이것은 독립형 작업 관리자 프로파일만을 위한 것입니다. 작업 관리자로 작용하는 배치 관리자에 대해서는 이를 사용하지 마십시오.
다중 셀 토폴로지에서 셀 이름 바꾸기:

스타 토폴로지와 같은 다중 셀 토폴로지에서 셀의 이름을 바꾸려면 이름 바꾸기 이전에 셀을 다른 셀에서 분리해야 합니다. 셀의 이름을 바꾼 후 셀을 다시 다른 셀과 연결시켜야 합니다.


주제 유형을 표시하는 아이콘 참조 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rxml_atutility
파일 이름:rxml_atutility.html