パブリッシュ/サブスクライブ情報を WebSphere® Message Broker バージョン 6.1 から WebSphere MQ にマイグレーションします。
目的
WebSphere MQ migmbbrk コマンドを使用して、
パブリッシュ/サブスクライブ情報を
WebSphere Message Broker バージョン 6.1 のブローカーから
WebSphere MQ キュー・マネージャーにマイグレーションします。
このコマンドによって、以下の
パブリッシュ/サブスクライブ情報を、指定のブローカーに関連付けられたキュー・マネージャーにマイグレーションするマイグレーション・プロセスが実行されます。
- サブスクリプション
- サブスクリプション・ポイント (サブスクリプション・ポイントがサポートされるのは、RFH2 メッセージが使用される場合だけです)
- ストリーム
- 保存パブリケーション
migmbbrk コマンドを実行する場合は、マイグレーション元の WebSphere Message Broker のバージョンのプロファイルを使用する必要があります。
migmbbrk コマンドを実行しても、アクセス制御リスト (ACL) はマイグレーションされません。その代わりに、-t パラメーターまたは -r パラメーターを指定してマイグレーションを実行すると、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップするための推奨 setmqaut コマンドが含まれているファイルが生成されます。マイグレーションを完了するために -c パラメーターを指定してマイグレーションを実行する前に、そのセキュリティー・コマンド・ファイルを検討し、必要に応じて変更してから、それらのコマンドを実行して、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップする必要があります。
注: UNIX システム では、プリンシパルではなくユーザー・グループがすべての権限を内部で保持しています。これにより、次のような影響があります。
- setmqaut コマンドを使用してプリンシパルに権限を付与すると、その権限は、そのプリンシパルの 1 次ユーザー・グループに付与されます。このため、そのユーザー・グループのすべてのメンバーに権限が効率的に付与されることになります。
- setmqaut コマンドを使用してプリンシパルから権限を取り消すと、その権限は、そのプリンシパルの 1 次ユーザー・グループから取り消されます。このため、そのユーザー・グループのすべてのメンバーから権限が効率的に取り消されることになります。
migmbbrk コマンドは、WebSphere MQ コマンドと WebSphere Message Broker コマンドの両方を正常に処理できるコマンド環境から実行する必要があります。通常、これらのコマンドを WebSphere Message Broker コマンド・コンソールから実行できます。
WebSphere Message Broker バージョン 6.1 パブリッシュ/サブスクライブ 構成データは、サブスクリプション・データベース表に格納されており、マイグレーション・プロセスでは削除されません。したがって、その構成データは、明示的に削除するまで使用可能です。
構文

