Menu Close

Red Hat Training

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

4.3. 3.1.x サーバーおよびサーバープラグインのアップグレード

JBoss ON 3.1.2 以降は JBoss ON 3.3 にアップグレードできます。以前の JBoss ON 3.1 サーバーは、最初に 3.1.2 にアップグレードし、JBoss ON 3.3 にアップグレードできます。
このアップグレード手順のすべてのステップが、Red Hat JBoss Operations Network インストールに適用されるわけではありません。ステップを順番に実行し、デプロイメントに必要な手順を実施します。
警告
アップグレード後に JBoss ON サーバーを以前のバージョンに戻すことはできません。アップグレードする前に、すべてのデータをバックアップします。
注記
移行プロセスが速くなるには、複数のストレージノードをデプロイしてからサーバーをアップグレードします。これは、で説明してい 「サーバーのインストール前のストレージノードのインストール」 ます。
  1. 3.1 以前のバージョンでは、JBoss ON 3.1.2 または最新のリリースにアップグレードしてください。
  2. サーバー マシンで実行している JBoss ON エージェントを停止します。エージェントがサービスとして実行している場合は、システムサービスを停止します。コマンドプロンプトで停止することもできます。
    [jsmith@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh
    > exit
  3. Windows のみ。RHQ_AGENT_RUN_AS または RHQ_AGENT_RUN_AS_ME パラメーターがエージェントの rhq-agent-env.bat ファイルに設定されている場合は、パスワードが必要で、パスワードプロンプトを無効にする必要があります。
    RHQ_AGENT_PASSWORD=secret
    RHQ_AGENT_PASSWORD_PROMPT=false
    注記
    RHQ_AGENT_RUN_AS* パラメーターのいずれかがパスワードなしで設定されている場合、エージェントのアップグレードプロセスはハングします。
    RHQ_AGENT_RUN_AS* パラメーターはアップグレード前に削除できます。
  4. JBoss ON の設定をクリーンアップします。移行の前に設定を簡単にクリーンアップすることは、移行後よりも簡単です。
    • インベントリーから未使用またはサービスプラットフォーム外を削除します。
    • 古い JBoss ON サーバーが JBoss ON インベントリーに追加されている場合は、削除します。
      古い JBoss ON サーバーは使用可能なリソースではないため、インベントリーから削除する必要があります。
  5. すべてのサーバーを停止します。例:
    [jsmith@server ~]$ serverRoot/jon-server-3.1.2.GA/rhq-server.sh stop
    重要
    アップグレードされた JBoss ON サーバーが既存の JBoss ON インスタンスも使用しているデータベースを使用する場合は、既存の JBoss ON インスタンスをすべて停止する必要があります。それ以外の場合は、データベースへの接続を試みるとインストーラーがハングし、別の JBoss ON サーバーが使用中であるためデータベースが利用できない状態になります。
  6. Windows のみ。サーバーがサービスとして実行している場合は、そのサービスをアンインストールします。
    C:> cd C:\jon\jon-server-3.1.2\bin
    C:\jon\jon-server-3.1.2\bin> ./rhq-server.bat remove
  7. アップグレードスクリプトの手順を行う前に、サーバーデータベースをバックアップします。
    アップグレードプロセスに問題がある場合には、バックアップで以前の状態に復元できます。
  8. rhq-server.sh または rhq-server-wrapper.conf ファイルをカスタマイズした場合は、これらのファイルをバックアップします。これらのファイルに加えられた変更は、アップグレードスクリプトの実行後に手動で再適用する必要があります。
  9. サーバーパッケージの展開
    [jsmith@server ~]$ unzip jon-server-3.3.2.GA.zip -d serverRoot/jon-server-3.3.2.GA
    重要
    以前のサーバーインストールには、新しいサーバーインストールはコピーしないでください。
    アップグレード中に使用されている既存の JBoss ON インストールディレクトリーは削除しないでください。古い rhq-server.properties ファイルを新しい rhq-server.properties ファイルに rhqctl upgrade マージします。
    server パッケージ内のディレクトリー構造により、新しいサーバーインストールディレクトリーにのようなバージョン固有の名前を指定し /opt/jon/jon-server-3.3.2.GAます。
  10. upgrade コマンドを実行します。
    upgrade コマンドで使用できる重要なオプションは 3 つあります。
    • 元のサーバーのインストールディレクトリーを特定 --from-server-dirするオプションの 1 つは常に必須です。
    • ローカルエージェントがある場合 --from-agent-dir は、も必要です。エージェントがない場合、ストレージノードのインストール時にインストールされます。デフォルトでは 3.3 では、これはサーバーのインストールディレクトリーと同じ親ディレクトリーにインストールされます(例: /opt/jon)。
    • 新しいストレージノードのホスト先を決定します。この upgrade コマンドにより、デフォルトで新しいローカルストレージノードが作成されます。ストレージノードは最初に作成することができます。ストレージノード設定はプロパティーファイルに追加され、--use-remote-storage-node オプションで通知されます。
    たとえば、これによりローカルサーバーおよびエージェントのアップグレードが実行され、新しいローカルストレージノードが作成されます。
    [jsmith@server ~]$ ./serverRoot/jon-server-3.3.2.GA/bin/rhqctl upgrade --from-server-dir /opt/rhq/rhq-server-old --from-agent-dir /home/rhq/rhq-agent-old
    リモートストレージノードを使用するには、以下を実行します。
    1. 別のシステムで、にあるように新しいストレージノードを作成し 「サーバーのインストール前のストレージノードのインストール」 ます。
    2. 新規 rhq-server.properties ファイルを編集して、新しいストレージノードを参照します。
      rhq.storage.cql-port=9142
      rhq.storage.gossip-port=7100
      rhq.storage.seeds=192.168.0.1, 192.168.0.2, 192.168.0.3
      start=false
    3. --use-remote-storage-node オプションを指定してアップグレードスクリプトを実行します。
      [jsmith@server ~]$ ./serverRoot/jon-server-3.3.2.GA/bin/rhqctl upgrade --from-server-dir /opt/rhq/rhq-server-old --from-agent-dir /home/rhq/rhq-agent-old --use-remote-storage-node
  11. JBoss ON 3.3 にアップグレードしたら、ストレージノードのデフォルトを変更するには、を作成し serverRoot/jon-server-3.3.2.GA/bin/rhq-storage.propertiesます。このファイルは、--storage-config オプションの設定に使用できます。これには、データストレージ、ホスト、ポート情報のディレクトリー、およびその他のオプションが含まれます。
  12. ストレージクラスタースキーマをアップグレードします。
    1. すべてのストレージノードを起動します。サーバーまたはエージェントは起動しないでください。
      [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl start --storage
    2. JBoss ON サーバーシステムで、--storage-schema オプションを 指定して upgrade コマンドを再実行します。このコマンドは、ストレージスキーマの変更をストレージクラスターに伝播するには一度だけ実行する必要があります。
      [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl upgrade --storage-schema
  13. 重要。過去のモニタリングデータを移行します。
    既存の監視データをすべて移行するために使用できるコマンドラインスクリプトがあります。ほとんどの場合、これはサーバーが移行されるのと同時に実行する必要があります。
    注記
    大規模なデータベースでは、監視データを移行するのに数時間かかる可能性が あり、プロセスが中断しない ようにしてください。使用が長くなると、移行の実行を検討してください。
    データマイグレーターツールは、計画を支援する移行にかかる時間予測を提供できます。
    データマイグレーターツールが実行されていない場合、古いサーバーからのすべての測定データが利用できなくなりました。また、サーバーがアップグレードされてデータ移行が実行されると、サーバーのアップグレードとデータ移行の間に収集される新しい監視データが失われます。
    [jsmith@server ~]$ ./rhq-data-migration.sh
  14. rhq-server.properties ファイルを確認して、編集が適切にマージされたことを確認します。このマージプロセスではすべての値を適切に移行する必要がありますが、アップグレードの完了後に古いプロパティーファイルが新しいプロパティーファイルに適切にコピーされたことを確認することが推奨されます。
  15. rhq-server.sh または rhq-server-wrapper.conf ファイルをカスタマイズした場合は、変更を再適用します。
  16. オプション。特定のニーズに対応する追加のプラグインパック(他のレイヤード Red Hat JBoss Middleware 製品に対する管理タスクなど)は、コア JBoss ON パッケージとは別のインストールに利用できます。
    各プラグインパックには少なくとも 1 つ(複数の)エージェントプラグインがあります。プラグインの各 zip ファイルには、特定の設定手順が含まれる README.txt ファイルがあります。
    注記
    高可用性セットアップに複数の JBoss ON サーバーがある場合、エージェントプラグインパックは一度だけインストールする必要があります。他のサーバーは、高可用性ポーリングの一部としてプラグインを選択します。
    プラグインファイルは、どこでも展開できます。例:
    [jsmith@server ~]$ unzip jon-plugin-pack-agent_plugin_name-3.3.2.GA.zip -d /opt/jon/jon-server-3.3.2.GA
  17. サーバー、エージェント、およびストレージノードを起動します。
    [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl start
  18. オプション。新しい JBoss ON サーバーをインベントリーのリソースとして追加します。