addSIBusMember 명령

wsadmin 도구를 사용하여 서비스 통합 버스에 멤버를 추가하려면 addSIBusMember 명령을 사용하십시오. 버스 멤버는 애플리케이션 서버, WebSphere® MQ 서버 또는 서버 클러스터여야 합니다.

명령을 실행하려면 wsadmin 스크립트 클라이언트AdminTask 오브젝트를 사용하십시오.

[IBM i][IBM i]wsadmin 스크립트 클라이언트는 Qshell에서 실행됩니다. . [IBM i]자세한 정보는 wsadmin 스크립트를 사용하여 WebSphere 스크립트를 실행하도록 Qshell 구성의 내용을 참조하십시오..

서비스 통합 버스에 대해 명령행 도움말이 제공됩니다.
  • Jython의 사용 가능한 서비스 통합 버스 명령 목록과 각 명령의 간단한 설명에 대해서는 wsadmin 프롬프트에 다음 명령을 입력하십시오.

    print AdminTask.help('SIBAdminCommands')

  • 제공된 명령에 대한 개요 도움말을 보려면 다음 명령을 wsadmin 프롬프트에 입력하십시오.

    print AdminTask.help('command_name')

명령을 사용한 후에는 다음 명령을 사용하여 변경사항을 마스터 구성에 저장하십시오.

AdminConfig.save()

목적

addSIBusMember 명령은 서비스 통합 버스에 새 멤버를 추가합니다. 애플리케이션 서버가 버스의 멤버로 추가될 때, 기본 설정을 갖는 메시징 엔진이 자동으로 작성됩니다.

클러스터가 버스의 멤버로 추가될 때, 메시징 엔진 정책 지원이 사용 불가능한 경우 기본 설정을 갖는 메시징 엔진이 자동으로 작성됩니다. 버스 멤버에 대한 추가 메시징 엔진을 작성하려면 createSIBEngine 명령을 사용하십시오.

클러스터가 버스에 추가될 때, 메시징 엔진 정책 지원이 사용 가능하며 고가용성 메시징 엔진 정책이 지정되는 경우 고가용성 정책을 지원하는 설정을 갖는 메시징 엔진이 자동으로 작성됩니다.

클러스터가 버스에 추가될 때, 메시징 엔진 정책 지원이 사용 가능하며 확장성 또는 고가용성 메시징 엔진 정책 유형을 갖는 확장성이 지정되는 경우 선택된 정책을 지원하는 설정을 갖는 메시징 엔진이 자동으로 작성됩니다. 그런 다음 createSIBEngine 명령을 사용하여 추가 메시징 엔진(클러스터의 각 애플리케이션 서버에 대해 하나)을 작성해야 합니다. 각 새 메시징 엔진의 경우, 선택된 정책을 지원하는 설정이 자동으로 작성됩니다.

메시징 엔진 정책 지원이 가능하고 사용자 정의 메시징 엔진 정책 유형이 지정된 상태에서 addSIBusMember 명령을 사용하는 경우, 첫 번째 메시징 엔진에 대한 동작을 설정한 후 createSIBEngine 명령을 사용하여 추가 메시징 엔진을 작성할 수 있습니다.

WebSphere MQ 서버가 버스의 멤버로서 추가될 때, WebSphere MQ 서버에서 정의되는 상위 연결 특성(호스트, 포트, 채널 및 SSL 보안 구성 별명)을 대체할 수 있는 서버 프록시가 작성됩니다. 이렇게 하여 서로 다른 연결 특성 세트를 각 버스 멤버십에 지정할 수 있습니다.

대상 오브젝트

없음.

버스 멤버 오브젝트가 작성됩니다. 버스 멤버가 서버 또는 서버 클러스터인 경우, 메시징 엔진도 작성됩니다.

필수 매개변수

-bus bus_name
서비스 통합 버스가 알려지는 이름입니다. listSIBuses 명령을 사용하여 기존 버스의 이름을 나열할 수 있습니다.

조건부 매개변수

-node node_name
-server server_name
애플리케이션 서버를 버스 멤버로 추가하려면 서버가 실행하는 노드의 이름과 해당 서버의 이름을 둘 다 지정하십시오.

이들 매개변수를 지정하는 경우 -cluster 또는 -wmqServer 매개변수를 지정하지 마십시오.