.---------.
V |
>>-migmbbrk--+- -c +----+-----+-+-- -b -BrokerName-------------><
+- -r + +- -l +
'- -t ' +- -o +
+- -s +
'- -z '
パラメーター
- -b BrokerName
- (必須) マイグレーションされる予定のパブリッシュ/サブスクライブ情報のソースとなるブローカーの名前。パブリッシュ/サブスクライブ情報のマイグレーション先となるキュー・マネージャーは、指定のブローカーに関連付けられているキュー・マネージャーです。
- -c
- (必須) パブリッシュ/サブスクライブ構成データのマイグレーションを完了します。マイグレーションの完了段階では、初期の -t 段階で作成されたトピック・オブジェクトを使用します。ブローカーの状態は、初期フェーズが実行されて以降変更している可能性があり、新しい追加のトピック・オブジェクトが必要になる可能性があります。
必要な場合は、完了段階でその新しいトピック・オブジェクトが作成されます。
完了段階で、不要になったトピック・オブジェクトが削除されることはありません。不要になったトピック・オブジェクトを削除するには、手動で削除操作を実行する必要があります。
マイグレーションを完了する前に、-r 段階または -t 段階で生成されたセキュリティー・コマンド・ファイルを検討し、必要に応じて変更してから、それらのコマンドを実行して、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップする必要があります。
この完了段階を実行する前に、初期の -t 段階を実行する必要があります。-c パラメーターと -r パラメーターまたは -t パラメーターを併用することはできません。
この段階では、マイグレーション・ログも作成されます。
- -r
- (必須) マイグレーション・プロセスのリハーサルを行いますが、何も変更しません。
-t パラメーターを指定してマイグレーションを実行する前に、このパラメーターを使用して、エラーが記録されたマイグレーション・ログを作成できます。そうすれば、現行の構成を何も変更することなく、マイグレーション・プロセスの結果を把握できるようになります。
マイグレーションのリハーサルを行うと、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップするための推奨 setmqaut コマンドが含まれているファイルも生成されます。-c パラメーターを指定してマイグレーションを完了する前に、セキュリティー・コマンド・ファイルを検討し、必要に応じて変更してから、それらのコマンドを実行して、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップする必要があります。
-r パラメーターと -c パラメーターまたは -t パラメーターを併用することはできません。
- -t
- (必須) ブローカーで定義されている ACL 項目に基づいて、キュー・マネージャーで必要になる可能性があるトピック・オブジェクトを作成します。
-t パラメーターを使用すると、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップするための推奨 setmqaut コマンドが含まれているファイルも生成されます。トピック・オブジェクトは、そのトピック・オブジェクトに対応する ACL を作成するためのセキュリティー・コマンドが実行されるという想定に基づいて作成されます。-c パラメーターを指定してマイグレーションを完了する前に、セキュリティー・コマンド・ファイルを検討し、必要に応じて変更してから、それらのコマンドを実行して、ブローカーに存在していたセキュリティー環境と同等のセキュリティー環境をキュー・マネージャーでセットアップする必要があります。
-c パラメーターを指定して完了段階を実行する前に、この段階を実行する必要があります。-t パラメーターと -c パラメーターまたは -r パラメーターを併用することはできません。
この段階では、マイグレーション・ログも作成されます。
- -l
- (オプション) ブローカーを実行されたままにします。このパラメーターを指定しないと、デフォルトでブローカーはマイグレーション・プロセスの最後にシャットダウンします。
- -o
- (オプション) サブスクリプションまたは保存パブリケーションのうち、キュー・マネージャーに既に存在し、ブローカーからマイグレーションされているサブスクリプションまたは保存パブリケーションと名前が同じものは、ブローカーから取得された パブリッシュ/サブスクライブ 情報によって上書きされます。-o パラメーターは、-r パラメーターと一緒に使用すると無効になります。
- -s
- (オプション) マイグレーション・プロセスの以前のインスタンスのうち、失敗または中断したインスタンスから保持された中間情報を破棄します。マイグレーション・プロセスは、専用キューに一時データを取り込みます。マイグレーション・プロセスが正常に完了すると、一時データは削除されます。このパラメーターを指定しないで、マイグレーション・プロセスが失敗または中断すると、一時データは保持されて、マイグレーション・プロセスを再開する場合に使用され、このプロセスが以前に失敗または中断した箇所から再開されます。
- -z
- (オプション) マイグレーション・プロセスを以前に実行して正常に完了したかどうかに関係なく、マイグレーション・プロセスを実行します。このパラメーターを指定しておらず、マイグレーション・プロセスが以前に実行されて正常に完了している場合には、このプロセスはこの事実を認識して終了します。-o パラメーターを -z パラメーターと一緒に使用できますが、これは必須ではありません。
-r パラメーターを使用してマイグレーションのリハーサルをそれまでに行っていたとしても、正常な完了としてはカウントされません。
戻りコード
| 0 |
マイグレーションが正常に終了しました |
| 20 |
処理中にエラーが発生しました |
出力ファイル
マイグレーション・プロセスによって、現行ディレクトリーに以下の 2 つの出力ファイルが作成されます。
- amqmigrateacl.txt
- setmqaut コマンドのリストが含まれているファイルです。ACL を複製するために、このファイルを検討して実行できます。必要に応じて変更してから実行することも可能です。
- amqmigmbbrk.log
- マイグレーションの詳細に関するレコードが含まれるログ・ファイル。
例
このコマンドは、ブローカー BRK1 のパブリッシュ/サブスクライブ情報を関連付けられているキュー・マネージャーにマイグレーションし、マイグレーション・プロセスが以前に実行されて正常に完了したかどうかに関係なくこのプロセスを実行するように指定します。また、サブスクリプションまたは保存パブリケーションのうち、キュー・マネージャーに既に存在し、ブローカーからマイグレーションされているサブスクリプションまたは保存パブリケーションと名前が同じものは上書きされる必要があることを指定します。
migmbbrk -r -z -o -b BRK1
サポートされるオペレーティング・システム
migmbbrk コマンドは、WebSphere Message Broker バージョン 6.1 がサポートされている以下のプラットフォームでのみ使用できます。
- Microsoft Windows XP Professional (SP2、32 ビット・バージョンのみ)
- Solaris (x86-64): Solaris 10
- Solaris (SPARC): Solaris 9 (64 ビット)
- AIX® バージョン 5.2 以降 (64 ビットのみ)
- HP-Itanium: HP-UX 11i
- Linux (System z® (64 ビット)
- Linux (POWER® (64 ビット)
- Linux (x86)
- Linux (x86-64)
z/OS® の場合、migmbbrk コマンドに相当する機能が CSQUMGMB ユーティリティーによって提供されます。
ハードウェアおよびソフトウェアのすべてのサポート・レベルに関する最新の詳細情報については、WebSphere Message Broker 要件 Web サイトにアクセスしてください。