modify_target

ターゲット・インスタンスの定義を変更します。

ノート:

データベース・ターゲットのモニタリング・パスワードを変更するには、update_db_password (RACレベル)を使用するか、次のオプションを付けてmodify_targetを使用します。

-credentials="UserName:newuser;password:PWD_FILE;Role:SYSDBA" 
-input_file="PWD_FILE:at_pwd_file"

書式

emcli modify_target
      -name="name"
      -type="type"
      [-properties="pname1:pval1;pname2:pval2;..."]...
      [-separator=properties="sep_string"]
      [-subseparator=properties="subsep_string"]
      [-credentials="userpropname:username;pwdpropname:password;..."]
      [-input_file="parameter_tag:file_path"]
      [-display_name="display name"]
      [-on_agent]

[ ]  indicates that the parameter is optional

オプション

name

ターゲット名。
type

ターゲット・タイプ。
properties

ターゲット・インスタンスのプロパティの名前と値のペアのリストです。nameは、ターゲット・タイプのメタデータ定義で識別されます。そのファイルで定義されている名前と完全に一致する必要があります。メタデータ・ファイルは、$AGENT_ORACLE_HOME/sysman/admin/metadataにあります。

ノート:

このverbは、グローバルなターゲット・プロパティの設定をサポートしていません。ターゲット・プロパティを設定するには、set_target_property_valuesを使用することをお薦めします。
separator=properties

-propertiesオプションの値で、名前と値のペアを区切る文字列デリミタを指定します。デフォルトのセパレータ・デリミタは「;」です。
subseparator=properties

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

ターゲット・インスタンスのモニタリング資格証明(名前と値のペア)。nameは、ターゲット・タイプのメタデータ定義で資格証明プロパティとして識別されます。そのファイルで定義されている名前と完全に一致する必要があります。メタデータ・ファイルは、$AGENT_ORACLE_HOME/sysman/admin/metadataにあります。
input_file

-credentialsオプションとともに使用すると、パスワードなどの特定のターゲットのモニタリング資格証明の値を別のファイルで格納できます。-input_fileオプションでは、タグとローカルのファイル・パス間のマッピングを指定します。タグは、-credentialsオプションの特定のモニタリング資格証明のかわりに指定します。タグにはコロン(:)とセミコロン(;)は使用できません。

input_fileパラメータの詳細は、「-input_fileの構文ガイドライン」を参照してください。
display_name

ターゲットの表示名を設定します。
on_agent

このターゲットのメトリックを収集する管理エージェントに変更を伝播します。

例

例1

この例では、databaseという名前のoracle_databaseターゲットの表示名とプロパティを変更します。on_agentフラグは、このターゲット用に収集する管理エージェントに変更が伝播されるようにします。

emcli modify_target
      -name="database"
      -type="oracle_database"
      -display_name="New Name DB"
      -properties="SID=newsid|Port=15091|OracleHome=/oracle"
      -properties="MachineName=smpamp-sun1.example.com"
      -separator=properties="|"
      -subseparator=properties="="
      -on_agent

例2

この例では、payroll_dbという名前のoracle_databaseターゲット・タイプを変更します。この例では、このデータベースの表示名(Enterprise Manager UIに表示されるターゲット名)がpayrollに変更されています。ポート番号は15067に、Oracleホームは/oradbに変更されています。前のデフォルトのロールがnormalだった管理者(dbsnmp)はsysdbaに変更されています。この例は、input_fileを使用して資格証明をカモフラージュする方法も示しています。パスワードは、実際にはat_pwd_fileという名前のファイルにあります。-input_file引数は、PWD_FILEを-credentialsオプションのat_pwd_fileの内容に置き換えています。

emcli modify_target
      -name="payroll_db"
      -type="oracle_database"
      -credentials="UserName:Fred;password:PWD_FILE;Role:sysdba"
      -properties="Port:15067;OracleHome:/oradb"
      -input_file="PWD_FILE:at_pwd_file"
      -display_name=payroll
      -on_agent

例3

この例では、TARGET_NAMEという名前の既存のApache Tomcatターゲットを変更します。ここで、ターゲットのSSLトラスト・ストアの場所が変更されます。

emcli modify_target 
		-name="TARGET_NAME" 
		-type="tomcat"
		-properties="SSLTrustStore:AGENT_HOME/agent_inst/sysman/config/montrust/AgentTrust.jks"
		-separator=properties=";" 
		-subseparator=properties=":" 
		-on_agent

例4

この例では、TARGET_NAMEという名前の既存のApache Tomcatターゲットを変更します。ここで、ターゲットのSSLトラスト・ストアの場所とSSLトラスト・ストア・パスワードが変更されます。

emcli modify_target 
		-name="TARGET_NAME" 
		-type="tomcat"
		-properties="SSLTrustStore:AGENT_HOME/agent_inst/sysman/config/montrust/AgentTrust.jks;SSLTrustStorePassword:welcome"
		-separator=properties=";"
		-subseparator=properties=":" 
		-on_agent

バグ修正1

この例では、RACおよびOracle DatabaseターゲットのORACLE_HOMEプロパティを更新します。RACターゲットを更新するには、合計4つの文が必要です。このコマンドは、RACターゲット内のOracle Databasesで実行する必要があります。

emcli modify_target(name="<TARGET_NAME>",type="rac_database",properties="OracleHome:/opt/oracle/product/11.2.0/racdb11204")
    modify_target(name="<TARGET_NAME>",type="oracle_database",properties="OracleHome:/opt/oracle/product/11.2.0/racdb11204",on_agent=True)
    modify_target(name="<TARGET_NAME>",type="oracle_database",properties="OracleHome:/opt/oracle/product/11.2.0/racdb11204",on_agent=True)
    modify_target(name="<TARGET_NAME>",type="oracle_database",properties="OracleHome:/opt/oracle/product/11.2.0/racdb11204",on_agent=True)