| <?xml version="1.0" encoding="iso-8859-1"?> | |
| <!-- | |
| ~ Licensed to the Apache Software Foundation (ASF) under one | |
| ~ or more contributor license agreements. See the NOTICE file | |
| ~ distributed with this work for additional information | |
| ~ regarding copyright ownership. The ASF licenses this file | |
| ~ to you under the Apache License, Version 2.0 (the | |
| ~ "License"); you may not use this file except in compliance | |
| ~ with the License. You may obtain a copy of the License at | |
| ~ | |
| ~ http://www.apache.org/licenses/LICENSE-2.0 | |
| ~ | |
| ~ Unless required by applicable law or agreed to in writing, | |
| ~ software distributed under the License is distributed on an | |
| ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY | |
| ~ KIND, either express or implied. See the License for the | |
| ~ specific language governing permissions and limitations | |
| ~ under the License. | |
| --> | |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" | |
| "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd"> | |
| <html xmlns="http://www.w3.org/1999/xhtml"> | |
| <head> | |
| <meta name="generator" content= | |
| "HTML Tidy for Windows (vers 14 June 2007), see www.w3.org" /> | |
| <meta http-equiv="content-type" content= | |
| "text/html; charset=us-ascii" /> | |
| <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> | |
| <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 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, | |
| WebLogic server (WLS) breaks with AXIOM on the WLS classpath. Hence | |
| a filtering classloader is required:</p> | |
| <p>Adding the following to weblogic-application.xml should resolve | |
| this 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>Note that the libraries listed--Xerces, StAX API, Woodstox--need | |
| to be on the application classpath.</p> | |
| </body> | |
| </html> |