2.8. ブローカーインスタンスの 7.8.x から 7.9.x へのアップグレード
以下のサブセクションでは、異なるオペレーティングシステムの 7.8.x ブローカーインスタンスを 7.9.x にアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。コンソールにリモートアクセスを設定する方法は、Configuring local and remote access to AMQ Management Console を参照してください。
2.8.1. Linux の 7.8.x から 7.9.x へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-brokerというユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.x.x-bin.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhatを使用しています。sudo mv amq-broker-7.x.x-bin.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツをデプロイメントします。以下の例では、ユーザー
amq-brokerはunzipコマンドを使用してアーカイブをデプロイメントします。su - amq-broker cd /opt/redhat unzip amq-broker-7.x.x-bin.zip
ブローカーが実行されている場合は停止します。
<broker_instance_dir>/bin/artemis stop現在のユーザーのホームディレクトリーにコピーして、ブローカーのインスタンスディレクトリーをバックアップします。
cp -r <broker_instance_dir> ~/(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
<broker_instance_dir>/log/artemis.logファイルの最後に以下のような行が表示されます。INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
<broker_instance_dir>/etc/artemis.profile設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーに
ARTEMIS_HOMEプロパティーを設定します。以下に例を示します。ARTEMIS_HOME='/opt/redhat/amq-broker-7.x.x-bin'
JAVA_ARGSプロパティーを探します。以下に示すように、ブートストラップクラスパスの引数が、ログマネージャーの依存するファイルに必要なバージョンを参照することを確認します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
<broker_instance_dir>/etc/bootstrap.xml設定ファイルを編集します。web要素で、7.9 の AMQ 管理コンソールに必要な.warファイルの名前を更新します。<web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web>アップグレードされたブローカーを起動します。
<broker_instance_dir>/bin/artemis run(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動したら、
<broker_instance_dir>/log/artemis.logファイルを開きます。以下のような 2 つの行を見つけます。ブローカーの稼働時にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Mes INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... sage Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
<broker_instance_dir>/etc/artemis.profileファイルで、ブローカーインスタンスの作成後のカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URIプロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/ディレクトリーおよびdata/ディレクトリーにのみ保存できました。
2.8.2. Windows の 7.8.x から 7.9.x へのアップグレード
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
- ファイルマネージャーを使用して、アーカイブを AMQ Broker の最後のインストール時に作成したフォルダーに移動します。
- アーカイブの内容をデプロイメントします。.zip ファイルを右クリックし、Extract All を選択します。
ブローカーが実行されている場合は停止します。
<broker_instance_dir>\bin\artemis-service.exe stopファイルマネージャーを使用してブローカーをバックアップします。
-
<broker_instance_dir>フォルダーを右クリックし、Copyを選択します。 - 同じウィンドウを右クリックし、Paste を選択します。
-
(オプション) ブローカーの現行バージョンをメモします。ブローカーが停止すると、
<broker_instance_dir>\log\artemis.logの末尾に以下のような行が表示されます。INFO [org.apache.activemq.artemis.core.server] AMQ221002: Apache ActiveMQ Artemis Message Broker version 2.13.0.redhat-00003 [4782d50d-47a2-11e7-a160-9801a793ea45] stopped, uptime 28 minutes
<broker_instance_dir>\etc\artemis.profile.cmdおよび<broker_instance_dir>\bin\artemis-service.xml設定ファイルを編集してください。アーカイブの抽出時に作成された新しいディレクトリーにARTEMIS_HOMEプロパティーを設定します。ARTEMIS_HOME=
<install_dir><broker_instance_dir>\etc\artemis.profile.cmd設定ファイルを編集します。以下に示すように、JAVA_ARGS環境変数が、ログマネージャーおよび依存するファイルの正しいバージョンを参照することを確認します。JAVA_ARGS=-Xbootclasspath/%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar
<broker_instance_dir>\bin\artemis-service.xml設定ファイルを編集します。以下に示すように、ブートストラップクラスパスの開始引数がログマネージャーおよび依存するファイルの正しいバージョンを参照することを確認します。<startargument>-Xbootclasspath/a:%ARTEMIS_HOME%\lib\jboss-logmanager-2.1.10.Final-redhat-00001.jar;%ARTEMIS_HOME%\lib\wildfly-common-1.5.2.Final-redhat-00002.jar</startargument>
<broker_instance_dir>\etc\bootstrap.xml設定ファイルを編集します。web要素で、7.9 の AMQ 管理コンソールに必要な.warファイルの名前を更新します。<web bind="http://localhost:8161" path="web"> ... <app url="console" war="hawtio.war"/> ... </web>アップグレードされたブローカーを起動します。
<broker_instance_dir>\bin\artemis-service.exe start(オプション) ブローカーが実行され、バージョンが変更されたことを確認します。ブローカーを起動した後、
<broker_instance_dir>\log\artemis.logファイルを開きます。以下のような 2 つの行を見つけます。ブローカーの稼働時にログに表示される新しいバージョン番号に注意してください。INFO [org.apache.activemq.artemis.core.server] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.18.0.redhat-00010 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、ブローカーインスタンスの作成を参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。In the
<broker_instance_dir>\etc\artemis.profileファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URIプロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内の\etcディレクトリーおよび\dataディレクトリーにのみ保存できました。
