RA WebService SOAP Agent fails to start due to error "java.lang.NoClassDefFoundError: javax/annotation/Resource"

Products

• CA Automic Applications Manager (AM)

Issue/Introduction

After upgrading Applications Manager, the RA Webservice SOAP Agent fails to start up with the below error found in the AgentService log.

08:56:55.63 AgentService: .A: javax/annotation/Resource
08:56:55.63 AgentService: .A: java.lang.NoClassDefFoundError: javax/annotation/Resource
08:56:55.63 AgentService: AwE-9999
08:56:55.67 AgentService: .AxOptions: NoErrorMsgProperties=false
ErrorMsg: AwE-9999 Internal error (4/25/25, 8:56 AM) 
java.lang.reflect.InvocationTargetException
    at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:118)
    at java.base/java.lang.reflect.Method.invoke(Method.java:580)
    at com.uc4.be.util.InvokeUtil.invoke(InvokeUtil.java:122)
    at com.appworx.automic.ra.extensibility.container.C.A(CITContainer.java:302)
    at com.appworx.agent.extensibleagent.A.Ô(GenericExtensibleAgent.java:515)
    at com.appworx.agent.AgentService.B(AgentService.java:1012)
    at com.appworx.agent.AgentService.A(AgentService.java:955)
    at com.appworx.agent.AgentService.<init>(AgentService.java:439)
    at com.appworx.agent.AgentService.main(AgentService.java:931)
Caused by: java.lang.NoClassDefFoundError: javax/annotation/Resource
    at org.apache.cxf.common.injection.ResourceInjector.<clinit>(ResourceInjector.java:60)
    at org.apache.cxf.bus.extension.ExtensionManagerImpl.loadAndRegister(ExtensionManagerImpl.java:224)
    at org.apache.cxf.bus.extension.ExtensionManagerImpl.activateAllByType(ExtensionManagerImpl.java:142)
    at org.apache.cxf.bus.extension.ExtensionManagerBus.<init>(ExtensionManagerBus.java:145)
    at org.apache.cxf.bus.extension.ExtensionManagerBus.<init>(ExtensionManagerBus.java:151)
    at org.apache.cxf.bus.CXFBusFactory.createBus(CXFBusFactory.java:40)
    at org.apache.cxf.bus.CXFBusFactory.createBus(CXFBusFactory.java:36)
    at org.apache.cxf.bus.CXFBusFactory.createBus(CXFBusFactory.java:32)
    at org.apache.cxf.bus.CXFBusFactory$createBus.call(Unknown Source)
    at org.codehaus.groovy.runtime.callsite.CallSiteArray.defaultCall(CallSiteArray.java:47)
    at org.codehaus.groovy.runtime.callsite.AbstractCallSite.call(AbstractCallSite.java:116)
    at org.codehaus.groovy.runtime.callsite.AbstractCallSite.call(AbstractCallSite.java:120)
    at WebServiceSoapImpl.agentInitialization(WebServiceSoap.groovy:131)
    at java.base/jdk.internal.reflect.DirectMethodHandleAccessor.invoke(DirectMethodHandleAccessor.java:103)
    ... 8 more
Caused by: java.lang.ClassNotFoundException: javax.annotation.Resource
    at com.uc4.extensibility.util.ExtensibleFrameworkClassLoader.loadClass(ExtensibleFrameworkClassLoader.java:1056)
    at com.uc4.extensibility.util.ExtensibleFrameworkClassLoader.loadClas

Environment

Applications Manager version 9.5.x, 9.6
JAVA or OpenJDK 11 or above

Cause

JDK version greater than version 9 doesn't ship with javax.annotation package

Resolution

Workaround:
Download javax.annotation-api-1.3.2.jar and jaxb-api-2.3.1.jar from the below links, place into the $AW_HOME/web/classes directory of the RA Webservice SOAP Agent, and restart Agent process or service.

https://repo1.maven.org/maven2/javax/annotation/javax.annotation-api/1.3.2/javax.annotation-api-1.3.2.jar

https://repo1.maven.org/maven2/javax/xml/bind/jaxb-api/2.3.1/jaxb-api-2.3.1.jar

Solution:
The next release of Applications Manager will include both jar files.