sun.com docs.sun.com My Sun Worldwide Sites

Previous Previous     Contents     Next Next
Chapter 4

Setup and Configuration

This chapter describes how to set up the SAAJ TCK and JavaTest harness software. Before proceeding with the instructions in this chapter, be sure to install all required software, as described in Chapter 3.

After completing the instructions in this chapter, proceed to Chapter 5 for instructions on running the SAAJ TCK.

This chapter includes the following topics:

4.1 Configuring Your Environment to Run the SAAJ TCK

This section describes how to configure the SAAJ TCK for your environment. After configuring your environment, continue with the instructions in Using the JavaTest Harness Software.


Note - In these instructions, variables in angle brackets need to be expanded for each platform. For example, <TS_HOME> becomes $TS_HOME on Solaris/Linux and %TS_HOME% on Windows 2000/XP. In addition, the forward slashes (/) used in all of the examples need to be replaced with backslashes (\) for Windows 2000/XP. Finally, be sure to use the appropriate separator for your operating system when specifying multiple path entries (; on Windows, : on UNIX/Linux).


ProcedureTo Configure Your Environment for the SAAJ TCK

  1. Set the following environment variables in your shell environment:

    1. JAVA_HOME to the directory in which Java SE 5 is installed

    2. TS_HOME to the directory in which the SAAJ TCK 1.3 software is installed

    3. SAAJ_HOME to the directory in which the SAAJ RI software is installed

    4. CATALINA_HOME to the directory in which the Apache Tomcat 5.5.x Web Container is installed

    5. ANT_HOME should not be set in your environment. If it is set, either unset it or make sure it is set to <TS_HOME>/tools/ant. The tsant script automatically sets ANT_HOME if it is unset in the environment.

  2. Edit your <TS_HOME>/bin/ts.jte file and set the following environment variables:

    1. Set the webServerHost property to the name of the host on which your Web server is running.

      The default setting is localhost.

    2. Set the webServerPort property to the port number of the host on which the Web server is running.

      The default setting is 8080.

    3. Set the local.classes property to point to the SAAJ RI classes/jars. You also need to include the servlet-api.jar, which you can include from the appropriate location within the reference implementation under test.

      For the Apache Tomcat 5.5.x standalone Web Container your local.classes property setting should be:

      local.classes=${env.SAAJ_HOME}/lib/saaj-api.jar:
      ${env.SAAJ_HOME}/lib/saaj-impl.jar:
      ${env.SAAJ_HOME}/lib/activation.jar:
      ${env.CATALINA_HOME}/common/lib/servlet-api.jar

    4. Set the webserver.container property to the supported web container type used for testing.

      The supported web container type for standalone web applications is Tomcat via tomcat.xml. By default this is set to tomcat.xml.

    5. Set the webcontainer.home property to the location in which the Web container under test is installed.

      The supported web container type for standalone Web applications is Tomcat, so this property should be set to where your Tomcat is installed.

    6. Set the porting.ts.url.class.1 property to your porting implementation class that is used for obtaining URLs.

      The default setting for the Sun RI porting implementation is:

      com.sun.ts.lib.implementation.sun.common.SunRIURL

  3. Provide your own implementations of the porting package interfaces provided with the SAAJ TCK.

    The porting interfaces are:

    • TSURLInterface.java -- Obtains URL strings for web resources in an implementation-specific manner

    API documentation for the TSURLInterface.java porting package interface is available in the <TS_HOME>/docs/api directory.

4.2 Deploying the SAAJ TCK Tests

ProcedureTo Deploy the SAAJ TCK Tests

  1. Change to the <TS_HOME>/dist directory.

  2. Copy the SAAJ TCK WAR files to the appropriate container.

    For example, for the Apache Tomcat 5.5.x Web container, use the following command:

    cp *war <CATALINA_HOME>/webapps

4.3 Configuring and Starting Your Java Web Server

Complete the following two procedures to configure your Web server environment for Java Web Services Developers Pack.

ProcedureTo Configure the Java Web Server

  1. Set the following environment variables in your shell environment:

    1. JAVA_HOME to the directory in which Java SE 5 is installed

    2. TS_HOME to the directory in which the SAAJ TCK 1.3 software is installed

    3. SAAJ_HOME to the directory in which the SAAJ RI software is installed

    4. CATALINA_HOME to the directory in which the Apache Tomcat 5.5.x Web Container is installed

  2. Copy the required jar files to the Web server shared library directory:

    For the Apache Tomcat 5.5.x Web Container, use the following commands:

    cp <TS_HOME>/lib/tsharness.jar <TS_HOME>/lib/saajtck.jar <CATALINA_HOME>/shared/lib
    cp <SAAJ_HOME>/lib/*.jar <CATALINA_HOME>/shared/lib

Previous Previous     Contents     Next Next
Company Info Contact Terms of Use Privacy Copyright 1994-2006 Sun Microsystems, Inc.