Axis2 Installation in Websphere:=

The following tutorial is about Axis2 Installation in Websphere 8.0 to 8.0.0.8

Step 1: Download the Required Axis2 War file from the Apache Axis Website
http://axis.apache.org/axis2/java/core/
Click on the Releases

Step 2: Download the Version you need to install

You can choose Axis2 1.6.1 or 1.6.2

Step 3: Extract the war file from the Zip file

Step 4: For convenience i have renamed the war file with specific version names

axis2.war to axis2_1_6_1.war / axis2_1_6_2.war depends on the version of war file which you have downloaded

Then Open the Zip file in the WinZip / 7Zip / Any Other utility

Step 5: Update the axis2.xml with the following attribute from false to true

Step 6: Update the file in the axis2_1_6_2\WEB-INF \conf folder

Step 7: Navigate to Websphere 8.0 Admin Console

Application --> Application Types --> Websphere enterprise applications --> Install

Step 8: Click choose in the install page

Step 9: Browse and Select the updated war file axis2_1_6_2.war (**Updated Axis2.xml must be in the war file)

Step 10: Click Next after selecting the war file

Step 11: Select Fast Path and Click Next

Step 12: Click Next with default parameters

Step 13: Click Next in Map Modules to Server

Step 14: Click Next in Map Virtual Host

Step 15: Provide the Context Root as /axis2 and Click Next

Step 16: Click Finish in the Summary Screen

Step 17: Click save directly to master configuration

Step 18: Click on the deployed war file

Step 19: Click on Class Loading and update detection

Step 20: Select Classes loaded with local class loader first (parent last) and click apply

Step 21: Click Save directly to the master configuration

Step 22: Click on the deployed war file

Step 23: Click on Manage Modules

Step 24: Click on the Module Name Hyperlink Apache-Axis2

Step 25: From the drop down Class Loader Order --> Select Classes loaded with local class loader first (parent first) and click apply

Step 26: Save directly to master configuration

Step 27: Click Ok

Step 28: Save directly to master configuration

Step 29: Select the war file and Click Start

Step 30: Application started successfully message will be displayed

Step 31: Open the url http://localhost:9080/axis2/services/Version?getVersion

Apache Axis 1.6.1 --> Run's fine in Websphere 8.0 at different patch levels

Apache Axis 1.6.2 --> Needs special changes in Websphere 8.0 at different patch levels especially for UNIX or LINUX operating system. In windows it will work fine for the above instruction.

I would strongly recommend to go for the latest version as of now 1.6.2

If you using Apache Axis2 1.6.2 in UNIX or LINUX you need to follow the below steps too

Step 32(Only for LINUX & UNIX OS): Copy (Not Move) the mar file to a jar file and move it to single jar file aall_module_secure.jar

The final jar file should be placed to the WEB-INF\lib

Rationale: IBM Websphere 8.0.0.1 doesn’t class load automatically for modules

Step 33 (Only for LINUX & UNIX OS): Don't use the default axis2.xml from Apache Axis2 1.6.2 you need to get the axis2.xml from the IBM Websphere server local /apps/WebSphere8/AppServer/plugins/org.apache.axis2.jar

org.apache.axis2.jar contains the axis2.xml file and other modules

Troubleshooting:

In case of any problem first thing to check is go the url http://localhost:9080/axis2/ and click validate

Make sure the jar files are loaded from WEB-INF/lib from the screen shot

If you have something like below then you have missed the Step 24, 25 and 26.

You can see that the axis jar file is loaded from Websphere instead of WEB-INF lib which is wrong
\WebSphere\AppServer\plugins\org.apache.axis2.jar

Examining webapp configuration

Essential Components
Found Apache-Axis (org.apache.axis2.transport.http.AxisServlet)
  at C:\IBM\WebSphere\AppServer\plugins\org.apache.axis2.jar
Found Jakarta-Commons Logging (org.apache.commons.logging.Log)
  at C:\IBM\WebSphere\AppServer\plugins\com.ibm.ws.prereq.commons-logging.jar
Found Streaming API for XML (javax.xml.stream.XMLStreamReader)
  at an unknown location
Found Streaming API for XML implementation (org.codehaus.stax2.XMLStreamWriter2)
  at C:\IBM\WebSphere\AppServer\profiles\AppSrv01\installedApps\AARYAN-VAIONode01Cell\axis2_1_6_2_war.ear\axis2_1_6_2.war\WEB-INF\lib\wstx-asl-3.2.9.jar
