Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

インストールガイド

Red Hat JBoss Operations Network 3.3

すべてのサーバーおよびエージェントのインストール手順とガイドライン

Jared イタリア

zach Rhoads

ella Deon Baard

イタリア イタリア

概要

本ガイドでは、JBoss ON 3.3 サーバーおよびエージェントのインストールおよび設定、インベントリーを設定する基本的なタスクについて説明します。

第1章 JBoss ON について
リンクのコピー

Red Hat JBoss Operations Network 3.3 は、JBoss ミドルウェア、他のネットワークインフラストラクチャー、Red Hat Enterprise Application Platform(EAP)上に構築されたアプリケーションを管理するための統合ソリューションを提供します。
本ガイドでは、JBoss ON サーバーおよびエージェントをインストールし、既存の JBoss ON システムをアップグレードする計画および手順について説明します。この 『インストールガイド』 は、JBoss ON の管理者を対象としています。
バグを報告します。

1.1. Red Hat JBoss Operations Network Overview
リンクのコピー

Red Hat JBoss Operations Network には、共に機能して管理プラットフォームを作成する 4 つの主要なコンポーネントがあります。
  • 設定を一元化し、コンポーネントに接続する JBoss ON サーバー
  • コンテンツパッケージ、リソースインベントリー、およびモニタリングデータを含む、JBoss ON の設定設定およびリソース関連のデータを格納する SQL データベース（PostgreSQL または Oracle）
  • 管理プラットフォームにインストールされているローカルエージェント。サーバーに接続してリソース設定の更新を受信し、監視データの収集および送信を行います。
  • 任意の場所から JBoss ON サーバーに接続し、リソースデータの表示と管理タスクの実行を可能にする Web ベースのインターフェースである JBoss ON GUI
バグを報告します。

第2章 データベースの設定
リンクのコピー

2.1. PostgreSQL の設定
リンクのコピー

PostgreSQL で Red Hat JBoss Operations Network を実行するには、以下の 3 つの項目が必要です。
  • メモリー、タイムアウト、接続、および関連する設定に適した PostgreSQL 設定
  • データベース
  • 適切なパーミッションを持つユーザー
JBoss ON は PostgreSQL 8.4.x、9.0.x、9.1.x、9.2.x、9.3.x*、9.4.x*、9.5.x* をサポートします。
* JBoss ON 3.3 Update 06 によって追加されたサポート。

2.1.1. PostgreSQL のインストール
リンクのコピー

必要な Microsoft Windows バイナリーは https://www.postgresql.org/download/windows/ からダウンロードできます 。
PostgreSQL のインストール YUM に使用 - 特定のバージョンの PostgreSQL 
sudo yum install postgresql postgresql-server
をインストールするには、https://yum.postgresql.org/rpmchart.php にアクセス し、postgresql, postgresql-server and postgresql-libs RPM パッケージをダウンロードし、ダウンロードディレクトリー yum からインストールします。例： 
sudo yum install
postgresql91-9.1.24-2PGDG.rhel6.x86_64.rpm
postgresql91-libs-9.1.24-2PGDG.rhel6.x86_64.rpm
postgresql91-server-9.1.24-2PGDG.rhel6.x86_64.rpm
バグを報告します。

2.1.2. PostgreSQL の設定
リンクのコピー

重要
以下の設定は、JBoss ON テスト環境に対して迅速にこのサーバーを設定する例になります。これらの手順で推奨される値は実稼働環境では使用されません。この手順は、実稼働サーバーの設定でサポートされる方法としては使用されません。本番環境を設定する際には、必ずデータベースプロバイダーの設定手順に注意して従ってください。
PostgreSQL ユーザーおよびデータベースのクライアント認証の設定に関する詳細は、http://www.postgresql.org/docs/8.4/interactive/client-authentication.html で対応しているバージョンの PostgreSQL ドキュメントを参照して ください。
注記
Postgres 認証メカニズムが正しく設定され、設定コマンドが機能するように適切に設定されていることを確認します。
  1. オプション。PostgreSQL の Unix ユーザーのパスワードを変更します。 
    sudo passwd postgres
  2. PostgreSQL データベースを初期化します。サーバーを起動する前にデータベースを初期化する必要があります。
    • Red Hat Enterprise Linux 6（およびそれ以前の）リポジトリーを使用してインストールする場合は、以下を行います。 
      sudo service postgresql initdb
    • Red Hat Enterprise Linux 6（およびそれ以前のバージョン）にダウンロードしたバイナリーを使用してインストールする場合： 
      sudo service postgresql-<version> initdb
      ここで、<version> = <major>.<minor>
      例： 
      sudo service postgresql-9.2 initdb
    • Red Hat Enterprise Linux 7（以降）リポジトリーを使用してインストールする場合： 
      sudo /usr/bin/postgresql-setup initdb
    • Red Hat Enterprise Linux 7（以降）でダウンロードしたバイナリーを使用してインストールする場合： 
      sudo /usr/pgsql-<version>bin/postgresql<version_short>-setup initdb
      ここで、<version_short> = <major><minor>
      例： 
      sudo /usr/pgsql-9.2/bin/postgresql92-setup initdb
  3. PostgreSQL サービスを起動します。
    • リポジトリーインストールを使用して、Red Hat Enterprise Linux 6（およびそれ以前）で以下を行います。 
      sudo service postgresql start
sudo chkconfig postgresql on
    • ダウンロードしたバイナリーを使用した Red Hat Enterprise Linux 6（およびそれ以前）では、以下を行います。 
      sudo service postgresql-<version> start
sudo chkconfig postgresql-<version> on
    • リポジトリーインストールを使用した Red Hat Enterprise Linux 7（以降）では、以下を行います。 
      sudo systemctl enable postgresql.service
sudo systemctl start postgresql.service
    • ダウンロードしたバイナリーを使用した Red Hat Enterprise Linux 7（以降）では、以下を行います。 
      sudo systemctl enable postgresql-<version>.service
sudo systemctl start postgresql-<version>.service
    • Microsoft Windows の場合： 
      net start pgsql-<version>
  4. データベース上で postgres ユーザーのパスワードを設定します。 
    # su - postgres
$ psql
postgres=# ALTER USER postgres PASSWORD 'password';
ALTER ROLE
  5. という名前の PostgreSQL ロールを作成します。ここで rhqadmin、'password' は強固なパスワードに置き換えます。 
    postgres=# CREATE USER rhqadmin PASSWORD 'password';
CREATE ROLE
    重要
    で想定されるデフォルトの postgresql 認証情報 rhqctl はユーザー rhqadmin およびパスワードですが rhqadmin、これらの認証情報はセキュリティーリスクを招くため使用しないでください。に関連する変更 rhqctl については、を参照してください 「rhqctl スクリプトについて」。
  6. rhqadmin ロールを所有者として指定して rhq、という名前の PostgreSQL データベースを作成します。 
    postgres=# CREATE DATABASE rhq OWNER rhqadmin;
CREATE DATABASE
  7. 以下のコマンドを使用して、以下を特定し pg_hba.conf fileます。 
    postgres=# SHOW hba_file;
  8. 終了 \q するには、を使用し psqlます。
  9. ユーザーに、コンピューターにデータベースへのアクセス権限を付与します。すべてのユーザーを許可するには、ローカル接続と外部接続の両方で、各接続種別（ローカル、IPv4、および IPv6）の適切な接続設定を設定 data/pg_hba.conf ファイルに追加します。 
    # TYPE DATABASE     USER       ADDRESS            METHOD

# "local" is for Unix domain socket connections only
local   all         all                               md5
# IPv4 local connections:
host    all         all         127.0.0.1/32          md5
host    all         all         172.31.7.0/24         md5
# IPv6 local connections:
host    all         all         ::1/128               md5
    この all all 設定を使用して、全ユーザーに対してすべての PostgreSQL データベースを設定します。この設定は、などの JBoss ON の特定のユーザーに対して、rhq all または使用して JBoss ON データベースにのみ適用でき rhq rhqadminます。プレーンテキストとして送信されず、パスワードが暗号化される md5 ように METHOD 値を変更する。
  10. データベースサービスを再起動します。
    • Red Hat Enterprise Linux 6（およびそれ以前のバージョン）では、以下のようになります。 
      sudo service postgresql restart
    • Red Hat Enterprise Linux 7（以降）では、以下のようになります。 
      sudo systemctl restart postgresql
    • ダウンロードしたバイナリーを使用した Red Hat Enterprise Linux 7（以降）では、以下を行います。 
      sudo systemctl restart postgresql-<version>
  11. で設定を変更し 「PostgreSQL パラメーターの設定」 ます。
バグを報告します。

2.1.3. PostgreSQL パラメーターの設定
リンクのコピー

PostgreSQL サーバー設定には、JBoss ON のパフォーマンスを向上させるように調整できる複数の設定があります。
バグを報告します。
2.1.3.1. postgresql.conf ファイルの編集
リンクのコピー
PostgreSQL では、postgresql.conf ファイルのデータベース設定にマイナーな変更が必要です。
  1. JBoss ON データベースに対応するために、十分な量のメモリーおよびシステムリソースが割り当てられていることを確認します。 
    ## not necessary  if the database is started with the -i flag
listen_addresses = '*'

## performance changes for JBoss ON
shared_buffers = 80MB   #  default is 32MB
work_mem = 2048   #  default is 1MB
checkpoint_segments = 10 #  default is 3
    注記
    パラメーター statement_timeout は設定しないでください。statement_timeout パラメーターが postgressql.conf 含まれる場合、JBoss ON データベースユーザーに上書きされる必要があります。 
    ALTER USER rhqadmin SET statement_timeout=0;
バグを報告します。
2.1.3.2. カーネルパラメーターの設定
リンクのコピー
システムのカーネルパラメーターを調整することを検討してください。カーネルリソースの管理 に関する詳細は、PostgreSQL ドキュメントを参照してください。
バグを報告します。
2.1.3.3. pg_hba.conf の編集
リンクのコピー
pg_hba.conf ファイルを更新して、新たに作成されたロールが JBoss ON サーバーがインストールされているマシンから接続できるようにします（例： localhost）。クライアント接続の追加については、クライアント 認証セクションの PostgreSQL ドキュメントを参照 してください。
pg_hba.conf ファイルを編集したら、PostgreSQL を再起動して変更を有効にします。エラーが表示されない場合、データベースは JBoss ON インストールをサポートする準備が整いました。
Postgres のチューニングに関する詳細は、PostgreSQL サーバーの Tuning your PostgreSQL ドキュメントを参照してください。
バグを報告します。
2.1.3.4. "Relation RHQ_Principal does not exist" Error の修正
リンクのコピー
データベース接続が有効とマークされているものの、Relation RHQ_Principal でインストールが失敗することがあり ます。これは、PostgreSQL インスタンスを介してロケール initdb で実行して新しいデータベースが作成され non-C たときに発生します。
このエラーを修正するには、以下を実行します。
  1. データベースを使用して、JBoss ON に使用されるデータベース RHQ_PRINCIPAL で呼び出された空のテーブルを作成します。
  2. をクリックし Install serverます。
    インストーラーは既存のスキーマに関する警告を表示します。既存のスキーマは空のテーブルのみで構成されるため上書きします。
もう 1 つのオプションとして作成されたデータベースのエンコーディングを指定することもでき SQL-ASCII ます。例： 
initdb -D /my/test/data -E SQL_ASCII --locale en_US.UTF-8
バグを報告します。

2.2. Oracle の設定
リンクのコピー

Oracle で JBoss ON を実行するには、以下の 2 つの項目のみが必要です。
  • データベース
  • 適切なパーミッションを持つユーザー
基本設定は、データベースとユーザーの設定プロセスに従います。また、大規模な JBoss ON デプロイメントのパフォーマンスを向上させる可能性のある、メモリー制限の増加などのデータベース設定の制御を強化する高度な設定プロセスもあります。
バグを報告します。

2.2.1. Oracle 設定の事前設定
リンクのコピー

Oracle 設定には、JBoss ON のパフォーマンスを向上させるように調整できる複数の設定があります。
バグを報告します。
2.2.1.1. SGA および PGA サイズの設定
リンクのコピー
JBoss ON のパフォーマンスでは、SGA および PGA サイズの Oracle の設定は非常に重要です。これらの値が小さすぎると、データベースは非常に遅くなります。調整する設定は 2 つあります。
  • sga_target
  • pga_aggregate_target
データベース管理者に連絡し、Oracle の SGA および PGA 設定のサイジング要件を確認します。
バグを報告します。
2.2.1.2. Open Cursors の調整
リンクのコピー
以下の SQL コマンドを実行して、max_open_cur 設定の値が 300 未満かどうかを確認します。 
select max(a.value) as highest_open_cur, p.value as max_open_cur
from v$sesstat a, v$statname b, v$parameter p
where a.statistic# = b.statistic#
and b.name = 'opened cursors current'
and p.name= 'open_cursors'
group by p.value;
値が小さい場合 は 300 未満のカーソルをさらに開きます。 
alter system set open_cursors=300 scope=spfile;
注記
このクエリーは、既存のセッションにのみ適用されます。セッションが切断されると、以前の値に設定が返されます。
バグを報告します。
2.2.1.3. プロセスおよびセッション数の設定
リンクのコピー
この v$resource_limit 制限は、JBoss ON が許可される Oracle プロセスおよびセッションの最大数を設定します。この計算の式には、以下の一般的なフローがあります。 
calculate the number of processes => add additional processes for Enterprise Manager => calculate the total number of sessions (final value)
プロセス数を計算する方法は 2 つあります（エージェントの数と他のサーバー数を使用する）。どのメソッドも使用すると数値が高くなります。
Expand
表2.1 Oracle プロセスの計算
計算タイプ 式 例
エージェント 1.5 * number_of_agents 1.5 * 100 エージェント = 150
サーバー 60 * number_of_servers 60 * 2 のサーバー = 120
Oracle Enterprise Manager の使用 highest_number_of_processes + 40 1.5 * 100 エージェント + 40 = 190
前述のとおり 表2.1「Oracle プロセスの計算」、Oracle Enterprise Manager を使用するシステムの計算は若干異なります。このような場合には、まずエージェントとサーバーのプロセスを計算します。次に、どの値も最大値を取り、別の 40（Oracle Enterprise Manager に対応するために）を追加し、設定するプロセス数を生成します。
プロセスの合計数を計算したら、別の 10% を追加し（数値を 1.1 で乗算）、セッションの合計数（および最終値 v$resource_limit）を決定します。

例2.1 JBoss ON の Oracle プロセスとセッションの計算

たとえば、Corp. は 175 エージェントと 3 つのサーバーのデプロイを計画しています。Oracle Enterprise Manager を使用して Oracle インスタンスを管理します。
最初のステップは、エージェントとサーバーに基づくプロセス数を計算することです。 
1.5 * 175 agents = 262.5 processes
60 * 3 servers = 180 process
したがって、プロセスに使用する方法は、その値が大きいため、エージェントの方法になります。
プロセス数に 40 を追加します。 
262.5 + 40 = 302.5
プロセスの合計数は 302.5 です。そこから、セッションの数を計算します。 
302.5 * 1.1 = 332.75
Oracle の v$resource_limit 制限データベース設定の最後の値は 333 です。
バグを報告します。

2.2.2. Oracle の設定
リンクのコピー

重要
以下の設定は、JBoss ON テスト環境に対して迅速にこのサーバーを設定する例になります。これらの手順で推奨される値は実稼働環境で使用しないでください。この手順は、実稼働サーバーを設定するためのサポート対象の方法として使用しないでください。本番環境を設定する際には、必ずデータベースプロバイダーの設定手順に注意して従ってください。
JBoss ON でデータを保存するには、特定の Oracle データベースとユーザーを設定する必要があります。
  1. JBoss ON に使用する専用の Oracle インスタンスを作成します。このプロセスは、Oracle ドキュメントに記載されています。
  2. システムユーザーとして Oracle にログインします。 
    [jsmith@server ~]$ sqlplus
SQL> CONNECT sys/your_sys_password AS sysdba;
  3. JBoss ON のデータベースを作成します。この例では、データベースの名前が付けられてい rhqます。このプロセスは、Oracle ドキュメントを参照してください。 
    SQL> CREATE DATABASE rhq;
SQL> @?/rdbms/admin/catalog.sql
SQL> @?/rdbms/admin/catproc.sql
  4. JBoss ON が Oracle にアクセスするために使用するユーザーを作成します。パスワード rhqadmin でという名前のユーザーを作成し rhqadminます。例： 
    SQL> CREATE USER rhqadmin IDENTIFIED BY rhqadmin;
  5. Oracle ユーザーに必要なパーミッションを付与します。このユーザーには、少なくとも connect および resource ロールが必要です。例： 
    SQL> GRANT connect, resource TO rhqadmin;
    重要
    Oracle 12c を JBoss ON のバックエンドとして設定する場合は、RESOURCE ロールはデフォルトで rhqadmin ユーザーに付与されないこと UNLIMITED TABLESPACE に注意してください。このシステム特権をユーザーに付与する方法は手動で行う必要があります。
    そのためには、必要なテーブル空間に rhqadmin ユーザーが十分なもの QUOTA である必要があります。
    無制限のテーブル空間を付与できる場合は、明示的に実行できます。 
    GRANT UNLIMITED TABLESPACE TO rhqadmin;
    それ以外の場合は、特定のクォータ制限を設定する必要があります。例： 
    ALTER USER $username QUOTA 100G ON $tablespace_name;
    または、以下のように設定します。 
    ALTER USER $username QUOTA -1 ON $tablespace_name;
  6. データベースコミットを処理するパラメーターを定義する JBoss ON の Oracle ユーザーの追加パーミッションを設定します。
    JBoss ON は、一部のデータベースアクションに対して内部的に 2 フェーズコミットを使用します。2 つのフェーズコミットの失敗から回復するには、Oracle ユーザーに適切なパーミッションを付与する必要があります。そうでないと、データベースは XAException.XAER_RMERR エラーを返します。
    ユーザーに対してこれらの 4 つの権限を設定します。 
    GRANT SELECT ON sys.dba_pending_transactions TO user;
GRANT SELECT ON sys.pending_trans$ TO user;
GRANT SELECT ON sys.dba_2pc_pending TO user;
GRANT EXECUTE ON sys.dbms_xa TO user;
    この GRANT EXECUTE 行は、Oracle サーバーがバージョン 11g R1 であることを前提としています。11g R1 よりも古いパッチが適用されていないバージョンの Oracle については、代わりに以下の行を使用してください。 
    GRANT EXECUTE ON sys.dbms_system TO user;
  7. db_block_size 値が最低でも 8 KB であることを確認します。 
    SQL> show parameter db_block_size;
NAME                                 TYPE        VALUE
------------------------------------ ----------- ------------------------------
db_block_size                        integer     8192
バグを報告します。

第3章 JBoss ON Server のインストール
リンクのコピー

Red Hat JBoss Operations Network のコアとなるサーバーは、エージェントと通信し、インベントリーを維持し、リソース設定を管理し、コンテンツプロバイダーと対話し、集中管理 UI を提供します。JBoss ON には、JBoss ON がその機能を実行するために必要な他のコンポーネント（プラットフォームにインストールされているエージェント、管理者がスクリプト設定を可能にする CLI、他の JBoss 製品と JBoss ON を統合するプラグインなど）があります。特定のネットワークのニーズに合わせて、各コンポーネントを独立してインストールおよび設定する必要があります。
バグを報告します。

3.1. サポートされるプラットフォーム、データベース、およびその他要件
リンクのコピー

Java などのサポートされるプラットフォーム、データベース、およびその他の要件の一覧はに記載されてい https://access.redhat.com/knowledge/articles/112523 ます。
バグを報告します。

3.2. ハードウェアの最小
リンクのコピー

サーバーまたはデータベースプラットフォームに関係なく、JBoss ON サーバーおよびその関連するデータベースのインストールに最低要件が満たされる必要があります。
Expand
表3.1 推奨される最小ハードウェア
  最小値
