mqsimigratecomponents コマンドを使用して、以前にインストールされたバージョンの製品から、同じコンピューター上の別のバージョンにコンポーネントをマイグレーションします。
WebSphere Application Server と WebSphere Message Broker を併用している場合や、SubIdentity オプションを使用するパブリッシュ/サブスクライブ・アプリケーションがある場合は、WebSphere Message Broker バージョン 6.1 をフィックスパック 4 にアップグレードしてから WebSphere Message Broker バージョン 7.0 にマイグレーションする必要があります。
WebSphere Application Server と WebSphere Message Broker を併用している場合や、SubIdentity オプションを使用するパブリッシュ/サブスクライブ・アプリケーションがある場合は、WebSphere Message Broker バージョン 6.0 または WebSphere Event Broker バージョン 6.0 をフィックスパック 10 にアップグレードしてから WebSphere Message Broker バージョン 7.0 にマイグレーションする必要があります。
ブローカーを バージョン 7.0 にマイグレーションする際には、その構成はブローカー・データベースから読み取られ、マイグレーションされたブローカーにより保守される内部リポジトリーにマイグレーションされます。 バージョン 6.1 またはバージョン 6.0 のブローカーにより使用されるブローカー・データベースは、バージョン 7.0 ブローカーでは不要となりました。 マイグレーションが正常に完了した場合、それ以降使用することがないのであれば、そのデータベースを削除しても、またはそのデータベース製品をアンインストールしても構いません。
さらに、mqsimigratecomponents コマンドを使用して、ブローカーを バージョン 7.0 から前のバージョンに戻し、前方マイグレーションの作用を逆転させることができます。ただし、ブローカーは前方マイグレーションの時点でアクティブであった構成により復元され、マイグレーション後に実行した更新は、前のバージョンのブローカーに関連付けられているデータベースには反映されません。 前のバージョンのブローカーを使用できるようにするには、関連するブローカー・データベースを保持しておく必要があります。
このコマンドは、ソース・バージョンであるかターゲット・バージョンであるかにかかわらず、インストールされている製品のいずれか遅いほうのバージョンから実行される必要があります。
このコマンドを正常に実行するには、ターゲット・バージョンとソース・バージョンの両方で製品がインストール済みであり、必要なコンポーネント・コードがインストールされている必要があります。
マイグレーションを開始する前に、WebSphere Message Broker Toolkit で、ブローカーおよびすべてのアクティブなデバッグ・セッションを停止してください。 デバッグ中のメッセージ・フローをマイグレーションすることはできません。
マイグレーションするブローカーに対して mqsicreatebroker コマンド上でデータ・ソース・ユーザー ID とパスワードを指定した場合、これらのパラメーターの値もマイグレーションされ、mqsisetdbparms コマンドにより使用される形式で保存されます。 これらの値は、ブローカーにより mqsisetdbparms コマンドを使用して代替値を設定していないユーザー・データベースにアクセスするために使用されます。 マイグレーション後に、ブローカーがユーザー・データベースにアクセスするために使用するユーザー ID またはパスワードを変更する場合は、mqsisetdbparms コマンドしか使用できません。
ユーザー ID とパスワード値を更新し、ブローカーを前のバージョンにマイグレーションして戻す場合、これらの新規の値も元のブローカーにマイグレーションして戻されます。
実行中のコンポーネントを検査できます。 検査は、若干の性能低下が生じることを別にして、コンポーネントには影響を与えません。
検査コマンドは、成功するか失敗するかのどちらかで、マイグレーションが成功するかどうかについてのメッセージを印刷します。しかし、プロセス中に変更は行われません。
パラメーター -c と -v は互いに排他的です。 さらに、このいずれかのパラメーターを指定する場合、このコマンドの実行時にそれ以外のパラメーターを指定することはできません。
パラメーター -c と -v は互いに排他的です。 さらに、このいずれかのパラメーターを指定する場合、このコマンドの実行時にそれ以外のパラメーターを指定することはできません。
(オプション) 操作時に状況メッセージをわずかしか印刷しません。
(オプション) WebSphere MQ の作業のみ行います。
このオプションは、バージョン 7.0 への前方マイグレーションの場合にのみ有効です。 このパラメーターを後方マイグレーションのために指定すると、それは無視されます。ブローカーの状態に加えた変更をマイグレーションして元に戻して、前のバージョンのブローカーに属するデータベースに適用することはできません。
-3 は、バージョン 7.0 への前方マイグレーションの場合にのみ有効です。
(必須) マイグレーションするコンポーネントの名前。
Windows XP および Windows Server 2003 システムでは、このコマンドを実行するユーザー ID は、ローカル・システムの管理者グループのメンバーでなければなりません。
このコンソールは、正しい mqsiprofile 環境で開始されます。その環境から、昇格が必要なコマンドを実行できます。
このコマンドを特権コマンド・コンソール内から実行しない場合は、コマンドが正常に処理されません。
mqsimigratecomponents コマンドは、レジストリー、ファイル・システム、および WebSphere MQ 定義を更新します。
このコマンドを実行するために使用されるユーザー ID に、これらのすべてのステップを実行する権限がない場合は、一度にコマンドの一部だけが実行されます。異なるユーザーが、自分が権限を持つ部分を実行して、全体的な結果を得ることができます。このアプローチは分割マイグレーションと呼ばれ、-1、-2、および -3 のパラメーターを使用して実行されます。
分割マイグレーションを実行する場合、ご使用のユーザー ID は常に製品のレジストリーの読み取りができなければなりません。
このコマンドは、さまざまな操作の結果に応じて、考えられる多数の応答を生成することがあります。このコマンドは、メッセージを生成する方法の点で他のコマンドと異なっています。メッセージは、プログラムの最後にバッチで報告されるのではなく、その生成時に表示されます。
データベース表をマイグレーションする場合、z/OS では分散システムよりも多くの出力が生成されます。 表示されるメッセージの数を減らすには、-q パラメーターを使用します。
以下の例は、バージョン 6.1 から バージョン 7.0 への分割マイグレーションを示しています。
mqsimigratecomponents BROKER1 -1 mqsimigratecomponents BROKER1 -2 mqsimigratecomponents BROKER1 -3
以下の例は、バージョン 7.0 から バージョン 6.1 へ戻るマイグレーションを示しています。
mqsimigratecomponents MYBROKER -t 6.1.0.3