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