必要なコンポーネント・コードがインストールされている (つまり、必要とされる場合にはブローカー・コンポーネントがインストールされている、など) 製品の バージョン 6.0 インストールを持っていなければなりません。
マイグレーションを開始する前に、コントロール・センターのデバッグ・セッションを停止してください。 デバッグ中のメッセージ・フローをマイグレーションすることはできません。
mqsimigratecomponents コマンドは、レジストリーおよびファイル・システム、WebSphere MQ 定義、およびデータベース定義を更新します。このコマンドを発行しているユーザーが、これらのすべてのステップを実行する権限を持たない場合、コマンドの一部だけが実行されます。異なるユーザーが、自分が権限を持つ部分を実行して、全体的な結果を得ることができます。これは分割マイグレーションと呼ばれ、-1、-2、および -3 パラメーターを使用して実行されます。
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 ブローカー・データベースの名前です。
mqsimigratecomponents FIRSTBROKER -t 6.0.0.1
mqsimigratecomponents BROKERB -1 -2
mqsimigratecomponents BROKERB -1 mqsimigratecomponents BROKERB -2
マイグレーション検査は、実行中のコンポーネント対して実行できます。 これは、パフォーマンスに多少の不利益が生じることを除けば、コンポーネントに影響を与えません。 UNIX システムでは、検査を実行する前に odbc.ini ファイルをマイグレーションする必要があります (つまり、以前のものと同じデータ・ソース・セットを持つ新規フォーマットの odbc.ini ファイルを作成する必要があります)。なぜなら、検査コマンドはブローカー・データベースにアクセスできなければならないからです。
検査コマンドは、成功するか失敗するかのどちらかで、マイグレーションが成功するかどうかについてのメッセージを印刷します。しかし、プロセス中に変更は行われません。
このコマンドは、さまざまな操作の結果に応じて、考えられる大量の応答を生成することがあります。 このコマンドは、メッセージを生成する方法が他のコマンドと異なることに注意してください。メッセージは、プログラムの最後にバッチで生成されるのではなく、必要に応じて表示されます。
次の例は、V2.1 からバージョン 6.0への BROKER1 のマイグレーションを検査します。
mqsimigratecomponents –c BROKER1 BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。 BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。 BIP 0003I: ブローカー・データベース‘BKRDB’とスキーマ‘WMQIUSER’は他のコンポーネントと共有されません。 BIP 0004I: ブローカー・データベースに無効な行が見つかりません。 BIP 0005I: マイグレーション検査をパスしました。 BIP 8071I: コマンドが正常に完了しました。
次の例は、V2.1 からバージョン 6.0 への BROKER1 の自動マイグレーションを行います。
mqsimigratecomponents BROKER1 BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。 BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。 BIP 0003I: ブローカー・データベース‘BKRDB’とスキーマ‘WMQIUSER’は他のコンポーネントと共有されません。 BIP 0004I: ブローカー・データベースに無効な行が見つかりません。 BIP 0005I: マイグレーション検査をパスしました。 BIP 0020I: コンポーネント‘BROKER1’のレジストリー・マイグレーションを開始中です。 BIP 0021I: 最上位 'CurrentVersion' キーが作成されました。 BIP 0021I: ‘DSN’サブキーが作成されました。 BIP 0022I: ‘HTTPListener’サブキーが作成されました。 BIP 0023I: ‘HTTPListener.HTTPConnector’サブキーが作成されました。 BIP 0024I: ‘FADLevel’値が作成されました。‘3’に設定されます。 BIP 0025I: ‘converters’値が作成されました。‘’に設定されます。 BIP 0028I: レジストリー・データを‘CurrentVersion’に移動中です。 BIP 0029I: 値‘AdminAgentPID’を移動しました。 [値ごとに繰り返し] BIP 0030I: レジストリー・データの‘CurrentVersion’への移動が完了しました。 BIP 0025I: コンポーネント‘BROKER1’のレジストリー・マイグレーションが完了しました。 BIP 0011I: ‘BKRDB’のデータベース表のマイグレーションが開始中です。’WMQIUSER’。 BIP 0012I: 表 ’BROKERRESOURCES’を ’somethingBROKERRESOURCES’に移動中です。 BIP 0013I: 新規表 ’BROKERRESOURCES’を作成中です。 BIP 0014I: データを‘somethingBROKERRESOURCES’から ’BROKERRESOURCES’にコピー中です。 BIP 0015I: すべてのデータ (322 行) を正常にコピーしました。 [表ごとに繰り返し] BIP 0016I: ‘BKRDB’のデータベース表のマイグレーションが完了しました。’WMQIUSER’。 BIP 0017I: ‘BKRQM’キュー・マイグレーションを開始中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.CONTROL’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.REPLY’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.REQUEST’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.TIMEOUT’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.AGGR.UNKNOWN’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.INTERBROKER.MODEL.QUEUE’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.TIMEOUT.QUEUE’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.ACK’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.INPUT’を作成中です。 BIP 0018I: 新規キュー‘SYSTEM.BROKER.WS.REPLY’を作成中です。 BIP 0026I: キュー‘SYSTEM.BROKER.ADMIN.QUEUE’をクリア中です。 BIP 0026I: キュー‘SYSTEM.BROKER.EXECUTIONGROUP.QUEUE’をクリア中です。 BIP 0026I: キュー‘SYSTEM.BROKER.EXECUTIONGROUP.REPLY’をクリア中です。 BIP 0026I: キュー‘SYSTEM.BROKER.IPC.QUEUE’をクリア中です。 BIP 0019I: ‘BKRQM’のキュー・マイグレーションが完了しました。 BIP 0005I: コンポーネント‘BROKER1’のマイグレーションが成功しました。 BIP 8071I: コマンドが正常に完了しました。
次の例は、前述の例の繰り返しですが、-q パラメーターが指定されています。
mqsimigratecomponents -q BROKER1 BIP 0001I: コンポーネント‘BROKER1’のマイグレーション検査を FAD レベル‘3’まで開始中です。 BIP 0002I: ‘BROKER1’はバージョン 2.1 です (自動検出)。 BIP 0005I: マイグレーション検査をパスしました。 BIP 0020I: コンポーネント‘BROKER1’のレジストリー・マイグレーションを開始中です。 BIP 0025I: コンポーネント‘BROKER1’のレジストリー・マイグレーションが完了しました。 BIP 0011I: ‘BKRDB’のデータベース表のマイグレーションが開始中です。’WMQIUSER’。 BIP 0016I: ‘BKRDB’のデータベース表のマイグレーションが完了しました。’WMQIUSER’。 BIP 0017I: ‘BKRQM’キュー・マイグレーションを開始中です。 BIP 0019I: ‘BKRQM’のキュー・マイグレーションが完了しました。 BIP 0005I: コンポーネント‘BROKER1’のマイグレーションが成功しました。 BIP 8071I: コマンドが正常に完了しました。
以下の例は、バージョン 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