This web page contains the following:
NOTE: The following conventions are used in this document.
ReleaseNotes.html
file for the Java Web Services Developer Pack.
ReleaseNotes.html
file
for instructions on setting the necessary environment variable.
In order to use JAXM from a servlet engine such as Tomcat, the
servlet engine must be able to load the JAXM libraries and also
the libraries JAXM depends on. These libraries are loadable if they are present
in the appropriate servlet engine directory or if they are on the classpath
of the servlet engine.
The libraries that JAXM depends on are in <JAXM-HOME>/lib.
The JAR files for the JAXM infrastructure itself are in
<JAXM-HOME>>/jaxm.
Only those libraries that are not present in the servlet engine need to
be added to the servlet engine's CLASSPATH. If you copy the files as
described in the following directions, you will not need to add anything
to the servlet engine's CLASSPATH.
Note: If you have used JAXM-1.0, you must delete
Note: If you have used JAXM-1.0.1-ea(2), you must delete
Note: If you have used JAXM-1.0, you must delete
Note: If you have used JAXM-1.0.1-ea(2), you must delete
Setting up Tomcat 4
Here is what you need to do to get the JAXM provider and the samples running
on Tomcat 4:
For example,
cd <JAXM-HOME>/lib
cp *.jar <TOMCAT-HOME>/common/lib
For example,
cd <JAXM-HOME>/samples
cp *.war <TOMCAT-HOME>/webapps
For example,
cd <JAXM-HOME>/jaxm
cp jaxm-runtime.jar <TOMCAT-HOME>/common/lib
cd <JAXM-HOME>/jaxm
cp saaj-ri.jar <TOMCAT-HOME>/common/lib
client.jar
from
TOMCAT_HOME/common/lib
, as the filename for this library has
changed in the current release to jaxm-runtime.jar
.
jaxm-client.jar
from
TOMCAT_HOME/common/lib
, as the filename for this library has
changed in the current release to jaxm-runtime.jar
.
For example,
cd <JAXM-HOME>/jaxm
cp jaxm-provider.war <TOMCAT-HOME>/webapps
Starting Tomcat
Windows: <TOMCAT-HOME>\bin\startup
Unix: <TOMCAT-HOME>/bin/startup.sh
http://localhost:8080/index.html
If Tomcat is running, the Tomcat documentation home page will come up.
Downloading Tomcat 3.2.3
Here are the steps for downloading Tomcat version 3.2.3:
http://jakarta.apache.org/builds/jakarta-tomcat/release/v3.2.3/bin/
jakarta-tomcat-3.2.3.zip
and use the window that
appears to indicate where you want the download to go.
jakarta-tomcat-3.2.3.zip
.
At the command line type the following:
unzip jakarta-tomcat-3.2.3.zip
This will create the directory jakarta-tomcat-3.2.3 containing all the
unzipped files. You can delete the zip file once you have unzipped it.
Setting Up Tomcat 3.2.3
For example:
cd <JAXM-HOME>/lib
cp *.jar <TOMCAT-HOME>/lib
For example:
cd <JAXM-HOME>/jaxm
cp jaxm-runtime.jar <TOMCAT-HOME>/lib
cd <JAXM-HOME>/jaxm
cp saaj-ri.jar <TOMCAT-HOME>/lib
client.jar
from
TOMCAT_HOME/lib
, as the filename for this library has
changed in the current release to jaxm-runtime.jar
.
jaxm-client.jar
from
TOMCAT_HOME/common/lib
, as the filename for this library has
changed in the current release to jaxm-runtime.jar
.
For example:
cd <JAXM-HOME>/samples
cp *.war <TOMCAT-HOME>/webapps
<RequestInterceptor
className="org.apache.tomcat.request.Jdk12Interceptor"/>
cd <JAXM-HOME>/jaxm
cp jaxm-provider.war <TOMCAT-HOME>/webapps
TOMCAT_HOME is the full pathname for the directory
jakarta-tomcat-3.2.3
.
For example,
Windows: set TOMCAT_HOME=C:\happy\jaxm\jakarta-tomcat-3.2.3
Unix: setenv TOMCAT_HOME /home/happy/jaxm/jakarta-tomcat-3.2.3
You will find instructions for setting environment variables in the
top level Release Notes file.
Starting Tomcat 3.2.3
Note that these instructions are identical to those for starting Tomcat 4.
Windows: <TOMCAT_HOME>\bin\startup
Unix: <TOMCAT_HOME>/bin/startup.sh
http://localhost:8080/index.html
If Tomcat is running, the Tomcat documentation home page will come up.