<?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> |