- How do I change the hostname that the Control-M/Server uses to identify itself to the Control-M/Agents?
- What are the steps to update the Control-M/Server to use a different hostname or machine name or an alias or virtual name (DNS CNAME)?
 

The name that the Control-M server uses to communicate with is set in the ctm_menu as the parameter "Local IP host interface name".
This parameter can be accessed using the ctm_menu on the following screen: ctm_menu --> parameter customizaton --> basic communication

=== Configuration of CONTROL-M/Server network parameters ===
CONTROL-M/Server parameters
1 : Local IP host interface name : <hostname_value>

This name must resolve to an IP address on the host where Control-M Server is running and be reachable by all of the agents.
This name is stored in the config.dat as the parameter as "OS_PRM_HOSTNAME". If this parameter does not exist then the $HOSTNAME value for
Unix is used or the %COMPUTERNAME% value is used for Windows.

Additionally, on every Control-M Agent, the "Local IP host interface name" value must be listed as an "Authorized Control-M/Server Hosts" using the 'ctmagcfg' utility.  The Agent can be configured to have multiple "Authorized Control-M/Server Hosts" values.
Both the Agent and Control-M Server have to be restarted after changing these values.

Here are the steps:
1. Add the new Control-M Server "Local IP host interface name" to the Agents "Authorized Control-M/Server Hosts" list so that it has both the new and the old "Local IP host interface name".
2. Restart the Agent.
3. Do this for all agents
4. Update the Control-M/Servers "Local IP host interface name" and restart the Control-M Server.
5. After everything has been verified, you can remove the old "Local IP host interface name" from the Agents
"Authorized Control-M/Server Hosts" list

The following video demonstrates this article: