1.3. ブローカーインスタンスの 7.0.x から 7.1.0 へのアップグレード
AMQ Broker 7.1.0 には、以前のバージョンに含まれていない設定ファイルおよび設定が含まれています。ブローカーインスタンスを 7.0.x から 7.1.0 にアップグレードするには、これらの新しいファイルおよび設定を既存の 7.0.x ブローカーインスタンスに追加する必要があります。以下のサブセクションでは、異なるオペレーティングシステムの 7.0.x ブローカーインスタンスを 7.1.0 にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。リモートアクセスを有効にするには、BROKER_INSTANCE_DIR/etc/jolokia-access.xml
の設定を変更する必要があります。詳細は、AMQ 管理コンソールと AMQ ブローカ接続の保護 を参照してください。
1.3.1. Linux での 7.0.x から 7.1.0 へのアップグレード
7.0.x ブローカーをアップグレードする前に、Red Hat AMQ Broker 7.1.0 をインストールし、一時的なブローカーインスタンスを作成する必要があります。これにより、7.0.x ブローカーのアップグレードに必要な 7.1.0 設定ファイルが生成されます。
前提条件
AMQ Broker をアップグレードする前に、ターゲットリリースのリリースノートを確認してください。
本リリースノートでは、ターゲットリリースにおける重要な機能拡張、既知の問題、および動作の変更を説明します。
詳細は、AMQ Broker 7.1 リリースノート を参照してください。
7.0.x ブローカーをアップグレードする前に、最初にバージョン 7.1 をインストールする必要があります。
Linux に 7.1 をインストールする手順は、Installing AMQ Broker を参照してください。
手順
実行中の場合は、アップグレードする 7.0.x ブローカーを停止します。
$ BROKER_INSTANCE_DIR/bin/artemis stop
現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r BROKER_INSTANCE_DIR ~/
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるartemis.profile
ファイルを開きます。ARTEMIS_HOME
プロパティーを更新し、その値が AMQ Broker 7.1.0 のインストールディレクトリーを参照するようにします。ARTEMIS_HOME="7.1.0_INSTALL_DIR"
更新した行の 1 つ下の行で、プロパティー
ARTEMIS_INSTANCE_URI
を追加して、7.0.x ブローカーインスタンスディレクトリーを参照する値を割り当てます。ARTEMIS_INSTANCE_URI="file://7.0.x_BROKER_INSTANCE_DIR"
JAVA_ARGS
プロパティーにjolokia.policyLocation
パラメーターを追加し、以下の値を割り当てて更新します。-Djolokia.policyLocation=${ARTEMIS_INSTANCE_URI}/etc/jolokia-access.xml
7.1.0 ブローカーインスタンスを作成します。作成手順では、7.0.x から 7.1.0 へのアップグレードに必要な設定ファイルが生成されます。以下の例では、インスタンスが
upgrade_tmp
ディレクトリーに作成されることに注意してください。$ 7.1.0_INSTALL_DIR/bin/artemis create --allow-anonymous --user admin --password admin upgrade_tmp
一時的な 7.1.0 インスタンスの
etc
ディレクトリーから、7.0.x ブローカーのBROKER_INSTANCE_DIR/etc/
ディレクトリーに設定ファイルをコピーします。management.xml
ファイルをコピーします。$ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/management.xml 7.0_BROKER_INSTANCE_DIR/etc/
jolokia-access.xml
ファイルをコピーします。$ cp TEMPORARY_7.1.0_BROKER_INSTANCE_DIR/etc/jolokia-access.xml 7.0_BROKER_INSTANCE_DIR/etc/
7.0.x ブローカーの
BROKER_INSTANCE_DIR/etc/
ディレクトリーにあるbootstrap.xml
ファイルを開きます。以下の 2 つの行をコメントアウトまたは削除します。
<app url="jolokia" war="jolokia.war"/> <app url="hawtio" war="hawtio-no-slf4j.war"/>
以下の行を追加して、直前の手順で削除された 2 つの行を置き換えます。
<app url="console" war="console.war"/>
アップグレードしたブローカーを起動します。
$ BROKER_INSTANCE_DIR/bin/artemis run
関連情報
ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。