AIX and Linuxでのマイグレーション: 一段階

シングルステージ・マイグレーションとは、サーバーにインストールされている「IBM® MQ、それ以降のリリースに置き換えることを表す言葉である。 一段階マイグレーションは、インプレースでのアップグレードまたはインプレース・アップグレードとも呼ばれます。 他の移行シナリオでは、いくつかのスクリプトや手順を変更する可能性がありますが、キューマネージャの移行がユーザに与える影響を軽減することができます。

1. group mqmでユーザーとしてログインします。
2. IBM MQインストールを使用しているすべてのアプリケーションを停止する。

   Managed File Transfer (MFT) コンポーネントを使用する場合は、すべての MFT エージェントが、関与していたすべてのファイル転送を完了していることを確認してください。 エージェントに関連した転送を未完了のまま残さないでください。また、SYSTEM.FTE.STATE キューにメッセージを入れておかないでください。

3. 次のコマンドを入力して、 IBM MQ インストール済み環境に関連付けられている mqweb サーバーを停止します。

   endmqweb

4. IBM MQ インストール済み環境に関連付けられているキュー・マネージャーのすべてのアクティビティーを終了します。
   1. dspmq コマンドを使用して、システム上のすべてのキュー・マネージャーの状態をリストします。

      dspmq -a
      

   2. DISPLAY LSSTATUSMQSC コマンドを使用して、キューマネージャに関連付けられているリスナのステータスをリストアップする：

      echo "DISPLAY LSSTATUS(*) STATUS" | runmqsc QmgrName
      

   3. endmqlsrコマンドを使用して、キューマネージャに関連付けられたリスナーを停止する：

      endmqlsr -m QMgrName
      

   4. endmqm コマンドを使用して、このインストール済み環境に関連付けられている実行中の各キュー・マネージャーを停止します。

      endmqm QMgrName

      endmqm コマンドは、接続先のキュー・マネージャーが停止中であることをアプリケーションに通知します。 キュー・マネージャーの停止を参照してください。

      マイグレーションを進めるためには、アプリケーションはキュー・マネージャから切断し、ロードした「IBM MQライブラリを解放することで、「endmqmコマンドに応答しなければならない。 そうでない場合は、アプリケーションを停止するなどして、アプリケーションに強制的に IBM MQ リソースを解放させる別の方法を見つける必要があります。

      また、インストールに含まれているクライアント・ライブラリを使用しているアプリケーションも停止してください。 クライアント・アプリケーションは、 IBM MQの異なるインストール済み環境を実行して、異なるキュー・マネージャーに接続されている可能性があります。 現在のインストール済み環境にあるキュー・マネージャーがシャットダウンすることについて、そのアプリケーションは通知を受けません。

      インストール済み環境からの IBM MQ 共有ライブラリーが引き続きロードされているアプリケーションでは、 IBM MQをアップグレードできません。 アプリケーションは、キュー・マネージャーから切断されるか、強制的に切断される可能性がありますが、 IBM MQ 共有ライブラリーはロードされたままになります。

5. このキュー・マネージャーをバックアップします。
   すべてのキュー・マネージャーのデータおよびログ・ファイル・ディレクトリー(すべてのサブディレクトリー、および qm.ini ファイルも含む) のコピーを取ります。 詳しくは、 IBM MQ キュー・マネージャー・データのバックアップと復元を参照してください。
6. IBM MQ のバージョンをアップグレードする前に、システム上に修正パックを用意する必要があります：
   • AIX では、未コミットの修正パックは、アップグレードする前に拒否するか、コミットする必要があります。
   • Linuxで、'IBM MQ 9.4に移行する場合、インストールをアップグレードする前に、以前の'IBM MQバージョンにインストールされているフィックスパックパッケージをアンインストールする必要があります。

     RPMベースのディストリビューションでは、フィックスパックパッケージは、'Uvrmfセグメントを含む名前でインストールされたパッケージとして識別されます。 例えば、MQSeriesRuntime-U93015-9.3.0-15などです。 ベースパッケージにはこのセグメントは含まれない。 例: MQSeriesRuntime-9.3.0-25。

7. 前のバージョンの製品を同じインストール・ディレクトリーで後のバージョンにアップグレードします。
   • AIXでは、新しいバージョンにアップグレードします。 詳しくは、 AIX の IBM MQ サーバーのインストールを参照。
   • Linux では、ベースパッケージレベルに APAR 'IT46908'https://www.ibm.com/support/pages/apar/IT46908 が含まれていることを確認してください。 このAPARは'IBM MQ99.2.0.30、'IBM MQ99.3.0.25、およびそれ以降のリリースに含まれています。 そして、その場で後のバージョンにアップグレードする。 詳細については、 Linux の IBM MQ インストールのアップグレードを参照してください。
8. オプション: setmqinst コマンドを使用して、 IBM MQ コマンドを実行するための検索パスを指定しないように、プライマリー・インストールを設定します。

   INSTALLATION_PATH/bin/setmqinst -i -n installationName
   

   dspmqinst コマンドを使用して、 InstallationNameをディスカバーします。

   プライマリー・インストールがある場合、 /usr/libで IBM MQ ライブラリーを検出することを予期している AIX and Linux アプリケーションは、 /usr/lib/32 ¹ でライブラリーへのシンボリック・リンクを見つけます。 /usr/lib/32 は通常、デフォルトの検索パスにあります。 また、 AIX and Linuxの IBM MQ ビルド・スクリプトでロード・パスとしても指定されます。

   アプリケーションを /usr/lib のみにリンクするだけで十分です。 後のバージョンの製品がプライマリー・インストールとしてサーバー上に定義されていれば、アプリケーションは、そのサーバー上の任意のインストール済み環境に関連付けられている任意のキュー・マネージャーに接続できます。 IBM MQ は、アプリケーション用の正しいライブラリーをロードします。

9. オプション: setmqm コマンドを使用して、キュー・マネージャーをインストール済み環境に関連付けます。

    
   setmqm -m qmgrName -n installationName

10. strmqm コマンドを使用して、キュー・マネージャーを開始し、後のバージョンの製品にマイグレーションします。

    strmqm qmgrName

    マイグレーションの後に初めてキュー・マネージャーを開始するとき、以下のようになります。

    • 既存のオブジェクトの新しい属性は、それぞれのデフォルト値に設定されます。
    • 新しいデフォルトのオブジェクトが作成されます。
    • キュー・マネージャーのデータがマイグレーションされます。

    この時点でキュー・マネージャーのデータがマイグレーションされ、旧リリースには戻せなくなります。

    重要: デフォルトのシステム・オブジェクトを明示的にリセットまたは再作成する場合を除き、 -c オプションを使用してキュー・マネージャーを開始しないでください。

    リスナーを開始する前に、 IBM MQ を開始する必要があります。

11. アプリケーションを開始します。