UNIX および Linuxでのマイグレーション: 段階的

段階的マイグレーションとは、同じサーバー上で新しいバージョンの IBM® MQ を前のバージョンと一緒に実行することを表す用語です。前のバージョンと共存する形で新しいバージョンをインストールした後、新しいキュー・マネージャーを作成して新しいバージョンのインストール環境を検証し、新しいアプリケーションを開発できます。それと同時に、キュー・マネージャーとそれに関連付けられたアプリケーションを前のバージョンから後のバージョンにマイグレーションできます。キュー・マネージャーとアプリケーションを 1 つずつマイグレーションすることにより、マイグレーションを管理するスタッフのピーク作業負荷を軽減することができます。

始める前に

重要: IBM MQ 9.0以降、ccsid_part2.tblファイルは既存のccsid.tbl追加の CCSID 情報を提供するために, プロダクトの前のバージョンで使用されるファイル。

ccsid_part2.tbl ファイルは ccsid.tbl ファイルより優先され、次の意味を持ちます:

CCSID 項目の追加や変更が可能になります
デフォルトのデータ変換を指定します
さまざまなコマンド・レベルのデータを指定します

ccsid_part2.tbl は、以下のプラットフォームにのみ適用されます。

Linux® -すべてのバージョン
Solaris
Windows

独自の CCSID 情報を既存の ccsid.tbl ファイルに追加した場合、カスタマイズする際に新しいフォーマットを利用するには、この情報を新しい ccsid_part2.tbl ファイルにコピーする必要があります。

既存のバージョンの IBM MQ が引き続き機能するように、情報を移動するのではなく、必要な情報をコピーする必要があります。

注:

アプリケーションが COM または ActiveX を使用する場合、プライマリー・インストールが存在する限り、どのキュー・マネージャーにも接続できます。
トランザクション・モードで IBM MQ.NET モニターを実行している場合は、接続先のキュー・マネージャーがプライマリー・インストールである必要があります。

前のバージョンをアンインストールするまでは、これらのアプリケーションを後のバージョンにマイグレーションすることはできません。

本タスクについて

段階的マイグレーション・シナリオでは、後のバージョンの製品を、前のバージョンに関連付けられたまま実行中のキュー・マネージャーと共存するようにインストールします。後のバージョンのインストール済み環境を使用して、キュー・マネージャーを作成し、新規アプリケーションを実行できます。前のバージョンのキュー・マネージャーとアプリケーションのマイグレーションを始める準備ができたら、マイグレーションを 1 つずつ行えます。後のバージョンへのマイグレーションが完了したら、前のバージョンをアンインストールし、後のバージョンのインストール済み環境をプライマリー・インストールにします。

段階的手法では、前のバージョンをアンインストールするまでに、後のバージョンのキュー・マネージャーに接続するアプリケーションを実行するように環境を構成する必要があります。 IBM MQ コマンドを実行するためのパスも指定する必要があります。これらのタスクは両方とも、setmqenv コマンドを使用して実行します。

注: 前のバージョンをアンインストールし、後のバージョンをプライマリー・インストールとして設定した場合、ほとんどの状況では、アプリケーションを実行するために setmqenv コマンドを実行する必要はありません。プライマリーではないインストール済み環境に関連付けられたキュー・マネージャーに接続するコマンドの場合は、引き続き setmqenv を実行して環境を設定する必要があります。

手順

前のバージョンとは異なるインストール・ディレクトリーに後のバージョンをインストールし、そのインストール済み環境を検査します。
1. インストールの命名規則を決定します。インストール先に任意の名前を指定するか、デフォルトのインストール名を受け入れます。
  最初のインストールの場合、デフォルト名は Installation1 になります。以後、2 番目のインストールの名前は Installation2 のように、番号が 1 つずつ増えていきます。
  AIX® の場合、インストール名を設定するオプションはありません。デフォルトでは、 Installation1 が設定されています。
2. インストールを検査します。
  
  インストール検査手順および独自のテストを実行します。
- アプリケーションを前のバージョンからマイグレーションする前に、後のバージョンを実行する新しいキュー・マネージャーを作成し、新規アプリケーションの開発を開始することもできます。
後のバージョンの製品のライブラリーをアプリケーションがロードするようにオペレーティング・システムを構成します。
1. キュー・マネージャーを 1 つずつマイグレーションします。
  
  後のバージョンの製品のライブラリーをロードする最初のアプリケーション・セットは、マイグレーションする第 1 のキュー・マネージャーに接続するアプリケーションです。
  
  これらのアプリケーションが、サーバー上の他のキュー・マネージャーにも接続するかどうかは関係ありません。アプリケーションが後のバージョンのライブラリーをロードする場合、 IBM MQ は、そのバージョンに接続するアプリケーションの前のバージョンのライブラリーを自動的にロードします。
  
  すべてのアプリケーションのオペレーティング・システム環境をマイグレーションすることも、または最初にマイグレーションするキュー・マネージャーに接続するアプリケーションのみをマイグレーションすることもできます。
