Agent Will Not Start on AIX After Upgrading JRE to 1.8

Document ID : KB000075062
Last Modified Date : 30/03/2018
Show Technical Document Details
Issue:
After updating the JRE on an AIX machine from 1.6 to 1.8, the agent will no longer start. The following error appears in the <AGENT_HOME>/nohup.stderr file...

Exception in thread "MainThread" cybermation.agent.CybAgentDriver$CybAgentInstantiationError: net (Not found in com.ibm.oti.vm.bootstrap.library.path)
at cybermation.agent.CybAgentDriver.runApplication(Unknown Source)
at cybermation.agent.CybAgentDriver.main(Unknown Source)
Caused by: java.lang.UnsatisfiedLinkError: net (Not found in com.ibm.oti.vm.bootstrap.library.path)
at java.lang.ClassLoader.loadLibraryWithPath(ClassLoader.java:1348) at java.lang.ClassLoader.loadLibraryWithClassLoader(ClassLoader.java:1313)
at java.lang.System.loadLibrary(System.java:552)
Environment:
WA System Agent 11.3.x
AIX
Cause:
Early builds of the agent for AIX did not ship with a JRE. Therefore, they would use a JRE that was loaded at the system level. If the agent is later upgraded to a build that supplies a JRE (SP1 and higher), the LIBPATH variable in the <AGENT_HOME>CybAgent script will still point to the system JRE. If that JRE is updated, it may cause issues with the agent if the new JRE version is not compatible.
Resolution:
If the agent is not updated to at least SP1 or higher, it should first be updated so that it can use the private JRE that ships with the agent.
After updating the agent, or to fix an agent that was already updated that is having this issue, follow these steps...

1. Open <AGENT_HOME>/agentparm.txt and find make sure the following parameter is set as...

oscomponent.libjvmpath=<AGENT_HOME>/jre/lib/ppc/libjava.so

where <AGENT_HOME> is the full path to your agent installation directory.

2. Open the <AGENT_HOME>/cybAgent script and find the LIBPATH variable setting. Remove any reference to a JRE path that is not under the <AGENT_HOME> directory. Add the following two paths to the variable setting replacing <AGENT_HOME> with the actual path to the agent install directory...

<AGENT_HOME>/jre/lib/ppc/classic
<AGENT_HOME>/jre/lib/ppc/