The core axis2 libraries are present.
Note: Even if everything this page probes for is present, there is no guarantee your Axis Service will work, because there are many configuration options that we do not check for. These tests are necessary but not sufficient

Examining Version Service

There was a problem in Axis2 version service , may be the service not available or some thing has gone wrong. But this does not mean system is not working ! Try to upload some other service and check to see whether it is working.

Troubleshooting based on Log file errors

Problem#1

If you get the error as below,

[29/04/14 21:42:56:607 EDT] 0000001c webapp E com.ibm.ws.webcontainer.webapp.WebApp logServletError SRVE0293E: [Servlet Error]-[AxisServlet]: org.apache.axis2.AxisFault: The system is attempting to engage a module that is not available: addressing
at org.apache.axis2.engine.AxisConfiguration.engageModule(AxisConfiguration.java:584)
at org.apache.axis2.engine.AxisConfiguration.engageGlobalModules(AxisConfiguration.java:705)
at org.apache.axis2.deployment.DeploymentEngine.engageModules(DeploymentEngine.java:831)
at org.apache.axis2.deployment.WarBasedAxisConfigurator.engageGlobalModules(WarBasedAxisConfigurator.java:300)
at org.apache.axis2.context.ConfigurationContextFactory.createConfigurationContext(ConfigurationContextFactory.java:94)
at org.apache.axis2.transport.http.AxisServlet.initConfigContext(AxisServlet.java:584)
at org.apache.axis2.transport.http.AxisServlet.init(AxisServlet.java:454)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.init(ServletWrapper.java:329)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.init(ServletWrapperImpl.java:168)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:577)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:449)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.handleRequest(ServletWrapperImpl.java:178)
at com.ibm.ws.webcontainer.filter.WebAppFilterManager.invokeFilters(WebAppFilterManager.java:1020)
at com.ibm.ws.webcontainer.servlet.CacheServletWrapper.handleRequest(CacheServletWrapper.java:87)
at com.ibm.ws.webcontainer.WebContainer.handleRequest(WebContainer.java:883)
at com.ibm.ws.webcontainer.WSWebContainer.handleRequest(WSWebContainer.java:1659)
at com.ibm.ws.webcontainer.channel.WCChannelLink.ready(WCChannelLink.java:195)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleDiscrimination(HttpInboundLink.java:452)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleNewRequest(HttpInboundLink.java:511)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.processRequest(HttpInboundLink.java:305)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.ready(HttpInboundLink.java:276)
at com.ibm.ws.tcp.channel.impl.NewConnectionInitialReadCallback.sendToDiscriminators(NewConnectionInitialReadCallback.java:214)
at com.ibm.ws.tcp.channel.impl.NewConnectionInitialReadCallback.complete(NewConnectionInitialReadCallback.java:113)
at com.ibm.ws.tcp.channel.impl.AioReadCompletionListener.futureCompleted(AioReadCompletionListener.java:165)
at com.ibm.io.async.AbstractAsyncFuture.invokeCallback(AbstractAsyncFuture.java:217)
at com.ibm.io.async.AsyncChannelFuture.fireCompletionActions(AsyncChannelFuture.java:161)
at com.ibm.io.async.AsyncFuture.completed(AsyncFuture.java:138)
at com.ibm.io.async.ResultHandler.complete(ResultHandler.java:204)
at com.ibm.io.async.ResultHandler.runEventProcessingLoop(ResultHandler.java:775)
at com.ibm.io.async.ResultHandler$2.run(ResultHandler.java:905)
at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1648)

