After installing AM 9.1, RA Agents fail to start and result in a java.lang.NoClassDefFoundError

Document ID : KB000084713
Last Modified Date : 14/04/2018
Show Technical Document Details
Issue:
Error Message :
java.lang.NoClassDefFoundError: org/apache/commons/logging/Log/Factory

After upgrading to Applications Manager 9.1.0 RA Agents will not start and in the AgentService log you will see errors similar to these:
 
18:05:03.909 AgentService: AwE-9999
18:05:03.911 AgentService: .AxOptions: NoErrorMsgProperties=false
ErrorMsg: AwE-9999 Internal error (2/9/16 6:05 PM)
Details: [OCTEST, No_Service, 02:24:49, N, 99, 2016-02-09 15:40:14.0, OFFLINE, OFFLINE, 306, 3, TTPOSOCTJS01, Y, 99_ALL_DAY, BannerAgent, UNIX, 47, 7, JAVA_AGENT , 99, 0, CPU, APPMGR, MGRSTOPPED, 1, null, null, null, null, null]
java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
at org.apache.bsf.BSFManager.<init>(BSFManager.java:102)
at com.appworx.automic.ra.extensibility.container.C.A(CITContainer.java:533)
at com.appworx.automic.ra.extensibility.container.C.<init>(CITContainer.java:234)
at com.appworx.agent.extensibleagent.A.Ñ(GenericExtensibleAgent.java:395)
at com.appworx.agent.AgentService.B(AgentService.java:1096)
at com.appworx.agent.AgentService.A(AgentService.java:1026)
at com.appworx.agent.AgentService.<init>(AgentService.java:450)
at com.appworx.agent.AgentService.main(AgentService.java:999)
Caused by: java.lang.ClassNotFoundException: org.apache.commons.logging.LogFactory
at java.net.URLClassLoader.findClass(URLClassLoader.java:381)
at java.lang.ClassLoader.loadClass(ClassLoader.java:424)
at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:331)
at java.lang.ClassLoader.loadClass(ClassLoader.java:357)
 
Beginning in AM 9.1 some of the jar files used by the RA Agents were moved to another directory, $AW_HOME/web/axis2.  However, the RA Agents are still looking for the files in the $AW_HOME/web/classes directory. 

 
Environment:
OS Version: N/A
Cause:
Cause type:
Defect
Root Cause: New v.9.1.0 Remote RA Agent installations fail to start after the install is complete. The AwE-9999 error may contain details similar to the following: java.lang.NoClassDefFoundError: org/apache/commons/logging/LogFactory
Resolution:
Update to a fix version listed below or a newer version if available.

Fix Status: Released

Fix Version(s):
Applications Manager 9.1.1 - Available
Additional Information:
Workaround :
Copy the following jar files from the $AW_HOME/web/axis2 directory to the $AW_HOME/web/classes directory:

commons-codec-1.3.jar
commons-fileupload-1.2.jar
commons-httpclient-3.1.jar
commons-io-1.4.jar
commons-logging-1.1.jar