Question:
- How to change port numbers used by CONTROL-M Server?
- What are the ports numbers that can be changed on the Control-M Server?
 

Answer:
- Following are the ports and procedures to change the ports used by CONTROL-M Server:

1. Control-M Server Inter-process Communications Port
This is used only by CONTROL-M/Server for communication between the processes and only needs to be modified on CONTROL-M/Server.

a) Stop CONTROL-M/Server  (shut_ctm)
b) Run the command ctm_menu as the CONTROL-M/Server User
c) Select the number for option "Parameter Customization"
d) Select the number for option "Basic Communication and Operational Parameters"
e) Select the number for option "Interprocess Communication Port Number"  and set the new port number
g) Start CONTROL-M/Server (start_ctm)

2. CONTROL-M/Enterprise Manager (EM) TCP/IP Port
This is used by CONTROL-M/Server and CONTROL-M/EM Gateway communication, so needs to be modified in both applications as in Part 1 and Part 2: below:

Part 1 - On CONTROL-M/Server:
a) Stop CONTROL-M/Server  (shut_ctm)
b) Run the command ctm_menu as the CONTROL-M/Server User
c) Select the number for option "Parameter Customization"
d) Select the number for option "Basic Communication and Operational Parameters"
e) Select the number for option "Control-M/EM TCP/IP Port Number"  and set its new port number
g) Start CONTROL-M/Server (start_ctm)

Part 2 - On CONTROL-M/Enterprise Manager:
a) From Control-M Configuration Manager (CCM),  stop the gateway for the Data Center that need to be modified
b) Right-click on the Data Center in question and select 'Properties'.
c) Update the Control-M/EM Port number to the desired port number
d) Save and close the Data Center definition
e) Change the value of field 'TCP/IP Port Number' to the same value you set for 'CONTROL-M/EM TCP/IP Port' in ctm_menu mentioned above
e) Recycle CONTROL-M/Server and the Gateway for the Data Center in question in CCM

3. Control-M Agent-to-Server Port Number
This is used by CONTROL-M/Server and CONTROL-M/Agent so needs to be modified in both applications as in Part 1 and Part 2:
This port number will be listening on the Control-M Server.

Part 1 - On CONTROL-M/Server:
a) Shut CONTROL-M/Server (shut_ctm)
b) Run the command ctm_menu as the CONTROL-M/Server user
c) Select the number for option "Parameter Customization"
d) Select the number for option "Basic Communication and Operational Parameters"
e) Select the number for option "Agent-to-Server Port Number""  and set the new port number
f) Start CONTROL-M/Server (start_ctm)

Part 2: - On CONTROL-M/Agent
a) Stop CONTROL-M/Agent
    For Unix: Run shut-ag script
    For Windows: Stop the Agent Service from Windows services console
b) As the CONTROL-M/Agent user, run ctmagcfg utility
c) Select the number for option "Agent-to-Server Port Number" and set the new port number
d) Select 'S' for Save
e) Select 'q' for Quit
f) Start CONTROL-M/Agent
   For Unix: Run start-ag script
   For Windows: Start the Agent Service from Windows services console

4. Control-M Server-to-Agent Port Number
This is used by CONTROL-M/Server and CONTROL-M/Agent so needs to be modified in both applications as in Part 1 and Part 2:
This port number will be listening on the Control-M Agent.

Part 1 - On CONTROL-M/Server:
a) Shut CONTROL-M/Server (shut_ctm)
b) Run the command ctm_menu as the CONTROL-M/Server user
c) Select the number for option "Parameter Customization"
d) Two options available as below:
    To set the default port that CONTROL-M/Server will communicate to ALL Control-M agents
     - select the number for "Default Parameters for Communicating with Agent Platforms".
    OR
    To set the port that CONTROL-M/Server will communicate to a specific Control-M agent
     - select the number for option "Parameters for Communicating with Specific Agent Platform"
e) Select the number for option "Server-to-Agent Port Number" parameter and set the new port number
f) Start CONTROL-M/Server (start_ctm)

Part 2 - On CONTROL-M/Agent:
a) Stop CONTROL-M/Agent
     For Unix: Run shut-ag script
     For Windows: Stop the Agent Service from Windows services console
b) As the CONTROL-M/Agent user, run ctmagcfg utility
c) Select the number for option "Server-to-Agent Port Number" and set the new port number
d) Select 'S' for Save
e) Select 'q' for Quit
f) Start CONTROL-M/Agent
    For Unix: Run start-ag script
    For Windows: Startthe Agent Service from Windows services console

5. Control-M Server High Availability Port Number (For Control-M Server V9 and above only)
This is used only by CONTROL-M/Server for communication between Primary and Secondary Control-M Server in A HA configuration.
This port need to be modified on both Primary and Secondary CONTROL-M/Server. On the primary (or currently active) Control-M/Server:

a) Stop CONTROL-M/Server  (shut_ctm)
b) Run the command ctm_menu as the CONTROL-M/Server User
c) Select the number for option "Parameter Customization"
d) Select the number for option "Basic Communication and Operational Parameters"
e) Select the number for option "High Availability Port Number"  and set the new port number
g) Start CONTROL-M/Server (start_ctm)

On the secondary (or currently inactive) Control-M/Server:
a) Edit ​<Control-M/Server home>/ctm_server/data/config.dat
b) Find this section:
# CA port number for high availability (default 2368)
                              CA_HA_PORT_NUMBER   2368
c) Change it to the same port number as the primary
d) Recycle the  ​config agent 

Additional Information:

1. Control-M/Server for UNIX and Microsoft Windows
2. Control-M/Agent for UNIX and Microsoft Windows
3. Control-M/Enterprise Manager