CA WA Agent installation on i5/OS fails with error: "Agent Install Library: Library check failed. Reason: Unexpected exception: Connection refused:java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:413)"

Document ID : KB000067051
Last Modified Date : 06/03/2018
Show Technical Document Details
Issue:

CA Workload Automation Agent installation on OS/400 fails with error:

Library error
-------------
Agent Install Library: Library check failed. Reason: Unexpected exception:
Connection refused:java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:413)
->1- Retry
2- Cancel
ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE
DEFAULT:

Environment:
CA Workload Automation Agent for i5/OS 11.3 SPx on i5/OS (OS/400 systems).
Cause:
Cause(s)
  • "ping localhost" fails.
  • LOCALHOST is not defined in the HOST table and/or LOOPBACK has not been defined to the TCP/IP interface.
  • The loopback interface is not active.

The System Agent installer on i5/OS checks the library specified during installation. The built-in library check program uses "LOCALHOST" to connect and run the following chkobj commands:

 
CHKOBJ OBJ(QSYS/<userLib>) OBJTYPE(*LIB) MBR(*NONE) AUT(*CHANGE)

CHKOBJ OBJ(QSYS/<userLib>) OBJTYPE(*LIB) MBR(*NONE) AUT(*USE)

Where: <userLib> denotes the Library name specified during installation.

If LOCALHOST is not resolvable, the installation would fail to perform the library check and results in

"Connection refused:java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:413)"

Resolution:

Please look up the host table for LOCALHOST and LOOPBACK entries.

  • At the command line, type CFGTCP(Configure TCP/IP).
  • Select option 10 (Work with TCP/IP Host Table Entries).
  • Verify that the host table contains an entry for the LOOPBACK host name and IP address 127.0.0.1.
  • If the LOCALHOST is not defined, then please add it to either the LOOPBACK line (127.0.0.1) or to the i5 server's own IP Address.
  • To activate the loopback interface:

i.  At the command line, type NETSTAT.

ii. Select option 1 (Work with TCP/IP interface status) for IPv4 interfaces

iii. Scroll down to find the loopback interface (127.0.0.1), and select option 9 (Start) from the Work with TCP/IP interface status menu.

f. Type ping localhost on a command line to verify that LOCALHOST is resolvable.