카탈로그 서비스 도메인 관리 태스크

Jacl 또는 Jython 스크립트 언어를 사용하여 WebSphere® Application Server 구성의 카탈로그 서비스 도메인을 관리할 수 있습니다. WebSphere DataPower® XC10 Appliance를 사용하여, 어플라이언스에서 실행 중인 카탈로그 서버와의 연결을 설정하기 위한 카탈로그 서비스 도메인을 정의할 수 있습니다. 동적 캐시 데이터 그리드에서만 이 구성을 작성해야 합니다.

요구사항

WebSphere Application Server 환경에 WebSphere eXtreme Scale Client를 설치해야 합니다.

모든 관리 태스크 나열

카탈로그 서비스 도메인과 연관된 모든 관리 태스크 목록을 가져오려면 wsadmin을 사용하여 다음 명령을 실행하십시오.
wsadmin>$AdminTask help XSDomainManagement 

명령

카탈로그 서비스 도메인에 대한 관리 태스크에는 다음 명령이 포함됩니다.

createXSDomain

createXSDomain 명령은 새 카탈로그 서비스 도메인을 등록합니다.
표 1. createXSDomain 명령 인수
인수 설명
-name(필수) 작성할 카탈로그 서비스 도메인의 이름을 지정합니다.
-default 카탈로그 서비스 도메인이 셀의 기본값인지를 지정합니다. 기본값은 true입니다. (부울: true 또는 false로 설정)
-properties 카탈로그 서비스 도메인의 사용자 정의 특성을 지정합니다.
표 2. defineDomainServers 단계 인수
인수 설명
name_of_endpoint 카탈로그 서비스 엔드포인트의 이름을 지정합니다.
  • 기존 애플리케이션 서버: 엔드포인트 이름은 다음 형식이어야 합니다.cell_name\node_name\server_name
  • 원격 서버의 경우: 원격 서버의 호스트 이름을 지정합니다. 여러 엔드포인트에 동일한 이름을 사용할 수 있지만 클라이언트 포트 값은 각 엔드포인트에서 고유해야 합니다.
custom_properties 카탈로그 서비스 도메인 엔드포인트의 사용자 정의 특성을 지정합니다.사용자 정의 특성이 없는 경우에는 이 인수에 큰따옴표 세트("")를 사용하십시오.
endpoint_ports
카탈로그 서비스 도메인 엔드포인트의 포트 번호를 지정합니다.포트는 다음 순서로 지정되어야 합니다. <client_port>,<listener_port>
클라이언트 포트
카탈로그 서비스 도메인에서 카탈로그 서버 간 통신에 사용되는 포트를 지정합니다. 이 값은 WebSphere Application Server 프로세스에서만 실행 중인 카탈로그 서버에 필수이며 다른 곳에서 사용 중이 아닌 포트로 설정할 수 있습니다.
리스너 포트
클라이언트와의 통신에 사용되는 포트를 지정합니다. 이 값은 원격 엔드포인트에 필요하며 카탈로그 서비스가 시작될 때 사용된 값과 일치해야 합니다. 리스너 포트는 카탈로그 서비스와 통신하기 위해 클라이언트 및 컨테이너에 의해 사용됩니다.
WebSphere DataPower XC10 Appliance 원격 엔드포인트의 경우: 어플라이언스 원격 엔드포인트에 2809 값을 사용하십시오.

리턴값:

일괄처리 모드 예제 사용법

일괄처리 모드에서는 명령 항목의 올바른 포맷이 필요합니다. 입력하는 값이 올바르게 처리될 수 있도록 대화식 모드를 사용할 것을 고려하십시오. 일괄처리 모드를 사용할 때에는 특정 특성 어레이를 사용하여 -defineDomainServers 단계 인수를 정의해야 합니다. 이 특성 어레이는 name_of_endpoint custom_properties endpoint_ports 형식으로 되어 있습니다. endpoint_ports 값은 다음 순서로 지정되어야 하는 포트 목록입니다.<client_port>,<listener_port>.

