wsadmin 스크립트를 사용한 AdminTask 오브젝트에 대한 명령

wsadmin 도구를 사용하여 관리 명령을 실행하려면 AdminTask 오브젝트를 사용하십시오.

관리 명령은 wsadmin 도구를 시작할 때 동적으로 로드됩니다. 사용 가능한 관리 명령과 관리 명령을 사용하여 수행할 수 있는 작업은 사용하는 제품 에디션에 따라 다릅니다.

-conntype NONE 옵션을 wsadmin 도구와 함께 사용하여 실행 중인 서버 없이 스크립트 클라이언트를 시작할 수 있습니다. AdminTask 관리 명령은 연결 모드와 로컬 모드 둘 다에서 사용할 수 있습니다. 현재 서버가 실행 중인 경우, 로컬 모드에서 수행된 구성 변경사항이 실행 중인 서버 구성에 반영되지 않기 때문에(반대의 경우도 마찬가지임) AdminTask 명령을 로컬 모드에서 실행하지 않도록 권장됩니다. 충돌하는 구성을 저장하면 구성이 손상될 수 있습니다.

구성 참고 사항: Jacl 스크립트 언어를 사용하면 대체하다 명령을 사용하면 명령의 변수를 이전에 설정한 값으로 대체할 수 있습니다. 예를 들어,

set nodeparm "node1"
$AdminTask setJVMMaxHeapSize [subst {-serverName server1 -nodeName $nodeparm -maximumHeapSize 100}]

다음 AdminTask 명령은 사용 가능하나 그룹에 속하지는 않습니다.

createTCPEndPoint
getTCPEndPoint
도움말
listTCPEndPoints
listTCPThreadPools
updateAppOnCluster

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 인바운드 채널을 포함하는 체인과 연관된 이름 지정된 엔드포인트를 확보합니다.

대상 오브젝트

NamedEndPoint와 연관된 TCPInboundChannel 또는 포함된 체인, 인스턴스 (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 오브젝트에 대한 일반 명령 정보를 리턴합니다.

예

일괄처리 모드 사용 예제:

다음 명령 예제는 AdminTask 오브젝트에 대한 일반 도움말 정보를 리턴합니다.

Jacl 사용:
```
$AdminTask help
```
Jython 사용:
```
print AdminTask.help()
```

다음 명령 예제는 AdminTask 오브젝트의 각 명령을 표시합니다.

Jacl 사용:
```
$AdminTask help -commands
```
Jython 사용:
```
print AdminTask.help('-commands')
```

다음 명령 예제는 AdminTask 오브젝트의 createJ2CConnectionFactory 명령에 대한 자세한 명령 정보를 리턴합니다.

Jacl 사용:

$AdminTask help createJ2CConnectionFactory

Jython 사용:

print AdminTask.help('createJ2CConnectionFactory')

다음 예제는 create 문자열을 포함하는 각 명령을 리턴하기 위한 와일드카드 문자(*) 사용을 보여줍니다.

Jacl 사용:
```
$AdminTask help -commands *create*
```

Jython 사용:

print AdminTask.help('-commands *create*')

다음 예제는 일반 Java 표현식(.*) 사용 구문을 보여줍니다.

Jacl 사용:
```
$AdminTask help -commands <pattern>
```

Jython 사용:

print AdminTask.help('-commands <pattern>')

listTCPEndPoints

listTCPEndPoints 명령은 TCP 인바운드 채널과 연관될 수 있는 이름 지정된 엔드포인트를 모두 나열합니다.

대상 오브젝트

이름 지정된 엔드포인트 후보가 나열되는 TCP 인바운드 채널 인스턴스 (ObjectName, 필수).

필수 매개변수

없음.

선택적 매개변수

-excludeDistinguished: 식별되지 않은 이름 지정된 엔드포인트만 표시할지 여부를 지정합니다. 이 매개변수에는 값이 필요하지 않습니다. (Boolean, 선택적)
-unusedOnly: 다른 TCP 인바운드 채널 인스턴스가 사용하고 있지 않은 이름 지정된 엔드포인트를 표시할지 여부를 지정합니다. 이 매개변수에는 값이 필요하지 않습니다. (Boolean, 선택적)

샘플 출력

이 명령은 이름 지정된 적합한 엔드포인트의 오브젝트 이름 목록을 리턴합니다.

예

일괄처리 모드 사용 예제:

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.client.props 파일을profile_root/properties 디렉토리(SOAP 커넥터가 사용되는 경우) 에서sas.client.props 파일, 때 JSR160RMI 커넥터 또는 RMI 커넥터가 사용됩니다. 그리고ipc.client.props IPC 커넥터를 사용할 때 파일입니다.

이 명령은 로컬 모드에서 지원되지 않습니다.

대상 오브젝트

없음.

필수 매개변수

-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')