Axis2
  1. Axis2
  2. AXIS2-4917

Provide proper documentation on deploying Axis2 in WebSphere

    Details

    • Type: Task Task
    • Status: Resolved
    • Priority: Minor Minor
    • Resolution: Fixed
    • Affects Version/s: None
    • Fix Version/s: 1.6.1, 1.7.0
    • Component/s: documentation
    • Labels:
      None

      Description

      Because WebSphere's JAX-WS implementation is based on Axis2, there are issues when deploying Axis2 on WAS 7.0 (and presumably on WAS 6.1 with the Web Services feature pack installed) because of conflicts with the Axis2 classes used internally by WebSphere. To solve this, it is necessary to change the class loader policy of the Web module to parent-last. However, this is not sufficient because Axis2 creates additional class loaders for modules and services, and these are parent-first.

      In particular, there is an issue with the addressing module because org.apache.axis2.handlers.addressing.AddressingInHandler is present both in the WebSphere runtime and the addressing module shipped with Axis2. Since the module class loader is parent-first (and the class is not present in the Web application class loader), it is WebSphere's version of the class that will be loaded. This results in the following exception:

      java.lang.ClassCastException: org.apache.axis2.handlers.addressing.AddressingInHandler incompatible with org.apache.axis2.engine.Handler

      As a workaround, IBM proposes [1] to add copies of the module files as JAR files to WEB-INF/lib. However, a simpler solution is to switch the module class loader to parent-last. This is made possible by AXIS2-4349, which will be available in 1.5.5.

      The different options to deploy Axis2 in WebSphere should be properly documented, i.e. [2] needs to be updated.

      [1] http://www-01.ibm.com/support/docview.wss?rs=0&q1=axis2&q2=technote&uid=swg21315686&loc=en_US&cs=utf-8&cc=us&lang=en
      [2] http://axis.apache.org/axis2/java/core/docs/app_server.html

        Issue Links

          Activity

          Andreas Veithen created issue -
          Andreas Veithen made changes -
          Field Original Value New Value
          Link This issue depends on AXIS2-4349 [ AXIS2-4349 ]
          Andreas Veithen made changes -
          Comment [ hh added via SOAP::Lite ]
          Andreas Veithen made changes -
          Fix Version/s 1.5.5 [ 12316011 ]
          Hide
          Hudson added a comment -

          Integrated in Axis2 #814 (See https://builds.apache.org/job/Axis2/814/)
          AXIS2-4917: Added documentation explaining how to deploy Axis2 on WebSphere, especially WAS 7.0.

          veithen :
          Files :

          • /axis/axis2/java/core/trunk/src/site/xdoc/docs/app_server.xml
          Show
          Hudson added a comment - Integrated in Axis2 #814 (See https://builds.apache.org/job/Axis2/814/ ) AXIS2-4917 : Added documentation explaining how to deploy Axis2 on WebSphere, especially WAS 7.0. veithen : Files : /axis/axis2/java/core/trunk/src/site/xdoc/docs/app_server.xml
          Andreas Veithen made changes -
          Status Open [ 1 ] Resolved [ 5 ]
          Fix Version/s 1.6.1 [ 12316466 ]
          Fix Version/s 1.7.0 [ 12316136 ]
          Resolution Fixed [ 1 ]
          Hide
          Hudson added a comment -

          Integrated in axis2-1.6 #52 (See https://builds.apache.org/job/axis2-1.6/52/)
          AXIS2-4917: Merged r1138144 and r1138203 to the 1.6 branch for inclusion in the Axis2 1.6.1 site.

          veithen :
          Files :

          • /axis/axis2/java/core/branches/1_6/src/site/xdoc/docs/app_server.xml
          • /axis/axis2/java/core/branches/1_6
          Show
          Hudson added a comment - Integrated in axis2-1.6 #52 (See https://builds.apache.org/job/axis2-1.6/52/ ) AXIS2-4917 : Merged r1138144 and r1138203 to the 1.6 branch for inclusion in the Axis2 1.6.1 site. veithen : Files : /axis/axis2/java/core/branches/1_6/src/site/xdoc/docs/app_server.xml /axis/axis2/java/core/branches/1_6
          Gavin made changes -
          Link This issue depends on AXIS2-4349 [ AXIS2-4349 ]
          Gavin made changes -
          Link This issue depends upon AXIS2-4349 [ AXIS2-4349 ]

            People

            • Assignee:
              Andreas Veithen
              Reporter:
              Andreas Veithen
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved:

                Development