You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by ru...@apache.org on 2001/08/13 20:27:35 UTC
cvs commit: xml-axis/java/docs install.html
rubys 01/08/13 11:27:35
Modified: java/docs install.html
Log:
Strike xml-soap references as Glen finds it confusing ;-)
(Just kidding, it really doesn't belong - the point of this document
is how easy it is to get up and running with xml-axis, not to compare
it to other products).
Also update the reference to the current class name for the AdminClient.
Revision Changes Path
1.6 +24 -43 xml-axis/java/docs/install.html
Index: install.html
===================================================================
RCS file: /home/cvs/xml-axis/java/docs/install.html,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- install.html 2001/06/08 02:18:48 1.5
+++ install.html 2001/08/13 18:27:35 1.6
@@ -1,4 +1,4 @@
-<html>
+html>
<head>
<title>Axis installation instructions</title>
<style type=text/css>
@@ -19,7 +19,7 @@
<img border=0 align=left src="axis.jpg" />
</a>
<div class="head">
-Installing and deploying web applications using xml-soap and xml-axis
+Installing and deploying web applications using xml-axis
</div>
</td>
</tr>
@@ -65,8 +65,8 @@
<tr><td class="section">Introduction</td></tr>
</table>
- <p>This document describes how to install both the xml-soap and xml-axis
- implementation side by side in as unobtrusive of a manner as possible.
+ <p>This document describes how to install xml-axis
+ in as unobtrusive of a manner as possible.
There will be no editing of configuration files, setting of server
classpaths, or the
like. Instead, these instructions will rely only on the automatic
@@ -80,9 +80,9 @@
<p>In your servlet installation, you should find a directory into which web
applications (webapps) are to be placed. Into this directory copy the
- webapps/soap directory from the xml-soap distribution, and the webapps/axis
- from the xml-axis distribution. You can actually name these
- directories anything you want, just be aware that the names you choose will
+ webapps/axis directory
+ from the xml-axis distribution. You can actually name this
+ directory anything you want, just be aware that the name you choose will
form the basis for the URL by which clients will access your service.</p>
<a name="depend"/>
@@ -90,30 +90,24 @@
<tr><td class="section">Step 2: installing the dependencies</td></tr>
</table>
- <p>In each of the directories you just created, you will find a WEB-INF
- directory. These contains some basic configuration information, but
+ <p>In the directory you just created, you will find a WEB-INF
+ directory. This contains some basic configuration information, but
can also be used to contain the dependencies and web services you wish to
deploy. This is actually the recommended way to deploy as the servlet
engine will then keep each web application isolated from each other.</p>
- <p>In each WEB-INF directory, create a "lib" directory. </p>
+ <p>In the WEB-INF directory, create a "lib" directory. </p>
<ul>
- <li>In the soap/WEB-INF/lib directory, copy the soap.jar from the xml-soap
- distribution as well as the xerces.jar from the xml-xerces distribution,
- mail.jar from javamail, and activation.jar from jaf.</li>
- <li>In the axis/WEB-INF/lib directory, copy the axis.jar from the xml-axis
- distribution as well as the xerces.jar from the xml-xerces distribution.
+ <li>In this directory, copy the axis.jar from the xml-axis
+ distribution as well the jars associated with the JAXP 1.1 XML
+ compliant parser of yourc chioce. This generally means either the
+ xerces.jar from the xml-xerces distribution, or the crimson.jar and
+ jaxp.jar from the JAXP 1.1 reference implementation.
</li>
</ul>
<p><span class="note">Note:</span>
- Note that there is no requirement that the xerces.jar's be at the same
- level. Early versions of xml-soap will not work with later versions of
- xml-xerces. If you are running with soap 2.1 or earlier, place a 1.3.0
- or earlier version of xerces.jar into the soap/WEB-INF/lib directory, but
- feel free to place a later version of xml-xerces in the corresponding
- axis/WEB-INF/lib directory. The servlet engine will keep it all
- straight. In fact, the servlet engine may very well use a different
- xml-parser entirely!</p>
+ Note that there is no requirement that each webapp or the web server itself
+ use the same xml parsers.</p>
<a name="websvc"/>
<table width=100%>
@@ -123,10 +117,8 @@
<p>If you got this far, the next step should be simple: </p>
<p>In each WEB-INF directory, create a "classes" directory. </p>
<ul>
- <li>In the soap/WEB-INF/classes directory, copy the services you wish to
+ <li>In this directory, copy the services you wish to
install, being careful to preserve the directory structure.</li>
- <li>In the axis/WEB-INF/lib directory, copy the services you wish to
- install, being careful to preserve the directory structure.</li>
</ul>
<p>Again, isolation is preserved. And, by the way, should your
services already be packaged into jar files, feel free to drop them into the
@@ -159,16 +151,11 @@
are a number of ways to do this, for now I'll simply describe one way that
is suitable for automation.</p>
<ul>
- <li>Temporarily add soap.jar, xerces.jar, mail.jar, activation.jar, and
- servlet.jar to your classpath. Locate the deployment descriptor
- for your service and execute the following command:
- <blockquote><code>
- java org.apache.soap.server.ServiceManagerClient http://localhost:8080/soap/servlet/rpcrouter deploy DeploymentDescriptor
- </code></blockquote>
- </li>
- <li>Temporarily add axis.jar and xerces.jar to your classpath. Locate the deployment descriptor
+ <li>Temporarily add axis.jar and the XML parser jar file or files (e.g.,
+ xerces.jar) to your
+ classpath. Locate the deployment descriptor
for your service and execute the following command:
- <blockquote><code>java org.apache.axis.client.http.AdminClient -lhttp://localhost:8080/axis/servlet/AxisServlet
+ <blockquote><code>java org.apache.axis.client.AdminClient -lhttp://localhost:8080/axis/servlet/AxisServlet
deploy.xml</code></blockquote>
</li>
@@ -187,14 +174,8 @@
purposes, it is presumed that you have installed and deployed the stockquote
demo.</p>
<ul>
- <li>Temporarily add soap.jar, xerces.jar, mail.jar, activation.jar as well
- as "." (your current working directory) to your classpath.
- Change directory to the distribution directory for xml-soap and execute
- the following command:
- <blockquote><code>java samples.stockquote.GetQuote
- http://localhost:8080/soap/servlet/rpcrouter IBM</code></blockquote>
- </li>
- <li>Temporarily add axis.jar, xerces.jar as well as "." (your
+ <li>Temporarily add axis.jar, and the parser jar or jars (e.g.,
+ xerces.jar) as well as "." (your
current working directory) to your classpath. Change directory to
the distribution directory for xml-axis and execute the following
command: