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

|  | Products |  | Downloads |  | Service & Solutions |  | Support |  | Training |  | Research

| Previous Contents Next
2. 3. 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 4.2 Deploying the SAAJ TCK Tests 4.3 Configuring and Starting Your Java Web Server 4.4 Using the JavaTest Harness Software 4.5 Using the JavaTest Harness Configuration GUI ## 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). ### To Configure Your Environment for the SAAJ TCK Set the following environment variables in your shell environment: `JAVA_HOME` to the directory in which Java SE 5 is installed `TS_HOME` to the directory in which the SAAJ TCK 1.3 software is installed `SAAJ_HOME` to the directory in which the SAAJ RI software is installed `CATALINA_HOME` to the directory in which the Apache Tomcat 5.5.x Web Container is installed `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. Edit your `<TS_HOME>/bin/ts.jte` file and set the following environment variables: Set the `webServerHost` property to the name of the host on which your Web server is running. The default setting is `localhost`. Set the `webServerPort` property to the port number of the host on which the Web server is running. The default setting is `8080`. 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
   6. 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`. 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. 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
2. 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 ### To Deploy the SAAJ TCK Tests Change to the `<TS_HOME>/dist` directory. 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
2. ## 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. ### To Configure the Java Web Server Set the following environment variables in your shell environment: `JAVA_HOME` to the directory in which Java SE 5 is installed `TS_HOME` to the directory in which the SAAJ TCK 1.3 software is installed `SAAJ_HOME` to the directory in which the SAAJ RI software is installed `CATALINA_HOME` to the directory in which the Apache Tomcat 5.5.x Web Container is installed 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 Contents Next

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