update_password

Updates passwords or other credentials for a given target.

Format

emcli update_password
        -target_type="ttype"
        -target_name="tname"
        -credential_type="cred_type"
        -key_column="column_name:column_value"
        -non_key_column="col:oldvalue:newvalue;..."
        [-input_file="tag1:file_path1;tag2:file_path2;..."]

[ ]  indicates that the parameter is optional

Options

• target_type

  Type of target.

• target_name

  Name of the target.

• credential_type

  Credential type to use. The type must be a base type, not a derived type. A derived type contains the XML tag <CredentialTypeRef> within its definition.

• key_column

  Name and value of the key column for the credential type. Usually, the key column represents the user name. To get the key column for a target type, you can execute following EM CLI verbs:

  emcli show_credential_type_info — Displays key columns for all target types.

  emcli show_credential_type_info -target_type=<target_type> — Displays key columns for a specific target type.

• non_key_column

  Name, old value, and new value of the non-key column(s) to modify. Usually, this is the name of the password column. Alternatively, a tag from the -input_file argument can be used so that the credential values are not seen on the command line. You can specify this option more than once.

• input_file

  Path of the file that has non_key_column argument(s). This option is used to hide passwords. You must accompany each path with a tag that is referenced in the non_key_column argument. You can specify this option more than once.

  You can obtain the list of columns and the credential types they belong to by using the emcli show_credential_type_info command.

  For more information about the input_file parameter, see -input_file Syntax Guidelines.

Examples

Example 1

emcli update_password
          -target_type=oracle_database
          -target_name=myDB
          -credential_type=DBCreds
          -key_column="DBUserName:joe"
          -non_key_column="DBPassword:oldPass:newPass"
          -non_key_column="DBRole:normal:sysdba"

Example 2

In This example, FILE1 is a tag used to refer to the contents of passwordFile. The contents of the password file is:

DBPassword:oldPass:newPass;DBRole:normal:sysdba

Note that this example has the same effect as Example 1.

emcli update_password
          -target_type=oracle_database
          -target_name=myDB
          -credential_type=DBCreds
          -key_column="DBUserName:joe"
          -non_key_column="FILE1"
          -input_file="FILE1:passwordFile"