If Control-M Enterprise Manager (EM) High Availability (HA) is configured when there is a firewall between the Primary and Secondary Control-M Enterprise Manager (EM) Servers, the failover will fails.  The Control-M EM HA failover will not work if there is a there is a firewall between the Primary and Secondary Control-M Enterprise Manager (EM) Servers.  This is because the EMCHA components on both EM Server are using the random ports to communicate each other for high availability purpose.

 

Apply Control-M/Enterprise Manager 9 fixpack 3 or higher.  If unable to apply maintenance the workaround is to open the firewall ports (all ports) between 2 Control-M EM Enterprise Manager machines (Primary and Secondary).  To fix the ports in the Enterprise Manager:

EM 9.0.00 FP3 
Add a HostPort parameter line for each EM server component, as follows:

• From the Control-M Configuration Manager and change the desired state of the server component to DOWN.
• Ensure that the server component is not running on any EM environment (ps -ef | grep <process name>).
• In the Control-M Configuration Manager, choose Tools => System Parameters.
• In the general section, select the HostPort parameter and click New to open the "Add New Parameter" dialog box.
• In the "Add New Parameter" dialog box, click Advanced.
• Modify the following field values:

Field	Value
Type	General (the default value)
Name	HostPort (the default value)
Value	Host_of_em:23345, which is specified in the format: HostName:port Do not specify 0 as the port number.
Advanced field: Type	<Server Component Name> (*)
Advanced field: Name	* (the default value) (**)
Advanced field: Host	* (the default value)

• Click Save.
• Start the server component using the Control-M Configuration Manager
• Repeat this action for each server component specified in the list below:

                                (*) <Server Component Name> should be:
                                - GUI Server
                                - GCS
                                - Gateway
                                - CMS
                                - Config Agent
                                - Config HA
                                - BIM
                                - Forecast Server
                                - Self Service Server
               
(**) If there are multiple GUI Server and/or Gateway processes, the parameter should be defined for each process, entering the specific name in the “Name” field.
 
EM 9.0.00 FP4
1. Update the existing HostPort single parameter line as follows:

• From the Control-M Configuration Manager change the desired state of the server components to DOWN.
• Ensure that all EM server components are not running on any EM environment (ps -ef | grep <account name>).
• In the Control-M Configuration Manager, choose Tools => System Parameters.
• In case there are multiple HostPort parameter lines already defined for each component, delete them by selecting the specific line and clicking X (Delete) button.
• In the general section, select the original single line HostPort parameter and double-click it to open its definition window.
• In the "Add New Parameter" dialog box, click Advanced.
• Modify the following field’s value:

Field	Value
Type	General (the default value)
Name	HostPort (the default value)
Value	:23345-23362, which is specified in the format: :port1-port2 Where “port1” and “port2” are the lower and upper limits of the ports range to be opened for EM, respectively. Do not specify 0 as the port numbers.
Advanced field: Type	* (the default value)
Advanced field: Name	* (the default value)
Advanced field: Host	* (the default value)

• ​Click Save.

  2. Repeat for all Gateways

•  Select again the above HostPort parameter line and click New to open the "Add New Parameter" dialog box.
• In the "Add New Parameter" dialog box, click Advanced.
• Modify the following field values:

Field	Value
Type	General (the default value)
Name	HostPort (the default value)
Value	{primary}:23363-23366, which is specified in the format: :port1-port2 Where “port1” and “port2” are the lower and upper limits of the ports range to be opened for EM, respectively. Do not specify 0 as the port numbers.
Advanced field: Type	Gateway
Advanced field: Name	* (the default value)
Advanced field: Host	{primary}

• where {primary} is the host name of the primary EM as appears in 'Running on'
• Click Save.
• Create another, similar entry for the secondary EM Server using its name (there will be TWO HostPort entries for Gateway)

 

• Start all server components using the Control-M Configuration Manager

EM 9.0.00 FP5 and higher
Starting with FixPack 5, the Gateway ports need to be defined separately from the other components.

1. Update the existing HostPort single parameter line as follows:

• From the Control-M Configuration Manager change the desired state of the server components to DOWN.
• Ensure that all EM server components are not running on any EM environment (ps -ef | grep <account name>) or Task Manager.
• In the Control-M Configuration Manager, choose Tools => System Parameters.
• In case there are multiple HostPort parameter lines already defined for each component, delete them by selecting the specific line and clicking X (Delete) button.
• In this example, the ports that are available are 23344 - 23366
  • ​Ports 23344 - 23360 will be used for all components, that are not Gateways.
  • Ports 23361 - 23366 will be used for the Gateways.
• In the general section, select the original single line HostPort parameter and double-click it to open its definition window.
• In the "Add New Parameter" dialog box, click Advanced.
• Modify the following field’s value:

Field	Value
Type	General (the default value)
Name	HostPort (the default value)
Value	:23344-23360, which is specified in the format: :port1-port2 Where “port1” and “port2” are the lower and upper limits of the ports range to be opened for EM, respectively. Do not specify 0 as the port numbers.
Advanced field: Type	* (the default value)
Advanced field: Name	* (the default value)
Advanced field: Host	* (the default value)

• Click Save.

  2. Repeat for all Gateways

•  Select again the above HostPort parameter line and click New to open the "Add New Parameter" dialog box.
• In the "Add New Parameter" dialog box, click Advanced.
• Modify the following field values:

Field	Value
Type	General (the default value)
Name	HostPort (the default value)
Value	{primary}: 23361-23366, which is specified in the format: :port1-port2 Where “port1” and “port2” are the lower and upper limits of the ports range to be opened for EM, respectively. Do not specify 0 as the port numbers.
Advanced field: Type	Gateway
Advanced field: Name	* (the default value)
Advanced field: Host	{primary}

• where {primary} is the host name of the primary EM as appears in 'Running on'
• Click Save.
• Create another, similar entry for the secondary EM Server using its name (there will be TWO HostPort entries for Gateway)
• Click Save.
• Start all server components using the Control-M Configuration Manager
•  

The following video shows how to set the value