メモリー 2 GB
インストールディレクトリーストレージ [a] 10 GB
一時ディレクトリーストレージ 10 GB
[a] サーバーは、システムユーザーとして実行します。ユーザーメモリーのシステム制限が、JBoss ON サーバーとそのすべてのデータに対応するのに十分な大きさに設定されていることを確認してください。
バグを報告します。

3.3. ディスク領域に関する考慮事項
リンクのコピー

特定の JBoss ON 機能はストレージ要件に大きく影響します。JBoss ON データベースにコンテンツの格納に関連するもの（設定が分散スナップショット、バンドルバージョン、WAR などのコンテンツベースのリソースなど）を使用することで、ストレージ要件が増加します。
JBoss ON はコンテンツのすべてのバージョンを保存します。したがって、バックエンドデータベース（Oracle または PostgreSQL）をホストするシステムには、ドリフト監視、コンテンツ更新、バンドルを使用して、すべてのリソースのすべてのバージョンを保存するのに十分なディスク領域が必要です。また、データベース自体にコンテンツに適したテーブル空間が必要です。
必要な領域を算出する際に、すべてのアーティファクト（バンドル、Web アプリケーション、監視ディレクトリー）のサイズを見積もり、各アーティファクトのバージョン数を計算します。少なくとも 2 倍の領域が利用可能です。PostgreSQL と Oracle の 両方で、vacuum、圧縮、およびバックアップおよび復元などのクリーンアップ操作を実行するには、PostgreSQL と Oracle の両方に 2 倍のデータベースサイズが必要です。
バグを報告します。

3.4. *nix システムへのインストールの準備
リンクのコピー

3.4.1. JBoss ON サーバーの JDK の設定
リンクのコピー

JBoss ON サーバーには Java 6 以上の JDK が必要です。
  1. 必要に応じて適切なバージョンの Java をダウンロードし、インストールします。
  2. を設定します。 JAVA_HOME インストールディレクトリーへの環境変数。
    1. JBoss ON を実行するシステムユーザー .bashrc に対して開きます。例： 
      vim /home/jon/.bashrc
    2. 設定する行を追加します。 JAVA_HOME 特定の JDK ディレクトリーへの環境変数。例： 
      export JAVA_HOME=/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/
  3. system alternatives コマンドを使用して、システムが正しいバージョンの JDK を使用するように設定します。選択したバージョンには *+ シンボルがあります。 
    /usr/sbin/alternatives --config javac

There are 2 programs which provide 'javac'.

  Selection    Command
-----------------------------------------------
   1           /usr/lib/jvm/java-1.6.0-bea/bin/javac
*+ 2           /usr/lib/jvm/java-1.6.0-openjdk/bin/javac

Enter to keep the current selection[+], or type selection number:
バグを報告します。

3.4.2. NTP の設定
リンクのコピー

マシンクロックを同期します。すべての JBoss ON サーバーおよびエージェントには同期されたクロックが必要です。クロックの変動により、可用性のレポート、メトリック測定、グラフ化、およびリソースをインベントリーに識別してインポートする際に問題が発生します。Network Time Protocol プロジェクトには http://www.ntp.org/、クロックが同期されるように NTP をインストールおよび設定するための情報があります。
バグを報告します。

3.4.3. DNS の設定
リンクのコピー

ホストサーバー、ストレージノード、およびエージェントがあるすべてのシステムでは、正引きおよび逆引き DNS マッピングエントリーの両方が存在する必要があります。
すべての IP アドレスに DNS サーバーの対応するエントリーがあるか、JBoss ON によって管理される各システム、またはサーバーまたはストレージノードをホストする各システムに対して明示的に定義する必要が /etc/hosts あります。
バグを報告します。

3.4.4. ポートの設定
リンクのコピー

サーバー、エージェント、およびストレージノードのポート上での通信を可能にするようにファイアウォールを設定します。 必要なポートがブロックされている場合は、個々のコンポーネントが相互に通信できなくなります。
デフォルト設定を使用すると、JBoss ON はに記載されたポートを使用し 表3.2「デフォルトの JBoss ON ポート」 ます。
Expand
表3.2 デフォルトの JBoss ON ポート
ポート 目的
7080 サーバークライアント通信用の標準 HTTP ポート
7443 セキュアなサーバークライアント通信用の HTTPS ポート
16163 サーバーからのエージェント通信
9142 ストレージクラスターの通信の場合
7299 ストレージノードの JMX 通信の場合
7100 ストレージノードのゴシップ（ノード間の）通信
バグを報告します。

3.5. Windows へのインストールの準備
リンクのコピー

3.5.1. JDK の設定
リンクのコピー

JBoss ON サーバーには Java 6 または Java 7 JDK が必要です。
必要な場合は、適切な Java バージョンを使用するように Windows を設定します。
  1. 必要に応じて適切なバージョンの Java をダウンロードし、インストールします。
  2. を設定します。 JAVA_HOME インストールディレクトリーへの環境変数。例： 
    C:\>set JAVA_HOME=C:\Program Files\Java\jdk1.6.0_29
バグを報告します。

3.5.2. サービスとして実行する JVM の設定
リンクのコピー

JBoss ON には、JBoss ON サーバーを Windows サービスとして実行するように設定できるように、Tanuma ソフトウェアの Java サービスラッパーが含まれています。JAVA_HOME、RHQ_JAVA_HOME、または RHQ_JAVA_EXE_FILE_PATH のいずれかが適切な JDK または JRE に設定されていることを確認します。
バグを報告します。

3.5.3. NTP の設定
リンクのコピー

マシンクロックを同期します。すべての JBoss ON サーバーおよびエージェントには同期されたクロックが必要です。クロックの変動により、可用性のレポート、メトリック測定、グラフ化、およびリソースをインベントリーに識別してインポートする際に問題が発生します。Network Time Protocol プロジェクトには http://www.ntp.org/、クロックが同期されるように NTP をインストールおよび設定するための情報があります。
バグを報告します。

3.5.4. DNS の設定
リンクのコピー

ホストサーバー、ストレージノード、およびエージェントがあるすべてのシステムでは、正引きおよび逆引き DNS マッピングエントリーの両方が存在する必要があります。
すべての IP アドレスには DNS サーバーの対応するエントリーを含めるか、JBoss ON によって管理される各システム、またはサーバーまたはストレージノードをホストする各 /etc/hosts ファイルに対して明示的に定義する必要があります。
バグを報告します。

3.5.5. ポートの設定
リンクのコピー

サーバー、エージェント、およびストレージノードのポート上での通信を可能にするようにファイアウォールを設定します。 必要なポートがブロックされている場合は、個々のコンポーネントが相互に通信できなくなります。
デフォルト設定を使用すると、JBoss ON はに記載されたポートを使用し 表3.3「デフォルトの JBoss ON ポート」 ます。
Expand
表3.3 デフォルトの JBoss ON ポート
ポート 目的
7080 サーバークライアント通信用の標準 HTTP ポート
7443 セキュアなサーバークライアント通信用の HTTPS ポート
16163 サーバーからのエージェント通信
9142 ストレージクラスターの通信の場合
7299 ストレージノードの JMX 通信の場合
7100 ストレージノードのゴシップ（ノード間の）通信
バグを報告します。

3.5.6. パス名の選択
リンクのコピー

サーバーインストールディレクトリーの 完全な パス名が比較的短いことを確認してください。19 文字を超えるパス名により、一部のサーバータスクの実行で問題が発生する可能性があります。のよう C:\jon な場所を使用し C:\Documents and Settings\myusername\jon-serverます。
また、extract all コマンドを使用する場合は注意してください。アーカイブを拡張すると、jon -server-VER.RELEASE/ という名前のディレクトリー（約 20 文字）が自動的に作成されます。extract all （アーカイブを展開するディレクトリーを指定する代わりに）を使用すると、アーカイブ名に展開してサブディレクトリーに展開してディレクトリー名を 2 倍にすることができます（例：） C:\example\jon-server-3.3.2.GA\jon-server-3.3.2.GA。他のツールを使用すると、などのダウンロードディレクトリーにインストールでき C:\Users\Administrator\Downloadsます。
アーカイブを短いトップレベルのディレクトリーに展開して、のインストールディレクトリーを作成 C:\jonすることが推奨され C:\jon\jon-server-3.3.2.GAます。
ファイル名とパス名の Windows 処理については、Windows Dev Center の Web サイトの 『Naming Files、Paths、および Namespaces』 ページの「 Maximum Path Length Limitation」を参照 してください。
バグを報告します。

3.5.7. JBoss ON で使用するユーティリティー
リンクのコピー

JBoss ON サーバーの管理に使用する唯一のユーティリティーは、バイナリーをインストールし、場合によっては設定ファイルを表示および編集するためのテキストエディターである可能性があります。
推奨される ZIP ユーティリティーは WinZip です。本ガイドの例では、通常 Windows コマンドプロンプトを使用するため、必要に応じて WinZip CLI ユーティリティーアドオンをインストールします。WinZip のダウンロードはから入手でき http://www.winzip.com ます。
バグを報告します。

3.5.8. Internet Explorer の設定
リンクのコピー

Internet Explorer 設定によっては、JBoss ON のログインページが適切にロードされなくなることがあります。デフォルトでは、Internet Explorer はプルスモードに あり、一部の Web サイトの JavaScript アクセスを無効にします。ログインページがロードできるようにするには、JBoss ON サーバーの IP アドレスを Internet Explorer のホワイトリストに追加します。
  1. Internet Explorer で、右上隅の歯車アイコンをクリックして選択し Internet optionsます。
  2. Security タブを開き、Local intranet アイコンを選択します。
  3. Sites ボタンをクリックします。
  4. ポップアップウィンドウの下部にある Advanced ボタンをクリックします。
  5. Add this webiste to the zone: フィールドに JBoss ON サーバーのホスト名または IP アドレスを入力し、をクリックし Addます。
  6. オプションウィンドウを閉じます。
バグを報告します。

3.5.9. Windows サービスとして管理されるコンポーネント
リンクのコピー

Windows では、rhqctl.bat スクリプトは UNIX ベースのプラットフォームと類似 rhqctl しています。
コンポーネントは Windows サービスとしてインストールおよび管理されます。Windows サービスは、デフォルトでローカルシステムアカウント（「デフォルト」または「.\LocalSystem」として知られる）として実行されます。JBoss ON では、エージェント設定の優先度がユーザーに関連付けられます。
注記
実行中 rhqctl.batは必ず「Run As Administrator」でコマンドウィンドウを起動し、スクリプトが Windows サービスを操作できるようにします。
RHQ Agent サービスを実行しているユーザーにカスタムエージェントの設定が正しく適用されていることを確認します。
これを行う方法は複数あります。
RHQ_AGENT_RUN_AS_ME を使用してインストールし、--agent-preference を使用します。
これにより、同じユーザーと同じユーザーがサービスを実行するため rhqctl、コマンドラインの --agent-preference 設定が適用されます。
--agent-config <custom-agent-configuration.xml> を使用してインストールします。
ユーザーが実行 RHQ_AGENT_RUN_AS_ME していない場合 rhqctl は、サービスを実行しているユーザーとは異なります。
このオプションは、RHQ Agent の初期起動時にカスタム設定ファイルを適用します。これには、サービスが正しいユーザーで実行されるのに必要な設定が含まれます。
インストール後の RHQ エージェント設定の更新
インストール後は、agent prompt コマンドを使用して、エージェント設定を更新できます。
ユーザーが実行 RHQ_AGENT_RUN_AS_ME していない場合 rhqctl は、サービスを実行しているユーザーとは異なります。インストール済み --agent-config のエージェントがない場合には、デフォルト設定が指定されます。

手順3.1 Windows サービスに必要なユーザーアカウントの設定

  1. を開き rhq-server-env.batます。
  2. 環境変数を定義します。 
    RHQ_SERVER_RUN_AS=.\username
RHQ_SERVER_PASSWORD=password

RHQ_STORAGE_RUN_AS=.\username
RHQ_STORAGE_PASSWORD=password

RHQ_AGENT_RUN_AS=.\username
RHQ_AGENT_PASSWORD=password
    RHQ_*_RUN_AS パラメーターは、使用するユーザーアカウントを設定します。この RHQ_*_RUN_AS_ME パラメーターは、ログインしているユーザーをサービスアカウントとして使用します。両方のパラメーターが設定されている場合、RHQ_*_RUN_AS_ME パラメーターが使用されているパラメーターになります。
  3. 指定したユーザーアカウントのサービスパーミッション としてログを明示的に 付与します。
バグを報告します。

3.5.10. ストレージノードのプランニング
リンクのコピー

メトリクスデータを保存するには、少なくとも 1 つのバックエンドストレージデータベースが必要です。このストレージノードは、rhqctl スクリプト（サーバーと同じ）を使用してインストールされます。メトリクスストレージデータベースはクラスターとして機能するため、必要に応じて複数のノードを作成して削除することができます。
ストレージノードをプランニングする際のガイドラインは以下のとおりです。
  • ストレージノードとサーバーは、同じマシンに配置する必要はありません。
  • ストレージノードをインストールする必要はありません。サーバーをインストールする必要はありません。
  • サーバーの前に少なくとも 1 つのストレージノードをインストールする必要があります。（ install コマンドのみで rhqctl スクリプトを実行すると、最初にストレージノードが自動的にインストールされ、次にサーバー、次にエージェントがインストールされます。）
  • サーバーをインストールする前に、複数のストレージノードをインストールできます。複数のノードをインストールする利点はいくつかあります。
    • アップグレードされた環境では、データ移行を迅速化します。
    • サーバーの実行後にノードをデプロイすることで発生する管理およびリソース要件を最小限に抑えることができます。
バグを報告します。

3.6. rhqctl スクリプトについて
リンクのコピー

Red Hat JBoss Operations Network には、サーバーおよびストレージノードの基本的なライフサイクル管理に使用される制御スクリプトがあります。サーバーコンソールを開き、サーバーを起動および停止できます。
コントロールスクリプト(rhqctl)には install、インストールプロセスに関連する 2 つのサブコマンドがあります upgrade。
注記
次に進む前に、PostgreSQL データベースユーザー 「PostgreSQL の設定」 用に設定 JBossON-install-location/bin/rhq-server.properties したパスワードを使用するように、以下の属性を開いて変更します。では、の手順を 
rhq.server.database.password
使用し rhqadminます 「プロパティーファイルの属性」。
バグを報告します。

3.6.1. rhqctl スクリプトの使用
リンクのコピー

rhqctl スクリプトには、サブコマンドとオプションがあります。 
rhqctl [command] [[options]
インストールプロセスでは、は関連する唯一のコマンドです install。
install コマンドには、必要に応じて JBoss ON サーバーの設定を可能にする複数のオプションがあります。

例3.1 オプションなしのインストール

サーバーを設定する最も簡単な方法は、install コマンドのみを実行することです。 
jsmith@server bin]$ ./rhqctl install
06:21:40,773 INFO  [org.jboss.modules] JBoss Modules version 1.3.3.Final-redhat-1

The [rhq.autoinstall.server.admin.password] property is required but not set in [rhq-server.properties].
Do you want to set [rhq.autoinstall.server.admin.password] value now?
yes|no: yes
rhq.autoinstall.server.admin.password (enter as plain text): 
Confirm:
rhq.autoinstall.server.admin.password (enter as plain text): 

The [jboss.bind.address] property is required but not set in [rhq-server.properties].
Do you want to set [jboss.bind.address] value now?
yes|no: yes
jboss.bind.address: 0.0.0.0
Is [0.0.0.0] correct?
yes|no: yes
これにより、3 つの管理コンポーネントがすべてインストールされます。
  • サーバー
  • ストレージデータベースノード
  • ローカルエージェント
設定プロセスが完了すると、サーバー、ストレージノード、およびエージェントが実行されていないため、これらのプロセスを手動で起動する必要があります。 
[jsmith@server bin]# ./rhqctl start

例3.2 サービスのインストールと起動

この --start オプションは、インストールプロセスが完了するとすぐにすべてのサービスを起動します。これは、すぐに start コマンドを実行するのと同じです。 
[jsmith@server bin]# ./rhqctl install --start

例3.3 特定のサービスのインストール

この install コマンドは、JBoss ON のサーバー、ストレージノード、およびエージェントを同時に設定します。
3 つの管理サービスをすべて同じシステム（同じ親ディレクトリーから）で実行することが推奨されますが、ストレージノードとは別のマシンで JBoss ON サーバーを実行するのに有益な環境があります。その他の場合は、異なるタイミングで異なるサービスをインストールする必要がある場合があります。
install コマンドには、サービスごとにオプションがあります。このオプションを使用すると、そのサービスだけがインストールされ、他のサービスは除外されます。
たとえば、これにより、サーバー、ストレージノード、およびエージェントが 3 つの異なるコマンド呼び出しにインストールされます。 
[jsmith@server bin]# ./rhqctl install --storage --start
[jsmith@server bin]# ./rhqctl install --server --start
[jsmith@server bin]# ./rhqctl install --agent --start
サービスが同じシステムにインストールされているものの、別々にインストールする場合は、最初にストレージノードをインストールします。サーバーのインストール時にストレージノードをインストールし、実行する必要があります。
Expand
表3.4 JBoss ON のインストールオプション
オプション description
--start インストールプロセスが完了すると、すべてのサービスを開始します。
--server サーバーをインストールします。サーバーはデフォルトでインストールされます。これを指定すると、サーバーがインストールされ、他のコンポーネントはインストールされません（明示的に指定されていない限り）。
--storage ストレージデータベースノードをインストールします。ストレージデータベースノードはデフォルトでインストールされます。これを指定すると、ストレージデータベースとコンパニオンエージェントがインストールされていますが、サーバーはインストールされません。
--storage-data-root-dir directory ストレージデータが保存されるディレクトリーを変更します。デフォルトでは、ストレージノードのディレクトリーはになり serverRoot/jon-server-3.3.2.GA/rhq-data/ます。
--agent エージェントをインストールします。エージェントはデフォルトでインストールされます。これを指定すると、エージェントがインストールされ、他のコンポーネントがインストールされていません（明示的に指定されていない限り）。
バグを報告します。

3.6.2. プロパティーファイルの属性
リンクのコピー

JBoss ON サーバーの設定はすべて、設定 rhq-server.properties ファイルから設定時にプルされます。ほとんどの設定はデフォルトで定義されます。
  • データベース接続情報
  • データベースユーザーのユーザー名およびパスワード
  • JBoss ON サーバーのポート番号
  • JBoss ON クラウドのサーバーインスタンスの名前
  • JBoss ON データベースの既存のスキーマを処理する方法
  • SSL 設定を含むサーバー/エージェント通信設定
  • サーバーの接続および同時実行制限
その他の設定もありますが、最も一般的な設定です。属性名と説明を以下に示します。これらの設定は、rhqctl スクリプトを実行する前に編集して新しい値を設定できます。変更が行われない場合は、主に以下の 3 つの設定エリアがあります。
  • デフォルトのデータベース設定は、JBoss ON サーバーと同じホストにインストールされている PostgreSQL データベースを使用します。
  • サーバーのバインドアドレス（IP アドレス）は空白のままにし、制御スクリプトは値の入力を要求します。
  • サーバー名は空白のままにし、デフォルト値はサーバーのホスト名です。

サーバー設定の rhq-server.properties 属性