대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask createXSDomain {-interactive}
  • Jython 문자열 사용:
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

deleteXSDomain 명령은 카탈로그 서비스 도메인을 삭제합니다.

필수 매개변수:
-name
삭제할 카탈로그 서비스 도메인의 이름을 지정합니다.

리턴값:

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Jython 문자열 사용:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask deleteXSDomain {-interactive}
  • Jython 문자열 사용:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

getDefaultXSDomain 명령은 셀의 기본 카탈로그 서비스 도메인을 리턴합니다.

필수 매개변수: 없음

리턴값: 기본 카탈로그 서비스 도메인의 이름입니다.

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $AdminTask getDefaultXSDomain
  • Jython 문자열 사용:
    AdminTask.getDefaultXSDomain
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask getDefaultXSDomain {-interactive}
  • Jython 문자열 사용:
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

listXSDomains 명령은 기존 카탈로그 서비스 도메인 목록을 리턴합니다.

필수 매개변수: 없음

리턴값: 셀에 있는 모든 카탈로그 서비스 도메인 목록입니다.

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $AdminTask listXSDomains
  • Jython 문자열 사용:
    AdminTask.listXSDomains
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask listXSDomains {-interactive}
  • Jython 문자열 사용:
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

modifyXSDomain 명령은 기존 카탈로그 서비스 도메인을 수정합니다.

일괄처리 모드에서는 명령 항목의 올바른 포맷이 필요합니다. 입력하는 값이 올바르게 처리될 수 있도록 대화식 모드를 사용할 것을 고려하십시오. 일괄처리 모드를 사용할 때에는 특정 특성 어레이를 사용하여 -modifyEndpoints, -addEndpoints-removeEndpoints 단계 인수를 정의해야 합니다. 이 특성 어레이는 name_of_endpoint host_name custom_properties endpoint_ports 형식으로 되어 있습니다. endpoint_ports 값은 다음 순서로 지정되어야 하는 포트 목록입니다.<client_port>,<listener_port>.

표 3. modifyXSDomain 명령 인수
인수 설명
-name(필수) 편집하려는 카탈로그 서비스 도메인 이름을 지정합니다.
-default true로 설정된 경우, 선택한 카탈로그 서비스 도메인이 셀의 기본값임을 지정합니다. (부울)
-properties 카탈로그 서비스 도메인의 사용자 정의 특성을 지정합니다.
표 4. modifyEndpoints 단계 인수
인수 설명
name_of_endpoint 카탈로그 서비스 엔드포인트의 이름을 지정합니다.
  • 기존 애플리케이션 서버: 엔드포인트 이름은 다음 형식이어야 합니다.cell_name\node_name\server_name
  • 원격 서버의 경우: 원격 클라이언트의 호스트 이름을 지정합니다. 여러 엔드포인트에 동일한 이름을 사용할 수 있지만 리스너 포트 값은 각 엔드포인트에서 고유해야 합니다. 어플라이언스를 구성 중인 경우 이 값은 완전한 도메인 이름이어야 합니다.
endpoint_ports
카탈로그 서비스 도메인 엔드포인트의 포트 번호를 지정합니다.엔드포인트는 다음 순서로 지정되어야 합니다. <client_port>,<listener_port>
클라이언트 포트
카탈로그 서비스 도메인에서 카탈로그 서버 간 통신에 사용되는 포트를 지정합니다. 이 값은 WebSphere Application Server 프로세스에서만 실행 중인 카탈로그 서버에 필수이며 다른 곳에서 사용 중이 아닌 포트로 설정할 수 있습니다.
리스너 포트
클라이언트와의 통신에 사용되는 포트를 지정합니다. 이 값은 원격 엔드포인트에 필요하며 카탈로그 서비스가 시작될 때 사용된 값과 일치해야 합니다. 리스너 포트는 카탈로그 서비스와 통신하기 위해 클라이언트 및 컨테이너에 의해 사용됩니다.
WebSphere DataPower XC10 Appliance 원격 엔드포인트의 경우: 어플라이언스 원격 엔드포인트에 2809 값을 사용하십시오.
표 5. addEndpoints 단계 인수
인수 설명
name_of_endpoint 카탈로그 서비스 엔드포인트의 이름을 지정합니다.
  • 기존 애플리케이션 서버: 엔드포인트 이름은 다음 형식이어야 합니다.cell_name\node_name\server_name
  • 원격 서버의 경우: 원격 클라이언트의 호스트 이름을 지정합니다. 여러 엔드포인트에 동일한 이름을 사용할 수 있지만 리스너 포트 값은 각 엔드포인트에서 고유해야 합니다. 어플라이언스를 구성 중인 경우 이 값은 완전한 도메인 이름이어야 합니다.