-cluster cluster_name
버스 멤버로 서버 클러스터를 추가하기 위해 클러스터의 이름을 지정합니다.

이 매개변수를 지정하는 경우 -node, -server 또는 -wmqServer 매개변수를 지정하지 마십시오.

-wmqServer
WebSphere MQ 서버를 버스 멤버로 추가하려면 WebSphere MQ 서버의 이름을 지정하십시오. 이것은 WebSphere MQ 서버가 작성될 때 -name 매개변수에서 지정된 이름입니다.

이 매개변수를 지정하는 경우 -cluster, -node 또는 -server 매개변수를 지정하지 마십시오.

선택적 매개변수

-description text
관리 목적을 위한 버스 멤버에 대한 선택적 설명.
-virtualQueueManagerName
WebSphere MQ 서버 가상 큐 관리자의 이름에 대한 대체 값. IBM MQ에 메시지를 전송하는 경우, IBM MQ 게이트웨이 큐 관리자는 버스를 원격 큐 관리자로 간주합니다. 가상 큐 관리자 이름은 이 원격 큐 관리자의 이름으로 IBM MQ에 전달된 이름입니다. 기본값은 버스의 이름입니다. 이 값이 IBM MQ 큐 관리자의 유효한 이름이 아니거나 동일한 이름을 가진 다른 IBM MQ 큐 관리자가 이미 존재하는 경우, 기본값을 IBM MQ 큐 관리자에 대해 유효하고 고유한 이름인 다른 값으로 바꾸십시오. 이름이 유효하려면 다음 기준을 충족해야 합니다.
  • 1 - 48자여야 합니다.
  • IBM MQ 큐 이름 지정 규칙을 준수해야 합니다(IBM MQ Information Center의 IBM MQ 오브젝트의 이름 지정 규칙 주제 참조).
-host
WebSphere MQ 서버 버스 멤버 호스트 속성의 대체 값입니다. 이 값은 큐 관리자 또는 큐 공유 그룹과 통신하기 위해 연결이 설정되는 호스트의 IP 주소 또는 호스트 이름입니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-port
WebSphere MQ 서버 버스 멤버 포트 속성의 대체 값입니다. 포트 번호는 연결을 청취하고 있는 큐 관리자 리스너 또는 큐 공유 그룹 리스너에 의해 모니터됩니다. 기본값은 1414입니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-channel
WebSphere MQ 서버 버스 멤버 채널 속성의 대체 값입니다. 이것은 IBM MQ 큐 관리자 또는 z/OS®용 IBM MQ 큐 공유 그룹에 대한 연결을 구축하는 데 사용되는 서버 연결 채널의 이름입니다. 기본값은 SYSTEM.DEF.SVRCONN입니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-securityAuthAlias
WebSphere MQ 서버 버스 멤버 securityAuthAlias 속성에 대한 대체 값입니다. 이것은 WebSphere MQ 서버에 연결할 때 제공되는 인증 별명입니다. 이 매개변수는 기본값이 없습니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-transportChain
WebSphere MQ 서버 버스 멤버 transportChain 속성에 대한 대체 값입니다. 이것은 IBM MQ와 통신할 때 사용할 전송 체인의 이름입니다. 기본값은 OutboundBasicWMQClient입니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-trustUserIds TRUE | FALSE
WebSphere MQ 서버 버스 멤버 trustUserIds 속성에 대한 대체 값입니다. IBM MQ으로부터 메시지에서 수신되는 사용자 ID가 메시지로 전파되는지 여부를 판별합니다. 애플리케이션 사용자 ID는 항상 jsAppUserIdRFH2 값으로부터 설정됩니다. 이 값이 없을 경우(키/값 쌍이 RFH2 헤더의 <sib> 폴더에 없거나 메시지에 RFH2 헤더가 없기 때문에) 이 필드는 설정되지 않습니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
사용자 ID가 메시지에 전파됩니다.
FALSE
사용자 ID가 메시지에 전파되지 않습니다.

기본값은 TRUE입니다. -wmqServer 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.

