EMCTL HAConfig Commands

Table 27-7 lists the EMCTL HA configuration commands.

Table 27-7 EMCTL HA Configuration Commands

EMCTL Commands Description

emctl exportconfig oms [-sysman_pwd <sysman password>]

Exports a snapshot of the OMS configuration to the specified directory. It is recommended to save the configuration details in a secure location and to save it every time there is a change in the configuration. These details will be required during a system recovery.

The parameter descriptions are as below:

  • -oms_only: Specifies the OMS-only backup on Administration server host.

  • -keep_host: Specifies that the host name will also be a part of the backup if no SLB is defined. Use this option only if recovery will be done on a machine that responds to this host name.

emctl importconfig oms -file <backup file> [-no_resecure] [-sysman_pwd <sysman password>] [-reg_pwd <registration password>]

Imports the OMS configuration from the specified backup file. This command is used during a system recovery. The parameter descriptions are as below:

  • -file <backup file>: Indicates the backup file to import from.

  • -no_resecure: Specifies that the system will not re-secure OMS after the import is complete. The default is to re-secure the OMS after the import is complete.

emctl config emrep [-sysman_pwd <sysman password>]

Configures the OMS and repository target. This command is used to change the monitoring Agent for the target and/or the connection string used to monitor this target. The parameter descriptions are as below:

  • -agent <new agent>: Specifies a new destination agent for the emrep target

  • -conn_desc [<jdbc connect descriptor>]: Updates Connect Descriptor with the specified value. If the value is not specified, it is taken from the stored value in emoms.properties.

  • -ignore_timeskew: Ignores time skew on Agents.

emctl config repos [-sysman_pwd <sysman password>]

Configures the repository database target. This command is used to change the monitoring Agent for the target and/or the monitoring properties (host name, Oracle Home and connection string used to monitor this target). The parameter descriptions are as below:

  • -agent <new agent>: Specifies a new destination agent for the repository target.

  • -host <new host>]: Specifies a new host name for the repository target.

  • -oh <new oracle home>: Specifies a new Oracle home for the repository target.

  • -conn_desc [<jdbc connect descriptor>]: Updates Connect Descriptor with the specified value. If the value is not specified, it is taken from the stored value in emoms.properties.

  • -ignore_timeskew: Ignores time skew on Agents.

emctl enroll oms [-as_host <host>] -as_port <port> - as_pws <admin password> -nm_pwd <nodemanager password>

Enrolls the OMS on to the specified Administration Server host. This command is used in the process of recovering an OMS in a multi-OMS environment. The parameter descriptions are as below:

  • -as_port <port>: Specifies the Administration Server secure port.

  • -as_pwd <admin password>: Specifies the Administration Server password.

  • -nm_pwd <nodemanager password>: Specifies the node manager password.