rhq.server.high-availability.name
JBoss ON サーバークラウド内のサーバーの特定に使用するオプションの名前を設定します。これが指定されていない場合、デフォルト値はサーバーのホスト名になります。
jboss.bind.address
JBoss ON サーバーへの接続に使用する IP アドレスを指定します。サーバーがすべてのインターフェースで利用可能な場合は、これをに設定し 0.0.0.0ます。
jboss.tx.node.id
これは、JON Server インスタンスの高可用性識別子です。一意の 23 文字でなければなりません。デフォルトは '1' です。
注記
HA 設定の JBoss Operations Network サーバーは同じデータベースを使用するため、データベーストランザクションを管理するためにそれぞれ個別の一意なノード識別子が必要になります。しかし、デフォルトの JBoss Operations Network サーバー設定は、データベーストランザクションに使用されるノード識別子の値を指定しません。つまり、基礎となるアプリケーションサーバーはデフォルトのノード識別子の値 1 を使用します。これにより、トランザクションの実行やリカバリーの失敗が急に発生し、JBoss Operations Network サーバーまたはそれが使用しているデータベースに追加の負荷が生じる可能性があります。
rhq.autoinstall.database
JBoss ON データベースの既存データの処理方法を設定します。デフォルトはです。つまり auto、インストールプロセスは新しいスキーマを追加しますが、既存のデータを保持します。または、スキーマを更新し overwrite、既存のデータを削除するオプションもあります。
rhq.autoinstall.server.admin.password
新規インストールの rhqctl install コマンドのステップとして生成された暗号化されたサーバーパスワードを保存します。暗号化値は、rhq-encode-value.(bat|sh) スクリプトを使用して手動で生成でき、ユーザーが手動で更新した値です。
rhq.server.startup.web.http.port , rhq.server.startup.web.https.port
JBoss ON サーバーの標準(HTTP)およびセキュア(HTTPS)ポートを設定します。デフォルト値は 7080 および 7443 です。
rhq.server.database.type-mapping
JBoss ON サーバーで使用されるデータベースのタイプまたはベンダーを指定します。PostgreSQL または Oracle10g（Oracle10g は Oracle データベースのバージョン 10、11、および 12 のいずれかに使用されます）。
rhq.server.database.connection-url
データベースへの接続時に JBoss ON サーバーが使用する JDBC URL。これは jdbc:db-type:hostname:port[:|/]db-name 形式になります。
例は、jdbc:postgresql://localhost:5432/rhq または jdbc:oracle:oci:@localhost:1521:orcl です。
rhq.server.database.user-name
データベースにログインする際に JBoss ON サーバーが使用するユーザーの名前。デフォルトはです rhqadmin。
rhq.server.database.password
データベースにログインする際に JBoss ON サーバーによって使用されるデータベースユーザーのパスワード。
このパスワードはハッシュに保存されます。デフォルトのパスワードはです rhqadmin。
データベースユーザーに別のパスワードが作成されている場合は、serverRoot/jon-server-3.3.2.GA/bin/rhq-encode-value.sh スクリプトを使用してパスワードを暗号化し、rhq.server.database.password 属性内の暗号化されたパスワード値を更新します。
注記
この rhq-encode-password.sh スクリプトは非推奨となっていますが、後方互換性のために JBoss ON に残ります。古いスクリプトの使用を中止し、serverRoot/jon-server-3.3.2.GA/bin/rhq-encode-value.sh パスワードの暗号化を開始することが推奨されます。
rhq.server.database.server-name
データベースが置かれているサーバー名。これは、接続 URL のサーバーと一致する必要があります。現在、これは PostgreSQL に接続するときにのみ使用されます。
rhq.server.database.port
データベースがリッスンしているポート。これは、接続 URL のポートと一致する必要があります。現在、これは PostgreSQL に接続するときにのみ使用されます。
rhq.server.database.db-name
データベースの名前。これは、接続 URL にある名前に一致する必要があります。現在、これは PostgreSQL に接続するときにのみ使用されます。
rhq.server.quartz.driverDelegateClass
サーバーとデータベース間の接続に使用される Quartz ドライバー。この値はインストールプログラムによって設定され、JBoss ON 情報を保存するために使用されるデータベースの種類によって異なります。PostgreSQL の場合、これはです。 org.quartz.impl.jdbcjobstore.PostgreSQLDelegateOracle の場合、これは org.quartz.impl.jdbcjobstore.oracle.OracleDelegate.
バグを報告します。

3.7. 基本設定： Linux へのサーバーのインストール
リンクのコピー

