[PATCH] Endorsed Standards Override Mechanism

[Dan Chisholm <da...@attbi.com>]

The following is a modification for the Axis install.html file.  I have
added a step that describes
the setup of the Endorsed Standards Override Mechanism.  This setup is
becoming more
important as more users are moving to J2SE v1.4.

The modification is the addition of a new "Step 3".  It describes a
modification to the java.endorsed.dirs system property and it provides an
example using Tomcat's
bin/setclasspath.sh file.

I also removed a sentence from the introduction since it was contradictory
to the new setup procedure.

Steps 3 through 6 of the original document have been renumbered.

If you would like to take a quick look at the modified page, then please see
the following.

http://home.attbi.com/~danchisholm/axis/doc/install.html

Note: The above page is not indexed, so nobody will see it if there is a
problem with the new instructions.

68,73c68,71
<       <p>This document describes how to install xml-axis in as unobtrusive
of a
<         manner as possible.&nbsp; There will be no editing of
configuration files,
<         setting of server classpaths, or the like.&nbsp; Instead, these
instructions
<         will rely only on the automatic configuration and isolation that
every
<         implementation compliant with the servlet 2.2 specification is
required
<         to support.</p>
---
>       <P>This document describes how to install xml-axis in as unobtrusive
of a
>       manner as possible.&nbsp; These instructions primarily rely on the
automatic configuration and isolation
>       that every implementation compliant with the servlet 2.2
specification is
>       required to support.</P>
112a111,155
>     <a name="ESOM"/></a>
>     <TABLE width="100%">
>       <TBODY>
>         <TR>
>           <TD class=section>Step 3: Endorsed Standards Override Mechanism
>     </TD></TR></TBODY></TABLE>
>  <P>When running Axis with Java 2 Standard Edition version 1.4
>  (J2SE v1.4), it is necessary to setup the
>  <A href="http://java.sun.com/j2se/1.4/docs/guide/standards/index.html">
>       Endorsed Standards Override Mechanism</A>.
>     XML parsers and other endorsed standards are included in
>     the J2SE v1.4 release of Java.&nbsp; The java.endorsed.dirs system
>     property is used to override the use of endorsed packages
>     that are included in a Java release such as J2SE v1.4.&nbsp;
>     The WEB-INF/lib directory containing the Axis jar
>     files must be added to the java.endorsed.dirs system property.&nbsp;
>     The following instructions describe the setup for Tomcat 4.
>  </P>
>  <UL>
>       <LI>
>         On a UNIX system, open the
>      %CATALINA_HOME%/bin/setclasspath.sh file and search for the
>      following lines.
>         <BLOCKQUOTE><CODE>
>      # Set the default -Djava.endorsed.dirs argument
>      JAVA_ENDORSED_DIRS="$BASEDIR"/bin:"$BASEDIR"/common/lib
>    </CODE></BLOCKQUOTE></LI>
>    <LI>
>      Add the path to your WEB-INF/lib directory.  For example,
>      if you installed Axis in the webapps/axis directory, the
>      JAVA_ENDORSED_DIRS property would be set as follows.
>         <BLOCKQUOTE><CODE>
>        JAVA_ENDORSED_DIRS="$BASEDIR"/bin:"$BASEDIR"/common/lib:
>        "$BASEDIR"/webapps/axis/WEB-INF/lib
>    </CODE></BLOCKQUOTE></LI>
>    <LI>
>      On a Windows system, JAVA_ENDORSED_DIRS would be set in the
>      setclasspath.bat file as follows.
>      <BLOCKQUOTE><CODE>
>        rem Set the default -Djava.endorsed.dirs argument
>           set JAVA_ENDORSED_DIRS=%BASEDIR%\bin;%BASEDIR%\common\lib;
>           %BASEDIR%\webapps\axis\WEB-INF\lib
>    </CODE></BLOCKQUOTE></LI>
>     </UL>
>
115c158
<       <tr><td class="section">Step 3: installing the web
services</td></tr>
---
>       <tr><td class="section">Step 4: installing the web
services</td></tr>
137c180
<       <tr><td class="section" height="16">Step 4: starting the web
server</td></tr>
---
>       <tr><td class="section" height="16">Step 5: starting the web
server</td></tr>
146c189
<       <tr><td class="section" height="16">Step 5: deploying the web
services</td></tr>
---
>       <tr><td class="section" height="16">Step 6: deploying the web
services</td></tr>
172c215
<       <tr><td class="section" height="16">Step 6: testing</td></tr>
---
>       <tr><td class="section" height="16">Step 7: testing</td></tr>