This article contains information about how to troubleshoot an Agent that has one of the following issues:
Information needed for analysis:
Files needed for analysis:
Server and Initialdata must be from the same Servicepack, the Agent should be from the same or previous Servicepack.
(Only valid for V9)
! - Note that the Agents of Servicepack 1-4 can only run with an Automation Engine and Initial Data of the same or a later Servicepack level.
Check the TCP/IP settings in the agent logfile.and compare them with the settings in the communication process logfile.
In the [TCP/IP] section you can find out which communication process (CP) was set for the agent to connect to:
20120812/131001.497 - port = 2323
20120812/131001.497 - bindaddr =
20120812/131001.497 - bindlocal = 0
20120812/131001.497 -; try all n seconds to connect to server
20120812/131001.497 - connect = 60
20120812/131001.497 - report = 60
20120812/131001.497 - SendBufferSize = 1048576
20120812/131001.497 - RecvBufferSize = 1048576
20120812/131001.497 - cp = NB0162:2217
In this example you can see that the ip address of the communication process the agent connects to was set to: NB0162:2217
Now look at the communication process logfile:
In the startup section of the communication process logfile you can find the following messages:
U0003492 Server has been started on Host 'NB0162' ('192.168.114.43') with process ID '6564'.
U0003486 ListenSocket with port number '2217' successfully created.
Also have a look at the port settings of the communication process logfiles in the startup section:
20120812/130702.635 - cp1 = 2217
20120812/130702.635 - cp2 = 2218
20120812/130702.635 - cp3 = 2219
20120812/130702.635 - cp4 = 2220
Now we have the information that the communication processes are started on host "NB0162" with the following ports assigned to them:
cp1 = NB0162:2217
cp2 = NB0162:2218
cp3 = NB0162:2219
cp4 = NB0162:2220
The settings information that we have read out of the agent logfile in the [TCP/IP] section is correct the agent is supposed to connect to cp = NB0162:2217.
If the agent and server settings differ from each other no connection can be made and the agent is not connected to the system.
If the above settings are correct, continue the analysis:
In the agent logfile look at the settings [CP_LIST] in the startup section of the agent:
This list is created when the Agent starts and is extended when new communication processes are activated, in some cases we have seen that this list contained information from other systems, this can happen when the Agent was connected to a different system, or if there have been changes in the Host name or TCP/IP scope.
This is the list the Agent will try to get a connection to if the connection to the Communication Process defined in the TCPIP section can't be made.
If there is invalid information in this section, it could also lead to connection issues.
Please erase all false information in the [CP_LIST] section and restart the agent. The list will be updated with the correct information.
If all of the settings above are correct, continue the analysis.
Look at the Agent and CP logfile, around the time the error occurred.
Here is a list of error messages and Knowledge base articles that are linked to these errors. For additional information on the individual errors, refer to the appropriate Known Error article referenced below.
U2000019 The Server is reporting as system 'Automic'. Disconnecting again.
Refer to Known Error Article 000009832 - Agent not starting receive U2001017 error
U0034036 There is no valid license for Agent 'WIN01' (license class 'V', license category 'TestSystem', platform 'EX.OS.WIN').
Refer to Known Error Article 000009834 - Receive U0034036 error when attempting to start Agent
U2000099 Transfer key could not be loaded
Refer to Known Error Article 000009835 - Agent fails to start, receive U2000099 error
U2001017 It was not possible to create list socket because port number '2303' is already in use.
Refer Known Error Article 000009832 - Agent not starting receive U2001017 error
U0003413 Socket call 'recv' returned error code '10054'.
An existing connection was forcibly closed by the remote host.
Refer to Known Error Article 000009579 - Agent down: Error U0003413 - Socket call 'recv' returns error code '10054'.