[29/04/14 21:42:56:612 EDT] 00000020 SystemOut O [INFO] OMException in getSOAPBuilder
org.apache.axiom.om.OMException: SOAP message MUST NOT contain a Document Type Declaration(DTD)
at org.apache.axiom.soap.impl.builder.StAXSOAPModelBuilder.createDTD(StAXSOAPModelBuilder.java:455)
at org.apache.axiom.om.impl.builder.StAXOMBuilder.next(StAXOMBuilder.java:282)
at org.apache.axiom.soap.impl.builder.StAXSOAPModelBuilder.getSOAPEnvelope(StAXSOAPModelBuilder.java:198)
at org.apache.axiom.soap.impl.builder.StAXSOAPModelBuilder.<init>(StAXSOAPModelBuilder.java:154)
at org.apache.axiom.soap.impl.builder.StAXSOAPModelBuilder.<init>(StAXSOAPModelBuilder.java:140)
at org.apache.axis2.builder.BuilderUtil.getSOAPBuilder(BuilderUtil.java:686)
at org.apache.axis2.transport.TransportUtils.createDocumentElement(TransportUtils.java:197)
at org.apache.axis2.transport.TransportUtils.createSOAPMessage(TransportUtils.java:145)
at org.apache.axis2.transport.TransportUtils.createSOAPMessage(TransportUtils.java:108)
at org.apache.axis2.transport.TransportUtils.createSOAPMessage(TransportUtils.java:67)
at org.apache.axis2.description.OutInAxisOperationClient.handleResponse(OutInAxisOperation.java:354)
at org.apache.axis2.description.OutInAxisOperationClient.send(OutInAxisOperation.java:421)
at org.apache.axis2.description.OutInAxisOperationClient.executeImpl(OutInAxisOperation.java:229)
at org.apache.axis2.client.OperationClient.execute(OperationClient.java:165)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:555)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:531)
at com.ibm._jsp._HappyAxis.invokeTheService(_HappyAxis.java:372)
at com.ibm._jsp._HappyAxis._jspService(_HappyAxis.java:512)
at com.ibm.ws.jsp.runtime.HttpJspBase.service(HttpJspBase.java:99)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:668)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.service(ServletWrapper.java:1147)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:722)
at com.ibm.ws.webcontainer.servlet.ServletWrapper.handleRequest(ServletWrapper.java:449)
at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.handleRequest(ServletWrapperImpl.java:178)
at com.ibm.wsspi.webcontainer.servlet.GenericServletWrapper.handleRequest(GenericServletWrapper.java:122)
at com.ibm.ws.jsp.webcontainerext.AbstractJSPExtensionServletWrapper.handleRequest(AbstractJSPExtensionServletWrapper.java:205)
at com.ibm.ws.webcontainer.filter.WebAppFilterManager.invokeFilters(WebAppFilterManager.java:1020)
at com.ibm.ws.webcontainer.servlet.CacheServletWrapper.handleRequest(CacheServletWrapper.java:87)
at com.ibm.ws.webcontainer.WebContainer.handleRequest(WebContainer.java:883)
at com.ibm.ws.webcontainer.WSWebContainer.handleRequest(WSWebContainer.java:1659)
at com.ibm.ws.webcontainer.channel.WCChannelLink.ready(WCChannelLink.java:195)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleDiscrimination(HttpInboundLink.java:452)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleNewRequest(HttpInboundLink.java:511)
at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.processRequest(HttpInboundLink.java:305)
at com.ibm.ws.http.channel.inbound.impl.HttpICLReadCallback.complete(HttpICLReadCallback.java:83)
at com.ibm.ws.tcp.channel.impl.AioReadCompletionListener.futureCompleted(AioReadCompletionListener.java:165)
at com.ibm.io.async.AbstractAsyncFuture.invokeCallback(AbstractAsyncFuture.java:217)
at com.ibm.io.async.AsyncChannelFuture.fireCompletionActions(AsyncChannelFuture.java:161)
at com.ibm.io.async.AsyncFuture.completed(AsyncFuture.java:138)
at com.ibm.io.async.ResultHandler.complete(ResultHandler.java:204)
at com.ibm.io.async.ResultHandler.runEventProcessingLoop(ResultHandler.java:775)
at com.ibm.io.async.ResultHandler$2.run(ResultHandler.java:905)
at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1648)

Solution#1 : (Fix for The system is attempting to engage a module that is not available: addressing)

Axis2.xml file attribute is not updated

And also Step 32 and 33 if you are in UNIX or LINUX

Problem#2

If you get the error as below,

[29/04/14 22:54:55:547 EDT] 00000017 WarBasedAxisC E org.apache.axis2.deployment.WarBasedAxisConfigurator <init> org.apache.commons.fileupload.FileUploadException

org.apache.axis2.deployment.DeploymentException: org.apache.commons.fileupload.FileUploadException

at org.apache.axis2.deployment.AxisConfigBuilder.processMessageBuilders(AxisConfigBuilder.java:774)

at org.apache.axis2.deployment.AxisConfigBuilder.populateConfig(AxisConfigBuilder.java:234)

at org.apache.axis2.deployment.DeploymentEngine.populateAxisConfiguration(DeploymentEngine.java:859)

at org.apache.axis2.deployment.WarBasedAxisConfigurator.<init>(WarBasedAxisConfigurator.java:156)

at org.apache.axis2.transport.http.AxisServlet.initConfigContext(AxisServlet.java:569)

