- How to add a new authorized Control-M/Server to the Control-M/Agent configuration?
- How to resolve the error: Host '<Control-M Server Host>' is not authorized.Please add <Control-M Server Host> to authorized servers list?
- How to mass update multiple Control-M/Agents' configurations to add new authorized Control-M/Server ?

Option 1: Use the Control-M Configuration Manager (CCM)
- Run the Control-M Configuration Manager (CCM) GUI
- Right-click on the Control-M/Agent
- Select Properties
- Add the new authorized Control-M Server by selecting from the drop down list in Authorized Control-M/Server list.

Option 2:  Use the Control-M Agent ctmagcfg utility
- Login to the Control-M/Agent host as the Agent user
- Run the command: ctmagcfg
- Select the number for " Authorized Control-M/Server Hosts"
- Add the new authorized Control-M/Server using the pipe (|) in Authorized Control-M/Server Hosts list for multiple hosts.
  For example: Host1|Host2

Option 3:  Use the ctmping utility on the Control-M/Server host
- From the current Control-M/Server which is already the authorized server, issue the following command to add the new authorized Control-M/Server for a Control-M/Agent:

If Control-M/Server version 7.0.00 and earlier:
ctmping -nodeid <agentname> -nodetype regular -authorized_hostname <new_authorized_server>

If Control-M/Server version 8.0.00 and later:
ctmping -hostid <agentname> -hosttype regular -authorized_hostname <new_authorized_server>

Optionally you can add the parameter -quiet to suppress screen output such as when executing this within a script.
The above command can run multiple times and will not add the entry if there is an existing entry for the <new_authorized_server> in the Control-M/Agent configuration.

- To update multiple Control-M/Agents' configurations, use the ctmping utility with -file option to specify multiple Control-M/Agents. The input file should have the following 2 columns for each Control-M/Agent:

• the name (host ID) of the agent or remote host (mandatory)
• the HOSTTYPE (optional)

The delimiter between the name and the HOSTTYPE is a blank or any number of blank spaces.
Where the computer type is not specified, a discovery process attempts to determine the type to be used. 

EXAMPLE: Assume the following computers must be pinged:

Name                 Type
dime                 not specified
comet                Control-M/Agent
mars                 remote host computer

EXAMPLE: The text below specifies the above details in a file:

dime                                                ###HOSTTYPE is not specified
comet REGULAR                           ###Control-M/Agent
mars REMOTE                               ###Remote Host

The syntax for ctmping to mass update multiple Control-M/Agents' configurations to add new authorized Control-M/Server:

ctmping -file <filename created in above format> -authorized_hostname <new_authorized_server>

The following video demonstrates this solution: