1.9. 長期サポートバージョン間のブローカーインスタンスのアップグレード
以下のサブセクションでは、ブローカーインスタンスを 7.4 Long Term Support(LTS)リリースストリームから異なるオペレーティングシステムの 7.8 LTS リリースストリームにアップグレードする方法を説明します。
AMQ Broker 7.1.0 以降では、デフォルトでローカルホストからのみ AMQ 管理コンソールにアクセスできます。コンソールにリモートアクセスを設定する方法は、「 Configuring local and remote access to AMQ Management Console 」を参照してください。
1.9.1. Linux の 7.4.x から 7.8.x へのアップグレード
ダウンロードするアーカイブの名前は、以下の例で使用されているものとは異なる場合があります。
手順
- Red Hat カスタマーポータルから必要なアーカイブをダウンロードします。AMQ Broker アーカイブのダウンロード に記載されている手順に従います。
アーカイブの所有者を、AMQ Broker インストールが含まれるのと同じユーザーに変更します。以下の例では、
amq-broker
というユーザーを設定しています。sudo chown amq-broker:amq-broker amq-broker-7.8.x.redhat-1.zip
AMQ Broker の元のインストール時に作成されたディレクトリーにアーカイブを移動します。以下の例では、
/opt/redhat
を使用しています。sudo mv amq-broker-7.8.x.redhat-1.zip /opt/redhat
ディレクトリーの所有者は、圧縮アーカイブのコンテンツを展開します。以下の例では、ユーザー
amq-broker
はunzip
コマンドを使用してアーカイブを展開します。su - amq-broker cd /opt/redhat unzip amq-broker-7.8.x.redhat-1.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.9.0.redhat-00001 [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.8.x-redhat-1'
JAVA_ARGS
プロパティを探します。以下に示すように、ブートストラップクラスパスの引数が、ログマネージャーの依存するファイルに必要なバージョンを参照することを確認します。-Xbootclasspath/a:$ARTEMIS_HOME/lib/wildfly-common-1.5.2.Final-redhat-00002.jar
BROKER_INSTANCE_DIR/etc/logging.properties
設定ファイルを編集します。設定する追加のロガーのリストに、AMQ Broker 7.7.0 で追加された
org.apache.activemq.audit.resource
リソースロガーを含めます。loggers=org.eclipse.jetty,org.jboss.logging,org.apache.activemq.artemis.core.server,org.apache.activemq.artemis.utils,org.apache.activemq.artemis.journal,org.apache.activemq.artemis.jms.server,org.apache.activemq.artemis.integration.bootstrap,org.apache.activemq.audit.base,org.apache.activemq.audit.message,org.apache.activemq.audit.resource
Console ハンドラー設定 セクションの前に、リソースロガーのデフォルト設定を追加します。
.. logger.org.apache.activemq.audit.resource.level=ERROR logger.org.apache.activemq.audit.resource.handlers=AUDIT_FILE logger.org.apache.activemq.audit.resource.useParentHandlers=false # Console handler configuration ..
BROKER_INSTANCE_DIR/etc/bootstrap.xml
設定ファイルを編集します。web
要素で、7.8 の 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] AMQ221007: Server is now live ... INFO [org.apache.activemq.artemis.core.server] AMQ221001: Apache ActiveMQ Artemis Message Broker version 2.16.0.redhat-00012 [0.0.0.0, nodeID=554cce00-63d9-11e8-9808-54ee759954c4]
関連情報
- ブローカーのインスタンス作成に関する詳細は、「ブローカーインスタンスの作成」を 参照してください。
-
ブローカーインスタンスの設定ファイルおよびデータを、ブローカーインスタンスのディレクトリー外の場所を含む、カスタムディレクトリーに格納できるようになりました。
BROKER_INSTANCE_DIR/etc/artemis.profile
ファイルで、ブローカーインスタンスの作成後にカスタムディレクトリーの場所を指定し、ARTEMIS_INSTANCE_ETC_URI
プロパティーを更新します。以前のバージョンでは、これらの設定ファイルとデータは、ブローカーインスタンスのディレクトリー内のetc/
ディレクトリーおよびdata/
ディレクトリーにのみ保存できました。