Remote Agent fails to start due to "Connection timed out" error

Products

• CA Automic Applications Manager (AM)

Issue/Introduction

A Remote Agent may fail to start due to the below error seen in the AgentService log.

• ErrorMsg: AwE-5103 network socket error
  Details: master.ip.address:60010
  network socket error : master.ip.address:60010 : java.net.ConnectException: Connection timed out: connect
   at com.appworx.agent.AgentService.createSocket(AgentService.java:644)
   at com.appworx.agent.AgentService.B(AgentService.java:784)
   at com.appworx.agent.AgentService.A(AgentService.java:677)
   at com.appworx.agent.AgentService.<init>(AgentService.java:357)
   at com.appworx.agent.AgentService.main(AgentService.java:1014)
  Caused by: java.net.ConnectException: Connection timed out: connect
   at java.net.DualStackPlainSocketImpl.connect0(Native Method)
   at java.net.DualStackPlainSocketImpl.socketConnect(DualStackPlainSocketImpl.java:79)
   at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350)
   at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)
   at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)
   at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:172)
   at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
   at java.net.Socket.connect(Socket.java:607)
   at sun.security.ssl.SSLSocketImpl.connect(SSLSocketImpl.java:288)
   at sun.security.ssl.BaseSSLSocketImpl.connect(BaseSSLSocketImpl.java:173)
   at com.appworx.agent.AgentService.createSocket(AgentService.java:637)
   ... 4 more
  java.net.ConnectException: Connection timed out: connect
   at java.net.DualStackPlainSocketImpl.connect0(Native Method)
   at java.net.DualStackPlainSocketImpl.socketConnect(DualStackPlainSocketImpl.java:79)
   at java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350)
   at java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)
   at java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)
   at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:172)
   at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)
   at java.net.Socket.connect(Socket.java:607)
   at sun.security.ssl.SSLSocketImpl.connect(SSLSocketImpl.java:288)
   at sun.security.ssl.BaseSSLSocketImpl.connect(BaseSSLSocketImpl.java:173)
   at com.appworx.agent.AgentService.createSocket(AgentService.java:637)
   at com.appworx.agent.AgentService.B(AgentService.java:784)
   at com.appworx.agent.AgentService.A(AgentService.java:677)
   at com.appworx.agent.AgentService.<init>(AgentService.java:357)
   at com.appworx.agent.AgentService.main(AgentService.java:1014)

Environment

Release : 9.4.2

Component : APPLICATIONS MANAGER

Cause

The error indicates that the Agent is unable to reach the Master, likely due to firewall or incorrect port configuration

Resolution

Ensure that the below is correct on the Remote Agent:

• The master host or IP address
• The awcomm port

If a firewall is enabled, ensure the below ports are defined and open:

• The Agent's AgentClientPort 
• The master's MasterServerPort
• The master's awcomm Port