custom_properties 카탈로그 서비스 도메인 엔드포인트의 사용자 정의 특성을 지정합니다.사용자 정의 특성이 없는 경우에는 이 인수에 큰따옴표 세트("")를 사용하십시오.
endpoint_ports
카탈로그 서비스 도메인 엔드포인트의 포트 번호를 지정합니다.엔드포인트는 다음 순서로 지정되어야 합니다. <client_port>,<listener_port>
클라이언트 포트
카탈로그 서비스 도메인에서 카탈로그 서버 간 통신에 사용되는 포트를 지정합니다. 이 값은 WebSphere Application Server 프로세스에서만 실행 중인 카탈로그 서버에 필수이며 다른 곳에서 사용 중이 아닌 포트로 설정할 수 있습니다.
리스너 포트
클라이언트와의 통신에 사용되는 포트를 지정합니다. 이 값은 원격 엔드포인트에 필요하며 카탈로그 서비스가 시작될 때 사용된 값과 일치해야 합니다. 리스너 포트는 카탈로그 서비스와 통신하기 위해 클라이언트 및 컨테이너에 의해 사용됩니다.
WebSphere DataPower XC10 Appliance 원격 엔드포인트의 경우: 어플라이언스 원격 엔드포인트에 2809 값을 사용하십시오.
표 6. removeEndpoints 단계 인수
인수 설명
name_of_endpoint 삭제할 카탈로그 서비스 엔드포인트의 이름을 지정합니다.

리턴값:

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Jython 문자열 사용:
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask modifyXSDomain {-interactive}
  • Jython 문자열 사용:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

testXSDomainConnection 명령은 카탈로그 서비스 도메인에 대한 연결을 테스트합니다.

필수 매개변수:
-name
연결을 테스트할 카탈로그 서비스 도메인의 이름을 지정합니다.
선택적 매개변수
-timeout
연결을 대기하는 최대 시간 크기(초)를 지정합니다.

리턴값: 연결할 수 있는 경우, true를 리턴하고 그렇지 않은 경우 연결 오류 정보가 리턴됩니다.

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $Admintask testXSDomainConnection
  • Jython 문자열 사용:
    AdminTask.testXSDomainConnection
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask testXSDomainConnection {-interactive}
  • Jython 문자열 사용:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

testXSServerConnection 명령은 카탈로그 서버에 대한 연결을 테스트합니다. 이 명령은 독립형 서버 및 카탈로그 서비스 도메인의 일부인 서버 모두에 적용됩니다.

필수 매개변수:
호스트(host)
카탈로그 서버가 상주하는 호스트를 지정합니다.
listenerPort
카탈로그 서버에 대한 리스너 포트를 지정합니다.
선택적 매개변수
제한시간(timeout)
카탈로그 서버에 대한 연결을 대기하는 최대 시간 크기(초)를 지정합니다.

리턴값:

일괄처리 모드 예제 사용법
  • Jacl 사용:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • Jython 문자열 사용:
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
대화식 모드 예제 사용법
  • Jacl 사용:
    $AdminTask testXSServerConnection {-interactive}
  • Jython 문자열 사용:
    AdminTask.testXSServerConnection ('[-interactive]')