Skip to main content


The Apache Axis2 servlet is not accessible after deploying the Apache Axis2 engine

 Technote (troubleshooting)
 
Problem(Abstract)
After deploying the Apache Axis2 engine in a runtime environment for IBM WebSphere Application Server, the Apache Axis2 servlet is not accessible.

Apache Axis2 applications do not run in a runtime environment for WebSphere Application Server.
 
Cause
WebSphere Application Server Version 7.0 requires Apache Axis2 Version 1.4.1.
In previous levels of the Apache Axis2 engine, the Web application was packaged with libraries that attempt to override the standard servlet classes in the runtime environment for WebSphere Application Server. This process does not comply with the constraints of the Java™ Servlet Specification, Version 2.5, section SRV.9.7.2.
 
Resolving the problem
If you attempt to deploy the Apache Axis2 engine onto WebSphere Application Server V7.0 and you encounter errors, you must upgrade to the Apache Axis2 Version 1.4.1 engine.
After you upgrade to Apache Axis2 V1.4.1 engine, you must perform the following steps, which change the structure of the Apache Axis2 Web application so that it is recognized by WebSphere Application Server:
  1. Locate the WEB-INF/modules directory within the Apache Axis2 Web application. The WEB-INF/modules directory contains the archive files, which are required by the Apache Axis2 run time.
    Note: These files do not have a .jar extension and the files do not exist in the WEB-INF/lib directory.

    According to section SRV.9.5 in version 2.5 of the Java Servlet specification, the default class path of a Web application includes the classes in the WEB-INF/classes directory and any files that end with a .jar extension in the WEB-INF/lib directory.
  2. Copy any files that end with a .mar extension in the WEB-INF/modules directory of the Axis2 Web application to the WEB-INF/lib directory. Rename these files with a .jar extension.

    Important: Do not use the move function, but copy the files from the WEB-INF/modules directory to the WEB-INF/lib directory. The Apache Axis2 engine looks for the files in the WEB-INF/modules directory. However, the files must reside in the WEB-INF/lib directory with the .jar extension so that the files are visible to the class loaders for WebSphere Application Server.
  3. Deploy the Apache Axis2 V1.4.1 engine on WebSphere Application Server.
  4. Change the class loading policy of the Apache Axis2 V1.4.1 Web application to ensure that the parent class loader of the application is used last when the class loader searches for classes. Make sure that you change the class loading policy for the Web application archives (WAR) module containing Axis2. Do not change the class loading policy for the application enterprise archive (EAR) file.

    For more information on the configuring application class loaders, see the "Configuring application class loaders" topic in the Information Center for WebSphere Application Server Version 7.0.
 
Related information
Release notes for Version 7.0
 
 
Cross Reference information
Segment Product Component Platform Version Edition
Application ServersWebSphere Application Server for z/OSWeb Services(for example: SOAP or UDDI or WSGW/WSIF)z/OS7.0
 
 

Copyright and trademark information

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.

Rate this page

Please take a moment to complete this form to help us better serve you.

This material provides me with the information I need.






This material is clear and easy to understand.






Did the information help you to achieve your goal?

What updates, improvements, or related information would you like to see in this document?

Your response will be used to improve our document content. Requests for assistance, if applicable, should be submitted through your normal support channel as we cannot respond from this site.

Input the verification number to submit feedback:


Close [x]

Maintenance Window

  • The IBM Technical support pages, including the Downloads and Drivers Finders will be temporarily unavailable for up to 4 hours due to planned maintenance. This will take place between Saturday November 14, 2009 9:00 PM ET and Sunday, November 15, 2009 7:00 AM ET. During the maintenance, you will not be able to search or download from these pages.

Close [x]

Unscheduled Maintenance Window

There is no unscheduled maintenance scheduled at this time.

Document information

Product categories:

Software

Application Servers

Distributed Application & Web Servers

WebSphere Application Server

Web Services (for example: SOAP or UDDI or WSGW or WSIF)

Operating system(s):

AIX, HP-UX, IBM i, Linux, Solaris, Windows

Software version:

7.0

Software edition:

Base, Express, Network Deployment

Reference #:

1315686

IBM Group:

Software Group

Modified date:

2008-09-19

Translate my page

Rate this page

Availability Notices