at org.apache.axis2.transport.http.AxisServlet.init(AxisServlet.java:457)

at com.ibm.ws.webcontainer.servlet.ServletWrapper.init(ServletWrapper.java:329)

at com.ibm.ws.webcontainer.servlet.ServletWrapperImpl.init(ServletWrapperImpl.java:168)

at com.ibm.ws.webcontainer.servlet.ServletWrapper.load(ServletWrapper.java:1283)

at com.ibm.ws.webcontainer.filter.WebAppFilterManager.invokeFilters(WebAppFilterManager.java:973)

at com.ibm.ws.webcontainer.webapp.WebApp.handleRequest(WebApp.java:3639)

at com.ibm.ws.webcontainer.webapp.WebGroup.handleRequest(WebGroup.java:304)

at com.ibm.ws.webcontainer.WebContainer.handleRequest(WebContainer.java:950)

at com.ibm.ws.webcontainer.WSWebContainer.handleRequest(WSWebContainer.java:1659)

at com.ibm.ws.webcontainer.channel.WCChannelLink.ready(WCChannelLink.java:195)

at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleDiscrimination(HttpInboundLink.java:452)

at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.handleNewRequest(HttpInboundLink.java:511)

at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.processRequest(HttpInboundLink.java:305)

at com.ibm.ws.http.channel.inbound.impl.HttpInboundLink.ready(HttpInboundLink.java:276)

at com.ibm.ws.tcp.channel.impl.NewConnectionInitialReadCallback.sendToDiscriminators(NewConnectionInitialReadCallback.java:214)

at com.ibm.ws.tcp.channel.impl.NewConnectionInitialReadCallback.complete(NewConnectionInitialReadCallback.java:113)

at com.ibm.ws.tcp.channel.impl.AioReadCompletionListener.futureCompleted(AioReadCompletionListener.java:165)

at com.ibm.io.async.AbstractAsyncFuture.invokeCallback(AbstractAsyncFuture.java:217)

at com.ibm.io.async.AsyncChannelFuture.fireCompletionActions(AsyncChannelFuture.java:161)

at com.ibm.io.async.AsyncFuture.completed(AsyncFuture.java:138)

at com.ibm.io.async.ResultHandler.complete(ResultHandler.java:204)

at com.ibm.io.async.ResultHandler.runEventProcessingLoop(ResultHandler.java:775)

at com.ibm.io.async.ResultHandler$2.run(ResultHandler.java:905)

at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1648)

Caused by: java.lang.NoClassDefFoundError: org.apache.commons.fileupload.FileUploadException

at java.lang.J9VMInternals.verifyImpl(Native Method)

at java.lang.J9VMInternals.verify(J9VMInternals.java:77)

at java.lang.J9VMInternals.initialize(J9VMInternals.java:139)

at java.lang.J9VMInternals.newInstanceImpl(Native Method)

at java.lang.Class.newInstance(Class.java:1345)

at org.apache.axis2.deployment.DescriptionBuilder.processMessageBuilders(DescriptionBuilder.java:230)

at org.apache.axis2.deployment.AxisConfigBuilder.processMessageBuilders(AxisConfigBuilder.java:771)

... 28 more

Caused by: java.lang.ClassNotFoundException: org.apache.commons.fileupload.FileUploadException

at org.eclipse.osgi.internal.loader.BundleLoader.findClassInternal(BundleLoader.java:506)

at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:422)

at org.eclipse.osgi.internal.loader.BundleLoader.findClass(BundleLoader.java:410)

at org.eclipse.osgi.internal.baseadaptor.DefaultClassLoader.loadClass(DefaultClassLoader.java:107)

at java.lang.ClassLoader.loadClass(ClassLoader.java:612)

... 35 more

[29/04/14 22:54:55:548 EDT] 00000017 AxisServlet I org.apache.axis2.util.OnDemandLogger info org.apache.axis2.deployment.DeploymentException: org.apache.commons.fileupload.FileUploadException

[29/04/14 22:54:55:549 EDT] 00000017 servlet E com.ibm.ws.webcontainer.servlet.ServletWrapper init Uncaught.init.exception.thrown.by.servlet

[29/04/14 22:54:55:564 EDT] 00000017 ClusterBuilde I org.apache.axis2.deployment.ClusterBuilder buildCluster Clustering has been disabled

[29/04/14 22:54:55:566 EDT] 00000017 WarBasedAxisC E org.apache.axis2.deployment.WarBasedAxisConfigurator <init> org.apache.commons.fileupload.FileUploadException