mqsimigratecomponents 명령

지원되는 플랫폼

  • Windows
  • Linux 및 UNIX 시스템
  • z/OS

목적

mqsimigratecomponents 명령은 제품의 이전에 설치된 버전(버전 2.1 또는 버전 5 전용)에서 다른 버전으로 구성요소를 이동합니다. 이 명령은 소스 버전 또는 대상 버전인지 여부와 상관없이 반드시 나중에 설치된 제품의 버전에서 실행되어야 합니다.
주:
  1. 버전 2.1 제품의 경우, 버전 2.1 CSD02(2.1.0.3) 릴리스부터 지원됩니다.(자세한 정보는 이주 및 업그레이드를 참조하십시오.)
  2. 버전 5 제품의 경우 버전 5.0.0.4 릴리스부터 지원됩니다.

필수 구성요소 코드가 있는 제품의 버전 6.0 설치가 설치되어 있어야 합니다. 즉, 필요한 경우 브로커 구성요소가 설치됩니다.

이주를 시작하기 전에 제어 센터의 디버깅 세션을 정지하십시오. 디버그 중인 메시지 플로우를 이주할 수는 없습니다.

다양한 옵션을 사용하여 명령을 호출하여 다음 조치 중 하나를 수행할 수 있습니다.
  • 변경사항을 작성하지 않고 구성요소를 점검하여 구성요소가 필수 이주에 적합한지 확인(-c)
  • 구성요소를 전체 또는 부분적으로 다른 버전으로 이동(-s-t)
  • 실패한 이주 단계 실행 취소(-u)
  • 성공적으로 이동되었는지 확인(-v)

mqsimigratecomponents 명령은 레지스트리 및 파일 시스템, WebSphere MQ 정의 및 데이터베이스 정의를 갱신합니다. 명령을 발행하는 사용자에게 이 단계 중 일부를 수행할 권한이 없으면 한번에 하나씩 명령을 실행할 수 있습니다. 종합적인 결과를 얻기 위해 다른 사용자가 수행할 권한이 있는 부분을 실행할 수 있습니다. 이 방법은 분할 이주라고 부르며 -1, -2-3 매개변수를 사용하여 수행됩니다.

Sybase 데이터베이스에서 mqsimigratecomponents 명령을 사용하는 경우, 다음 조치를 수행하여 데이터베이스를 수정해야 합니다.
  1. 시스템 관리자 계정을 사용하여 ISQL에 로그온하십시오.
  2. 일련의 다음 명령을 실행하십시오.
    1> use master
    2> go
    1> sp_dboption "BROKER1","ddl in tran",TRUE
    2> go
    Database option 'ddl in tran' turned ON for database 'BROKER1'.
    Run the CHECKPOINT command in the database that was changed.
    (return status = 0)
    1> use BROKER1
    2> go
    1> checkpoint
    2> go
    여기서 BROKER1은 Sybase 브로커 데이터베이스의 이름입니다.

구문

매개변수

-c
(선택사항) 지정된 구성요소의 이주 전 점검을 수행하여 다음 사항을 확인하십시오.
  • 브로커의 자동 발견 버전은 명령행에서 지정된 버전과 일치합니다.
  • 버전 6.0에서 이전 릴리스로 이주하는 경우 64비트 실행 그룹이 없습니다.
  • 이전 릴리스에서 복사할 데이터베이스 테이블에는 버전 6.0 색인 요구사항을 위반하는 행이 포함되지 않습니다.
이주하려는 브로커가 다른 브로커와 데이터베이스 스키마를 공유하면 경고 메시지 BIP8678이 발행되고 점검이 실패합니다. 이 경우 데이터베이스 스키마를 공유하는 모든 브로커는 함께 이주되어야 합니다.
  1. 데이터베이스 스키마를 공유하는 모든 브로커를 정지하십시오.
  2. 첫 번째 브로커를 이주하십시오. 그러면 첫 번째 브로커에 해당되는 파일 시스템, 레지스트리 및 WebSphere MQ 정의뿐 아니라 모든 브로커의 데이터베이스 테이블이 이주됩니다. 예:
    mqsimigratecomponents FIRSTBROKER -t 6.0.0.1 
  3. 다른 브로커 각각에 해당되는 파일 시스템, 레지스트리 및 WebSphere MQ 부분을 이주하십시오. -1 and -2 매개변수를 사용하여 한 단계에 또는 두 단계로 나누어 이주를 수행하십시오.
    • 한 단계:
      mqsimigratecomponents BROKERB -1 -2
    • 두 단계:
      mqsimigratecomponents BROKERB -1
      mqsimigratecomponents BROKERB -2