-enableAssistance TRUE | FALSE
메시징 엔진 정책 지원을 사용할지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
메시징 엔진 정책 지원이 가능합니다. -policyName 매개변수를 제공해야 합니다.
FALSE
메시징 엔진 정책 지원이 사용 안됩니다. 이것이 기본값입니다. -cluster 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-policyName HA | SCALABILITY | SCALABILITY_HA | CUSTOM
클러스터에 적용될 메시징 엔진 정책의 유형입니다. 이 매개변수는 다음 4가지 가능한 값을 갖습니다.
HA
고가용성 메시징 엔진 정책을 클러스터에 적용합니다.
SCALABILITY
확장성 메시징 엔진 정책을 클러스터에 적용합니다.
SCALABILITY_HA
고가용성을 포함한 확장성 메시징 엔진 정책을 클러스터에 적용합니다.
CUSTOM
사용자 정의 메시징 엔진 정책을 클러스터에 적용합니다.

이 매개변수는 기본값이 없습니다. -cluster 매개변수가 지정되고 -enableAssistance 매개변수가 TRUE로 설정되는 경우 이 매개변수를 사용하십시오.

-failover TRUE | FALSE
메시징 엔진에 대한 호스트 서버가 실패하는 경우 클러스터의 메시징 엔진이 클러스터의 다른 서버로 장애 복구할 수 있는지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
메시징 엔진이 장애 복구할 수 있습니다.
FALSE
메시징 엔진이 장애 복구할 수 없습니다.

기본값은 FALSE입니다. -cluster 매개변수가 지정되고 -enableAssistance 매개변수가 TRUE로 설정되고 -policyName 매개변수가 CUSTOM으로 설정되는 경우 이 매개변수를 사용하십시오.

-failback TRUE | FALSE
선호하는 서버가 다시 사용 가능해지는 경우 장애 복구한 클러스터의 메시징 엔진이 선호하는 서버 목록의 더 선호하는 서버로 복구 전환할 수 있는지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
메시징 엔진이 복구 전환할 수 있습니다. 이 옵션을 사용하는 경우 -preferredServerList 매개변수를 제공하십시오.
FALSE
메시징 엔진이 복구 전환할 수 없습니다.

기본값은 FALSE입니다. -cluster 매개변수가 지정되고 -enableAssistance 매개변수가 TRUE로 설정되고 -policyName 매개변수가 CUSTOM으로 설정되는 경우 이 매개변수를 사용하십시오.

-preferredServersOnly TRUE | FALSE
클러스터의 메시징 엔진이 선호하는 서버 목록에 있는 서버만 또는 클러스터의 임의의 서버에서 실행할 수 있는지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
메시징 엔진은 선호하는 서버 목록에 있는 서버에서만 실행할 수 있습니다. 이 옵션을 사용하는 경우 -preferredServerList 매개변수를 제공하십시오.
FALSE
메시징 엔진이 클러스터의 임의의 서버에서 실행할 수 있습니다.

기본값은 FALSE입니다. -cluster 매개변수가 지정되고 -enableAssistance 매개변수가 TRUE로 설정되고 -policyName 매개변수가 CUSTOM으로 설정되는 경우 이 매개변수를 사용하십시오.

-preferredServerList {{node_name server_name}}
클러스터의 메시징 엔진이 실행하는 것을 선호하는 서버의 우선순위의 목록입니다. 목록에 있는 각 서버에 대해 서버가 실행하는 노드의 이름과 서버의 이름을 둘 다 지정하십시오. 이 매개변수의 기본값은 없습니다. -cluster 매개변수가 지정되고 -enableAssistance 매개변수가 TRUE로 설정되고 -policyName 매개변수가 CUSTOM으로 설정되는 경우 이 매개변수를 사용하십시오.
-fileStore
메시징 엔진을 위한 메시지 저장소로 사용할 파일 저장소를 작성하십시오. 파일 저장소는 운영 체제를 통해 파일 시스템에 있는 파일을 직접 사용하는 메시지 저장소의 유형입니다. 대체는 데이터 저장소를 사용하는 것입니다. 자세한 정보는 관련 링크를 참조하십시오.
-logSize logsize
MB 단위의 로그 파일의 크기입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-logDirectory logdirectoryname
기본 로그 디렉토리를 사용하기를 원하지 않는 경우 로그 파일 디렉토리의 이름입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-minPermanentStoreSize minpermanentstoresize
MB 단위의 영구 저장소 파일의 최소 크기입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-minTemporaryStoreSize mintemporarystoresize
MB 단위에 임시 저장소 파일의 최소 크기입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-maxPermanentStoreSize maxpermanentstoresize
MB 단위의 영구 저장소 파일의 최대 크기입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-maxTemporaryStoreSize maxtemporarystoresize
MB 단위의 임시 저장소 파일의 최대 크기입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-unlimitedPermanentStoreSize TRUE | FALSE
영구 저장소 크기가 무제한인지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
영구 저장소 크기가 무제한입니다.
FALSE
영구 저장소 크기가 제한됩니다. 이 옵션을 사용하는 경우 -maxPermanentStoreSize 매개변수를 제공하십시오.

-fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.

-unlimitedTemporaryStoreSize TRUE | FALSE
임시 저장소 크기가 무제한인지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
임시 저장소 크기가 무제한입니다.
FALSE
임시 저장소 크기가 제한됩니다. 이 옵션을 사용하는 경우 -maxTemporaryStoreSize 매개변수를 제공하십시오.

-fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.

-permanentStoreDirectory permanentstoredirectoryname
기본 영구 저장소 디렉토리를 사용하기를 원하지 않는 경우 영구 저장소 디렉토리의 이름입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-temporaryStoreDirectory temporarystoredirectoryname
기본 임시 저장소 디렉토리를 사용하기를 원하지 않는 경우 임시 저장소 디렉토리의 이름입니다. -fileStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-dataStore
메시징 엔진을 위한 메시지 저장소로 사용할 데이터 저장소를 작성하십시오.

데이터 저장소는 데이터베이스에 있는 지속적인 데이터를 저장하기 위해 메시징 엔진이 사용하는 테이블 세트로 구성됩니다. 데이터 저장소를 구성하는 테이블의 목록에 대해서는 데이터 저장소 테이블의 내용을 참조하십시오. 데이터 저장소의 모든 테이블은 동일한 데이터베이스 스키마에 보유됩니다. 각 데이터 저장소에 대해 서로 다른 스키마 이름을 사용할 경우 동일한 데이터베이스에 여러 개의 데이터 저장소를 작성할 수 있습니다.

대체는 파일 저장소를 사용하는 것입니다(기본값). 자세한 정보는 관련 링크를 참조하십시오.
-createDefaultDatasource TRUE | FALSE
메시징 엔진이 작성될 때 기본 데이터 소스를 작성할지 여부를 지정하는 매개변수입니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
기본 데이터 소스를 작성합니다.
FALSE
기본 데이터 소스를 작성하지 않습니다.

-dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오. -cluster 매개변수가 지정되는 경우에는 이 매개변수를 사용하지 마십시오.

-datasourceJndiName jndiname
메시징 엔진이 데이터 저장소의 관계형 데이터베이스 관리 시스템(RDBMS)에 액세스하기 위해 사용하는 데이터 소스의 JNDI 이름입니다. -dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-authAlias authalias
메시징 엔진이 데이터 저장소에 있는 데이터베이스에 연결하는 데 사용하는 인증 별명의 이름입니다. -dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-createTables datasource
지정된 데이터 소스에 대한 데이터베이스 테이블을 자동으로 작성합니다. 이 옵션이 지정되지 않으면, 데이터베이스 관리자가 테이블을 작성해야 합니다. -dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-restrictLongDBLock TRUE | FALSE
활성 메시징 엔진이 데이터베이스의 SIBOWNER 테이블에 장기 실행 잠금을 유지해야 하는지 여부를 지정하는 매개변수입니다. 이 옵션을 선택하면 메시징 엔진이 짧은 기간에 대해서만 데이터베이스에 대해 잠금을 설정합니다. 데이터베이스에 반응하지 않는 활성 메시징 엔진의 이벤트에서, 활성 메시징 엔진은 짧은 지속 기간 잠금만 보유하기 때문에 대기 메시징 엔진이 데이터베이스의 소유권을 가질 수 있습니다. 이 매개변수는 다음 두 가지 값을 가집니다.
TRUE
데이터베이스에 대한 장기 실행 잠금을 제한합니다.
FALSE
데이터베이스에 대한 장기 실행 잠금을 제한하지 않습니다.

-dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.

