createWSNServicePoint 명령
createWSNServicePoint 명령을 사용하여 새 WS-Notification 서비스를 작성할 수 있습니다.
이 주제에 설명된 대로 wsadmin 도구를 사용하거나 새 버전 6.1 WS-Notification 서비스 위치 작성 및 새 버전 7.0 WS-Notification 서비스 위치 작성에 설명된 대로 관리 콘솔을 사용하여 새 WS-Notification 서비스 위치를 작성할 수 있습니다.
명령을 실행하려면 wsadmin 스크립트 클라이언트의 AdminTask 오브젝트를 사용하십시오.
wsadmin 스크립트 클라이언트는 Qshell에서
실행됩니다. .
자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..
서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
- 사용 가능한 WS-Notification 명령 목록 및 각 명령에 대한 간단한
설명을 보려면 wsadmin 프롬프트에 다음 명령을
입력하십시오.
print AdminTask.help('WSNotificationCommands')
- 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.
print AdminTask.help('command_name')
AdminConfig.save()
목적
버스 멤버에서 WS-Notification 서비스 위치의 존재는 WS-Notification 웹 서비스가 해당 버스 멤버에서 표시되어 이 WS-Notification 서비스에 대한 알림 브로커, 등록 관리자, 공개자 등록 관리자가 서비스 위치가 연관된 버스 멤버에 표시되도록 합니다. WS-Notification 애플리케이션은 이 엔드포인트를 사용하여 WS-Notification 서비스와 상호 작용합니다.
- WS-Notification 서비스에서 새 WS-Notification 서비스 위치를 작성합니다.
- 버전 7.0 WS-Notification 서비스 위치의 경우, 브로커의 세 가지 역할에 대한 웹 서비스 엔드포인트가 버스 멤버에서 공개됩니다.
- 버전 6.1 WS-Notification 서비스 위치의 경우, 브로커의 세 가지 역할을 표시하는 세 가지 서비스 통합 버스 인바운드 포트를 작성하고, 필요한 경우 서비스 통합 버스 엔드포인트 리스터를 작성하며, WS-Notification 서비스와 연관되는 서비스 통합 버스에 새 엔드포인트 리스너 또는 기존 엔드포인트 리스너를 연결합니다.
- 버스 멤버 유형(서버 또는 클러스터)
- 버전 6.1 WS-Notification 서비스 위치에 대한 엔드포인트 리스너(새로 작성 또는 기존 사용)
- -eplName
- -eplURLRoot
- -eplWSDLServingURLRoot
- -transportURLRoot
- -transportSoapVersion
- -jaxwsHandlerListNB
- -jaxwsHandlerListSM
- -jaxwsHandlerListPRM
WebSphere® Application Server 버전 7.0 이상 버스 멤버에서 버전 7.0 WS-Notification 서비스에 대해서만 서비스 위치를 작성할 수 있습니다. 버스 멤버가 클러스터인 경우, 클러스터의 모든 서버가 WebSphere Application Server 버전 7.0 이상 애플리케이션 서버여야 합니다.
WebSphere Application Server 버전 6.1 이상 애플리케이션 서버에서 버전 6.1 WS-Notification 서비스에 대해 서비스 위치를 작성할 수 있습니다.
대상 오브젝트
WSNService
필수 매개변수
- -name
조건부 매개변수
연관된 버스 멤버에 대해 서버 또는 클러스터를 선택하십시오.
- -server
- WS-Notification 서비스 위치가 작성되는 서버의 이름입니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 이 매개변수가 사용되면 node 매개변수는 지정해야 하고, cluster 매개변수는 지정하면 안됩니다.
- -node
- 서버가 있는 노드의 이름입니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 이 매개변수가 사용되면 server 매개변수는 지정해야 하고, cluster 매개변수는 지정하면 안됩니다.
- -cluster
- WS-Notification 서비스 위치가 작성되는 클러스터의 이름입니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 이 매개변수가 사용되면 server 및 node 매개변수는 지정하면 안됩니다.
버전 6.1 WS-Notification 서비스의 경우, 새 엔드포인트 리스너를 구성하도록 선택하거나 기존 엔드포인트 리스너를 사용하도록 선택하십시오.
- -eplName
- 엔드포인트 리스너의 이름.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 선택된 서버 또는 클러스터에 이 엔드포인트 리스너가 이미 정의되어 있는 경우 eplURLRoot 및 eplWSDLServingURLRoot 매개변수는 지정하면 안됩니다. 그렇지 않으면 eplURLRoot 및 eplWSDLServingURLRoot 매개변수를 모두 지정해야 합니다.
- 버전 6.1 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
- -eplURLRoot
- 이 엔드포인트 리스너를 통해 액세스한 웹 서비스의 외부에서 볼 수 있는
엔드포인트 주소 URL의 루트입니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 선택된 서버 또는 클러스터에 엔드포인트 리스너가 이미 정의되어 있는 경우 이 매개변수를 지정하면 안됩니다.
- 버전 6.1 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
- -eplWSDLServingURLRoot
- 이 엔드포인트 리스너와 연관된 WSDL 파일이 있는
외부에서 볼 수 있는 HTTP URL의 루트입니다. 대부분의 환경에서 이 루트는 http://host_name:port_number/SIBWS입니다. 자세한 정보는 새 엔드포인트 리스너 구성 작성 또는 createSIBWSEndpointListener 명령의 내용을 참조하십시오.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 선택된 서버 또는 클러스터에 엔드포인트 리스너가 이미 정의되어 있는 경우 이 매개변수를 지정하면 안됩니다.
- 버전 6.1 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
버전 7.0 WS-Notification 서비스의 경우, 웹 서비스 엔드포인트를 구성하십시오.
- -transportURLRoot
- 다음과 같은 형식의 WS-Notification 서비스 위치에 대해 외부에서 볼 수 있는 엔드포인트 주소의
루트입니다.
여기서 protocol은 http 또는 https입니다. 예제:protocol://host_nameport_number/service_location
http://myhostname:9080/ctx123/mySvc
- 이 매개변수를 사용하여 관리 콘솔을 통해 WSDL을 압축 파일로 공개할 때 특정 외부 웹 주소를 WS-Notification 서비스와 연관시킬 수 있습니다. 이 주소는 WS-Notification 서비스가 공개된 주소와 동일하지 않을 수 있습니다. 이 주소는 프록시를 통해 WS-Notification 서비스에 액세스할 때 필요합니다.
- 이 매개변수를 지정하지 않으면 기본 JAX-WS 구현이 서비스 위치 설치 프로세스의 일부로 제공된 정보를 기반으로 적당한 URL을 작성합니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 이 속성은 버전 6.1 WS-Notification 서비스에 작성된 서비스 위치에 대한 eplURLRoot 매개변수와 동등합니다. 버전 7.0 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
- -transportSoapVersion
- 허용된 값은 SOAP 1.1(기본값)에 대해 1.1 및 SOAP 1.2에 대해 1.2입니다.
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 버전 7.0 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
기존 WS-Notification 서비스 위치 정의에서 구성을 복사하십시오.
- -copyServicePoint
- 기타 구성 속성이 복사되는 WS-Notification 서비스에 구성된 기존 서비스 위치의 이름입니다. 이 매개변수를 지정할 경우 name 매개변수만 지정하면 됩니다. 기타 값은 모두 지정된 기존 서비스 위치에서 가져옵니다.
선택적 매개변수
- -description
- -jaxwsHandlerListNB
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 버전 7.0 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
- -jaxwsHandlerListSM
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 버전 7.0 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
- -jaxwsHandlerListPRM
- copyServicePoint 매개변수를 지정하면 이 매개변수를 지정할 필요가 없습니다.
- 버전 7.0 WS-Notification 서비스에 대한 매개변수만 지정하십시오.
예
다음 예제에서 WS-Notification 서비스 위치는 "wsadmin 도구를 사용하여 새 WS-Notification 서비스 작성" 주제의 예제에 작성된 WS-Notification 서비스 newService를 사용합니다.
기존 엔드포인트 리스너 SIBWSHTTPChannel1을 사용하는 cluster1에 버전 6.1 WS-Notification 서비스 위치를 작성하십시오.
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-cluster", "cluster1", "-eplName", "SIBWSHTTPChannel1"] )
node1에 있는 server1에 버전 WS-Notification 서비스 위치를 작성한 후 채널 1에 있는 HTTP를 통한 SOAP를 사용하는 새 엔드포인트 리스너를 작성하십시오(여기서 서버의 호스트 주소는 http://myHost:9080임).
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1", "-eplName", "myNewEPL",
"-eplURLRoot", "http://myhost:9080/wsn", "-eplWSDLServingURLRoot", "http://myhost:9080/sibws"] )
node1에 있는 server1에 버전 7.0 WS-Notification 서비스 위치를 작성하십시오(최소 매개변수 세트).
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN"] )
node1에 있는 server1에 버전 7.0 WS-Notification 서비스 위치를 작성하십시오(전체 매개변수 세트).
newServicePoint = AdminTask.createWSNServicePoint(newService,
["-name", "newServicePoint", "-node", "node1", "-server", "server1",
"-transportURLRoot", "http://myhost:9080/myWSN", "-transportSoapVersion", "1.1",
"-jaxwsHandlerListNB", "nbList", "-jaxwsHandlerListSM", "smList", "-jaxwsHandlerListPRM", "prmList"] )