이주 점검은 실행 중인 구성요소에 대해 실행할 수 있습니다. 이는 약간의 성능 손실을 제외하고는 구성요소에 영향을 주지 않습니다. UNIX 시스템에서 점검 명령이 브로커 데이터베이스에 액세스할 수 있어야 하므로 점검을 실행하기 전에 odbc.ini 파일을 병합해야 합니다(즉, 기존의 것과 동일한 데이터 소스 세트로 새 형식 odbc.ini 파일을 작성해야 함).

점검 명령이 성공하거나 실패하고, 이주가 성공하는지 여부에 대한 메시지를 인쇄하지만 프로세스 중 수정사항이 작성되지 않습니다.

-v
(선택사항) 지정된 구성요소의 이주 후 점검을 수행하여 다음 사항을 확인하십시오.
  • 지정된 버전에 대한 올바른 데이터베이스 테이블 및 큐가 존재합니다.
  • 레지스트리가 지정된 버전에 대한 올바른 형식으로 되어 있습니다.
-q
(선택사항) 조작 중 더 적은 상태 메시지를 인쇄합니다.
-1
(선택사항) 레지스트리와 파일 시스템 작업만 수행합니다.
  • 버전 6.0으로 이주할 때, -2 또는 -3 매개변수 앞에 -1매개변수를 사용하십시오.
  • 이전 버전으로 역으로 이주할 때는 -2 또는 -3 매개변수를 -1 매개변수 앞에 사용하십시오.
-2
(선택사항) WebSphere MQ 작업만 수행합니다.
-3
(선택사항) 데이터베이스 작업만 수행합니다.
-u
(선택사항) 실패한 이주 단계를 실행 취소합니다. 또한 -1, -2 또는 -3 중 하나 이상을 지정해야 합니다. 이주에 실패하고 자동 복구에도 실패한 경우에만 이 옵션을 사용합니다(예: 분할 이주 중 실패).
-sSource Version
(선택사항) 구성요소의 이전 버전.
  • 이 값이 지정되지 않는 경우 자동으로 감지됩니다.
  • 버전 6.0으로 분할 이주를 수행할 때 -1 매개변수를 사용하여 mqsimigratecomponents 명령을 실행한 후에는 -s 매개변수가 필수입니다. 이에 대해서는 분할 이주 에 설명되어 있습니다.
  • 지원되는 제품의 버전 번호에 대한 제한사항은 목적을 참조하십시오.
-tTarget Version
(선택사항) 구성요소의 목적지 버전.
  • 이 값은 지정되지 않는 경우 현재 버전으로 가정됩니다.
  • 버전 6.0에서 이전 버전으로 이주할 때 -t 매개변수는 필수입니다. 이에 대해서는 분할 이주 에 설명되어 있습니다.
  • 지원되는 제품의 버전 번호에 대한 제한사항은 목적을 참조하십시오.
구성요소 이름
(필수) 이주할 구성요소의 이름

권한 부여

단일 단계 이주를 실행할 때 이 명령을 호출하는 데 사용된 사용자 ID에는 다음과 같은 기능이 있어야 합니다.
  • 제품에 대한 리지스트리 및 파일 시스템에 기록
  • 구성요소와 연관된 데이터베이스 수정
  • 큐 정의 수정
분할 이주의 경우 이 명령을 호출하는 데 사용된 사용자 ID에는 항상 제품에 대한 레지스트리에서 읽을 수 있는 권한이 있으며, 각 단계를 완료하기 위한 특정 권한도 있습니다.
  • -1에는 제품에 대한 레지스트리 및 파일 시스템에 기록하는 기능이 필요합니다.
  • -2에는 큐 정의를 수정하는 기능이 필요합니다.
  • -3에는 구성요소와 연관된 데이터베이스를 수정하는 기능이 필요합니다.

응답

변경 시작이 명령은 다양한 조작의 결과에 따라 가능한 많은 수의 응답을 생성할 수 있습니다. 이 명령은 메시지를 생성하는 방법에서 다른 명령과 다름에 유의하십시오. 프로그램 끝에 배치로 생성되지 않고 필요한 대로 표시됩니다. 데이터베이스 테이블을 이주할 때 z/OS는 분산 시스템보다 많은 출역을 생성합니다. 변경 끝

다음 예는 버전 2.1에서 버전 6.0으로의 BROKER1의 이주를 점검합니다.

변경 시작
mqsimigratecomponents –c BROKER1
BIP8849I: Broker 'BROKER1' (Version 2.1) with Queue Manager 'brkqm1' and Data Source 'brkdb1' specified for migration.
BIP8791I: Duplicate rows check started.
BIP8794I: Table BRMINFO has no duplicated rows.
BIP8794I: Table BRMRTDDEPINFO has no duplicated rows.
BIP8794I: Table BROKERRESOURCES has no duplicated rows.
BIP8794I: Table BRMRTDINFO has no duplicated rows.
BIP8794I: Table BRMWFDINFO has no duplicated rows.
BIP8792I: Duplicate rows check passed.
BIP8791I: Duplicate rows check started.
BIP8800W: No invalid topic syntax was detected in table BSUBSCRIPTIONS.
BIP8800W: No invalid topic syntax was detected in table BPUBLISHERS.
BIP8800W: No invalid topic syntax was detected in table BRETAINEDPUBS.
BIP8797I: Topic syntax check succeded
BIP8680I: Pre-migration check succeeded.
BIP8071I: 명령이 정상적으로 완료되었습니다.
변경 끝

