インストールガイド
すべてのサーバーおよびエージェントのインストール手順とガイドライン
Last Updated: 2020-08-30
すべてのサーバーおよびエージェントのインストール手順とガイドライン
Jared Morgan
jmorgan@redhat.com Zach Rhoads
zach@redhat.com Ella Deon Ballard dlackey@redhat.com Tyler Kelly
tkelly@redhat.com
Copyright © 2017 Red Hat.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at
http://creativecommons.org/licenses/by-sa/3.0/
. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
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 applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat 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 Linus Torvalds 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 is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
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 sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
概要 概要
本ガイドでは、
JBoss ON 3.3
サーバーおよびエージェントのインストールおよび設定、およびイ ンベントリーを設定する基本的なタスクについて説明します。. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
. . . .
目次 目次
第
第1章章 JBOSS ON についてについて
1.1. RED HAT JBOSS OPERATIONS NETWORK OVERVIEW 第
第2章章データベースの設定データベースの設定 2.1. POSTGRESQL の設定 2.2. ORACLE の設定 第
第3章章 JBOSS ON SERVER のインストールのインストール
3.1. サポートされるプラットフォーム、データベース、およびその他要件
3.2. ハードウェアの最小
3.3. ディスク領域に関する考慮事項
3.4. *NIX システムへのインストールの準備 3.5. WINDOWS へのインストールの準備 3.6. RHQCTL スクリプトについて
3.7. 基本設定： LINUX へのサーバーのインストール
3.8. 基本設定： MICROSOFT WINDOWS へのサーバーのインストール
3.9. サーバーおよびエージェント間の認証の設定
3.10. 高可用性向けの追加のサーバーのインストール
3.11. サーバーのインストール前のストレージノードのインストール
3.12. サーバーサービスの管理 第
第4章章 JBOSS ON サーバーおよびストレージノードのアップグレードサーバーおよびストレージノードのアップグレード
4.1. アップグレードに関する注意事項
4.2. アップグレードスクリプトについて
4.3. 3.1.X サーバーおよびサーバープラグインのアップグレード
4.4. 3.2 サーバー、ストレージノード、およびサーバープラグインのアップグレード
4.5. サーバーの再インストール
第
第5章章 JBOSS ON サーバーのアンインストールサーバーのアンインストール
5.1. 管理システムでのエージェントのアンインストール
5.2. サーバーのアンインストール
第
第6章章 JAR ファイルからの管理対象プラットフォームでのエージェントのインストールおよびアップグレードファイルからの管理対象プラットフォームでのエージェントのインストールおよびアップグレード
6.1. エージェントのインストール前
6.2. JAR ファイルからのエージェントのインストール
6.3. エージェントのサイレントインストール
6.4. JBOSS ON AGENT をサービスとして実行
6.5. エージェント接続設定の変更
6.6. エージェントの自動更新
6.7. JBOSS ON エージェントの手動アップグレード
6.8. エージェントの再インストール
6.9. エージェントの起動 第
第7章章 RPM からのエージェントのインストールからのエージェントのインストール
7.1. エージェント RPM について
7.2. RPM からのエージェントのインストール
7.3. RPM インストール後のエージェント設定の変更
7.4. JAR インストールから RPM インストールへの移行 7.5. エージェントの起動
7.6. エージェント RPM のアップグレード
7.7. RPM インストールのトラブルシューティング
第
第8章章 JBOSS ON ユーザーインターフェースを使用したエージェントのインストールユーザーインターフェースを使用したエージェントのインストール
4 4 5 5 10 14 14 14 14 15 16 22 27 29 32 32 33 36 38 38 38 40 44 48 49 49 50 52 52 55 58 60 63 63 66 67 67 69 69 73 77 79 81 81 85 86
. . . .
. . . . . . . .
. . . . 8.1. インストールオプション
第
第9章章 JBOSS エージェントプラグインパックのインストールおよび削除エージェントプラグインパックのインストールおよび削除
9.1. JBOSS エージェントプラグインパックのインストール
9.2. JBOSS エージェントプラグインパックの削除
第
第10章章 JBOSS ON CLI のインストールのインストール
第
第11章章インストールとアップグレードに関するトラブルシューティングインストールとアップグレードに関するトラブルシューティング 11.1. 例外ログおよびエラーログ
11.2. コネクションの問題 付録
付録A ドキュメント履歴ドキュメント履歴
87 89 89 90
92 93 93 94 95
第 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 つあります（エージェントの数と他のサーバー数を使用する）。どのメ ソッドも使用すると数値が高くなります。
表
表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 サーバーおよびその関連する データベースのインストールに最低要件が満たされる必要があります。
表
表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 インストールディレクトリーへの環境変数。
a. JBoss ON を実行するシステムユーザー .bashrc に対して開きます。例：
vim /home/jon/.bashrc
b. 設定する行を追加します。 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 ポート」ます。
表
表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 ポート」ます。
表
表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
サービスが同じシステムにインストールされているものの、別々にインストールする場合は、最初 にストレージノードをインストールします。サーバーのインストール時にストレージノードをイン ストールし、実行する必要があります。
表
表3.4 JBoss ON のインストールオプションのインストールオプション オプション
オプション description
--start インストールプロセスが完了すると、すべてのサー
ビスを開始します。
--server サーバーをインストールします。サーバーはデフォ
ルトでインストールされます。これを指定すると、
サーバーがインストールされ、他のコンポーネント はインストールされません（明示的に指定されてい ない限り）。
--storage ストレージデータベースノードをインストールしま す。ストレージデータベースノードはデフォルトで インストールされます。これを指定すると、スト レージデータベースとコンパニオンエージェントが インストールされていますが、サーバーはインス トールされません。
--storage-data-root-dir directory ストレージデータが保存されるディレクトリーを変
更します。デフォルトでは、ストレージノードの ディレクトリーはになりserverRoot/jon-server- 3.3.2.GA/rhq-data/ます。
--agent エージェントをインストールします。エージェント
はデフォルトでインストールされます。これを指定 すると、エージェントがインストールされ、他のコ ンポーネントがインストールされていません（明示 的に指定されていない限り）。
オプション
オプション description
バグを報告します。
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 バイナリーをダウンロードします。
a. カスタマーポータルで Downloads タブをクリックし、Product Downloads ページを開き ます。
b. Software Downloads ページ JBoss Development and Management にアクセスする Red Hat JBoss Operations Network リンクを選択します。
c. Download リンク Red Hat JBoss Operations Network 3.3 Base Distribution をクリック します。
d. 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 バイナリーをダウンロードします。
a. カスタマーポータルで Downloads タブをクリックし、Product Downloads ページを開き ます。
b. Software Downloads ページ JBoss Development and Management にアクセスする Red Hat JBoss Operations Network リンクを選択します。
c. Download リンク Red Hat JBoss Operations Network 3.3 Base Distribution をクリック します。
d. 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 パラメーターは、使用するユーザーアカウントを設定します。この