중요사항: 특성이 선택되는 경우에도 특성은 데이터베이스 테이블이 WebSphere Application Server 버전 9.0 이상에 대한 sibDBUpgrade 명령을 사용하여 업그레이드될 때까지 적용되지 않습니다.
-schemaName schemaname
기본 스키마 이름을 사용하지 않으려는 경우 데이터 저장소에 대한 테이블을 포함하는 데이터베이스 스키마의 이름입니다. 기본 스키마에 대한 자세한 내용은 데이터베이스에 사용자 및 스키마 작성의 내용을 참조하십시오. -dataStore 매개변수가 지정되는 경우 이 매개변수를 사용하십시오.
-initialHeapSize size
서버 또는 클러스터의 각 서버의 초기 JVM(Java™ virtual machine) 힙 크기(MB)입니다. 기본값은 없습니다. 이 매개변수가 지정되지 않으면, 어떤 변경도 작성되지 않습니다. 이 매개변수가 지정되는 경우, 제공되는 값은 0보다 크거나 같고 2048보다 작거나 같아야 합니다. 매개변수가 값 없이 제공되는 경우 오류 메시지가 생성됩니다.
[z/OS]참고: addSIBusMember 명령의 주제인 서버가 z/OS에서 실행 중인 경우 또는 주제가 클러스터인 경우 클러스터의 모든 서버가 z/OS에서 실행 중인 경우 이 매개변수는 무시됩니다.
-maxHeapSize size
서버 또는 클러스터의 각 서버의 최대 JVM 힙 크기(MB)입니다. 기본값은 없습니다. 이 매개변수가 지정되지 않으면, 어떤 변경도 작성되지 않습니다. 이 매개변수가 지정되는 경우, 제공되는 값은 0보다 크거나 같고 2048보다 작거나 같아야 합니다. 매개변수가 값 없이 제공되는 경우 오류 메시지가 생성됩니다.
[z/OS]참고: addSIBusMember 명령의 주제인 서버가 z/OS에서 실행 중인 경우 또는 주제가 클러스터인 경우 클러스터의 모든 서버가 z/OS에서 실행 중인 경우 이 매개변수는 무시됩니다.

예제

node1의 server1을 기본 파일 저장소를 갖는 bus1의 멤버로 추가하십시오.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')

server1을 bus1의 멤버로 추가하고, 파일 저장소를 사용하여 메시지를 저장하십시오.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')

server1을 bus1의 멤버로서 추가하고, 파일 저장소를 사용하여 옵션과 함께 메시지를 저장하십시오.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore 
-logSize 100 -logDirectory C:\\filestore1 ]') 

server1을 bus1의 멤버로 추가하고, 데이터 저장소를 사용하여 메시지를 저장하십시오.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')

server1을 bus1의 멤버로서 추가하고, 데이터 저장소를 사용하여 옵션과 함께 메시지를 저장하십시오.

AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore 
-createDefaultDatasource true -datasourceJndiName myjndi]') 

메시징 엔진 정책 지원 없이 cluster1을 bus1에 추가하고 파일 저장소를 메시징 엔진에 대한 메시지 저장소로 사용하십시오.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -fileStore true 
-logDirectory C:\\filestore1 -permanentStoreDirectory C:\\filestore2 
-temporaryStoreDirectory C:\\filestore3]')

cluster1을 bus1에 추가하고 메시징 엔진 정책 지원 및 고가용성 메시징 엔진 정책을 사용하십시오. 파일 저장소를 메시징 엔진을 위한 메시지 저장소로 사용하십시오.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true 
-policyName HA -fileStore -permanentStoreDirectory C:\\filestore1 
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\filestore1 ]') 

cluster1을 bus1에 추가하고 메시징 엔진 정책 지원 및 사용자 정의 메시징 엔진 정책을 사용하십시오. 파일 저장소를 메시징 엔진을 위한 메시지 저장소로 사용하십시오. 메시징 엔진을 복구 전환이 아니라 장애 복구하고 server1 및 server2에서만 실행하도록 설정하십시오.

AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true 
-policyName CUSTOM -fileStore -permanentStoreDirectory C:\\filestore1 
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\temp\filestore 
-failover true -failback false -preferredServersOnly true 
-preferredServerList [[node1 server1] [node2 server2]]]') 

[AIX Solaris HP-UX Linux Windows][IBM i]초기 JVM 힙 크기를 256, 최대 JVM 힙 크기를 512로 변경하십시오.

[AIX Solaris HP-UX Linux Windows][IBM i]
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 
-initialHeapSize 256 -maxHeapSize 512]')

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



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