1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. add_virtual_platform

add_virtual_platform

Oracle Virtual Platformを、リモートからモニターするためにXenベースのハイパーバイザを追加します。ハイパーバイザ上で実行されている関連付られているOracle ServerおよびOracle Virtual Serverも追加されます。

同時に複数のハイパーバイザを追加できます。このコマンドは、ターゲットを追加するために発行されたジョブの名前と実行識別子を返します。

Oracle Virtual Platformおよびその関連ターゲットを削除するには、delete_target Verbを使用します。

書式

emcli add_virtual_platform 
       -name="host_name/IP_address_or_list_from_an_input_file"
       -agent="agent_target_name"
       [-failover_agent="failover_agent_target_name"]
       -credentials="property_name1:property_value1;property_name2:
           property_value2;..."
	       [-wait_for_completion=true|false]
	       [-wait_for_completion_timeout=<time_in_minutes>]
       [-separator=credentials="separator_for_key_value_pairs"]
	       [-subseparator=credentials="separator_for_key_value_pair"]
       [-input_file="FILE:file_path_or_name:FILE"]

[ ]  indicates that the parameter is optional

オプション

  • name

    Enterprise ManagerでOracle Virtual Platformとして追加されるXenベースのハイパーバイザのIPアドレスまたはホスト名。この値を提供する方法は2つあります。ターゲットが1つのみの場合は、この値は、コマンドラインからホスト名またはIPアドレスを直接渡することができます。値が複数ある場合は、ファイルにホスト名、IPアドレスまたはIPアドレスの範囲を列挙して、-input_fileオプションを使用してその入力ファイル名を渡すことができます。ホスト名またはIPアドレスを区切るには、新しい行を使用します。各行には、マシンのホスト名、IPアドレス、またはIPアドレスの範囲を指定します。

    詳細は、例を参照してください。

  • agent

    Oracle Virtual Platformおよび関連ターゲットをモニターするために使用するプライマリ・エージェントのターゲット名。

  • failover_agent

    Oracle Virtual Platformおよび関連ターゲットをモニターするために使用するフェイルオーバー・エージェントのターゲット名。

  • credentials

    ターゲット・インスタンスのモニタリング資格証明(名前と値のペア)。nameは、ターゲット・タイプのメタデータ定義で資格証明プロパティとして定義されます。メタデータ・ファイルは、$AGENT_HOME/sysman/admin/metadataにあります。

    様々なオプションの詳細は、例を参照してください。

  • wait_for_completion

    発行したジョブが終了するまでCLIが待機するのかを示すフラグ。デフォルト値はfalseです。値がtrueの場合、Oracle Virtual Platformの追加が成功または失敗した際にジョブの進捗状況がコマンドラインに出力されます。

  • wait_for_completion_timeout

    ジョブが終了するためにCLIが停止して待機する時間(分)。このオプションは、wait_for_completionオプションの値がtrueの場合のみ適用されます。値が負またはゼロの場合、ジョブの終了は待機されません。

    詳細は、例を参照してください。

  • separator=credentials

    資格証明のキーと値のペアのカスタムのセパレータ。-credentialsオプションの値で、名前と値のペアを区切る文字列デリミタを指定します。デフォルトのセパレータ・デリミタは「;」です。

    separatorオプションの詳細は、「-input_fileの構文ガイドライン」を参照してください。

  • subseparator=credentials

    キーと値のペアのカスタムのセパレータ。-credentialsオプションの値で、各名前と値のペアの名前と値を区別する文字列デリミタを指定します。デフォルトのセパレータ・デリミタは「:」です。

    subseparatorオプションの詳細は、「-input_fileの構文ガイドライン」を参照してください。

  • input_file

    -credentialsオプションとともにオプションで使用。このオプションを使用すると、パスワードやSSHキーなど特定のターゲットをモニタリングするの資格証明値を別のファイルに設定できます。

    タグとローカルのファイル・パス間のマッピングを指定します。このタグは、特定の-credentialsプロパティ値のかわりに指定します。

例

例1

この例では、パスフレーズなしのSSHキー認証を必要とするUnix Sudoユーザーを使用してOracle Virtual Platformを追加します。SSHプライベート・キー、SSHパブリック・キーおよびパスワードは、入力ファイルより読み取られます。

emcli add_virtual_platform 
      -name=example.com 
      -agent=example.com:1838   
      -credentials='type:DMOvsSshKeyCreds;PrivilegeType:sudo;privilegedUser:true;
            RunAs:root;PrivilegeCommand:/usr/bin/sudo -S -u %RUN_AS% %COMMAND%;
            EnablePseudoTerminal:false;SshPrivateKey:PRIVATE_KEY;
            SshPublicKey:PUBLIC_KEY;OVSUsername:sudoer1;OVSPassword:PWD_FILE' 
      -input_file='PRIVATE_KEY:id_dsa' 
      -input_file='PUBLIC_KEY:id_dsa.pub' 
      -input_file='PWD_FILE:password'

例2

この例では、パスフレーズなしのSSHキー認証を必要とするUnix PowerBrokerユーザーを使用してOracle Virtual Platformを追加します。SSHプライベート・キー、SSHパブリック・キーおよびパスワードは、入力ファイルより読み取られます。

emcli add_virtual_platform 
      -name=example.com 
      -agent=example.com:1838
      -credentials='type:DMOvsSshKeyCreds;PrivilegeType:powerbroker;
           privilegedUser:true;RunAs:root;PrivilegeCommand:
           /usr/bin/pbrun -l -u %RUN_AS% %COMMAND%;
           PowerBrokerProfile:profile;PowerBrokerPasswordPrompt:myprompt;
           SshPrivateKey:PRIVATE_KEY;SshPublicKey:PUBLIC_KEY;
           OVSUsername:myuser;OVSPassword:PWD_FILE' 
      -input_file='PRIVATE_KEY:id_dsa' 
      -input_file='PUBLIC_KEY:id_dsa.pub' 
      -input_file='PWD_FILE:password'