Menu Close

Red Hat Training

A Red Hat training course is available for Red Hat JBoss Operations Network

7.6. エージェント RPM のアップグレード

エージェントパッケージを含む RPM は、管理対象プラットフォームにエージェントをインストールします。その後、最新のエージェント RPM を使用してそのエージェントをアップグレードできます。
エージェントが JBoss ON サーバーと同じシステムにインストールされている場合、そのエージェントはエージェント RPM または設定されたシステムツールを使用してアップグレードまたは管理 でき ます。このエージェントは、JBoss ON サーバーおよびその rhqctl ツールと連携するように変換する必要があります。

7.6.1. 管理システムでのエージェント RPM のアップグレード

重要
ここでは、JBoss ON によって管理されるプラットフォーム上のエージェントをアップグレードする方法について説明します。
このシステムが JBoss ON サーバーをホストする場合は、の説明に従って、サーバーインストールプロセスの一部としてエージェントを移行し 「JBoss ON Server マシンでのエージェントの移行」 ます。JBoss ON サーバーと同じマシン上のエージェントは、エージェント RPM からインストールまたは管理できます。rhqctl スクリプトを使用してインストールおよび管理する必要があります。
  1. JBoss ON リポジトリー yum が含まれるようにリポジトリーを設定します。例:
    [root@server ~]# subscription-manager repos --enable jb-eap-7-for-rhel-7-server-rpms
  2. を使用 yum して、パッケージをアップグレードします。
    [root@server ~]# yum upgrade jboss-on-agent-3.3
カスタマーポータルからパッケージをダウンロードして、rpm -U コマンドを使用してアップグレードすることもできます。
[root@server ~]# rpm -Uvh jboss-on-agent-3.3.2.GA.el6.noarch.rpm

7.6.2. JBoss ON Server マシンでのエージェントの移行

JBoss ON 3.1.x バージョンでは、同じシステム上にある場合でも、エージェントがインストールされた JBoss ON サーバーとは独立して管理されました。そのため、JBoss ON サーバーをホストするシステムの RPM からエージェントをインストールすることができ、管理プラットフォームも可能です。
しかし、JBoss ON 3.2 以降では、同じインストールパッケージと管理スクリプト(rhqctl)を使用して、JBoss ON サーバーと同じシステムにインストールされているエージェントがサーバーとともにインストールおよび管理されます。そのため、JBoss ON サーバーマシンのエージェントを RPM からインストールできません。
既存のエージェントのインストールでは、エージェントを新しい管理スクリプトおよび設定に移行する必要があります。
注記
この移行スクリプトは、経験のある管理者に便利です。サポートについては、Red Hat サポートサービスまでご連絡ください。
  1. 新しい JBoss ON 3.3 サーバーをインストールするか、サーバーを JBoss ON 3.3 にアップグレードします。
  2. エージェントのエージェント名、トークン、バインドアドレス、およびサーバーバインドアドレスを取得します。
    1. JBoss ON サーバー UI にログインします。
    2. トップメニューの Administration タブをクリックします。
    3. 左側の Topology ボックスで、Agents リンクをクリックします。
    4. 一覧で移行するエージェントの名前をクリックします。
    5. この Agent Details エリアには、必要な情報をすべて表示します。エージェントインスタンスを移行するには、このエージェント情報を agent-configuration.xml ファイルに処理する必要があります。
  3. 既存の agent-configuration.xml ファイルを新しいエージェントの場所にコピーし agentRoot/rhq-agent/conf/agent-configuration.xmlます。
  4. エージェントアイデンティティー情報の agent-configuration.xml プロパティーを更新します。例:
    <entry key="rhq.agent.name" value="agent-01" />
    <entry key="rhq.agent.security-token" value="abcd1234" />
    <entry key="rhq.agent.server.bind-address" value="server.example.com" />
    <entry key="rhq.communications.connector.bind-address" value="1.1.1.1" />
    UI フィールド名 設定ファイルプロパティー
    エージェント名 rhq.agent.name
    token rhq.agent.security-token
    address rhq.agent.server.bind-address
    現在のサーバー rhq.communications.connector.bind-address
  5. 古いエージェントプロセスを停止します。
    [jsmith@server ~]$ sudo service jon-agent stop
  6. このサンプルスクリプトをコピーして、古いエージェントのインストール場所、更新された設定ファイル、および agent-configuration-migrate.sh スクリプトに新しいサーバーを入力します。
    ###### agent-configuration-migrate.sh #########
    #!/bin/sh
    #
    #
    # Note: Assumes and installs agent into default location. Modify steps as
    necessary
    #       if this is not true.
    ######################################################################
    
    #Ex. OLDER_RPM_AGENT_INSTALL=/usr/share/jboss-on-3.3.0.GA/agent
    OLDER_RPM_AGENT_INSTALL=
    
    #Ex. AGENT_MIGRATION_CONFIG_LOCATION=/tmp/agent-migration.xml  For security
    consider using $(mktemp) if you automate this further.
    AGENT_MIGRATION_CONFIG_LOCATION=
    
    #Ex. NEWEST_SERVER_LOCATION=/opt/jon/jboss-on-3.3.1.GA . Note bin, etc,
    modules are immediate sub directories.
    NEWEST_SERVER_LOCATION=
    
    #Install newer native agent including older agent configuration details.
    #NOTE: new agent will be installed to default location. Modify the following
    line accordingly
    $NEWEST_SERVER_LOCATION/bin/rhqctl install --agent --agent-config
    $AGENT_MIGRATION_CONFIG_LOCATION
    
     # Echo next steps to complete migration.
     echo -e "\n If no errors, then migration of older agent configuration was
     successful."
     echo Ex. Additional environment variables added to old agent.
     echo -e "\t i) (if necessary) Merge $OLDER_RPM_AGENT_INSTALL/bin/*.sh with
     $NEWEST_SERVER_LOCATION/../rhq-agent/bin/*.sh."
     echo -e "\t ii)(if necessary) Manually and carefully merge old and new agent
     log settings."
     echo -e "\t iii)Continue JON server upgrade. Ex. \n '
     $NEWEST_SERVER_LOCATION/bin/rhqctl upgrade --from-server-dir (insert older
     jon server directory) --run-data-migrator'"
     echo    "iv)Start all desired components. Ex.'
     $NEWEST_SERVER_LOCATION/bin/rhqctl start'"
     echo    "v)Verify migration and remove intermediate migration
     scripts/files.'"
     echo "Done."
  7. 移行スクリプトを実行します。

7.6.3. RPM を使用したカスタム agent-configuration.xml および log4j.xml 設定のアップグレード

ユーザーが agent-configuration.xml または編集して log4j.xml いる場合は、RPM アップグレードプロセスはそのファイルを保持し、これらのファイルの最新バージョンを *.rpmnew として追加します。RPM アップグレードプロセスの詳細は、『 Red Hat Enterprise Linux システム管理ガイド』の RPM セクションを参照してください