手順3.2

  1. カスタマーポータルから JBoss ON バイナリーをダウンロードします。
    1. カスタマーポータルで Downloads タブをクリックし、Product Downloads ページを開きます。
    2. Software Downloads ページ JBoss Development and Management にアクセスする Red Hat JBoss Operations Network リンクを選択します。
    3. Download リンク Red Hat JBoss Operations Network 3.3 Base Distribution をクリックします。
    4. JBoss ON サーバーと使用できるプラグインパックは、Product ドロップダウンメニューを使用してアクセス可能になります。プラグインには以下が含まれます。
      • Red Hat JBoss Enterprise Application Platform(JBoss ON for EAP)
      • Red Hat JBoss Enterprise Data Services(JBoss ON for EDS)
      • Red Hat JBoss Enterprise Web Server(JBoss ON for EWS)、および
      • Red Hat JBoss Service Oriented Architecture Platform(JBoss ON for SOA-P)。
  2. JBoss ON の希望のホームディレクトリーにサーバーディストリビューションを展開します。例： 
    [jsmith@server ~]$ unzip jon-server-3.3.2.GA.zip -d /path/to/install_dir/
    これにより、バージョン固有のインストールディレクトリーが作成され /path/to/jon-server-3.3.2.GAます。unzip 操作の前に、この名前のディレクトリーが存在していないことを確認してください。
  3. オプション。デフォルトでは、スクリプトはバックエンドデータベースがサーバーと同じシステムで実行している PostgreSQL サーバーであることを前提としています。データベースパスワード、サーバーポート番号、サーバー名、データベーススキーマの処理方法などのその他の設定では、事前定義されたデフォルトを使用します。1 つのパラメーター（サーバーのバインドアドレス）は空で、制御スクリプトによりプロンプトが表示されます。
    これらのデフォルトを変更するか、または追加情報を設定するには、rhq-server.properties ファイルを編集します。これは、で簡単に説明し 「プロパティーファイルの属性」 ます。
    注記
    JBoss ON がサービスとして実行するように設定するには、『 Configuring JON Servers and Agents』の「 Running the JBoss ON Server as a Service 」を参照してください。
    重要
    JBoss ON を root ユーザーとして実行しないことが推奨されます。
  4. JBoss ON の制御スクリプトを実行して、サーバーおよび他のサービスを設定します。rhq-server.properties ファイルを編集しない場合、スクリプトにより管理パスワードとサーバーのバインドアドレスの入力が求められます。これは、0.0.0.0 とに設定できます。 rhq.autoinstall.server.admin.password. 
    [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --start
06:21:40,773 INFO  [org.jboss.modules] JBoss Modules version 1.3.3.Final-redhat-1

The [rhq.autoinstall.server.admin.password] property is required but not set in [rhq-server.properties].
Do you want to set [rhq.autoinstall.server.admin.password] value now?
yes|no: yes
rhq.autoinstall.server.admin.password (enter as plain text): 
Confirm:
rhq.autoinstall.server.admin.password (enter as plain text): 

The [jboss.bind.address] property is required but not set in [rhq-server.properties].
Do you want to set [jboss.bind.address] value now?
yes|no: yes
jboss.bind.address: 0.0.0.0
Is [0.0.0.0] correct?
yes|no: yes
    このコマンドは、以下の 2 つのことを行います。
    • JBoss ON サーバー、ストレージノード、およびエージェントを設定します。
    • 設定プロセスが完了すると、すべてのサービスが開始されます。
  5. サーバープロセスを開始するまでに数分の時間がかかる場合があります。起動後、JBoss ON サーバーの Web ベースのユーザーインターフェースにアクセスし、Web ブラウザー経由で http://hostname:7080 を使用してリソースを設定でき ます。例： 
    http://server.example.com:7080
    または、ローカルインストール http://localhost:7080 の場合はになります。
    ユーザー名はで rhqadmin、パスワードは直前の手順でインストールプログラムを実行する際に設定されている値か、の値を変更して手動で設定します。 rhq.autoinstall.server.admin.password で説明している rhq-server.properties ファイルでは、を参照してください 「プロパティーファイルの属性」。
バグを報告します。

3.8. 基本設定： Microsoft Windows へのサーバーのインストール
リンクのコピー

手順3.3

  1. Microsoft Windows コマンドプロンプトを開くとき、名前またはアイコンを右クリックして選択し Run as Administratorます。
  2. カスタマーポータルから JBoss ON バイナリーをダウンロードします。
    1. カスタマーポータルで Downloads タブをクリックし、Product Downloads ページを開きます。
    2. Software Downloads ページ JBoss Development and Management にアクセスする Red Hat JBoss Operations Network リンクを選択します。
    3. Download リンク Red Hat JBoss Operations Network 3.3 Base Distribution をクリックします。
    4. JBoss ON サーバーと使用できるプラグインパックは、Product ドロップダウンメニューを使用してアクセス可能になります。プラグインには以下が含まれます。
      • Red Hat JBoss Enterprise Application Platform(JBoss ON for EAP)
      • Red Hat JBoss Enterprise Data Services(JBoss ON for EDS)
      • Red Hat JBoss Enterprise Web Server(JBoss ON for EWS)、および
      • Red Hat JBoss Service Oriented Architecture Platform(JBoss ON for SOA-P)。
  3. インストールするサーバーのディレクトリーを作成します。
    比較的短い名前を使用します。19 文字を超えるパス名により、サーバーの実行や一部のタスクの実行で問題が発生する可能性があります。
  4. JBoss ON の希望のホームディレクトリーにサーバーディストリビューションを展開します。例： 
    C:> winzip32 -e jon-server-3.3.2.GA.zip C:\jon
    これにより、バージョン固有のインストールディレクトリーが作成され C:\jon\jon-server-3.3.2.GAます。この名前のディレクトリーは、unzip 操作の前に存在しないでください。
    重要
    extract all コマンドを使用する場合は注意してください。アーカイブを拡張すると、jon -server-VER.RELEASE/ という名前のディレクトリー（約 20 文字）が自動的に作成されます。extract all （アーカイブを展開するディレクトリーを指定する代わりに）を使用すると、アーカイブ名に展開してサブディレクトリーに展開してディレクトリー名を 2 倍にすることができます（例：） C:\example\jon-server-3.3.2.GA\jon-server-3.3.2.GA。他のツールを使用すると、などのダウンロードディレクトリーにインストールでき C:\Users\Administrator\Downloadsます。
    ディレクトリーパスが長すぎると、Windows へのインストールは失敗します。
    アーカイブを抽出することが推奨されます（例：） C:\jon C:\jon\jon-server-3.3.2.GA。
  5. JDK インストールへのディレクトリーパスを設定します。例： 
    set RHQ_JAVA_HOME=C:\Program Files\Java\jdk1.6.0_29
  6. オプション。デフォルトでは、スクリプトはデータベースがサーバーと同じシステムで実行している PostgreSQL サーバーであることを前提としています。データベースパスワード、サーバーポート番号、サーバー名、データベーススキーマの処理方法などのその他の設定では、事前定義されたデフォルトを使用します。1 つのパラメーター（サーバーのバインドアドレス）は空で、制御スクリプトによりプロンプトが表示されます。
    これらのデフォルトを変更するか、または追加情報を設定するには、rhq-server.properties ファイルを編集します。これは、で簡単に説明し 「プロパティーファイルの属性」 ます。
  7. オプション。Windows サービスは、デフォルトでローカルシステムアカウント（デフォルトまたは .\LocalSystem）として実行されます。rhq-server-env.bat スクリプトに適切なプロパティーを設定して、サービスを異なるユーザーとして実行するように設定できます。
    RHQ_*_RUN_AS パラメーターは、使用するユーザーアカウントを設定します。この RHQ_*_RUN_AS_ME パラメーターは、ログインしているユーザーをサービスアカウントとして使用します。両方のパラメーターが設定されている場合、RHQ_*_RUN_AS_ME パラメーターが使用されているパラメーターになります。 
    RHQ_SERVER_RUN_AS=.\username
RHQ_SERVER_PASSWORD=password

RHQ_STORAGE_RUN_AS=.\username
RHQ_STORAGE_PASSWORD=password

RHQ_AGENT_RUN_AS=.\username
RHQ_AGENT_PASSWORD=password
    定義されたユーザーアカウントには、サービスパーミッション としてログインする必要があり ます。これは、明示的に付与する必要がある場合があります。
  8. JBoss ON の制御スクリプトを実行して、サーバーおよび他のサービスを設定します。rhq-server.properties ファイルを編集しない場合、スクリプトによりサーバーのバインドアドレスが要求されます。これは、0.0.0.0 とに設定できます。 rhq.autoinstall.server.admin.password. 
    C:\jon\jon-server-3.3.2.GA\bin> serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --start
06:21:40,773 INFO  [org.jboss.modules] JBoss Modules version 1.3.3.Final-redhat-1

The [rhq.autoinstall.server.admin.password] property is required but not set in [rhq-server.properties].
Do you want to set [rhq.autoinstall.server.admin.password] value now?
yes|no: yes
rhq.autoinstall.server.admin.password (enter as plain text): 
Confirm:
rhq.autoinstall.server.admin.password (enter as plain text): 

The [jboss.bind.address] property is required but not set in [rhq-server.properties].
Do you want to set [jboss.bind.address] value now?
yes|no: yes
jboss.bind.address: 0.0.0.0
Is [0.0.0.0] correct?
yes|no: yes
    このコマンドは、以下の 2 つのことを行います。
    • JBoss ON サーバー、ストレージノード、およびエージェントを設定します。
    • 設定プロセスが完了したら、すべてのサービスを起動します。
  9. サーバープロセスを開始するまでに数分の時間がかかる場合があります。起動後、JBoss ON サーバーの Web ベースのユーザーインターフェースにアクセスし、Web ブラウザー経由で http://hostname:7080 を使用してリソースを設定でき ます。例： 
    http://server.example.com:7080
    または、ローカルインストール http://localhost:7080 の場合はになります。
    ユーザー名はで rhqadmin、パスワードは直前の手順でインストールプログラムを実行する際に設定されている値か、の値を変更して手動で設定します。 rhq.autoinstall.server.admin.password で説明している rhq-server.properties ファイルでは、を参照してください 「プロパティーファイルの属性」。
バグを報告します。

3.9. サーバーおよびエージェント間の認証の設定
リンクのコピー

警告
認証のない接続を許可することは重大なセキュリティー上の懸念です。
『 JBoss Operations Network 『Configuring JBoss ON Servers, Agents, and Storage Nodes』に記載されている認証手順を確認し、』 これに従ってインストールのセキュリティーを保護します。
バグを報告します。

3.10. 高可用性向けの追加のサーバーのインストール
リンクのコピー

JBoss ON は、同じ SQL データベースバックエンドを使用する複数のサーバーインスタンスを設定することで、高可用性クラウドで実行するように設定できます。すべてのサーバーがバックエンドを共有するため、使用するデータとインベントリーのセットはすべて同じで、すべて同じエージェントと通信します。

エージェントおよびストレージノードを使用した追加のサーバーのインストール

  1. 追加のサーバーは、最初の JBoss ON サーバーインスタンスと同じ SQL データベース情報と共にインストールする必要があります。rhq-server.properties ファイルを編集して、元のインスタンスと同じデータベース設定を使用する必要があります。データベースプロパティーはセクション 3.6.2 に一覧表示され 「プロパティーファイルの属性」 ます。
  2. rhq-server.properties ファイルを編集して、一意の jboss.tx.node.id 値を使用する必要があります。
    重要
    HA 環境のすべての JON サーバーが、一意の jboss.tx.node.id 値を使用するように設定する必要があります。
  3. データベースおよび HA 識別子設定のプロパティーファイルを編集した後、サーバーを通常通りにインストールできます。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --start

個別ストレージノードを使用した追加サーバーのインストール

デフォルト install コマンドでは、サーバー、エージェント、およびストレージノードがインストールされている。高可用性のデプロイメントによっては、全サーバーとストレージノードがインストールされない場合があります。この場合は、インストールプロセスの一環として、既存のストレージノードの設定をサーバー設定に追加する必要があります。

  1. 追加のサーバーは、最初の JBoss ON サーバーインスタンスと同じ SQL データベース情報と共にインストールする必要があります。rhq-server.properties ファイルを編集し、元のインスタンスと同じデータベース設定を使用します。データベースプロパティーはセクション 3.6.2 に一覧表示され 「プロパティーファイルの属性」 ます。
  2. rhq-server.properties ファイルを編集して一意の jboss.tx.node.id 値を使用します。
    重要
    同じ HA 環境にあるすべての JON サーバーが一意の jboss.tx.node.id 値を使用するように設定する必要があります。
  3. 元のサーバーマシンで、ストレージノードおよびクライアントおよびノードが使用するゴシップポートの IP アドレスまたはホスト名の Administration >Storage Nodes 一覧を確認します。
  4. 新しいサーバーマシンでサーバーをインストールする前に、rhq-server.properties ファイルを編集してストレージノードの接続情報を追加します。
    rhq.storage.nodes パラメーターに一覧表示されるカンマ区切りの各ストレージノードを追加します。次に、クライアントとゴシップポートの値を追加します。 
    [jsmith@server ~]# vim serverRoot/jon-server-3.3.2.GA/bin/rhq-server.properties

rhq.storage.nodes=192.168.0.1,192.168.0.2,192.168.0.3
rhq.storage.cql-port=9142
rhq.storage.gossip-port=7100
  5. サーバーとエージェントをインストールします。--server および --agent オプションを指定すると、これら 2 つのコンポーネントのみがインストールされます。ストレージデータベースは除外されます。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --server --agent --start
バグを報告します。

3.11. サーバーのインストール前のストレージノードのインストール
リンクのコピー

サーバーをインストールする前に複数のストレージノードを作成してから、事前にインストールしたノードでサーバーをインストールできます。これは、ストレージデータベースが別個の専用のマシンにある場合にも便利です。
警告
これは高度な設定です。クラスター内のストレージノードまたはノードが適切に設定されていない場合は、クラスターが適切に機能しない可能性があります。
警告
ノード一覧をクラスター設定にデプロイし、許可 さ れるホストはストレージクラスター内のデータにアクセスできます。
許可されたホスト一覧を変更できないように、rhq-storage-auth.conf ファイルへのアクセスを制限して、攻撃者がクラスターおよび保存されたデータにアクセスできるようにします。
重要
すべてのストレージノードは、同じクライアント(CQL)とゴシップポートを使用する必要があります。
さらに、全ストレージノードシステムのホスト名および IP アドレスは、DNS で完全に解決できるか、各システムの hosts ファイルで設定する必要があります。
  1. 使用するノードおよびクラスター設定情報を判別します。
    • ノードをホストする各システムのホスト名または IP アドレスを特定します。
    • クラスターが通信に使用する 2 つのポートを定義します（デフォルトでは、9142 および 7100）。
  2. ストレージノードをインストールする前に、ノード とクラスター情報をすべて指定してストレージプロパティーファイルを編集します。 
    [jsmith@server ~]# vim serverRoot/jon-server-3.3.2.GA/bin/rhq-storage.properties
    たとえば、この rhq.storage.seeds パラメーターで設定される 3 つのノードを設定します。 
    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. コンパニオンエージェントを使用して、各システムにストレージノードをインストールします。サーバーが インストールされていない場合でも、JBoss ON サーバーの IP アドレスが必要です。
    重要
    この時点で、ストレージノードやエージェントは起動しないでください。インストールスクリプトには --start オプションを使用しないでください。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --storage --agent-preference="rhq.agent.server.bind-address=192.168.0.2"
    注記
    Windows ユーザーの詳細は、「Windows サービスとして管理されるコンポーネント」 を参照してください --agent-preference。
  4. 各ストレージノードについて、ローカル rhq-storage-auth.conf ファイルを編集します。これにより、クラスター内のすべてのストレージノードのホスト名または IP アドレスが 1 行ごとに一覧表示されます。 
    [jsmith@server ~]# vim serverRoot/jon-server-3.3.2.GA/rhq-storage/conf/rhq-storage-auth.conf

192.168.0.1
192.168.0.2
192.168.0.3
    サーバーの設定後、ローカルエージェントはノードのホスト名または IP アドレスで rhq-storage-auth.conf ファイルを更新し、クラスターからデプロイされ、削除されます。
  5. 各ノードを起動します。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl start --storage
  6. サーバーをインストールする前に、rhq-server.properties ファイルを編集してストレージノードの接続情報を追加します。
    rhq.storage.nodes パラメーターに一覧表示されるカンマ区切りの各ストレージノードを追加します。次に、クライアントとゴシップポートの値を追加します。 
    [jsmith@server ~]# vim serverRoot/jon-server-3.3.2.GA/bin/rhq-server.properties

rhq.storage.nodes=192.168.0.1,192.168.0.2,192.168.0.3
rhq.storage.cql-port=9142
rhq.storage.gossip-port=7100
  7. rhq-server.properties ファイルにデータベース設定を指定します。
    ストレージノードを JBoss ON データベースに正しく登録するには、以下のデータベースプロパティーを設定する必要があります。
    • rhq.server.database.connection-url
    • rhq.server.database.user-name
    • rhq.server.database.password
    これらは、RHQ Server のインストール時に使用される設定と同じです。これらのパラメーターの説明は、を参照 「プロパティーファイルの属性」 してください。
  8. サーバーとエージェントをインストールします。--server および --agent オプションを指定すると、これら 2 つのコンポーネントのみがインストールされます。ストレージデータベースは除外されます。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl install --server --agent --start
    既存の JBoss ON エージェントをアップグレードする場合は、--use-remote-storage-node オプションを指定してアップグレードスクリプトを実行し、ストレージノードをインストールするのではなくプロパティーファイルからストレージデータベース情報をロードします。 
    [jsmith@server]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl upgrade --use-remote-storage-node=true
バグを報告します。

3.12. サーバーサービスの管理
リンクのコピー

3.12.1. サーバーおよび他のサービスの起動
リンクのコピー

インストール済みのサービス（サーバー、エージェント、およびストレージノード）をすべて起動する最も簡単な方法は、start コマンドでスクリプトを実行するだけです。 
[jsmith@server ~]$ serverRoot/bin/rhqctl start
Trying to start the RHQ Server...
RHQ Server (pid 27547) is starting
適切なオプション（、、、または --agent）を使用して--server --storage、個々のサービスを起動できます。 
[jsmith@server ~]$ serverRoot/bin/rhqctl start --server
The RHQ_JAVA_HOME サーバーを起動するには、Red Hat Enterprise Linux システムで環境変数を設定する必要があります。これは、のように一般的な値に設定でき /usr/ます。
注記
スクリプトではなく、rhqctl スクリプトを使用してサーバーを起動する必要があり rhq-server.sh ます。
サーバーにインストールされているエージェントは、rhqctl コマンドを使用して起動する必要があります。rhq-agent.sh スクリプトを使用して起動することはできません。
また、エージェントはユーザーの介入なしに起動する必要があります。エージェントを起動するのにパスワードが必要ないようにするには、この RHQ_AGENT_PASSWORD_PROMPT パラメーターを常にコメントアウトするか、false に設定する必要があります。
バグを報告します。

3.12.2. コンソールでサーバーを開く
リンクのコピー

サーバーが Windows または Linux のいずれかでサービスとして稼働している場合、バックグラウンドで実行されます。コントロールスクリプトを使用すると、コンソールウィンドウでサーバーを開くことができます。
  1. JBoss ON サーバーを停止します。 
    [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl stop
  2. console コマンドで rhqctl スクリプトを実行します。 
    [jsmith@server ~]$ serverRoot/jon-server-3.3.2.GA/bin/rhqctl console --server
バグを報告します。

第4章 JBoss ON サーバーおよびストレージノードのアップグレード
リンクのコピー

Red Hat JBoss Operations Network のアップグレード手順では、既存の設定およびデータベースで新しい JBoss ON パッケージおよびライブラリーをオーバーレイします。アップグレードの手順は、インストールプロセスと非常に似ています。新しいパッケージをインストールして、同じ設定スクリプトでサーバーを設定する必要があります。違いは、サーバーによって既存のデータベースとデータが再利用され、以前のインストールの設定が保持される点が挙げられます。
バグを報告します。

4.1. アップグレードに関する注意事項
リンクのコピー

  • アップグレード後に JBoss ON サーバーを以前のバージョンに戻すことはできません。アップグレードする前に、すべてのデータをバックアップします。
  • サーバーおよびエージェントをアップグレードする際に必要なダウンタイムにより、監視データの損失は最小限に抑えられます。さらに、サーバーがインベントリーに含まれている場合は、JBoss ON サーバーの監視データはすべて失われます。
  • JBoss ON エージェントをアップグレードする前に JBoss ON サーバーをアップグレードする必要があります。
  • エージェントがアップグレードされると、エージェントのディレクトリーにある .sh または .bat 拡張のあるファイルは、新しいエージェントの /bin ディレクトリーにコピーされ /bin ます。
  • JBoss ON サーバーのアップグレードは基本的に古いインスタンスに代わる新しいサーバーインスタンスを作成します。JBoss ON サーバーがインベントリーに追加されている場合、古い JBoss ON サーバーリソースがインベントリーから削除する必要があります。これは、アップグレード後に使用可能なリソースではないためです。アップグレードプロセスが完了したら、JBoss ON サーバーをインベントリーに再度追加し、そのリソースの以前の設定（アラート、スケジュールされた操作、グループメンバーシップなど）をすべて再設定する必要があります。
  • 高アベイラビリティークラウドにある JBoss ON サーバーはすべて、アップグレード時に停止する必要があります。それ以外の場合は、データベースへの接続を試みるとインストーラーがハングし、別の JBoss ON サーバーが使用中であるためデータベースが利用できない状態になります。
  • 以前のサーバーインストールには、新しいサーバーインストールはコピーしないでください。
  • Windows の場合Windows で JBoss ON サーバーをサービスとして設定する場合は、パスワードを設定せずに RHQ_SERVER_RUN_AS パラメーターを設定できました。JBoss ON 3.3 では、RHQ_SERVER_PASSWORD パラメーターに RHQ_SERVER_RUN_AS パラメーターが必要です。
  • Windows の場合JBoss ON を実行している Windows サービス上で Java 実装を 32 ビットから 64 ビットに更新する場合は、その Windows サービスをアンインストールおよび再インストールする必要があります。このプロセスの詳細は、の手順 2 および 3 を参照してください 「サーバーのアンインストール」。
バグを報告します。

4.2. アップグレードスクリプトについて
リンクのコピー

インストール(「rhqctl スクリプトについて」)と同様に、この rhqctl スクリプトはサーバー移行の管理に使用されます。アップグレードコマンド（install コマンドなど）は、サーバーシステム上の 3 つの管理コンポーネントをすべて処理します。
  • JBoss ON サーバーをアップグレードします。
  • JBoss ON サーバーと同じシステムで JBoss ON エージェントを アップグレードします。[1]
  • JBoss ON のストレージノードをアップグレードします。3.1（またはそれ以前の）デプロイメントからアップグレードすると、アップグレードプロセスによりストレージノードがインストールされます。
アップグレードスクリプトには、サーバーおよびエージェントディレクトリーの元の場所が必要です。

JBoss ON のアップグレードオプション

--list-versions
トポロジーにインストールされているサーバーおよびストレージノードのバージョンを出力します。これは、新たにインストールまたはアップグレード済みの JBoss ON 3.3 サーバーから実行する必要があります。これは、スタンドアロンストレージノードから実行できず、サーバーのみから実行することはできません。
注記
このオプションを使用すると、他のオプションは無視されます。
--from-server-dir directory
アップグレードするサーバーへのディレクトリーパスを指定します。
--from-agent-dir directory
--from-server-dirs> のサーバーインストールディレクトリーへの相対パスを指定します。デフォルトの場所はです serverRoot/jon-server-3.3.2.GA/rhq-agent/。
注記
エージェントがカスタムの場所にインストールされた場合にのみ必要です。
--storage-data-root-dir directory
デフォルト以外のディレクトリーを使用する場合は、ストレージノードに使用する場所を指定します（デフォルトではアップグレードの一部としてインストールされます）。これは、などの JBoss ON ユーザーがデフォルトのディレクトリーに書き込みできない場合に便利です /var/lib。
注記
3.1 以前のサーバーのアップグレード
--storage-schema
ストレージクラスタースキーマを更新します。これは、すべてのストレージノードおよびサーバーがアップグレードされ、実行された後に行われます。これは、新たにインストールまたはアップグレード済みの JBoss ON 3.3 サーバーから実行する必要があります。これは、スタンドアロンストレージノードから実行できず、サーバーのみから実行することはできません。
スキーマ更新の実行時間は、スキーマの変更により異なるため、中断しないようにしてください。
注記
このオプションを使用すると、他のオプションは無視されます。
--use-remote-storage-node [true | false]
ローカルストレージノードまたは別のシステム上のノードを使用するかどうかを設定します。デフォルトでは、ストレージノードとサーバーは同じシステム上にあります。このオプションがに設定されている場合 true、サーバー設定を使用してリモートストレージノードの接続情報を特定します。
スキーマ更新の実行時間は、スキーマの変更により異なるため、中断しないようにしてください。
注記
このオプションを使用すると、他のオプションは無視されます。
バグを報告します。

[1] JAR ファイルからインストールされたエージェントは、サーバーによって自動的にアップグレードされます。RPM でインストールしたエージェントは、新しいパッケージで rpm -Uvh コマンドを使用して更新できます。

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 サーバーをインベントリーのリソースとして追加します。
バグを報告します。

4.4. 3.2 サーバー、ストレージノード、およびサーバープラグインのアップグレード
リンクのコピー

これらのアップグレード手順の一部は、Red Hat JBoss Operations Network のすべてのインストールには適用されません。各手順を実行して、特定のデプロイメントに必要なステップを実行します。

手順4.1 アップグレードに向けて現在のインストールの準備

  1. サーバー マシンで実行している JBoss ON エージェントを停止します。 
    [jsmith@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl stop --agent
    サーバーとインストールされたエージェントは JBoss ON サーバーで更新する必要があります。サーバーがアップグレードされると、その他すべてのエージェントが自動的に更新されます。
  2. 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* パラメーターはアップグレード前に削除できます。
  3. JBoss ON インベントリーをクリーンアップします。移行の前に設定を簡単にクリーンアップすることは、移行後よりも簡単です。
    • インベントリーから未使用またはサービス外のプラットフォームを削除します。
    • 古い JBoss ON サーバーが JBoss ON インベントリーに追加されている場合は、削除します。
      古い JBoss ON サーバーは使用可能なリソースではないため、インベントリーから削除する必要があります。
  4. すべてのサーバーおよびストレージノードを停止します。
    アップグレード中の JBoss ON サーバー と、現在クラウドで稼働し ている JBoss ON インスタンスを停止します。
    重要
    アップグレードされた JBoss ON サーバーが既存の JBoss ON インスタンスも使用しているデータベースを使用する場合は、既存の JBoss ON インスタンスをすべて停止する必要があります。それ以外の場合は、データベースへの接続を試みるとインストーラーがハングし、別の JBoss ON サーバーが使用中であるためデータベースが利用できない状態になります。 
    [jsmith@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl stop
  5. アップグレードスクリプトを実行する前に、サーバーデータベースと関連 rhq-data ディレクトリーをバックアップします。
    アップグレードプロセスで問題が発生した場合、これらのバックアップでは JBoss ON を以前の状態に復元できます。
    警告
    アップグレード後に JBoss ON サーバーを以前のバージョンに戻すことはできません。
    • データベースのバックアップを作成します。
    • 各 rhq-storage ノードの rhq-data ディレクトリーをバックアップします。
    JBoss ON インストールのこれらの部分をバックアップすると、以前の環境に復元できます。

手順4.2 各スタンドアロンストレージノードのアップグレード

サーバーをアップグレードする前に、各スタンドアロンストレージノードをアップグレードします。
  1. ストレージノードおよびエージェントのすべての 3.2 プロセスを停止します。 
    [jsmith@server ~]# serverRoot/jon-server-3.2.0.GA/bin/rhqctl stop
  2. サーバーパッケージの展開 
    [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ます。
  3. すべての Database プロパティーが serverRoot /jon-server-3.2.0.GA/bin/rhq-server.properties に正しく設定されていることを確認します。必要な 「プロパティーファイルの属性」 データベースプロパティーはを参照してください。
  4. アップグレードスクリプトを実行します。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl upgrade --from-server-dir serverRoot/jon-server-3.2.0.GA
    注記
    ストレージノードが同じシステムにある場合、そのストレージノードで JBoss ON サーバーにアップグレード upgrade されます。スタンドアロン（JBoss ON サーバーと共存しないストレージノード）には、個別のアップグレードが必要です。

手順4.3 各サーバーをアップグレード

  1. rhq-server.sh または rhq-server-wrapper.conf ファイルをカスタマイズした場合は、これらのファイルをバックアップします。これらのファイルに加えられた変更は、アップグレードスクリプトの実行後に手動で再適用する必要があります。
  2. upgrade サブコマンドで rhqctl スクリプトを実行します。例： 
    [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
    移行するサーバーを特定するには、--from-server-dir オプションが必要です。
  3. アップグレード前のサーバーのコピーに対してアップグレードされた rhq-server.properties ファイルをチェックして、編集が適切にマージされたことを確認します。アップグレードプロセスのこのステップで、古いプロパティーファイルが新しいプロパティーファイルに適切にコピーされたことを確認することが推奨されます。
  4. rhq-server.sh または rhq-server-wrapper.conf ファイルをカスタマイズした場合は、変更を再適用します。
  5. 次のステップに進む前に、プラグインパックを個別にダウンロードして展開します。
    特定のニーズに対応するプラグインパック（他のレイヤード Red Hat JBoss Middleware 製品のサポート管理タスクなど）は、コア JBoss ON パッケージとは別のインストールに利用できます。
    エージェントプラグインパック 「基本設定： Microsoft Windows へのサーバーのインストール」 のダウンロード手順は、「基本設定： Linux へのサーバーのインストール」 またはを参照してください。
    各プラグインパックには少なくとも 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

手順4.4 ストレージクラスタースキーマの更新

  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

手順4.5 自動更新用に設定されていない各エージェントのアップグレード

  1. をクリック 「JBoss ON エージェントの手動アップグレード」 し、指示に従って各エージェントをアップグレードします。
  2. エージェントのアップグレード手順が完了したら、この手順に戻ります。

手順4.6 アップグレードしたインストールの開始

  1. サーバー、エージェント、およびストレージノードを起動します。 
    [jsmith@server ~]# serverRoot/jon-server-3.3.2.GA/bin/rhqctl start
  2. オプション。新しい JBoss ON サーバーをインベントリーのリソースとして追加します。
バグを報告します。

4.5. サーバーの再インストール
リンクのコピー

JBoss ON サーバーの初期設定時に、フラグのセットが、アップグレードではなく初期設定であることを rhq-server.properties 示します(rhq.autoinstaller.*)。初期設定が完了したら、自動インストーラーが無効になります（で rhq.autoinstaller.* プロパティーを設定してもサーバー設定を再開始し rhq-server.properties ません）。
サーバーを再インストールするには、サーバーのホームディレクトリー全体を削除し、元の JBoss ON サーバーアーカイブを展開し、サーバーがすべて新しいかのように設定し 「基本設定： Linux へのサーバーのインストール」 ます。
バグを報告します。

第5章 JBoss ON サーバーのアンインストール
リンクのコピー

Red Hat JBoss Operations Network サーバーとエージェントの両方がアーカイブファイルを抽出するため、サーバーまたはエージェントを削除すると、最終的にこれらのファイルが削除されます。
バグを報告します。

5.1. 管理システムでのエージェントのアンインストール
リンクのコピー

5.1.1. Linux(JAR)上のエージェントの削除
リンクのコピー

注記
この手順では、スタンドアロンエージェントを削除します。JBoss ON サーバーまたはストレージノードでエージェントがインストールされている場合は、rhqctl スクリプトを使用して停止および削除します。
  1. エージェントを停止します。
  2. JBoss ON トポロジーからエージェントを削除します。
    1. JBoss ON UI で、トップメニューの Administration タブをクリックします。
    2. 左側のメニューの Topology セクションで Agents 項目を選択します。
    3. インストール済みエージェントの一覧で、削除するエージェントの行を選択します。
    4. ページ下部の Delete ボタンをクリックします。
    5. エージェントを削除する必要があることを確認します。
  3. 管理システムで、エージェントのインストールディレクトリーを削除します。
バグを報告します。

5.1.2. エージェント RPM の削除
リンクのコピー

  1. エージェントサービスを停止します。 
    [jsmith@server ~]# service jon-agent stop
  2. JBoss ON トポロジーからエージェントを削除します。
    1. JBoss ON UI で、トップメニューの Administration タブをクリックします。
    2. 左側のメニューの Topology セクションで Agents 項目を選択します。
    3. インストール済みエージェントの一覧で、削除するエージェントの行を選択します。
    4. ページ下部の Delete ボタンをクリックします。
    5. エージェントを削除する必要があることを確認します。
  3. パッケージがを使用してインストールされている場合は yum、を使用 yum してパッケージを削除します。 
    [jsmith@server ~]# yum remove jboss-on-agent jboss-on-agent-init
    RPM パッケージがを使用してインストールされている場合は rpm、rpm以下を使用してアンインストールします。 
    [jsmith@server ~]# rpm -e jboss-on-agent-3.3.2.GA jboss-on-agent-init-3.3.2.GA
バグを報告します。

5.1.3. Windows でのエージェントの削除
リンクのコピー

注記
この手順では、スタンドアロンエージェントを削除します。JBoss ON サーバーまたはストレージノードでエージェントがインストールされている場合は、rhqctl スクリプトを使用して停止および削除します。
  1. エージェントを停止します。
  2. JBoss ON トポロジーからエージェントを削除します。
    1. JBoss ON UI で、トップメニューの Administration タブをクリックします。
    2. 左側のメニューの Topology セクションで Agents 項目を選択します。
    3. インストール済みエージェントの一覧で、削除するエージェントの行を選択します。
    4. ページ下部の Delete ボタンをクリックします。
    5. エージェントを削除する必要があることを確認します。
  3. エージェントが Windows サービスとして設定されている場合は、これをサービスとして削除します。 
    > rhq-agent.bat remove
  4. エージェントのインストールディレクトリーを削除します。
バグを報告します。

5.2. サーバーのアンインストール
リンクのコピー

サーバーを削除すると、データベースとその情報がそのまま残されるので、履歴データはデータベース自体から直接入手できます。
  1. これが唯一の JBoss ON サーバーであれば、すべてのエージェントを停止します。トポロジーに他の JBoss ON サーバーがある場合、このサーバーによって管理されるエージェントが、高可用性トポロジーの他のサーバーに移行されます。
  2. サーバーを停止します。 
    > serverRoot/jon-server-3.3.2.GA/bin/rhqctl stop
  3. サーバーが Windows サービスとして設定されている場合は、これをサービスとして削除します。 
    > C:\rhq\jon-server-3.3.2.GA\bin\rhqctl.bat remove
  4. サーバーのインストールディレクトリーを削除します。
バグを報告します。
Red Hat Enterprise Linux、Windows、Solaris、AIX、および他の *nix ディストリビューションに Red Hat JBoss Operations Network エージェントをインストールするjar ファイルは、JBoss ON サーバーからダウンロードできます。
重要
これは、JBoss ON によって管理されるプラットフォームにエージェントをインストールします。このシステムが JBoss ON サーバーをホストする場合は、の説明に従って、サーバーのインストールプロセスの一部としてエージェントをインストールし 3章JBoss ON Server のインストール ます。
バグを報告します。

6.1. エージェントのインストール前
リンクのコピー

6.1.1. 親ディレクトリーパーミッションの確認
リンクのコピー

更新プロセス中、ファイルはエージェントが現在インストールされているディレクトリーに書き込まれます。つまり、エージェントのインストールディレクトリーの親ディレクトリーは、エージェントを実行しているユーザーが書き込み可能である必要があります。
たとえば、エージェントの rhq-agent-env.sh ファイルがを $RHQ_AGENT_HOME として指定する場合 /opt/rhq-agent-parent/rhq-agent、エージェントにはその /opt/rhq-agent-parent ディレクトリーに対する書き込み権限が必要です。
バグを報告します。

6.1.2. （任意手順）: JBoss ON エージェントの JRE の設定
リンクのコピー

この手順は、以下の場合にのみ必要です。
  • デフォルトの Java JRE は JBoss ON エージェントと互換性がありません。
  • オーバーライドする必要があります。 JAVA_HOME 使用環境パラメーター RHQ_JAVA_HOME,
  • The JAVA_HOME 環境変数が正しくないか、設定されていません。
JBoss ON エージェントには Java 6 または Java 7 JRE が必要です。
  1. 必要に応じて、適切なバージョンの JRE をダウンロードし、インストールします。
  2. を設定します。 RHQ_JAVA_HOME インストールディレクトリーへの環境変数。
    1. rhq-agent-env.sh|.bat JBoss ON Agent インストールを開きます。例： 
      vim JBossON-Agent-install-location/bin/rhq-agent-env.sh
    2. uncomment RHQ_JAVA_HOME 必要に応じて編集します。
バグを報告します。

6.1.3. Java パスの設定
リンクのコピー

エージェントでは、Java ホームディレクトリーへのパスが環境変数として明示的に設定される必要があります。
バグを報告します。

6.1.4. エージェントシステムユーザーの選択
リンクのコピー

エージェントをインストールする前に、エージェントの実行に使用するシステムユーザーおよびグループを計画します。指定のユーザーは、リソースの検出方法や、管理用に設定する方法に影響を及ぼす可能性があります。
JBoss ON が管理するサーバーの一般的なタイプは以下のとおりです。
  • JBoss EAP サーバー
  • PostgreSQL データベース
  • Tomcat サーバー
  • Apache サーバー
  • 汎用 JVM
エージェントがリソースを検出できるようにするには、エージェントがそのリソースの設定への読み取りアクセスを持つ必要があります。リソースタイプによっては、読み取りアクセス以外のリソースタイプが必要になる場合があります。JBoss EAP 5 リソースの場合、エージェントにはファイルの読み取り権限と、run.jar ファイルへのパスにあるすべてのディレクトリーに対する実行および検索のパーミッションが必要です run.jar。
一部のリソースタイプでは、読み取りアクセスや root アクセスでは不十分な場合があります。Tomcat サーバーは、JBoss ON エージェントと Tomcat サーバーが同じユーザーとして稼働している場合にのみ検出できます。アタッチ API を使用する JVM サーバーおよび JMX サーバーも同様です。
エージェントが実行しているシステムユーザーは、いくつかの一般的なエージェントタスクに影響します。
  • 検出
  • アプリケーションのデプロイ
  • スクリプトの実行
  • 起動、停止、および再起動の操作の実行
  • JBoss ON UI を使用した子リソースの作成
  • リソース設定の表示および編集
通常、エージェントは管理リソースと同じユーザーとして実行され、リソースを効果的に管理するための最も簡単なオプションです。
重要
JBoss ON エージェントを root ユーザーとして実行でき、簡単なコンテキストの一部では、エージェントを設定する前に root でサービスを実行するセキュリティー上の影響を考慮してください。
通常、サービスは 操作の実行に必要な最小限のアクセス権限で実行する必要が あります。これは、サービスが侵害された場合に、そのアクセスパーミッションを攻撃者が悪用するためです。
『 Red Hat Enterprise Linux セキュリティー 『ガイド』』 には、セキュリティーガイドラインとセキュリティープランニングドキュメントへのリンクが記載されています。Windows ドキュメントには、同様の推奨事項があります。
エージェントインストーラーの JAR ファイルから JBoss ON エージェントをインストールする場合、エージェントのインストールファイルを所有するシステムユーザーとグループは JAR をインストールしたユーザーと同じです。したがって、特別なシステムユーザーを作成または選択でき、そのユーザーがエージェントをインストールできます。
エージェントとリソースを異なるユーザーとして実行し、エージェントがリソースユーザーとして一部のアクションを実行する必要がある場合は、実行すべき設定に応じていくつかの設定オプションがあります。
  • を使用して、実行するスクリプトまたは操作を設定し sudoます。サービスやプロセスの開始などの長期実行される操作では、スクリプトを実行するユーザーは適切な承認とパーミッションを持つため、リソースユーザーと同じである必要があります。
  • リソースのプリンシパルおよび認証情報（ある場合）を使用するように、start スクリプト環境変数を設定します。
  • JVM サーバーまたは JMX サーバーの場合。ユーザー設定に基づいて接続設定を選択します。異なるユーザーには、JMX リモーティングを使用します。同じユーザーに対して、JMX リモーティングまたはアタッチ API を使用します。
Expand
表6.1 Agent and Resource Users のスプレッドシート
resource ユーザー情報
PostgreSQL 監視および検出には影響しません。設定の表示および編集には、エージェントユーザーに PostgreSQL 設定ファイルへの読み取り/書き込み権限が必要です。
apache 監視および検出には影響しません。設定の表示および編集には、エージェントユーザーに Apache 設定ファイルへの読み取り/書き込み権限が必要です。
Tomcat 同じユーザーを使用する必要があります。そうでない場合、検出できません。
JMX サーバーまたは JVM JMX リモーティングを使用する場合は、ユーザーごとに問題ありません。異なるユーザーやアタッチ API では検出できません。
JBoss AS/EAP ユーザーはすべて問題ありませんが、run.jar で読み取り権限が必要で、run.jar のすべての先祖ディレクトリーに対して実行および検索パーミッションが必要になります。
バグを報告します。

6.2. JAR ファイルからのエージェントのインストール
リンクのコピー

  1. ブラウザーで、サーバー上のダウンロード URL を示します。例： 
    http://server.example.com:7080/agentupdate/download
    エージェントをインストールするディレクトリー .jar に、エージェントバイナリーの更新を保存します。保存するファイルには .jar 拡張子があるはずです。
  2. JBoss ON サーバーからダウンロード .jar したエージェント更新バイナリーをディレクトリーにコピーします。
  3. JAR をインストールします。 
    java -jar downloaded_agent_jar_file.jar --install
    これにより、エージェント更新バイナリーに、JBoss ON エージェントディストリビューションを展開し、rhq-agent サブディレクトリーに新しいコピーをインストールするように指示されます。
    重要
    名前にスペースがあるディレクトリーにエージェントをインストールしないでください C:\Program Files。
    pathname に空白のディレクトリーにエージェントをインストールすると、エージェントが特定のタイプのリソース（一部の JBoss サービスを含む）への接続を確立する際に問題が生じる可能性があります。
  4. エージェントの環境変数として JRE へのパスを設定します。エージェントでは、Java ホームディレクトリーが設定で明示的に設定されている必要があります。
    agentRoot/rhq-agent/bin/rhq-agent-env.sh ファイルを開き、アンコメントを解除するか、RHQ_JAVA_HOME 変数の行を追加します。 
    export RHQ_JAVA_HOME=/usr
  5. エージェントを起動して、設定プロセスを開始します。 
    agentRoot/rhq-agent/bin/rhq-agent.sh
    注記
    設定をすべて一度に送信して、設定ウィザードをスキップすること 「エージェントのサイレントインストール」 ができます。には、設定をエージェントインストーラーに直接渡すことのできるファイルの設定の詳細が記載されています。
  6. プロンプトが表示されたら、エージェントとサーバー接続の情報を入力します。 
    [Agent Name] agentdomain.example.com
[Agent Hostname or IP Address] agentdomain.example.com
[Agent Port] 16163
[JON Server Hostname or IP Address] server.example.com
[JON Server Port] 7080
native enable
    • エージェント名は、JBoss ON デプロイメントのすべてのエージェント間で一意でなければなりません。デフォルトでは、名前はホストマシンの完全修飾ドメイン名です。
    • ポートは、エージェントがサーバーから受信メッセージをリッスンするのに使用するものです。これは、デフォルト値が使用されていない場合 rhq.agent.server.bind-port に設定ファイル内にあります。
    • サーバーのホスト名とポートは、JBoss ON システムに登録するためにエージェントによって使用されます。これは、登録後にエージェントが使用する必ずしもプライマリーサーバーとは限りません。設定ファイルでは、はとに rhq.agent.server.bind-address なります。 rhq.agent.server.bind-port
    高度な設定オプションなど、パラメーターの完全な一覧をに記載されてい 表6.2「詳細設定で使用可能なすべてのオプション」 ます。
  7. の説明に従って、エージェントをバックグラウンドサービスとして設定し 「JBoss ON Agent をサービスとして実行」 ます。
エージェントが設定されると、Java Preferences バッキングストアでその設定が永続化されます。これが発生すると、agent-configuration.xml 不要となったり、使用されるようになりました。エージェントを再起動しても、編集してもエージェント agent-configuration.xml は影響を受けなくなります。agent-configuration.xml ファイルへの変更を取得するには、コマンドラインオプションでエージェントを再起動するか、config --import agent prompt --cleanconfig コマンドで設定を再読み込みする必要があります。
重要
エージェントがサーバーへの登録に失敗し、メッセージを出力した後にハングしていると思われます 。エージェントにプラグインがない場合、ダウンロード後またはプロパティーが設定されていないのを待機 します。そうでない場合は、エージェントログファイルでエラーメッセージ(agentInstallDir)/logs/agent.logを確認してください。
通常、エージェントが解決できない、または JBoss ON サーバーからアクセスできない IP アドレスまたはホスト名にバインドしたときに問題が発生します。
同様に、JBoss ON サーバーのパブリックエンドポイントアドレスがすべて JBoss ON エージェントによって解決可能であることを確認してください。エージェントが登録するために入力された JBoss ON サーバーは、エージェントがプライマリーサーバーとして使用するものとは異なる場合があります。高可用性の設定により異なります。エージェントがそのサーバーに接続できない場合は、正しく起動できません。
Expand
表6.2 詳細設定で使用可能なすべてのオプション
設定オプション description 通常の設定または高度な設定
エージェントのホスト名または IP アドレス サーバーからメッセージをリッスンするバインドするアドレス。これは通常、JBoss ON サーバーがエージェントへの接続に使用するアドレスと同じです。ネットワーク環境によりアドレスが異なる場合、トランスポートパラメーターを設定してアドレスを解決する必要があります。 normal
エージェントポート エージェントがリッスンするポート番号。IP アドレスと同様に、これは、エージェントへの接続に使用するサーバーに設定したポートと同じですが、ネットワーク環境によりこれらのポートが異なる場合は、トランスポートパラメーターを設定してポートを解決する必要があります。 normal
エージェント転送プロトコル エージェントがサーバーから受信メッセージの受信に使用することが予想されるプロトコルを設定します。これは通常、ソケットまたは sslsocket です。 Advanced
エージェント転送のパラメーター agent-server 接続のリモーティングフレームワークによって使用されるロケーター（URL 形式のアドレス）の最後に追加するトランスポートパラメーターを設定します。 Advanced
RHQ サーバーのホスト名または IP アドレス エージェントが通信するプライマリーサーバーの IP アドレスまたはホスト名を指定します。この情報は、JBoss ON サーバー設定で設定されたホスト名または IP アドレスと同じである 必要 があります。 normal
RHQ サーバーポート エージェントが通信するプライマリーサーバーのポート番号を指定します。この情報は、JBoss ON サーバー設定で設定されたポート番号と同じである 必要 があります。 normal
RHQ サーバートランスポートプロトコル エージェントが JBoss ON サーバーへの送信メッセージに使用するトランスポートプロトコルを設定します。この情報は、サーバーが設定設定で想定されるように設定されたトランスポートメソッドと同じである 必要 があります。 Advanced
RHQ サーバートランスポートパラメーター エージェントがプライマリー JBoss ON サーバーに接続するときに使用する追加のトランスポートパラメーターを指定します。これはサーバーへの接続に使用されるため、これらのパラメーターは JBoss ON サーバー設定で設定されたトランスポートパラメーターと同じである 必要 があります。これらの設定は、JBoss ON サーバーが実際にバインドするものとは異なるホストまたはポートに接続する必要がある場合に特に重要になります。 Advanced
バグを報告します。

6.3. エージェントのサイレントインストール
リンクのコピー

すべてのエージェント設定が agent-configuration.xml ファイルに書き込まれ、ロードされます。インストール時に、事前定義されたパラメーターや、環境固有で提供する必要のあるパラメーターがいくつかあります。エージェントの設定では、この環境またはインスタンス固有の情報を要求します。
ただし、エージェントを初めて実行する前に、必要な情報を提供することが可能です。必要な情報がすべて提供されるため、エージェントはその情報を要求せず、単に起動します。
  1. agent-configuration.xml ファイルを作業ディレクトリーにコピーします。例： 
    [jsmith@server ~]$ cp agentRoot/rhq-agent/conf/agent-configuration.xml /tmp/files/
  2. （必要な場合）コメントを解除し、希望するエージェントパラメーターを編集します。
    エージェントパラメーター（SSL 接続およびその他の高度な設定など）は、で定義でき agent-configuration.xmlます。少なくとも、エージェントとサーバーのエントリーキー 表6.3「エージェントセットアップ用の設定ファイルキー」 をファイルに設定する必要があります。 
    [jsmith@server ~]$ vim /tmp/files/agent-configuration.xml

...
<!-- agent properties -->
<entry key="rhq.agent.name" value="agent.example.com"/>
<entry key="rhq.communications.connector.bind-address"     value="255.255.255.1" />
<entry key="rhq.communications.connector.bind-port"        value="16163" />

<!-- server properties -->
<entry key="rhq.agent.server.bind-address"     value="255.255.255.0" />
<entry key="rhq.agent.server.bind-port"        value="7080" />
<entry key="rhq.agent.disable-native-system" value="false"/>
...
  3. エージェントが初期設定としてロードする true ように rhq.agent.configuration-setup-flag キーを設定します。 
    <entry key="rhq.agent.configuration-setup-flag" value="true" />
  4. --config option> で編集した設定ファイルを指定して、エージェントを起動します。 
    [jbossadmin@server !]$ agentRoot/rhq-agent/bin/rhq-agent.sh --config /tmp/files/agent-configuration.xml
Expand
表6.3 エージェントセットアップ用の設定ファイルキー
インストーラーのプロンプトテキスト キー名 description
  rhq.agent.configuration-setup-flag エージェント設定がすでに設定ファイルにあることをインストーラーに指示します。これは、インストーラーが設定ファイルを読み込む true ために設定する必要があります。
[agent Name] rhq.agent.name サーバーにエージェントを識別する一意の名前を指定します。
[agent Hostname or IP アドレス] rhq.communications.connector.bind-address サーバーがエージェントへの接続に使用するホスト名または IP アドレスを指定します。この <entry> 行は、設定する前にコメント解除しなければならない場合があります。
[agent Port] rhq.communications.connector.bind-port エージェントとの通信に使用するサーバーのポートを指定します。ほとんどの場合、デフォルト(16163)を使用できます。
[RHQ Server Hostname or IP Address] rhq.agent.server.bind-address エージェントがそれ自体を登録するためにサーバーに接続するために使用するホスト名または IP アドレスを指定します。これがホスト名の場合には、エージェントが解決できる必要があります。
[RHQ Server Port] rhq.agent.server.bind-port サーバーとの通信に使用するエージェントのポートを指定します。サーバーがデフォルト値で設定されている場合は、デフォルト値(7080)を使用できます。
ネイティブ rhq.agent.disable-native-system エージェントが使用する JNI ライブラリーを有効にします。これにより、エージェントは、システムネイティブライブラリーを使用して、一部のタイプのリソースを検出および管理できるようになります。
バグを報告します。

6.4. JBoss ON Agent をサービスとして実行
リンクのコピー

ほぼすべての実稼働環境では、エージェントはバックグラウンドデーモンプロセスとして起動する必要があります。Windows では、これはサービスとして実行されます。Linux および Unix システムでは、エージェントは init.d から起動時に起動します。
エージェントサーバーラッパースクリプトの編集およびエージェントデーモンの管理に関する詳細は、『 『管理および設定ガイド』』 を参照してください。
バグを報告します。

6.4.1. エージェントを Windows サービスとして実行
リンクのコピー

  1. エージェントが完全にセットアップされていることを確認します。エージェントは、サービスとして起動する際に設定を求めるプロンプトを出しません。
  2. rhq-agent-env.bat スクリプトを編集し、init スクリプトが実行されるようにシステムユーザーを定義する環境変数を設定します。以下の 2 つのオプションがあります。
    • RHQ_AGENT_RUN_AS ユーザーアカウント名を明示的に設定します。これは、Windows ユーザーアカウント名 DOMAIN\username の形式と一致する必要があります。
    • RHQ_AGENT_RUN_AS_ME エージェントを現在のユーザーとして実行するように強制し ます。\ %USERNAME % 形式を使用します。両方の環境変数が定義されている場合、この変数は上書きされます。 RHQ_AGENT_RUN_AS.
    注記
    設定前 RHQ_AGENT_RUN_AS_ME または RHQ_AGENT_RUN_AS指定のユーザーに、サービスを開始するパーミッションがあることを確認します。必要に応じて、適切な権限をユーザーに割り当てます。割り当て権限は、Windows ドキュメントで説明されています。
    変数が設定されていない場合、エージェント init スクリプトはローカルシステムアカウント（Default または .\LocalSystem）として実行されます。
    その他の利用可能な環境変数は、rhq-agent-wrapper.bat スクリプトのコメントに一覧表示され、定義されます。
  3. rhq-agent-wrapper.bat スクリプトを実行して init スクリプトをサービスとしてインストールします。install コマンドを使用して init スクリプトをインストールします。
  4. プロンプトが表示されたら、サービスが実行されるシステムユーザーのパスワードを入力します。
バグを報告します。

6.4.2. エージェントをデーモンまたは init.d サービスとして実行
リンクのコピー

  1. エージェントが完全にセットアップされていることを確認します。エージェントは、サービスとして起動する際に設定を求めるプロンプトを出しません。
  2. rhq-agent-env.sh ファイルを開きます。
  3. エージェントのディレクトリー、JDK ディレクトリー、および PID bin ディレクトリーに必要な環境変数のコメントを解除し、設定します（エージェントユーザーが書き込み可能でなければなりません）。 
    RHQ_AGENT_HOME=agentRoot/rhq-agent/
export RHQ_JAVA_HOME=/usr
RHQ_AGENT_PIDFILE_DIR=/var/run
    注記
    の設定時 RHQ_AGENT_PIDFILE_DIR Red Hat Enterprise Linux で、rhq-agent-wrapper.sh スクリプトファイルの pidfile 設定を編集します。ラッパースクリプトの値はにより使用され chkconfigます。
  4. オプションの環境変数のいずれかを設定します。
    • RHQ_AGENT_DEBUG デバッグロギングを有効にします。
    • RHQ_AGENT_JAVA_EXE_FILE_PATH Java 実行ファイルを指定します。
    • RHQ_AGENT_JAVA_OPTS 設定をエージェント JVM に渡します。
    • RHQ_AGENT_ADDITIONAL_JAVA_OPTS 追加の Java オプションを JVM に渡します。
  5. オプション。にあるように、カスタム start コマンドを設定し 「カスタムコマンドを使用したエージェントの起動」 ます。
  6. root でシステムにログインします。
    重要
    残りの手順では、Red Hat Enterprise Linux でエージェント init スクリプトをサービスとして設定する方法を説明します。その他の Unix システムについては、特定のプラットフォームに対応する同様の手順に従います。
  7. ラッパースクリプトが実行可能であることを確認します。 
    [jsmith@server rhq-agent]$ chmod a+x agentRoot/rhq-agent/bin/rhq-agent-wrapper.sh
  8. rhq-agent-wrapper.sh ファイルのシンボリックリンクです /etc/init.d/。例： 
    [jsmith@server rhq-agent]$ ln -s agentRoot/rhq-agent/bin/rhq-agent-wrapper.sh /etc/init.d/rhq-agent-wrapper.sh
    重要
    Solaris では、エージェントスクリプトファイルのシンボリックリンクでは、起動が必要 rhq-agent-wrapper.shです。一部の Solaris インストール readlink で readlink は、デフォルトでは提供されません。Solaris ユーザーは、Sunfreeware などのソース readlink からダウンロードする必要があります。
  9. rhq-agent-wrapper.sh に登録し chkconfigます。 
    [root@server rhq-agent] # /sbin/chkconfig --add rhq-agent-wrapper.sh
  10. システムの起動時にエージェントサービスを実行でき、システムのシャットダウン時に正常に停止できるようにします。 
    [root@server rhq-agent] # /sbin/chkconfig rhq-agent-wrapper.sh on
システムの起動時にエージェントサービスを起動しない場合は、スクリプトをオフに chkconfigします。 
[root@server rhq-agent] # /sbin/chkconfig rhq-agent-wrapper.sh off
バグを報告します。

6.4.3. カスタムコマンドを使用したエージェントの起動
リンクのコピー

エージェントをサービスとして実行するように設定すると 「エージェントをデーモンまたは init.d サービスとして実行」、エージェントはカスタム start コマンドで開始するように設定できます。これは主に sudo、su またはを使用してエージェントを起動し、エージェントを別のユーザーとして実行できるようにするために使用されます。
start コマンドは、rhq-agent-env.sh ファイルの他のエージェントプロパティーで定義されます。設定には、start コマンド自体とパスワードプロンプトを有効にする設定の 2 つの部分があります。 
RHQ_AGENT_START_COMMAND="su -m test -c '${RHQ_AGENT_HOME}/bin/rhq-agent.sh'"
RHQ_AGENT_PASSWORD_PROMPT=true
start コマンドを設定すると、エージェントを起動するためにコマンドラインで渡されるコマンドが上書きされます。
パスワードプロンプトは必要ありません。設定は sudo、およびエージェントのユーザー設定によって異なります。必要な場合は、ユーザーがパスワードを入力するか、またはパスワードを RHQ_AGENT_PASSWORD パラメーターに設定できるようにパスワードプロンプトを有効にする必要があります。それ以外の場合は、開始プロセスがハングします。
定義した start コマンドが無効な場合、エージェントは起動できません。コマンドのフォーマットに加えて、ディレクトリー名は影響を受けます。名前にスペースや特殊文字がある場合は、コマンドの実行をエスケープする必要があります。
バグを報告します。

6.5. エージェント接続設定の変更
リンクのコピー

エージェント設定には、2 つの部分があります。
  • エージェントインスタンスとサーバーとの通信方法を定義するエージェント接続プロパティー。
  • エージェントのパフォーマンスとオプションを管理するエージェント JVM プロパティー
エージェントの接続プロパティーは、エージェントのインストール時に定義されます。これには、接続先のサーバー、ポート番号、および SSL 接続を使用するサーバーなどの情報が含まれます。
そのエージェント接続設定は、最初に起動時にセットアッププロンプトで入力 agent-configuration.xml した値が、最初に読み取られて上書きされます。エージェントの初期設定後、エージェントはその設定を永続化し、agent-configuration.xml 再度参照しません。その情報を変更するには、エージェント接続情報を削除してリセットする必要があります。
接続設定を変更する場合は、オプションを使用し --cleanconfig、設定ウィザードで再度実行します。 
agentRoot/rhq-agent/bin/rhq-agent.sh --cleanconfig
ほとんどの JVM およびオプションの設定（永続的な設定）は、エージェントが起動するたびに読み込まれる、のような rhq-agent-env.sh ファイルで行われ setconfigます。
バグを報告します。

6.6. エージェントの自動更新
リンクのコピー

エージェントの自動アップグレードであっても、アップグレードプロセスがスムーズに実行され、エージェントが正常に再起動するように JBoss ON エージェントに特定の準備を行う必要があります。
バグを報告します。

6.6.1. エージェントの自動アップグレード時のプロセス
リンクのコピー

デフォルトでは、JBoss ON サーバーおよびエージェントはエージェントを自動的にアップグレードするように設定されます。JBoss ON サーバーがアップグレードされるとすぐにエージェントがアップグレードされます。
注記
の説明に従って、エージェントをバックグラウンドで正しくアップグレードする必要があり 「JBoss ON Agent をサービスとして実行」 ます。
自動アップグレードプロセスは、サーバーの更新を確認する通常のエージェントタスクの一部です。
  1. 更新されたサーバーは、更新されたエージェントパッケージをエージェントがアクセスできるディレクトリーに配置します。
  2. サーバーは、サーバーがエージェントが古いバージョンを実行していることを検出し次第、エージェントが更新する必要があることを通知します。
  3. エージェントが更新の準備ができると、他のプロセスをシャットダウンします。各スレッドを正常にシャットダウンするため、数分の時間がかかる場合があります。
  4. エージェントはサーバーから新しいバイナリーをダウンロードします。
  5. エージェントは新しい Java プロセスを開始します。
  6. Java プロセスは古いエージェント設定のバックアップを作成し、更新を適用します。
  7. その後、Java プロセスはエージェントを再起動し、それ自体を強制終了します。
エージェントが更新を開始するように指示したり、エージェントのコマンドラインで更新が利用可能かどうか update を確認するように指示することができます。 
agentRoot/rhq-agent/bin/rhq-agent.sh

> update
バグを報告します。

6.6.2. エージェント設定
リンクのコピー

Java ホームディレクトリーなどの設定のエージェント設定は、通常使用するために環境変数に設定できます。ただし、アップグレードプロセスが停止してエージェントを再起動すると、シェルに設定した環境変数が失われます。これは、アップグレード後にエージェントを自動的に再起動しないことを意味します。エージェントのカスタム設定（例：） RHQ_AGENT_HOME または RHQ_AGENT_ADDITIONAL_JAVA_OPTS, を rhq-agent-env.sh ファイルに追加する必要があります。このファイルはアップグレード中に保持されるため、すべての設定が続きます。
警告
JBoss ON エージェントの起動に使用するスクリプトは編集しないでください。変更するべきではない 4 つのファイルがあります。
  • rhq-agent.sh
  • rhq-agent-wrapper.sh
  • rhq-agent.bat
  • rhq-agent-wrapper.bat
ランチャースクリプトへの変更は、自動更新時に上書きされます。環境ファイル（など rhq-agent-env.sh ）への変更は、更新時に保持されます。
バグを報告します。

6.6.3. カスタムスクリプト
リンクのコピー

JBoss ON 3.3 では、カスタムスクリプトをエージェントに配置でき /binます。エージェントがアップグレードされると、エージェントのディレクトリーにある .sh または .bat 拡張のあるファイルは、新しいエージェントの /bin ディレクトリーにコピーされ /bin ます。
バグを報告します。

6.6.4. カスタム log4j 設定のアップグレード
リンクのコピー

rhq-agent-env.sh ファイルの Java 設定に対する編集は、アップグレード間で保持されます。また、log4j.xml ファイルに変更を加えた場合、ファイル全体がコピーされます。
バグを報告します。

6.6.5. カスタム agent-configuration.xml 設定のアップグレード
リンクのコピー

アップグレードプロセス中に、現在のファイルが新たにインストールされたもの agent-configuration.xml と全く異なる場合は agent-configuration.xml、両方のファイルが保持されます。現在の agent-configuration.xml ファイルは、同じ名前で保持されます。新規インストール後の名前 agent-configuration.xml が変更され agent-configuration.xml.newます。これにより、--cleanconfig オプションを使用してエージェントを再起動すると、カスタム設定を保持することができます。新しい設定が必ず追加されるように、両方のファイルを確認する必要があり agent-configuration.xmlます。
注記
現在のバージョン agent-configuration.xml と新規インストールが同じ場合 agent-configuration.xml は、agent-configuration.xml.new ファイルは作成されません。
バグを報告します。

6.6.6. キーストアおよびトラストストアの設定
リンクのコピー

元の JBoss ON エージェントがカスタムキーストアおよびトラストストアを使用して SSL で実行されるよう設定されている場合、アップグレードされたエージェントが引き続きアクセスできるようにこれらのストアが設定されていることを確認してください。
  1. キーストアファイルには、ファイル名に keystore という単語が含まれている必要があります。例： my-agent-keystore.dat
  2. トラストストアファイルには、ファイル名に トラストストア という単語が必要です。例： my-agent-truststore.dat
  3. キーストアとトラストストアファイルは、共にエージェントの agentRoot/rhq-agent/conf/ ディレクトリーに置く必要があります。エージェントの conf/ ディレクトリー内の信頼ファイルは、アップグレード中など、エージェントの設定が消去またはパージされた際に保持されます。
SSL ファイルが適切に設定されている限り、これらのファイルは新しいエージェント設定にコピーされ、新しいエージェントは自動的に SSL で実行されます。
バグを報告します。

6.6.7. エージェントホームディレクトリーでの書き込み権限の設定
リンクのコピー

アップグレードプロセスにより、新しいファイルがエージェントの現在のインストールディレクトリーに書き込まれるため、エージェントのシステムユーザーに 親 ディレクトリーへの書き込み権限が必要になります。たとえば、エージェントがインストールされている場合は /opt/rhq/rhq-agent、エージェントユーザーにその /opt/rhq ディレクトリーへの書き込み権限が必要です。
必要に応じて、エージェントのホームディレクトリーの権限をリセットします。例： 
[root@server ~]# chown agent_user /opt/rhq
バグを報告します。

6.6.8. エージェントをバックグラウンドサービスとして起動
リンクのコピー

「JBoss ON Agent をサービスとして実行」 では、エージェントをバックグラウンドサービスとして実行するように設定する方法を説明します。Windows では、これはサービスとして実行されます。Linux および Unix システムでは、エージェントは init.d から起動時に起動します。
自動アップグレードプロセスでは、エージェントがバックグラウンドで実行されていることを前提としています。エージェントがバックグラウンドデーモンとして実行されていない場合は、エージェントの自動更新時にコンソールで実行している古いエージェントプロセスはシャットダウンし、可能な場合は新しいエージェントがバックグラウンドサービスとして再起動します。
バグを報告します。

6.7. JBoss ON エージェントの手動アップグレード
リンクのコピー

JBoss ON サーバーとの互換性を確保するには、各エージェントをサーバーと同じバージョンの JBoss ON にアップグレードする必要があります。
エージェントには、それ自体を自動更新できます。したがって、ほとんどの条件では、エージェントを手動でアップグレードする必要はありません。ただし、何らかの理由で自動更新に失敗したり、エージェントの自動更新を無効にした場合は、エージェントを手動でアップグレードできます。
注記
全エージェントを同時にアップグレードする必要があります。異なるバージョンのエージェントには対応していません。
  1. JBoss ON エージェントをシャットダウンします。
  2. Windows のみ。エージェントが Windows サービスとして実行している場合は、Windows サービスをアンインストールします。 
    cd old-agent-install-dir/bin
./rhq-agent-wrapper.bat remove
  3. にあるように、JBoss ON サーバーをアップグレードし 4章JBoss ON サーバーおよびストレージノードのアップグレード ます。エージェントをアップグレードする前に JBoss ON サーバーをアップグレードする必要があります。
  4. アップグレードした JBoss ON サーバーがまだ起動していない場合は再起動します。
  5. サーバーからエージェント更新バイナリーをダウンロードします。
  6. エージェント更新バイナリー JAR ファイルを、エージェントがインストールされている親ディレクトリーにコピーします。例： 
    cp agent-update-binary.jar /opt/rhq/rhq-agent
  7. 以下のコマンドを実行して、エージェント更新バイナリーから新しい JBoss ON エージェントを抽出します。 
    java -jar agent-update-binary.jar --update=agent_installation_directory
    これにより、エージェント更新バイナリーに指示され、JBoss ON エージェントディストリビューションを抽出し、rhq-agent サブディレクトリーにある現在のエージェントを更新します。この時点で、アップグレードされた JBoss ON エージェントは元の rhq-agent ディレクトリーに置かれます。古いエージェントが rhq-agent-old ディレクトリーにバックアップされている。アップグレードエラーはすべてエージェントのログファイルに書き込まれます。
  8. 最後に、JBoss ON エージェントを起動します。
バグを報告します。

6.8. エージェントの再インストール
リンクのコピー

エージェントは完全に新しい設定で再インストールできます。エージェントの設定には、エージェントの（ローカル）永続設定、エージェントインベントリー（および関連するリソースデータ）、およびサーバーインベントリーのプラットフォームエントリーの 3 つの点があります。エージェントが正常に再インストールできるようにするには、ローカルマシンの設定と JBoss ON サーバーのエージェントおよびリソース設定の両方をクリアする必要があります。
  • エージェントの永続化された Java 設定はパージされる必要があります。
  • エージェントのインベントリーは、リソースの履歴および設定と共にパージする必要があります。
  • エージェントは JBoss ON インベントリーから削除する必要があります。これは、（推奨） Administration > Agents エリアの JBoss ON 設定からエージェントを削除するか、インベントリーから platform リソースを削除して実行できます。
エージェントを再インストールするには、以下を実行します。
  1. 元のエージェントインスタンスが正しく削除されていることを確認します。
    1. エージェントプロセスを停止します。
    2. JBoss ON サーバーインベントリーから platform エントリーを削除します。
  2. --fullcleanconfig オプションを指定してエージェントを再起動します。これにより、エージェントに新しいセキュリティートークンと新しい設定が登録されます。 
    agentRoot/rhq-agent/bin/rhq-agent.sh --fullcleanconfig
バグを報告します。

6.9. エージェントの起動
リンクのコピー

エージェントが起動し、エージェントの bin/ ディレクトリー内のスクリプトを使用して実行されます。
注記
JBoss ON サーバーまたはストレージノードでエージェントがインストールされている場合、サーバーの bin/ ディレクトリーの rhqctl スクリプトを使用して管理されます。
管理システムにインストールされるすべてのエージェントは、rhq-agent.sh スクリプトを使用して管理されます。
サーバー起動スクリプト（サーバープロセスが開始され、スクリプトが終了し、エージェントスクリプトは開いたままになります）とは異なり、必要に応じてさらに入力を受け入れるプロンプトが表示されます。（通常は、バックグラウンドでスクリプトを開始してそのまま使用できます。） 
/opt/rhq-agent/bin/rhq-agent.sh

RHQ 3.3.0-SNAPSHOT [cda7569] (Tue Apr 13 13:39:16 EDT 2017)
>
ほとんどの場合、JBoss ON エージェントは追加のオプションや設定なしで実行できます。追加の設定オプションは、rhq-agent-env.sh スクリプトファイルを編集するか、スクリプトで -D プロパティー名を使用して設定でき rhq-agent.sh ます。プロパティーファイルと起動スクリプトで設定を変更する方法は、「 『Configuring JBoss ON Servers, Agents, and Storage Nodes』 」を参照してください。
注記
JBoss ON エージェントの起動時にエラーが発生した場合は、でエージェント起動スクリプトを実行して以前のエージェント設定 --cleanconfig を消去し、新規の起動を開始します。
バグを報告します。

第7章 RPM からのエージェントのインストール
リンクのコピー

Red Hat Enterprise Linux システムでは、RPM パッケージを使用してエージェントをインストールし、オプションでエージェントサービスを利用できます。
重要
本章では、JBoss ON によって管理されるプラットフォームにエージェントをインストールおよび管理します。
このシステムが JBoss ON サーバーをホストする場合は、の説明に従って、サーバーのインストールプロセスの一部としてエージェントをインストールし 3章JBoss ON Server のインストール ます。JBoss ON サーバーと同じマシン上のエージェントは、エージェント RPM からインストールまたは管理できます。rhqctl スクリプトを使用してインストールおよび管理する必要があります。
バグを報告します。

7.1. エージェント RPM について
リンクのコピー

RPM でエージェントをインストールすると、単純で標準化されたインストールプロセスができるため、クラウド環境および PaaS 環境のリソース、またはデータセンターのキックスタートマシンのリソースにエージェントをインストールできます。
また、JBoss ON エージェント RPM は、エージェントが自動的にシステムサービスとして機能するように自動的に設定されるため、他の Linux システムアプリケーションと同様にエージェントの管理が容易になります。
  • 適切なパーミッションを持つシステムユーザーおよびグループの設定はすでに設定されている。
  • エージェントを起動、停止、再起動するシステムサービス
  • エージェント設定を変更するシステムサービス
  • システムツールを使用したアップグレード
JAR ファイルからエージェントをインストールする場合、インストールディレクトリーや Java 設定ストアの場所など、エージェント設定を定義するインストール環境にいくつかの要因があります。つまり、インストールディレクトリーは JAR が展開される場所によって決定されます。エージェントユーザーと Java 優先の場所は、いずれもインストールを実行するシステムユーザーが定義します。
これらの設定の多くは RPM 設定の一部として定義されるため、環境によるエージェント設定への影響は最小限に抑えられます。このセクションでは、RPM と JAR インストールの違いと、RPM プロセスで設定したデフォルト設定の一部を説明します。
バグを報告します。

7.1.1. JAR インストールと RPM インストールの相違点
リンクのコピー

最も注目すべき違いは、実行場所や、それを開始したユーザーアカウント(root)に関係なく、RPM がホームディレクトリーと重要なファイルの場所を定義すること rpm です。
Expand
表7.1 JAR および RPM のインストール間の違い
設定エリア JAR 値 RPM 値
agent user インストールするシステムユーザーに設定します。 jbosson-agent user, jbosson group
エージェントサービス Not set ──-agent
環境変数 installDir/bin/rhq-agent-env.sh
  • ADDITIONAL_JAVA_OPTS の /etc/init.d/jon-agent（init スクリプト）
  • /usr/share/jboss-on-3.3.2.GA/agent/bin/rhq-agent-env.sh for JAVA_OPTS
ホームディレクトリーの場所 JAR がインストールされている場所 /usr/share/jboss-on-3.3.0.GA/agent/
agent-configuration.xml の場所 JAR がインストールされている conf/ ディレクトリーで /etc/jboss-on/agent/ [a]
Java 設定の場所 ~/.Java/default（システムユーザー Java 設定） /var/lib/jboss-on/agent/prefs/.java/.userPrefs/rhq-agent/default/
データディレクトリーの場所 agentInstallDir/data /var/lib/jboss-on/agent/data/
ログディレクトリーの場所 JAR がインストールされている logs/ ディレクトリーで /var/log/jboss-on/agent/ [b]
Autoupgrade enabled disabled
[a] /usr/share/jboss-on-3.3.0.GA/agent/conf へのシンボリックリンク
[b] /usr/share/jboss-on-3.3.0.GA/agent/logs へのシンボリックリンク
バグを報告します。

7.1.2. JBoss ON ユーザー
リンクのコピー

エージェント JAR をインストールする前に、JBoss ON エージェントを実行するシステムユーザーの選択が最も重要になります(「エージェントシステムユーザーの選択」)。これには、システム上のエージェントプロセスのセキュリティー上の影響があり、ユーザーがローカルサーバーおよびアプリケーションリソース（それぞれに独自のシステムユーザーとパーミッションを持つ）がどのように対話するかにも影響します。
エージェント RPM は、ディレクトリーアクセスなどのセキュリティーの問題に対応するために、適切なシステム設定を持つ新しいシステムユーザーを自動的に作成します。
重要
エージェントユーザーは依然としてリソースと対話する必要があります。適切なグループパーミッション、SELinux コンテキスト、およびその他のリソース設定は、エージェントがリソースの検出および管理方法に影響します。このような考慮事項は 「エージェントシステムユーザーの選択」 概説します。必要に応じて、システム設定を変更して、エージェントがリソースへのアクセスの適切なレベルになるようにシステム設定を変更します。
注記
エージェント RPM は、インストール時に jon-agent ユーザーと jbosson グループを作成します。RPM がアンインストールされると、ユーザーおよびグループは削除されません。
Expand
表7.2 エージェントのユーザー設定
property 値
username jbosson-agent
グループ名 jbosson
ユーザー ID(UID) 400
グループ ID(GID) 400
ユーザープロパティー NOSHELL
init スクリプトの所有者 ルート
init スクリプトユーザー ──-agent [a]
[a] これは、任意のシステムユーザーとして編集できます。
バグを報告します。

7.1.3. サービスツールおよび Init スクリプト
リンクのコピー

RPM 設定の一部には、JBoss ON エージェントをシステムサービスとして設定することが含まれます。エージェントには init スクリプトがインストールされ /etc/init.d/jon-agentます。これにより、システムの起動時にエージェントが起動し、デーモンとして実行さ chkconfig れるようにエージェントが起動します。
init スクリプトには、通常のサービス管理コマンドと、エージェント自体を管理するための特定のコマンドがすべて含まれています。
  • start
  • stop
  • restart
  • status
  • kill。エージェントプロセスが強制的に停止するように強制します。
  • config。エージェント設定ウィザードを再度実行し、エージェント設定を新しい設定で更新します。
で説明されているように start stop restart、、、、、および status コマンドは、エージェントがサービスとして実行するよう手動で設定されている場合に利用でき 「JBoss ON Agent をサービスとして実行」 ます。ただし、kill および config コマンドは、エージェント RPM で提供される init スクリプトでのみ利用できます。
エージェント init スクリプトは /etc/init.d/jon-agent、JAR インストールで rhq-agent-env.sh ファイルに設定される環境変数を設定します。この init スクリプトは、エージェントシステムのユーザーおよびグループ、ログおよびデータディレクトリーの場所、および Java オプションを定義します。たとえば、init スクリプトを編集すると、エージェントを別のユーザーとして実行したり、別の JVM 設定で開始したりできます。
重要
RPM からエージェントがインストールされている場合は、以下の config コマンドを実行して、または init スクリプトを編集して、エージェント設定を編集することがサポートされる唯一の方法になります。rhq-agent-env.sh ファイルまたは他の設定ファイルを直接編集することはサポートされていません。
バグを報告します。

7.1.4. 更新の違い
リンクのコピー

JAR 経由でエージェントがインストールされている場合、agent-configuration.xml ファイルにはエージェントにアップグレードを確認するように指示するキーセットがあります。その後エージェントはサーバーをポーリングし、JBoss ON サーバーバージョンがエージェントバージョンよりも新しい場合、エージェントはサーバーから更新されたバイナリーをリクエストします。
エージェント RPM は、エージェント JAR ファイルとは完全に異なるインストールパスを使用します。RPM としてインストールされたエージェントは、ローカルシステムツールに依存してパッケージを管理します。agent-configuration.xml ファイル内のアップグレードフラグがオフになり、自動アップグレードで試行を無効にし、ローカルシステムがエージェントパッケージを管理できるようにします。 
<entry key="rhq.agent.agent-update.enabled" value="false" />
autoupdates が無効の場合、JBoss ON サーバーがアップグレードされるたびにエージェントを手動でアップグレードし、バージョンが JBoss ON サーバーバージョンと同期されるようにする必要があります。
バグを報告します。

7.1.5. JBoss ON エージェントを提供するリポジトリーの有効化
リンクのコピー

Expand
表7.2 エージェントのユーザー設定
JBoss ON Agent(jboss-on-agent-3.3)は、Red Hat Enterprise Linux 6 および Red Hat JBoss Enterprise Application Platform 6 以降、さまざまな Red Hat JBoss Enterprise Application Platform リポジトリーで提供されます。
JBoss ON Agent は、Red Hat Enterprise Linux 6 の 32 ビットアーキテクチャーと 64 ビットアーキテクチャーの両方に提供されますが、Red Hat Enterprise Linux 7 の 64 ビットアーキテクチャーでのみ利用できます。Red Hat Enterprise Linux の yum パッケージマネージャーは、jboss-on-agent-3.3 のインストール時にシステムアーキテクチャーを検出します。
Red Hat JBoss Enterprise Application Platform リポジトリーは、Red Hat Subscription Manager(subscription-manager)を使用して有効にします。 
subscription-manager repos --enable=jb-eap-EAP_version-for-rhel-RHEL_VERSION-server-rpms
RHEL_VERSION は、Red Hat Enterprise Linux Server のバージョンを指します（Red Hat Enterprise Linux Server 7など）。
Red Hat JBoss Enterprise Application Platform リポジトリーには、Current と Minor の 2 つのタイプがあります。
Red Hat JBoss Enterprise Application Platform（および関連する JBoss ON Agent）の 現行 バージョンが必要な場合、EAP_version はメジャーバージョン（Red Hat JBoss Enterprise Application Platform 6 または 7など）を参照します。
たとえば、Red Hat Enterprise Linux Server 7 で Red Hat JBoss Enterprise Application Platform 6 を使用するには、以下を実行します。 
subscription-manager repos --enable=jb-eap-6-for-rhel-7-server-rpms
ただし、Red Hat JBoss Enterprise Application Platform の特定の マイナー バージョンが必要な場合は、EAP_version はマイナーバージョンを参照します（例： Red Hat JBoss Enterprise Application Platform 6.2、6.3、または 7.0）。
たとえば、Red Hat Enterprise Linux Server 6 で Red Hat JBoss Enterprise Application Platform 6.4 を使用するには、以下を実行します。 
subscription-manager repos --enable=jb-eap-6.4-for-rhel-6-server-rpms
Red Hat JBoss Enterprise Application Platform リポジトリーの詳細は、『 Red Hat JBoss Enterprise Application Platform インストールガイド』を参照してください。
バグを報告します。

7.2. RPM からのエージェントのインストール
リンクのコピー

JBoss ON エージェントは jboss-on-agent-3.3 パッケージからインストールされます。このパッケージはすべてのエージェントファイルをインストールし、特定の JBoss ON エージェントシステムユーザーを作成し、JBoss ON エージェントをシステムサービスとして設定します。
重要
この手順では、JBoss ON によって管理されるプラットフォームでエージェントをインストールおよび管理します。
このシステムが JBoss ON サーバーをホストする場合は、の説明に従って、サーバーのインストールプロセスの一部としてエージェントをインストールし 3章JBoss ON Server のインストール ます。JBoss ON サーバーと同じマシン上のエージェントは、エージェント RPM からインストールまたは管理できます。rhqctl スクリプトを使用してインストールおよび管理する必要があります。
バグを報告します。

7.2.1. yum を使用したインストール
リンクのコピー

インストールの前に、前述のセクションで説明されているように、関連する Red Hat JBoss Enterprise Application Platform リポジトリーを追加していることを確認してください 「JBoss ON エージェントを提供するリポジトリーの有効化」。
注記
RPM をインストールするには、3.3 リリースの RHN ユーザーアカウントの特定のエンタイトルメントが必要です。適切なリポジトリーにアクセスできるように、この RHN ユーザーアカウントを使用してシステムを登録する必要があります。
  1. を使用 yum してパッケージをインストールします。 
    [root@server ~]# yum install jboss-on-agent-3.3
    これにより、にエージェントがインストールされ /usr/share/jboss-on-3.3.2.GA/agentます。
  2. service jon-agent config コマンドを実行してエージェントを設定します。これは、高度なインストーラーで実行され、エージェントを設定します。 
    [jsmith@server ~]$ sudo service jon-agent config
RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
** Advanced Setup **
... 8< ...
Agent Name [agent.example.com] : agent1
Agent Hostname or IP Address [!*] :
Agent Port [16163] :
Agent Transport Protocol [socket] :
Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
RHQ Server Hostname or IP Address [255.255.255.255] :
RHQ Server Port [7080] :
RHQ Server Transport Protocol [servlet] :
RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
RHQ Server Alias [rhqserver] :
The setup has been completed for the preferences at node [/rhq-agent/default].
    この config コマンドは、すべての高度な設定オプションで実行し、エージェントの 3 つのエリアを設定します。
    • エージェントをサーバーに登録するために使用されるエージェント接続情報
      • エージェント名
      • エージェントポート
      • エージェントホスト（ホスト名または IP アドレスによる）
    • エージェントとの通信の頻度に関する SSL またはセキュアな接続およびルールの設定を含む agent-server 通信設定
      • ソケット（通常）または sslsocket(secure)のいずれかのエージェントプロトコル。
        sslsocket の場合は、JBoss ON サーバー 『およびエージェントの設定の SSL 接続を許可するよう JBoss ON サーバーを設定する必要が』 あります。
      • サーバーへの接続に使用するクライアントトランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。トランスポートパラメーターには、プールサイズ、タイムアウト期間、バッファー設定が含まれます。完全なリストは、JBoss Remoting クライアントパラメーターのドキュメントを参照してください。
      • エージェントがサーバーへのメッセージを送信するために使用するサーバープロトコル（通常の）または sslservlet（セキュア）
        エージェントで設定したサーバー接続設定は、サーバー自体の設定と一致している 必要 があります。
      • エージェントからメッセージを受信するために使用するサーバートランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。サーバーのトランスポートパラメーターは、エージェントメッセージの受信に使用されるサーブレットに関連します。
    • 登録する JBoss ON サーバー
      • サーバーホスト（ホスト名または IP アドレスによる）
      • サーバーポート
      • サーバーインスタンスを識別するための短いニックネームサーバーエイリアス。
  3. エージェントを起動します。 
    [jsmith@server ~]$ sudo service jon-agent start
バグを報告します。

7.2.2. RPM のダウンロードによるインストール
リンクのコピー

  1. でカスタマーポータルにログインし https://access.redhat.com ます。
  2. Downloads タブをクリックします。
  3. Packages ボックスをクリックして、エージェント RPM パッケージを検索します。
  4. パッケージ名 jboss-on-agent として入力し、In the following architectures ラジオボタンを選択して、システムに適したアーキテクチャーを設定します。
  5. パッケージ名をクリックし、最新のエージェント RPM 更新の名前をクリックします。
  6. ページの下部までスクロールし、Download Package リンクをクリックして、パッケージをシステムの任意の場所に保存します。
  7. rpm コマンドを使用してインストールします。例： 
    [root@server ~]# rpm -ivh /tmp/downloads/jboss-on-agent-3.3.2.GA.el6.noarch.rpm
    これにより、にエージェントがインストールされ /usr/share/jboss-on-3.3.2.GA/agentます。
  8. service jon-agent config コマンドを実行してエージェントを設定します。これは、高度なインストーラーで実行され、エージェントを設定します。 
    [jsmith@server ~]$ sudo service jon-agent config
RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
** Advanced Setup **
... 8< ...
Agent Name [agent.example.com] : agent1
Agent Hostname or IP Address [!*] :
Agent Port [16163] :
Agent Transport Protocol [socket] :
Agent Transport Parameters [numAcceptThreads=1&maxPoolSize=303&clientMaxPoolSize=304&socketTimeout=60000&enableTcpNoDelay=true&backlog=200] :
RHQ Server Hostname or IP Address [255.255.255.255] :
RHQ Server Port [7080] :
RHQ Server Transport Protocol [servlet] :
RHQ Server Transport Parameters [/jboss-remoting-servlet-invoker/ServerInvokerServlet] :
RHQ Server Alias [rhqserver] :
The setup has been completed for the preferences at node [/rhq-agent/default].
    この config コマンドは、すべての高度な設定オプションで実行し、エージェントの 3 つのエリアを設定します。
    • エージェントをサーバーに登録するために使用されるエージェント接続情報
      • エージェント名
      • エージェントポート
      • エージェントホスト（ホスト名または IP アドレスによる）
    • エージェントとの通信の頻度に関する SSL またはセキュアな接続およびルールの設定を含む agent-server 通信設定
      • ソケット（通常）または sslsocket(secure)のいずれかのエージェントプロトコル。
        sslsocket の場合は、JBoss ON サーバー 『およびエージェントの設定の SSL 接続を許可するよう JBoss ON サーバーを設定する必要が』 あります。
      • サーバーへの接続に使用するクライアントトランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。トランスポートパラメーターには、プールサイズ、タイムアウト期間、バッファー設定が含まれます。完全なリストは、JBoss Remoting クライアントパラメーターのドキュメントを参照してください。
      • エージェントがサーバーへのメッセージを送信するために使用するサーバープロトコル（通常の）または sslservlet（セキュア）
        エージェントで設定したサーバー接続設定は、サーバー自体の設定と一致している 必要 があります。
      • エージェントからメッセージを受信するために使用するサーバートランスポートパラメーター
        サーバーとエージェントはいずれも、通信に JBoss Remoting を使用します。JBoss Remoting を使用すると、サーバーとクライアントは URL 形式のアドレスを使用して接続設定を渡すことができます。サーバーのトランスポートパラメーターは、エージェントメッセージの受信に使用されるサーブレットに関連します。
    • 登録する JBoss ON サーバー
      • サーバーホスト（ホスト名または IP アドレスによる）
      • サーバーポート
      • サーバーインスタンスを識別するための短いニックネームサーバーエイリアス。
  9. エージェントを起動します。 
    [jsmith@server ~]$ sudo service jon-agent start
バグを報告します。

7.3. RPM インストール後のエージェント設定の変更
リンクのコピー

エージェント設定には、2 つの部分があります。
  • エージェントインスタンスとサーバーとの通信方法を定義するエージェント接続プロパティー。
  • エージェントのパフォーマンスとオプションを管理するエージェント JVM プロパティー
バグを報告します。

7.3.1. エージェント接続設定の変更
リンクのコピー

エージェントの接続プロパティーは、エージェントのインストール時に定義されます。これには、接続先のサーバー、ポート番号、および SSL 接続を使用するサーバーなどの情報が含まれます。
そのエージェント接続設定は、最初に起動時にセットアッププロンプトで入力 agent-configuration.xml した値が、最初に読み取られて上書きされます。エージェントの初期設定後、エージェントはその設定を Java 設定(/var/lib/jboss-on/agent/prefs/.java/.userPrefs/rhq-agent/default/)で永続化し、agent-configuration.xml 再度参照しません。
その情報を変更するには、エージェント接続情報を削除してリセットする必要があります。
エージェントの接続（登録）設定を変更するには、config service コマンドを使用して再度設定オプションを介して実行します。これにより、設定ストアが消去され、agent-configuration.xml ファイルの再読み取りが行われ、設定が再度実行されます。
重要
RPM から JBoss ON エージェントをインストールすると、自動的にシステムサービスとして設定されます。データの一貫性とエージェントのパフォーマンスは、設定ファイルや JVM 起動プロパティーを直接編集しようとするのではなく、サービスツールを使用してエージェント接続設定を常に管理します。
例： 
[jsmith@server ~]$ sudo service jon-agent config
RHQ 4.4.0.JON311GA [6910991] (Wed Aug 01 18:43:03 EDT 2012)
** Advanced Setup **
Agent Name [agent.example.com] : agent1
Agent Hostname or IP Address [!*] :
Agent Port [16163] :
Agent Transport Protocol [socket] :
... 8< ...
config service コマンドはエージェント起動スクリプトを開き、エージェント接続設定を編集する一連のオプションを自動的に渡します。
  • --cleanconfig, 以前の設定を消去するには
  • --setup また --advanced、エージェントの設定を再度実行するように強制します。
  • --daemon さらに --nostart、エージェントプロセスを開始せずにエージェントのコマンドプロンプトを実行し、終了します（これにより、エージェントをサービスとして起動可能）。
したがって、service jon-agent config コマンドは、これらのすべてのオプションでエージェントを起動するのと同じです。 
rhq-agent.sh --cleanconfig --setup --advanced --daemon --nostart
バグを報告します。

7.3.2. エージェント JVM および他の Init 設定の変更
リンクのコピー

エージェントの設定後、オプションの JVM 設定（永続設定）は init スクリプト、/etc/init.d/jon-agent ファイル、または環境スクリプトで設定され rhq-agent-env.shます。どちらのファイルがエージェントを起動するたびに読み込まれます。init スクリプトを編集することが推奨されます。これにより、追加の JAVA_OPTS 値を設定することが推奨されます。
例： 
RHQ_AGENT_ADDITIONAL_JAVA_OPTS="-Drhq.agent.data-directory=$RHQ_AGENT_DATA_DIR -Djava.util.prefs.userRoot=$RHQ_AGENT_PREFS_DIR -Xms64m -Xmx128m -Djava.net.preferIPv4Stack=true"
export RHQ_AGENT_ADDITIONAL_JAVA_OPTS
のような agent prompt コマンドを使用して、Java 設定を編集することもでき setconfigます。これは、「 JBoss ON のサーバーおよびエージェントの設定 」を参照してください。
バグを報告します。

7.4. JAR インストールから RPM インストールへの移行
リンクのコピー

JBoss ON サーバーダウンロード(6章JAR ファイルからの管理対象プラットフォームでのエージェントのインストールおよびアップグレード)で利用可能な JAR ファイルからエージェントを最初にインストールした場合、RPM インストールにエージェントを切り替えることができます。潜在的なパスは 2 つあります。古いエージェントをスクレープして新しいエージェントをインストールしたり（元のエージェント設定とデータがすべて失われる）か、エージェントデータを元の JAR インストールから新しい RPM インストールに移行することができます。
バグを報告します。

7.4.1. エージェントの変換（設定データのロード）
リンクのコピー

この方法では、永続ストア、データディレクトリー、ログなど、エージェントの元データがすべて失われます。ただし、元のセキュリティートークンを再使用することで、エージェントはサーバーと再登録し、以前のインベントリーとリソースの履歴と設定を取得できるため、プラットフォームの管理情報が失われることはありません。
  1. エージェントのセキュリティートークンを取得します。
    1. Administration タブをクリックし、左側の Topology セクションの下にある Agents リンクをクリックします。
    2. 一覧からエージェントを選択し、その名前をクリックして詳細ページを開きます。
    3. セキュリティートークンをコピーします。
  2. エージェントをシャットダウンします。
  3. JAR インストールディレクトリーを削除します。
  4. エージェント RPM をインストールします。
  5. agent-configuration.xml ファイルを編集し、エージェントの元のセキュリティートークンの行を追加します。 
    vim /etc/jboss-on/agent/agent-configuration.xml
						
<entry key="rhq.agent.security-token" value="abcd1234" />
  6. エージェント設定インストーラーから実行します。 
    [jsmith@server ~]$ sudo service jon-agent config
  7. エージェントを起動します。 
    [jsmith@server ~]$ sudo service jon-agent start
バグを報告します。

7.4.2. RPM へのエージェントの移行（設定データの準備）
リンクのコピー

元の設定データをすべて維持し、エージェントに対して JVM を保持することができ、データを永続化できます。ただし、これには、元のエージェントの Java 設定ブラウザーを介して Java ストアにアクセスし、ストア内の他のデータに影響を与えずに新しいエージェントの Java ストアにコピーする必要があります。Java ストアを編集する際には常にリスクがあります。
  1. 元のエージェントをシャットダウンします。
  2. エージェント RPM をインストールします。
  3. エージェントの設定ディレクトリーを上にコピーします。これには、データディレクトリー（SSL に使用されるドリフト検出またはトラストストアの変更セットなどの操作情報が含まれます）およびログディレクトリーが含まれます。例： 
    [root@server ~]# cp -r agentRoot/rhq-agent/data/ /var/lib/jboss-on/agent/data/
[root@server ~]# cp -r agentRoot/rhq-agent/logs/ /var/log/jboss-on/agent/
  4. Java プリファレンスエディターを使用して、~/.java/.userPrefs/rhq-agent/default （デフォルトでは）元の設定ストアからエージェントに固有の Java 設定をエクスポートします。
    注記
    必ずセキュリティートークンを取得してください。トークンにより、エージェントはサーバーが正常に再登録できるようになります。
  5. Java プリファレンスエディターを使用して、エージェントの Java 設定を /var/lib/jboss-on/agent/prefs/default （デフォルトでは）の新しい設定ストアにインポートします。
  6. エージェント設定インストーラーから実行します。 
    [jsmith@server ~]$ sudo service jon-agent config
  7. エージェントを起動します。 
    [jsmith@server ~]$ sudo service jon-agent start
バグを報告します。

7.5. エージェントの起動
リンクのコピー

デフォルトでは、エージェントが RPM を使用してインストールされると、システムサービスとして設定されます。これは、service コマンドを使用して開始されることを意味します。 
[root@@server ~]# service jon-agent start
エージェントは、エージェントの bin/ ディレクトリーのスクリプトを使用して起動および実行できます。
注記
JBoss ON サーバーまたはストレージノードでエージェントがインストールされている場合、サーバーの bin/ ディレクトリーの rhqctl スクリプトを使用して管理されます。
RPM でインストールされたエージェントは、rhqctl スクリプトで管理できません。
agent コマンドプロンプトは、特定のエージェントコマンドを渡したり、エージェント設定を変更したりするのに役立ちます。rhq-agent.sh コマンドを使用するとコマンドプロンプトが開きます。 
/opt/rhq-agent/bin/rhq-agent.sh

RHQ 3.3.0-SNAPSHOT [cda7569] (Tue Apr 13 13:39:16 EDT 2017)
>
バグを報告します。

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" />
    Expand
    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 セクションを参照してください。
バグを報告します。

7.7. RPM インストールのトラブルシューティング
リンクのコピー

問：
エージェントを正常にインストールしましたが、現在はサーバーに接続できません。なぜですか？
答：
インストーラーから実行するには、フォアグラウンドでエージェントを起動する必要があります。インストーラーは、エージェントが JBoss ON サーバーにアクセスする内容を通知する場所です。エージェントのインストーラーを経由 せず にエージェントサービスを起動した場合、エージェントは、接続するサーバーを識別せずにその設定を読み込みます。
「」で説明されているように、エージェント設定を編集してサーバー接続情報を設定 「RPM インストール後のエージェント設定の変更」 する必要があります。 
[jsmith@server ~]$ sudo service jon-agent config
バグを報告します。

第8章 JBoss ON ユーザーインターフェースを使用したエージェントのインストール
リンクのコピー

JBoss ON UI は、SSH を介してサーバーに JBoss ON エージェントをインストールする機能を提供します。これは、既存の JBoss ON エージェントと JBoss ON エージェントがなくてもサーバーで使用できます。
注記
リモートインストールを実行するために使用される認証情報は、JBoss ON エージェントの起動に使用されるものと同じです。
JBoss ON UI を使用してエージェントをインストールするには、以下を実行します。
  1. 上部ナビゲーションバーの Administration メニューをクリックし、左側のナビゲーションにある Topology セクションの Agents 下にあるをクリックします。
  2. 下部の New ボタンをクリックします。
  3. host, port, user, および password 情報を入力します。各フィールドの詳細については、を参照してください。 「インストールオプション」
  4. エージェントのインストールパスを入力します。Find Agent ボタンは、に指定されたパスの下の検索も使用でき Agent Install Pathます。詳細はを参照 Agent Install Pathしてください 「インストールオプション」。
  5. オプション。新たにインストールされたエージェントに指定すること agent-configuration.xml ができます。設定されていない場合 agent-configuration.xml は、デフォルトが使用されます。
  6. をクリックし Install Agentます。
  7. エージェントのインストールが完了すると、エージェントのインストール情報が表示されます。さらに、新たにインストールされたエージェントの状態を反映するように更新されます Agent Status。また、対応するボタンを使用してエージェントを起動および停止することもできます。
バグを報告します。

8.1. インストールオプション
リンクのコピー

SSH 上の JBoss ON Agent インストールでは、インストールプロセスで以下のフィールドが提供されます。
  • Host : このフィールドは、SSH を使用して接続するサーバーのホスト名を指定します。
  • Port : このフィールドは、SSH 接続に使用するポートを指定します。デフォルトでは、ポート 22 を使用します。
  • User and Password : これらのフィールドは、サーバーへの接続に使用する認証情報です。このユーザーは、JBoss ON エージェントの起動および停止にも使用されます。
  • Agent Install Path : このフィールドは、JBoss ON エージェントをインストールするパスを指定します。JBoss ON UI はボタンも提供します。この Find Agent ボタンは、Agent Install Path フィールドで指定された親パスの下にインストールされた既存のエージェントの検索を試みます。指定されたパスでエージェントが見つかった場合 Agent Install Path は、そのエージェントへのパスで更新されます。見つかったエージェントは、対応するボタンを使用して起動および停止することもできます。
    何も入力されていない場合は、ホスト上でインストールパスを検索して共通の場所が検索されます。
    注記
    インストールを実行するには、User フィールドに指定されたユーザーが指定したパスのパーミッションが必要になり Agent Install Pathます。既存のエージェントに Agent Install Path 対応し、インストールが試行されると、インストールプロセスにより、既存のエージェントが上書きされる前に警告が行われます。
  • Update Status : このフィールドは、Install Agent ボタンをクリックしたら、既存のエージェント Agent Install Path またはインストールプロセスのステータスを提供します。
  • Agent-Configuration.xml : このフィールドにより、使用するカスタム agent-configuration.xml ファイルを指定できます。このフィールドは任意です。agent-configuration.xml ファイルを指定しないと、デフォルトが使用されます。
バグを報告します。

第9章 JBoss エージェントプラグインパックのインストールおよび削除
リンクのコピー

Red Hat JBoss Operations Network には、EWS、EDS、EAP、または SOA-P などの特定の JBoss リソースを処理する追加のエージェントプラグインがあります。これらのプラグインは JBoss ON リソースプラグインですが、個別のパッケージに含まれ、ダウンロードに別のサブスクリプションが必要になります。
サーバーにプラグインがインストールされている場合、これらのプラグインは設定済みのすべての JBoss ON エージェントによってダウンロードされ、利用できます。これは、管理されるインベントリーに JBoss リソースを検出してインポートできることを意味します。
プラグインは、プラグインディレクトリーからプラグインを削除し、サーバーを再起動するか、JBoss ON 管理コンソールを介してリソース管理を使用してすべての JBoss ON エージェントで削除できます。
バグを報告します。

9.1. JBoss エージェントプラグインパックのインストール
リンクのコピー

手順9.1 How To Install JBoss ON Agent Plug-in Packs using the Command Line or GUI

  1. プラグイン JAR ファイルをダウンロードします。
    1. JBoss ON Software Download ページ を読み込み、Red Hat Network の認証情報を使用してログオンします。
    2. Product ドロップダウンを開き、ドロップダウンリストで JBoss ON for プラグイン 製品を選択します。
    3. ドロップダウンリストで JBoss ON for プラグイン 製品を選択します。
    4. 必要なプラグインパックをダウンロードします。
  2. プラグインパックアーカイブを一時的な場所に展開します。これにより、jon-plugin-pack-plugin_name-version という名前のサブディレクトリーが作成されます。例： 
    [jsmith@server rhq-agent]$ unzip jon-plugin-pack-eap-3.3.zip -d /tmp
  3. 抽出したプラグイン JAR ファイルを jon-plugin-pack-plugin_name-3.3/ ディレクトリーから JBoss ON サーバープラグインディレクトリーにコピーします。例： 
    [root@server rhq-agent]# cp /tmp/jon-plugin-pack-plugin_name-3.3/*.jar /opt/jon/jon-server-3.3.2.GA/plugins

  4. スタンドアロンプラットフォーム

    JBoss ON サーバーがそのプラグインを更新している。これは、JBoss ON GUI を使用するか、サーバーを再起動して実行できます。
    GUI を使用してプラグインを読み込むには、以下のコマンドを実行します。
    1. Administration タブを開きます。
    2. 左側の Configuration エリアで、Agent Plug-ins リンクを選択します。
    3. ロードされたエージェントプラグインの一覧の下部にある SCAN FOR UPDATES ボタンをクリックします。

  5. 管理プラットフォーム

    管理されたプラットフォームにインストールされたすべてのエージェントは、新たにインストールされた JBoss プラグインを使用するようにプラグインを更新する必要があります。エージェントは手動でプラグインを再読み込みし、plugins 以下のコマンドを使用してエージェントのコマンドプロンプトから新しいプラグインを読み込むことができます。 
    [jsmith@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh
> plugins update
    エージェントが JBoss ON インベントリーにインポートされている場合は、エージェントまたはグループまたはエージェントの 更新プラグ イン操作をスケジュールして JBoss ON GUI で実行できます。インベントリーでエージェントリソースエントリーを選択し、Operations タブを開き、更新プラグイン操作をスケジュールします。
バグを報告します。

9.2. JBoss エージェントプラグインパックの削除
リンクのコピー

手順9.2 JBoss ON Plug-in Pack の手動削除方法

  1. /opt/jon/jon-server-3.3.2.GA/plugins を開く
  2. インベントリーで不要になったプラグインを削除します。

  3. スタンドアロンプラットフォーム

    JBoss ON サーバーがそのプラグインを更新している。これは、JBoss ON GUI を使用するか、サーバーを再起動して実行できます。
    GUI を使用してプラグインを再読み込みするには、以下を実行します。
    1. Administration タブを開きます。
    2. 左側の Configuration エリアで、Agent Plug-ins リンクを選択します。
    3. ロードされたエージェントプラグインの一覧の下部にある SCAN FOR UPDATES ボタンをクリックします。

  4. 管理プラットフォーム

    管理されたプラットフォームにインストールされたエージェントはすべてプラグインを更新し、削除された JBoss プラグインを認識する必要があります。エージェントは手動でプラグインを再読み込みし、plugins 以下のコマンドを使用してエージェントのコマンドプロンプトから変更を検出できます。 
    [jsmith@server ~]$ agentRoot/rhq-agent/bin/rhq-agent.sh
> plugins update
    エージェントが JBoss ON インベントリーにインポートされている場合は、エージェントまたはグループまたはエージェントの 更新プラグ イン操作をスケジュールして JBoss ON GUI で実行できます。
    更新プラグイン操作をスケジュールするには、以下を実行します。
    1. インベントリーのエージェントリソースエントリーを選択します。
    2. Operations タブを開きます。
    3. 更新プラグイン操作のスケジュール
バグを報告します。

第10章 JBoss ON CLI のインストール
リンクのコピー

Red Hat JBoss Operations Network CLI は、Java Scripting API を使用するスタンドアロンの Java アプリケーションです（これには Java 6 以降が必要です）。CLI を使用すると、管理者はプログラムで JBoss ON と対話できるため、JBoss ON をネットワーク環境に統合できます。
JBoss ON 機能の大規模なサブセットは CLI で公開されます。この リモートクライアント (CLI)は JBoss ON サーバーからアーカイブとしてダウンロードされ rhq-remoting-cli-4.12.0.JON330GA.zipます。
注記
JBoss ON サーバーの管理には、CLI の対応するバージョンのみを使用できます。他のバージョンには互換性がありません。
CLI をインストールするには、以下を実行します。
  1. JBoss ON GUI を開きます。 
    http://server.example.com:7080
  2. メインメニューの Administration リンクをクリックします。
  3. Downloads メニュー項目を選択します。
  4. Command Line Client Download セクションまでスクロールし、をクリックし Download Client Installerます。
  5. CLI がインストールされているディレクトリーに .zip ファイルを保存します。
  6. パッケージを展開します。 
    [root@server jon]# unzip rhq-remoting-cli-4.12.0.JON330GA.zip
バグを報告します。

第11章 インストールとアップグレードに関するトラブルシューティング
リンクのコピー

本章では、Red Hat JBoss Operations Network サーバーのインストールまたはアップグレード後に発生した最も一般的な問題について説明します。その他の問題は、JBoss ON の頻繁にスキャンされたリクエストにも対応しています。

11.1. 例外ログおよびエラーログ
リンクのコピー

問：
org.apache.catalina.connector.CoyoteAdapter サービスの null ポインター例外が発生しています。意味は？
答：
JBoss ON 3.3 サーバーを最初にインストールすると、org.apache.catalina.connector.CoyoteAdapter サービスの null ポインター例外が返されます。これらのエラーは無害で、無視できます。インストールは正常に完了し、サーバーと GUI の両方が正常に起動され、動作します。
問：
3.3 にアップグレードしましたが、null ポインターの例外があります（javax.management.InstanceNotFoundException）に、トランスポートサービスが登録されていないというエラーログに記録されます。
答：
エージェントの実行中にサーバーを起動すると、サーバーはサーバーが完全に起動する前に起動シーケンスの初期にリモーティング（通信またはトランスポート）クラスがロードされる 
[org.rhq.enterprise.server.resource.metadata.ResourceMetadataManagerBean]
Persisting new ResourceType [ModeShapePlugin:Sequencing Service(id=0)]...
2011-01-10 16:45:38,571 ERROR [org.apache.catalina.core.ContainerBase]
Servlet.service() for servlet ServerInvokerServlet threw exception
java.lang.reflect.UndeclaredThrowableException
 at $Proxy424.processRequest(Unknown Source)
 at org.jboss.remoting.transport.servlet.web.ServerInvokerServlet.processRequest(ServerInvokerServlet.java:128)
 at org.jboss.remoting.transport.servlet.web.ServerInvokerServlet.doPost(ServerInvokerServlet.java:157)
 at javax.servlet.http.HttpServlet.service(HttpServlet.java:710)
 at javax.servlet.http.HttpServlet.service(HttpServlet.java:803)
....
ためです。これにより、サーバーが完全に起動するまで通信が中断します。これらのエラーは無視できます。
問：
サーバーのインストール（またはアップグレード）時にエラーメッセージが表示されます。意味は？
答：
アップグレード中に、以下のようなエラーメッセージがコンソールに表示されます。 
ERROR [ClientCommandSenderTask] {ClientCommandSenderTask.send-failed}Failed to send
command [Command: type=[remotepojo]; cmd-in-response=[false]; config=[{rhq.timeout=1000,
rhq.send-throttle=true}]; params=[{targetInterfaceName=org.rhq.enterprise.communications.Ping,
invocation=NameBasedInvocation[ping]}]]. Cause: org.jboss.remoting.CannotConnectException:[.....]
これは無視できます。
問：
JBoss ON 3.0.1 にアップグレードしました。ただし、サーバーログに null ポインター例外が表示され、プラグインにはバージョン 3.0.0 が表示されます。（'Server Name' フィールドはアップグレード中に変更されました。）
答：
アップグレード中に、アップグレードしたサーバープラグインを登録するプロセスは null ポインター例外で失敗します。例： 
2012-03-08 20:33:34,523 ERROR [org.rhq.enterprise.server.core.plugin.ServerPluginScanner] Failed to register server plugin file [/home/hudson/jon-server-3.0.1.GA/jbossas/server/default/deploy/rhq.ear/rhq-serverplugins/rhq-serverplugin-ant-bundle-4.2.0.JON.3.0.1.GA.jar]
java.lang.NullPointerException
	at org.rhq.enterprise.server.core.plugin.ServerPluginScanner.registerServerPlugin(ServerPluginScanner.java:212)
...
このエラーは、サーバーがアップグレードされたときに設定ページに別のサーバー名が入力された場合にのみ発生します。この Server Name フィールドの変更は、アップグレードではサポートされていません。
問：
エラーログが表示される ErrorCode=[2289]。なぜですか？
答：
Oracle では、上書きがない場合は overwrite table オプションを選択すると、というエラーメッセージが表示され ErrorCode=[2289]ます。これは無視できます。

11.2. コネクションの問題
リンクのコピー

問：
インストール後にサーバーに接続できません。
答：
サーバーのセットアップ時にインストーラーが 0.0.0.0 にバインドされていない場合は、必要な接続プロパティーをすべて設定しません。特に、インストーラーは java.rmi.server.hostname パラメーターを実際の値に設定しず、デフォルトの 0.0.0.0 を使用します。このパラメーターは、手動で rhq-server.properties ファイルを編集して、サーバーの実際の IP アドレスに設定する必要があります。プロパティーファイルを編集した後にサーバーを再起動して、変更が読み込まれます。
バグを報告します。

付録A ドキュメント履歴
リンクのコピー

改訂履歴
改訂 3.3.7-1Tue 11 Apr 2017Conscot ムムー
さまざまなバグ修正を再構築します。
改訂 3.3.2-14Tue 29 Nov 2016Conscot ムムー
BZ-1389336: Java 7 への参照が削除されました。
改訂 3.3.2-13Fri 22 Jul 2016Conscot ムムー
管理および設定ガイドの認証手順に参照（およびリンク）を追加。
改訂 3.3.2-12Tue 12 Jul 2016Conscot ムムー
BZ-1331201: postgres サービスの起動コマンドを更新します。
改訂 3.3.2-11Tue 23 Feb 2016Conscot ムムー
bz-1──36:「root」としてインストールの実行を提案している命令が修正されました。
改訂 3.3.2-10Thu 02 Jul 2015Jared イタリア
Preface front-matter を削除しました。
JBoss ON UI のヘルプ > ドキュメントメニューにリンクしていた HTML Anchors が修正されました。
改訂 3.3.2-1Tue 28 Apr 2015Jared イタリア
JBoss ON 3.3.2 リリースの準備
改訂 3.3.1-6Mon Apr 20 2015Jared イタリア
PDF 生成の問題を修正するため。
改訂 3.3.1-5Fri Feb 27 2015Jared イタリア
JBoss ON 3.3.2.GA リリースの準備
BZ#1158247: 非推奨となった "run-data-migrator do-it" が含まれるセクションが修正されています。
BZ#1164940: お客様に問題を引き起こした RHQ_JAVA_HOME パスから末尾の /bin/java/ を削除します。
BZ#1177772: rhqadmin/rhqadmin とスクリプト名のさまざまな修正により、お客様のアップグレードに問題が生じます。
BZ#1177919: root で実行する必要があるコマンドを推奨する Basic Linux Server 設定手順のインスタンスが修正されました。
BZ#1179421: 「 192.168..」ではなく「192.68...」として宣言された IP アドレスの問題は、本書でグローバルに修正されました。
BZ#1181626: XML エンティティーが正しくない原因となったバージョン番号をポイントする正しいアップグレード手順さらに、アップグレード手順をクリーンアップし、主要な概念をよりダイジェスト可能な情報チャンクに分割します。
改訂 3.3-46Thu Dec 11 2014Jared イタリア
コマンドライン手順で rhqctl.sh への誤った参照が修正されました。
改訂 3.3-45Mon Nov 24 2014ella Deon Baard
アップグレードの手順を修正しました。
改訂 3.3-42Mon Nov 24 2014Jared イタリア
https://bugzilla.redhat.com/show_bug.cgi?id=1162646: コマンドを修正し、rhqctl に関連するシェルを追加します。この操作の Hitchcock が原因です。
https://bugzilla.redhat.com/show_bug.cgi?id=1148991: 非推奨の rhq-encode-password.sh スクリプトを説明するために追加されました。

法律上の通知
リンクのコピー

著作権 © 2017 Red Hat。
このドキュメントのテキストおよび図は、Red Hat によって Creative Commons Attribution-Share Alike 3.0 Unported ライセンス("CC-BY-SA")でライセンスが適用されています。CC-BY-SA についての説明は、 http://creativecommons.org/licenses/by-sa/3.0/.CC-BY-SA に従って、本書を配布したり、その適合を配布する場合は、元のバージョンの URL を指定する必要があります。
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by apply.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linusinusvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent.Red Hat Software Collections は、公式の Joyent Node.js オープンソースまたは商用プロジェクトによって正式に関連または承認されていません。
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission.We are not affiliated with, endorsed or stuorsed by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

Legal Notice

Theme

© 2026 Red Hatトップに戻る