Manual failover not completing in DE (ESP dSeries) when changerole command issued in CLI

Products

• CA Workload Automation DE

Issue/Introduction

The changerole command will not failover Primary server to standby server.  The following error may be observed in DE logs:

202XXXXX 00:00:12.345 [hac] [ERROR] RMI TCP Connection(25)-x.xx.xx.xx: [202X-XX-1XX_00:00:12.345] Peer server cannot be found via RMI. Cannot Change Roles.
java.rmi.UnmarshalException: Error unmarshaling return header; nested exception is: 
 java.io.IOException: Read timed out
 at sun.rmi.transport.StreamRemoteCall.executeCall(StreamRemoteCall.java:254) ~[?:1.8.0_362]

 

 

Environment

DE: 12.0 or above

 

Cause

The RMI ports are not open / blocked between Primary and Standby servers.

Resolution

DE / dSeries requires RMI ports to be open in bidirectional mode between Primary and Standby.  By default the RMI ports are 7598 and 7599. 

To determine the ports, run the following commands on the CLI:

getproperty property("rmi.export.port")

getproperty property("rmi.registry.port")

E.g.