다음 예는 버전 2.1에서 버전 6.0으로의 BROKER1의 자동 이주를 수행합니다.

변경 시작
mqsimigratecomponents BROKER1
BIP8849I: Broker 'BROKER1' (Version 2.1) with Queue Manager 'BROKER1' and Data Source 'BROKERDB' specified for migration.
BIP8755I: Copied value 'QueueManagerName' into the new location
BIP8755I: Copied value 'DataSourceName' into the new location
BIP8755I: Copied value 'DataSourceUserId' into the new location
BIP8755I: Copied value 'DataSourcePassword' into the new location
BIP8755I: Copied value 'LilPath' into the new location
BIP8755I: Copied value 'ConfigurationTimeout' into the new location
BIP8755I: Copied value 'ConfigurationDelayTimeout' into the new location
BIP8755I: Copied value 'MigrationNeeded' into the new location
BIP8755I: Copied value 'MQTrustedQueueManager' into the new location
BIP8755I: Copied value 'UserNameServerQueueManagerName' into the new location
BIP8755I: Copied value 'BrokerUUID' into the new location
BIP8755I: Copied value 'AdminAgentPID' into the new location
BIP8763I: Deleted value 'QueueManagerName' from the old location
BIP8763I: Deleted value 'DataSourceName' from the old location
BIP8763I: Deleted value 'DataSourceUserId' from the old location
BIP8763I: Deleted value 'DataSourcePassword' from the old location
BIP8763I: Deleted value 'LilPath' from the old location
BIP8763I: Deleted value 'ConfigurationTimeout' from the old location
BIP8763I: Deleted value 'ConfigurationDelayTimeout' from the old location
BIP8763I: Deleted value 'MigrationNeeded' from the old location
BIP8763I: Deleted value 'MQTrustedQueueManager' from the old location
BIP8763I: Deleted value 'UserNameServerQueueManagerName' from the old location
BIP8763I: Deleted value 'BrokerUUID' from the old location
BIP8763I: Deleted value 'AdminAgentPID' from the old location
BIP8768I: Finished registry migration for component 'BROKER1'.
BIP8654I: Moving filesystem artefacts from '' to 'C:\Documents and Settings\AllUsers\Application Data\IBM\MQSI'
BIP8670I: Database migration started
BIP8663I: Creating temporary new tables
BIP8664I: Migrating from existing tables to temporary new tables
BIP8665I: Dropping existing tables
BIP8666I: Creating new tables
BIP8667I: Copying all rows from temporary new tables to new tables
BIP8668I: Dropping temporary new tables
BIP8669I: Database migration successful
BIP8785I: Starting WebSphere MQ queue migration for component 'BROKER1'.
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.AGGR.REQUEST'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.AGGR.CONTROL'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.AGGR.REPLY'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.AGGR.TIMEOUT'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.AGGR.UNKNOWN'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.TIMEOUT.QUEUE'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.WS.INPUT'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.WS.REPLY'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.WS.ACK'
The setmqaut command completed successfully.
BIP8786I: Created WebSphere MQ queue 'SYSTEM.BROKER.IPC.QUEUE'
BIP8787I: Cleared WebSphere MQ queue 'SYSTEM.BROKER.ADMIN.QUEUE'
BIP8787I: Cleared WebSphere MQ queue 'SYSTEM.BROKER.EXECUTIONGROUP.QUEUE'
BIP8787I: Cleared WebSphere MQ queue 'SYSTEM.BROKER.EXECUTIONGROUP.REPLY'
BIP8787I: Cleared WebSphere MQ queue 'SYSTEM.BROKER.IPC.QUEUE'
BIP8789I: Finished WebSphere MQ queue migration for component 'BROKER1'.
BIP8071I: 명령이 정상적으로 완료되었습니다.
변경 끝

다음 예는 버전 2.1에서 버전 6.0으로의 분할 이주를 설명합니다.

mqsimigratecomponents BROKER -1
mqsimigratecomponents BROKER -s 2.1.0.8 -2
mqsimigratecomponents BROKER -s 2.1.0.8 -3

다음 예는 버전 6.0에서 버전 2.1로의 분할 이주를 설명합니다.

mqsimigratecomponents BROKER -t 2.1.0.8 -2
mqsimigratecomponents BROKER -t 2.1.0.8 -3
mqsimigratecomponents BROKER -t 2.1.0.8 -1
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
an26150_