Setting the interface name in the database and configuration files for cloud computers

This procedure describes how to set the interface name in the database and configuration files when Control-M/EM is running on a cloud environment. Cloud computers often switch published host (interface) name after being recycled. The new interface name value must be updated in configuration files, such as CONFIG_HA.ini and in the database tables such as CONFREG.

To set the interface name:

1. Stop all Control-M/EM processes in the secondary intallation environment and then in the primary and distributed installation environments.
2. From a command line type one of the following:
   • UNIX: em restore_host_config –interface_name [-silent] [-name <new interface name>] [[-password <dbo password>] or [-password_file [<file_path>]]]
   • Windows: restore_host_config –interface_name [-silent] [-name <new interface name>] [[-password <dbo password>] or [-password_file [<file_path>]]]

   NOTE:

   • <new interface name> is the new interface name to publish. This parameter cannot be defined on AWS computers.
   • If the -silent flag is not specified and optional parameters are not defined in the command line, the script asks for the relevant input interactively.
   • The -name flag can be specified to define a customized interface (published) host name, if it is not available to the software.
   • The script must be executed with this option on each High Availability or distributed installation where the interface name is modified.