Red Hat Training

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

第5章 JBoss ON CLI コマンド構文

JBoss ON CLI はシェルおよびインタープリターであるため、コマンドおよびステートメントを JBoss ON サーバーに対して対話的に実行できます。ファイルに保存されたスクリプトも実行できるため、JBoss ON サーバーの操作を自動化できます。
バグを報告します。

5.1. CLI スクリプト

CLI スクリプトは、cli-install-dir/bin ディレクトリーから直接実行されます。JBoss ON CLI の起動に関連するファイルが 2 つあります。
  • スクリプト(rhq-cli.sh|bat)
  • 環境変数のファイル(rhq-cli-env.sh|bat)
    rhq-cli-env.sh|bat ファイルの環境変数は、ほとんどのデプロイメントで妥当なデフォルトを使用するため、このファイルを編集する必要はありません。変数をリセットして、仮想マシンやデフォルト以外の JVM などのデフォルトのインストールに従わないサーバーをポイントすることができます。rhq-cli-env.|bat ファイルの上部にあるコメントには、利用可能な環境変数の詳細リストが含まれます。
    重要
    rhq-cli.sh|bat ファイルは編集しないでください。スクリプト自体ではなく、ターミナルまたは rhq-cli-env.sh|bat ファイルで環境変数のみを設定します。
注記
にある Java 6 インストールへの正しいパスを必ず設定してください。 RHQ_CLI_JAVA_HOME または RHQ_CLI_JAVA_EXE_FILE_PATH 変数。
この rhq-cli.sh|bat スクリプトには、以下の一般的な構文があります。 
rhq-cli.sh|bat options
ユーザー名の指定など、引数を指定せずに CLI スクリプトを起動できます。これにより、サーバーに接続 せず に CLI クライアントが開きます。 
[jsmith@server bin]$ cliRoot/rhq-remoting-cli-4.9.0.JON320GA/bin/rhq-cli.sh
RHQ - RHQ Enterprise Remote CLI 
unconnected$
スクリプトはログインせずに実行できますが、CLI の機能の多くは利用できません。JBoss ON CLI を実際に使用するには、ユーザー名とパスワードを渡すか、CLI の起動後に login コマンドを使用して、JBoss ON ユーザーとしてサーバーにログインします。 
[jsmith@server bin]$ rhq-cli -u rhqadmin -p rhqadmin
CLI では、対話モードと非対話式の 2 つの操作モードを利用できます。
インタラクティブモードは、個別のステートメントを実行します。インタラクティブモードは、CLI のプロトタイプ、テスト、学習、および検出のためのシンプルな環境を提供します。
非対話モードは指定のスクリプトファイルを読み込み、複数のコマンドを順番に実行します。非対話モードでは、管理リソースでのメトリクスの収集やスケジュールされた操作の実行などのタスクを自動化する機能を提供します。
重要
このようなネイティブコマンドは quit、などのネイティブコマンドは対話モードでのみ利用できます。ファイルからスクリプトを実行する場合など、CLI が非対話モードで使用されている場合はスクリプトで使用 できません。このような場合には、Java メソッドを使用します。
ログイン後、コマンド（で確認 「インタラクティブな CLI コマンド」）をサーバーに渡すことができます。
重要
CLI をどのユーザーが実行する場合でも（つまり、システムユーザーが rhq-cli.sh スクリプトを実行するもの）は、CLI の logs/ ディレクトリーへの書き込みアクセスが必要になります。
CLI が root としてインストールされている場合は、通常ユーザーは CLI を実行できず、書き込みエラーで失敗します。
バグを報告します。