| <?xml version="1.0" encoding="iso-8859-1"?> |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" |
| "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> |
| <html> |
| <head> |
| <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" /> |
| <title>Application Server Specific Configuration Guide</title> |
| <meta content="amaya 9.2.1, see http://www.w3.org/Amaya/" /> |
| <link href="../css/axis-docs.css" rel="stylesheet" type="text/css" |
| media="all" /> |
| </head> |
| |
| <body> |
| <h1>Application Server Specific Configuration Guide</h1> |
| |
| <p>This document provides configuration information required for your |
| Application Server to run Apache Axis2 to its fullest potential.</p> |
| |
| <p>Send your feedback or questions to: <a |
| href="mailto:axis-dev@ws.apache.org?subject=[Axis2]">axis-dev@ws.apache.org</a>. |
| ( Subscription details are available on the <a |
| href="http://ws.apache.org/axis2/mail-lists.html">Axis2 site</a>.) Kindly |
| prefix subject with [Axis2].</p> |
| <a></a> |
| |
| <h3>WebLogic/ WebSphere</h3> |
| |
| <p><strong>1. Use exploded configuration to deploy Axis2 WAR</strong></p> |
| |
| <p>We recommend using the exploded configuration to deploy Axis2 WAR in |
| WebLogic and WebSphere application servers to support the hotupdate/ |
| hotdeployment features in Axis2. However, if you do want to deploy custom |
| WARs, say in a clustering environment, you need to add two additional files |
| into the WEB-INF named "services.list" and "modules.list" under the modules |
| and services directory respectively.</p> |
| <ul> |
| <li><b>WEB-INF/services/services.list</b> : should list all the services |
| (aar files) that you want to expose.</li> |
| <li><b>WEB-INF/modules/modules.list</b> : should list all the modules (mar |
| files) that you want to use.</li> |
| </ul> |
| NOTE: In both cases, please list one entry per line. |
| |
| <p>WebLogic ships with JARs that conflict with JARs present in Axis2. |
| Therefore use <prefer-web-inf-classes> to ensure that JARs packaged in |
| Axis2 WAR are picked up from WEB-INF/lib. You can do this by setting the |
| <prefer-web-inf-classes> element in WEB-INF/weblogic.xml to true. An |
| example of weblogic.xml is shown below:</p> |
| <pre><weblogic-web-app> |
| <container-descriptor> |
| <prefer-web-inf-classes>true</prefer-web-inf-classes> |
| </container-descriptor> |
| </weblogic-web-app></pre> |
| |
| <p>If set to true, the <prefer-web-inf-classes> element will force |
| WebLogic's classloader to load classes located in the WEB-INF directory of a |
| Web application in preference to application or system classes. This is a |
| recommended approach since it only impacts a single Web module.</p> |
| |
| <p>Please refer to the following documents in WebLogic/ WebSphere for more |
| information:</p> |
| <ul> |
| <li><a |
| href="http://e-docs.bea.com/wls/docs81/programming/classloading.html">WebLogic |
| ServerApplication Classloading</a>- For more information on how |
| WebLogic's class loader works</li> |
| <li><a |
| href="http://e-docs.bea.com/wls/docs81/webapp/deployment.html">Redeploying |
| a Web Application in Exploded Directory Format</a></li> |
| <li><a |
| href="http://publib.boulder.ibm.com/infocenter/wsiihelp/v8r3/index.jsp?topic=/com.ibm.websphere.ii.product.ce.doc/configuring/iiyviigdepwebexpl.htm">Deploying |
| the Web application in exploded form</a></li> |
| </ul> |
| |
| <p><strong>2. Lack of namespacing on serialised items</strong></p> |
| |
| <p>BEA WebLogic Server 9.0 comes with its own StAX implementation. This |
| results in lack of namespacing on serialised items. In turn, WeLogic server |
| (WLS) breaks with AXIOM on the WLS classpath. Hence a filtering classloader |
| is required:</p> |
| |
| <p></p> |
| |
| <p>Adding the following to weblogic-application.xml should resolve the |
| issue:</p> |
| <pre><prefer-application-packages> |
| <package-name>com.ctc.wstx.*</package-name> |
| <package-name>javax.xml.*</package-name> |
| <package-name>org.apache.*</package-name> |
| </prefer-application-packages></pre> |
| |
| <p></p> |
| |
| <p>Note that the classes - Xerces, StAX API, Woodstox need to be on the |
| application classpath</p> |
| </body> |
| </html> |