Control-M/EM Configuration Agent

NOTE: In some cases, after setting a virtual host name online, the physical host name of the cluster node becomes unavailable. In such case, additional configuration is required for the Control-M/EM Configuration Agent. This configuration provides the ability to send life check communications to the Control-M/EM Configuration Agent using the virtual host name.

This configuration should only be used if the Control-M/EM Configuration Agent appears in the Control-M Configuration Manager as Not Responding after starting the Control-M/EM Configuration Agent.

To add a HostPort system parameter for the Control-M/EM Configuration Agent:

1. Stop the Control-M/EM Configuration Agent from root_menu or by running the command stop_config_agent from the shell prompt (this requires the Control-M/EM DBO password).
2. In the Control-M Configuration Manager, choose Tools > System Parameters.
3. In the general section, select the HostPort parameter and click New to open the "Add New Parameter" dialog box.
4. In the Add New Parameter dialog box, click Advanced.
5. Modify the following field values:

   Field	Value
   Type	General (the default value)
   Name	HostPort (the default value)
   Value	vhemxxx:0, which is specified in the format: virtualHostName:port By specifying 0 (zero) as the port number, the Control-M/EM Configuration Agent will listen on a random port that is chosen when the Control-M/EM Configuration Agent starts. If a port other than zero is specified, the Control-M/EM Configuration Agent will use the specified port number.
   Advanced field: Type	Config Agent
   Advanced field: Name	* (the default value)
   Advanced field: Host	* (the default value) Computer hostname

   NOTE: If the installation of the Control-M/EM components is distributed between additional hosts other than the cluster nodes, a separate condition must be specified with the physical host names of each cluster node specified in the Host Name parameter.

6. Click Save.
7. Start the Control-M/EM Configuration Agent.