2. IBM MQ MQI client アプリケーションのマイグレーション
  
  一部のアプリケーションは、別のワークステーションで IBM MQ MQI client アプリケーションとして実行されている可能性があります。キュー・マネージャーをマイグレーションしても、そのキュー・マネージャーに接続されたクライアントは、後のバージョンのクライアント・ライブラリーをロードすることなく稼働し続けます。
  
  これらのクライアントは、後で必要に応じてマイグレーションできます。
  重要: サーバー上で前のバージョンのライブラリーを使用している IBM MQ MQI client アプリケーションがある場合は、前のバージョンをアンインストールする前に、後のバージョンの製品を使用するように最終的にクライアントをマイグレーションする必要があります。
次のようにして、後のバージョン用の新しいライブラリーをロードするようアプリケーションをマイグレーションします。
- setmqenv を実行して、 IBM MQ ライブラリーを検索するローカル・パスを変更します。
- IBM MQ ライブラリーを検索するグローバル検索パスを変更します。
- アプリケーションを追加ランタイム・ロード・パスに再リンクします。
- オペレーティング・システムの資料でグローバル・サーチ・パスを変更する方法を調べるか、アプリケーション・ロード・モジュールに所定のランタイム・ロード・パスを組み込みます。
-s オプションを使用して setmqenv を実行するには、以下のようにします。
```
.Inst_1_INSTALLATION_PATH/bin/setmqenv -s -k
```
-s オプションは、setmqenv コマンドを実行するインストール済み環境をセットアップします。

-k オプションは、 LD_LIBRARY_PATH 環境変数の先頭に IBM MQ ロード・ライブラリーへのパスを挿入し、その変数をローカル環境に追加します。 IBM MQ ライブラリーのロードを参照してください。

注: UNIX では、先頭の . がクリティカルです。ドットとその後に続くスペースは、コマンド・シェルに同じコマンド・シェルで setmqenv を実行し、setmqenv で設定された環境を継承するように指示します。
キュー・マネージャーとそれに接続されたアプリケーションを再始動します。
1. ローカル環境をインストール済み環境にセットアップします Inst_1。
```
.Inst_1_INSTALLATION_PATH/bin/setmqenv -s
```
  -s オプションは、setmqenv コマンドを実行するインストール済み環境をセットアップします。
2. setmqm コマンドを実行して、 QM1 を Inst_1に関連付けます。
```
setmqm -m QM1 -n Inst_1
setmqm -m QM2 -n Inst_1
```
3. strmqm コマンドを実行して QM1 を開始し、新しいバージョンにマイグレーションします。
```
strmqm QM1
strmqm QM2
```
4. アプリケーションの再始動 1
  - アプリケーションが最新バージョンのライブラリーをロードし、後のバージョンの製品に関連付けられた QM1 に接続します。
すべてのキュー・マネージャーとアプリケーションを後のバージョンにマイグレーションします。
- 必要に応じて、すべてのキュー・マネージャーおよびアプリケーションが新しいバージョンの製品にマイグレーションされるまで、ステップ 2 および 4を繰り返します。
前のバージョンの製品をアンインストールします。
- 以前の製品をアンインストールする場合は、サーバーに IBM MQ ライブラリーをロードしたすべてのキュー・マネージャーとアプリケーションを停止する必要があります。そのため、前のバージョンの製品のアンインストールは、都合の良い保守時間帯になるまで延期することもできます。前のバージョンの製品がサーバーにインストールされていない場合は、アンインストールまたは更新するインストール済み環境からライブラリーをロードしたキュー・マネージャーとアプリケーションを停止するだけで十分です。他のインストール済み環境に関連付けられているアプリケーションおよびキュー・マネージャーを停止する必要はありません。
1. サーバーに IBM MQ ライブラリーをロードしたすべてのアプリケーションを停止します。
2. サーバー上のキュー・マネージャーおよびリスナーを停止します。
3. 前のバージョンの製品をアンインストールします。
  すべてのローカル IBM MQ アプリケーションの停止
Inst_1 をプライマリー・インストールにします。
1. setmqinst コマンドを実行します。
```
Inst_1_INSTALLATION_PATH/bin/setmqinst -i -n Inst_1
```
- プライマリー・インストールから IBM MQ コマンドを実行するために検索パスをセットアップする必要はありません。
- 後のバージョンの製品のインストール済み環境を UNIX and Linux上でプライマリーとして設定する場合、ほとんどの場合、 LD_LIBRARY_PATH をセットアップする必要はありません。 setmqenv の呼び出しを削除して、 LD_LIBRARY_PATHを設定できます。

次のタスク

最新バージョンまたはその他のバージョンの IBM MQ がインストールされているシステムに、旧バージョンの製品を再インストールすることはできません。

前のバージョンの製品をアンインストールし、後のインストール済み環境をプライマリーにしたので、アプリケーション・ランタイム環境の設定方法を検討することができます。後のバージョンのライブラリーをロードするために setmqenv を実行して検索パスをセットアップする必要がなくなりました。後のバージョンの製品のインストール済み環境が 1 つだけ存在する場合は、コマンドを実行するために setmqenv を実行する必要はありません。