Red Hat Training

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

2.3. rhqctl コントロールスクリプト

JBoss Operations Network には、サーバーおよびストレージノードの基本的なライフサイクル管理に使用される制御スクリプトがあります。サーバーコンソールを開き、インスタンスの起動および停止、およびコンポーネントのインストールまたはアップグレードを行うことができます。
rhqctl スクリプトには、サブコマンドとオプションがあります。
rhqctl [command] [[options]
オプションは通常、、、、またはにタスクを実行するローカルインスタンスを指定 --server --agent--storageます。

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

この install コマンドは、JBoss ON のサーバー、ストレージノード、およびエージェントを同時に設定します。
3 つの管理サービスをすべて同じシステム(同じ親ディレクトリーから)で実行することが推奨されますが、ストレージノードとは別のマシンで JBoss ON サーバーを実行するのに有益な環境があります。その他の場合は、異なるタイミングで異なるサービスをインストールする必要がある場合があります。
install コマンドには、サービスごとにオプションがあります。このオプションを使用すると、そのサービスだけがインストールされ、他のサービスは除外されます。
たとえば、これにより、サーバー、ストレージノード、およびエージェントが 3 つの異なるコマンド呼び出しにインストールされます。
[root@server bin]# ./rhqctl install --storage --start
[root@server bin]# ./rhqctl install --server --start
[root@server bin]# ./rhqctl install --agent --start
サーバーまたはノードのインストール後には、rhqctl コマンドを使用してインスタンスを起動および停止します。したがって、start/stop コマンドは最も一般的なコマンドです。オプションを指定せずにコマンドを実行すると、そのコマンドはシステム上のすべての JBoss ON インスタンスに対して実行されます。
[root@server bin]# ./rhqctl start
オプションを使用すると、そのインスタンスにのみそのコマンドが実行されます。
[root@server bin]# ./rhqctl start --server --agent

表2.5 rhqctl コマンド

コマンド description
コンソール サービスとしてではなく、フォアグラウンドでサーバーまたはストレージノードを起動します。
install サーバー、ストレージノード、またはエージェントインスタンスをインストールします。
restart JBoss ON サービスを再起動します。サービスの種別が指定されていない場合は、すべてのローカルサービスが再起動されます。
start JBoss ON サービスを開始します。サービスの種別が指定されていない場合は、すべてのローカルサービスが開始されます。
status JBoss ON サービスのステータスを表示します。サービスの種別が指定されていない場合は、すべてのローカルサービスのステータスが表示されます。
stop JBoss ON サービスを停止します。サービスの種別が指定されていない場合は、ローカルサービスがすべて停止します。
アップグレード すべての JBoss ON サービスをアップグレードします。これは、サーバーの移行後に過去のメトリックデータを移行するために再実行することができます。

表2.6 rhqctl オプション

オプション description 許可するコマンド
--start すべてのサービスを起動します。
  • アップグレード
  • install
--server ローカルサーバーの指定コマンドを実行します。このパラメーターを指定すると、コマンドはサーバーに対してのみ実行され、他のコンポーネントは無視されます(明示的に指定されていない限り)。
  • コンソール
  • restart
  • start
  • stop
  • status
  • install
--agent エージェントに対して指定されたコマンドを実行します。このパラメーターを指定すると、コマンドはエージェントに対してのみ実行され、他のコンポーネントは無視されます(明示的に指定されていない限り)。
  • restart
  • start
  • stop
  • status
  • install
--storage ストレージデータベースノードの指定コマンドを実行します。これが指定されている場合、コマンドはストレージデータベースノードに対してのみ実行され、その他のコンポーネントは明示的に指定されていない限り実行されます。
  • コンソール
  • restart
  • start
  • stop
  • status
  • install
--storage-data-root-dir directory ストレージデータが保存されるディレクトリーを変更します。デフォルトでは、ストレージノードのディレクトリーはになり serverRoot/jon-server-3.3.0.GA/rhq-data/ます。
  • install
--from-server-dir directory アップグレードするサーバーへのディレクトリーパスを指定します。
  • アップグレード
--from-agent-dir directory アップグレードするエージェントへのディレクトリーパスを指定します。アップグレードスクリプトは、というサブディレクトリーに、サーバーと同じディレクトリーにエージェントがインストールされていることを前提としてい rhq-agent/ます。このオプションは、エージェントの場所が異なる場合に必要です。
  • アップグレード
--run-data-migrator 既存の JBoss ON SQL データベースから新しい監視ストレージデータベースにデータを移行します。upgrade コマンドは、監視データベースを作成します。このオプションを使用しないと、以前のモニタリングデータは失われます。
  • アップグレード