Author: veithen
Date: Wed Dec 28 11:20:23 2011
New Revision: 1225163
URL: http://svn.apache.org/viewvc?rev=1225163&view=rev
Log:
Refreshing the page with the instructions for deployment on WebSphere 7.0 since
this is a popular question.
Modified:
axis/axis2/java/core/site/docs/app_server.html
Modified: axis/axis2/java/core/site/docs/app_server.html
URL:
http://svn.apache.org/viewvc/axis/axis2/java/core/site/docs/app_server.html?rev=1225163&r1=1225162&r2=1225163&view=diff
==============================================================================
--- axis/axis2/java/core/site/docs/app_server.html (original)
+++ axis/axis2/java/core/site/docs/app_server.html Wed Dec 28 11:20:23 2011
@@ -1,5 +1,5 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd";>
-<!-- Generated by Apache Maven Doxia at Sep 9, 2011 -->
+<!-- Generated by Apache Maven Doxia at Dec 28, 2011 -->
<html xmlns="http://www.w3.org/1999/xhtml"; xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
@@ -11,7 +11,7 @@
@import url("../css/site.css");
</style>
<link rel="stylesheet" href="../css/print.css" type="text/css"
media="print" />
- <meta name="Date-Revision-yyyymmdd" content="20110909" />
+ <meta name="Date-Revision-yyyymmdd" content="20111228" />
<meta http-equiv="Content-Language" content="en" />
</head>
@@ -31,7 +31,7 @@
<div class="xleft">
- <span id="publishDate">Last Published: 2011-09-09</span>
+ <span id="publishDate">Last Published: 2011-12-28</span>
| <span id="projectVersion">Version: 1.6.1</span>
</div>
<div class="xright"> <a href="../index.html"
title="Axis2/Java">Axis2/Java</a>
@@ -271,6 +271,9 @@
Before deploying the Axis2 WAR, edit the
<tt>axis2.xml</tt> file and set the
<tt>EnableChildFirstClassLoading</tt> parameter to
<tt>true</tt>.
Please note that this parameter is only supported in
Axis2 1.5.5 or higher.
+ The parameter is already present in the default
<tt>axis2.xml</tt> file included in the
+ WAR distribution, but its value is set to
<tt>false</tt>. Therefore it is enough to change
+ the parameter value.
</li>
<li>
After deployment, modify the application configuration
to enable parent last class loading
@@ -300,6 +303,29 @@
Axis2 to use a repository location outside of the
<tt>installedApps</tt> directory.
</p>
</div>
+ <div class="section"><h3>Deploying older Axis2 versions<a
name="Deploying_older_Axis2_versions"></a></h3>
+ <p>
+ The instructions given above apply to Axis2 1.5.5 or
higher. Older versions don't support
+ the <tt>EnableChildFirstClassLoading</tt> parameter, and
we don't provide any support for
+ deploying these versions on WAS 6.1 (with the Web Services
feature pack installed) or 7.0.
+ However, IBM has published a <a class="externalLink"
href="https://www-304.ibm.com/support/docview.wss?uid=swg21315686";>technote</a>
+ with an alternative approach that may work for older Axis2
versions.
+ </p>
+ </div>
+ <div class="section"><h3>Known issues<a
name="Known_issues"></a></h3>
+ <p>
+ On some WAS versions the following error may occur, e.g.
when accessing a WSDL exposed by Axis2:
+ </p>
+<div><pre>java.lang.VerifyError: JVMVRFY013 class loading constraint violated;
+class=org/apache/xerces/dom/CoreDocumentImpl,
method=getDomConfig()Lorg/w3c/dom/DOMConfiguration</pre></div>
+ <p>
+ This is caused by the XmlBeans library
+ packaged with Axis2. This library contains a set of
interfaces in the <tt>org.w3c.dom</tt> package
+ and this may cause issues with class loaders that don't
use a simple parent-first policy.
+ To avoid this issue, upgrade your WAS to a more recent fix
pack level, remove the XmlBeans library
+ from the Axis2 WAR or remove the content of the
<tt>org.w3c.dom</tt> package from the XmlBeans library.
+ </p>
+ </div>
</div>
