wsadmin 스크립트를 사용한 AdminTask 오브젝트에 대한 명령
wsadmin 도구로 관리 명령을 실행하려면 AdminTask 오브젝트를 사용하십시오.
관리 명령은 wsadmin 도구를 시작할 때 동적으로 로드됩니다. 사용자가 사용할 수 있는 관리 명령과 그 명령으로 수행할 수 있는 조작은 사용하고 있는 제품의 개정판에 따라 다릅니다.
wsadmin 도구와 함께 -conntype NONE 옵션을 사용하여 실행 중인 서버 없이 스크립트 클라이언트를 시작할 수 있습니다. AdminTask 관리 명령은 연결 모드 및 로컬 모드 둘 다에서 사용할 수 있습니다. 현재 서버가 실행 중인 경우, 로컬 모드에서 수행된 구성 변경사항이 실행 중인 서버 구성에 반영되지 않기 때문에(반대의 경우도 마찬가지임) AdminTask 명령을 로컬 모드에서 실행하지 않도록 권장됩니다. 충돌 구성을 저장하면 구성이 손상될 수 있습니다.
배치 관리자 환경에서 구성 업데이트는 스크립트 클라이언트가 배치 관리자에 연결되어 있는 경우에만 사용 가능합니다. 노드 에이전트 또는 관리 애플리케이션 서버에 연결된 경우, 이러한 서버 프로세스의 구성은 배치 관리자에 위치하는 마스터 구성의 사본이므로 구성을 업데이트할 수 없습니다. 사본은 배치 관리자와 노드 에이전트 사이에 구성 동기화가 발생할 때 노드 시스템에서 작성됩니다. 배치 관리자에 스크립트 클라이언트를 연결하여 서버 프로세스에 대한 구성 변경을 작성하십시오. 구성을 변경하려면 노드 시스템의 로컬 모드에서 스크립트 클라이언트를 실행하지 마십시오. 그 이유는 지원되지 않기 때문입니다.
set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]
createTCPEndPoint
createTCPEndPoint 명령은 TCP 인바운드 채널과 연관시킬 수 있는 새 엔드포인트를 작성합니다.
대상 오브젝트
TCPInboundChannel을 포함하는 TransportChannelService의 상위 인스턴스(ObjectName, 필수)필수 매개변수
- -name
- 새 엔드포인트의 이름을 지정합니다.(문자열, 필수)
- -host
- 새 엔드포인트의 호스트를 지정합니다.(문자열, 필수)
- -port
- 새 엔드포인트의 포트를 지정합니다.(문자열, 필수)
선택적 매개변수
없음.샘플 출력
명령은 작성한 엔드포인트의 오브젝트 이름을 리턴합니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask createTCPEndPoint (cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1) {-name Sample_End_Pt_Name -host mybuild.location.ibm.com -port 8978}
- Jython 문자열 사용:
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', '[-name Sample_End_Pt_Name -host mybuild.location.ibm.com -port 8978]')
- Jython 목록 사용:
AdminTask.createTCPEndPoint('cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TransportChannelService_1', ['-name', 'Sample_End_Pt_Name', '-host', 'mybuild.location.ibm.com', '-port', '8978'])
대화식 모드 사용법 예제:
- Jacl 사용:
$AdminTask createTCPEndPoint {-interactive}
- Jython 사용:
AdminTask.createTCPEndPoint('-interactive')
getTCPEndPoint
getTCPEndPoint 명령은 TCP 인바운드 채널이나 TCP 인바운드 채널을 포함하는 체인과 연관된 이름 지정된 엔드포인트를 얻습니다.
대상 오브젝트
TCPInboundChannel 또는 포함 체인, NamedEndPoint와 연관된 인스턴스. (ObjectName, 필수)필수 매개변수
없음.선택적 매개변수
없음.샘플 출력
명령은 TCP 인바운드 채널 인스턴스 또는 채널 체인과 연관된 기존의 이름 지정된 엔드포인트의 오브젝트 이름을 리턴합니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask getTCPEndPoint TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask getTCPEndPoint DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)
- Jython 문자열 사용:
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
- Jython 목록 사용:
print AdminTask.getTCPEndPoint('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#TCPInboundChannel_1)')
print AdminTask.getTCPEndPoint('DCS(cells/mybuildCell01/nodes/mybuildCellManager01 /servers/dmgr|server.xml#Chain_3)')
대화식 모드 사용법 예제:
- Jacl 사용:
$AdminTask getTCPEndPoint {-interactive}
- Jython 사용:
print AdminTask.getTCPEndPoint('-interactive')
도움말
help 명령은 도움말 명령의 요약 및 관리 명령을 호출하는 방법을 제공합니다.명령 구문에서 와일드카드 문자(*) 또는 Java 일반 표현식(.*)을 사용하여 검색 조회를 사용자 정의할 수 있습니다.
대상 오브젝트
없음.선택적 매개변수
- -commands
- help 명령은 -commands 매개변수를 사용하면 사용 가능한 관리 명령 목록을 제공합니다.(문자열, 선택적)
- -commandGroups
- help 명령은 -commandGroups 매개변수를 사용하면 관리 명령 그룹 목록을 제공합니다.(문자열, 선택적)
- -commandName
- help 명령은 제공된 관리 명령에 대한 도움말 정보를 제공합니다.(문자열, 선택적)
- -stepName
- help 명령은 관리 명령의 제공된 단계에 대한 도움말 정보를 제공합니다.(문자열, 선택적)
샘플 출력
명령은 AdminTask 오브젝트에 대한 일반 명령 정보를 리턴합니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask help
- Jython 사용:
print AdminTask.help()
- Jacl 사용:
$AdminTask help -commands
- Jython 사용:
print AdminTask.help('-commands')
- Jacl 사용:
$AdminTask help createJ2CConnectionFactory
- Jython 사용:
print AdminTask.help('createJ2CConnectionFactory')
- Jacl 사용:
$AdminTask help -commands *create*
- Jython 사용:
print AdminTask.help('-commands *create*')
- Jacl 사용:
$AdminTask help -commands <pattern>
- Jython 사용:
print AdminTask.help('-commands <pattern>')
listTCPEndPoints
listTCPEndPoints 명령은 TCP 인바운드 채널과 연관시킬 수 있는 이름 지정된 모든 엔드포인트를 나열합니다.
대상 오브젝트
이름 지정된 엔드포인트 후보가 나열된 TCP 인바운드 채널 인스턴스(ObjectName, 필수)필수 매개변수
없음.선택적 매개변수
- -excludeDistinguished
- 이름 지정된 비구별 엔드포인트만을 표시할지 여부를 지정합니다. 이 매개변수에는 값이 필요하지 않습니다.(부울, 선택적)
- -unusedOnly
- 다른 TCP 인바운드 채널 인스턴스에서 사용하지 않는 이름 지정된 엔드포인트를 표시할지 여부를 지정합니다. 이 매개변수에는 값이 필요하지 않습니다.(부울, 선택적)
샘플 출력
명령은 이름 지정된 적절한 엔드포인트에 대한 오브젝트 이름 목록을 리턴합니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished}
$AdminTask listTCPEndPoints TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1) {-excludeDistinguished -unusedOnly}
- Jython 문자열 사용:
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished]')
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', '[-excludeDistinguished -unusedOnly]')
- Jython 목록 사용:
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished'])
print AdminTask.listTCPEndPoints('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)', ['-excludeDistinguished', '-unusedOnly'])
대화식 모드 사용법 예제:
- Jacl 사용:
$AdminTask listTCPEndPoints {-interactive}
- Jython 사용:
print AdminTask.listTCPEndPoints('-interactive')
listTCPThreadPools
listTCPThreadPools 명령은 TCP 인바운드 채널 또는 TCP 아웃바운드 채널과 연관시킬 수 있는 모든 스레드 풀을 나열합니다.
대상 오브젝트
ThreadPool 후보가 나열된 TCPInboundChannel 또는 TCPOutboundChannel 인스턴스(ObjectName, 필수)필수 매개변수
없음.선택적 매개변수
없음.샘플 출력
명령은 적절한 스레드 풀 오브젝트 이름의 목록을 리턴합니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask listTCPThreadPools TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)
- Jython 문자열 사용:
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
- Jython 목록 사용:
print AdminTask.listTCPThreadPools('TCP_1(cells/mybuildCell01/nodes/mybuildCellManager01/servers/dmgr|server.xml#TCPInboundChannel_1)')
대화식 모드 사용법 예제:
- Jacl 사용:
$AdminTask listTCPThreadPools {-interactive}
- Jython 사용:
print AdminTask.listTCPThreadPools('-interactive')
updateAppOnCluster
updateAppOnCluster 명령을 사용하여 노드를 동기화하고 클러스터에 배치된 애플리케이션 업데이트를 위해 클러스터 멤버를 다시 시작할 수 있습니다. 애플리케이션 업데이트 후에는 이 명령을 사용하여 모든 노드의 모든 클러스터 멤버를 중지할 필요 없이 노드를 한 번에 동기화할 수 있습니다. 이 명령은 동시에 하나의 노드를 동기화합니다. 애플리케이션이 대상으로 지정된 클러스터 멤버를 중지한 다음 노드 동기화 조작을 수행하고 클러스터 멤버를 다시 시작하여 각 노드를 동기화합니다.
이 명령은 대상 클러스터 범위에 있는 노드의 수에 따라 기본 커넥터 제한시간보다 많은 시간이 소요될 수 있습니다. SOAP 커넥터를 사용할 때에는 profile_root/properties 디렉토리의 soap.client.props 파일에서, JSR160RMI 커넥터 또는 RMI 커넥터를 사용할 때에는 sas.client.props 파일에서, IPC 커넥터를 사용할 때는 ipc.client.props 파일에서 적절한 제한시간 값을 설정하십시오.
이 명령은 로컬 모드에서 지원되지 않습니다.
대상 오브젝트
없음.필수 매개변수
- -ApplicationNames
- 업데이트되는 애플리케이션의 이름을 지정합니다.(문자열, 필수)
선택적 매개변수
- -timeout
- 각 노드 동기화의 제한시간 값(초)을 지정합니다. 기본값은 300초입니다.(정수, 선택적).
샘플 출력
명령은 출력을 리턴하지 않습니다.예
일괄처리 모드 사용법 예제:
- Jacl 사용:
$AdminTask updateAppOnCluster {-ApplicationNames app1}
$AdminTask updateAppOnCluster {-ApplicationNames app1 -timeout 600}
- Jython 문자열 사용:
AdminTask.updateAppOnCluster('[-ApplicationNames app1]')
AdminTask.updateAppOnCluster('[-ApplicationNames app1 -timeout 600]')
- Jython 목록 사용:
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1'])
AdminTask.updateAppOnCluster(['-ApplicationNames', 'app1', '-timeout', '600'])
대화식 모드 사용법 예제:
- Jacl 사용:
$AdminTask updateAppOnCluster -interactive
- Jython 사용:
AdminTask.updateAppOnCluster('-interactive')