第3章 コマンド

3.1. RHEVM への接続

3.1.1. RHEVM への接続 (connect)

connect コマンドは、Red Hat Virtualization Manager に接続します。.rhevmshellrc ファイルでは Red Hat Virtualization Manager へ接続するための URL、ユーザー名、認証局、パスワードを設定することができます。connect コマンドは、ユーザーが毎回オプションを指定する必要なしに、このファイルのパラメーターを使用して Manager に接続します。
構文

connect [options]

注記

.rhevmshellrc ファイルでユーザー名、パスワード、URL、認証局ファイルを設定した場合は、追加オプションを指定する必要はありません。

表3.1 connect のオプション

オプション説明必須
--urlRed Hat Virtualization Manager の REST API への URL。形式は https://[server]/api となります。はい
--usernameRed Hat Virtualization Manager へアクセスを試行するユーザーのユーザー名およびディレクトリーサービスドメイン。形式は [username]@[domain] となります。はい
--passwordRed Hat Virtualization Manager へアクセスを試行するユーザーのパスワードはい
--key-fileSSL 経由で接続するための鍵ファイルいいえ
--cert-fileSSL 経由で接続するための証明書ファイルいいえ
--ca-fileSSL 経由で接続するための認証局ファイルはい (--insecure の使用時は除く)
--insecureCLI から認証なしに SSL 経由で接続することができるようになります。このオプションにより、中間者 (MITM) 攻撃によるサーバーのなりすましが可能となってしまう場合があるため、細心の注意を払って使用してください。はい (認証局が提示されていない場合のみ)
--filterユーザーのパーミッションに基づいたフィルタリングを有効にします。いいえ
--port--url の一部として指定されていない場合の REST API への接続ポート番号いいえ
--timeout接続のタイムアウトいいえ

例3.1 .rhevmshellrc が設定されていない場合の connect の例

[RHEVM shell (disconnected)]# connect --url "https://rhevm.example.com/api" --username "admin@exampleids.com" --password "p@55w0rd!" --ca-file "/home/user/ca.crt"

 ==========================================
 >>> connected to RHEVM manager 4.0.0.0 <<<
 ==========================================

[RHEVM shell (connected)]#

注記

証明書を指定せずに「--insecure」オプションを使用して証明書なしに接続することができますが、中間者攻撃によるサーバーのなりすましが可能になる場合があるため、このオプションの使用は推奨していません。

3.1.2. RHEVM からの接続解除 (disconnect)

disconnect コマンドで Red Hat Virtualization Manager への接続を解除します。
構文

disconnect

例3.2 disconnect の例

[RHEVM shell (connected)]# disconnect

  =======================================
  >>> disconnected from RHEVM manager <<<
  =======================================

[RHEVM shell (disconnected)]#