Menu Close

Red Hat Training

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

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 エージェントをインストールします。エージェントはデフォルトでインストールされます。これを指定すると、エージェントがインストールされ、他のコンポーネントがインストールされていません(明示的に指定されていない限り)。

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.