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

  Previous Contents Next
Chapter 3

Installation

This chapter explains how to install the Java API for XML Web Services TCK 2.2 (JAX-WS TCK) software. After installing the software according to the instructions in this chapter, proceed to Chapter 4 for instructions on configuring your test environment.

3.1 Obtaining the JAX-WS 2.2 Reference Implementation

You can obtain the Sun Microsystems JAX-WS Reference Implementation (RI), Version 2.2 software from Java Partner Engineering Web site.

3.2 Installing the Software

Before you can run the JAX-WS TCK tests, you must install and set up the following software components:

  • Java SE 5 or higher

  • JAX-WS TCK version 2.2

  • The JAX-WS 2.2 Reference Implementation (RI)

  • The JAX-WS 2.2 Vendor Implementation (VI)

  • The Java EE 6 RI which contains the JAX-WS 2.2 Reference Implementation (RI)

To install the JAX-WS software

  1. Install the Java SE software, if it is not already installed.

    Download and install the Java SE software from the Java Software Web site. Refer to the installation instructions that accompany the software for additional information.

  2. Install the JAX-WS TCK 2.2 software
    1. Copy or download the JAX-WS TCK software to your local system.

      You can obtain the JAX-WS TCK software from the Java Partner Engineering Web site. The JAX-WS TCK software is located in the OPTPKG-XML/jaxws directory in the Web site's Download Center area.

    2. Use the unzip command to extract the bundle in the directory of your choice:unzip jaxws-2_2-tck.zip

      This creates the jaxwstck directory. The <install_directory>/jaxwstck directory is the test suite home, <TS_HOME>.

  3. Install the Sun Java EE 6 RI software which contains the Sun JAX-WS 2.2 Reference Implementation or install the Standalone Sun JAX-WS 2.2 RI software.

    You can obtain the Sun Java EE 6 RI software and the Standalone Sun JAX-WS 2.2 RI software from Java Partner Engineering Web site.

    The Sun Java EE 6 RI software contains the Sun JAX-WS 2.2 Reference Implementation and is used to validate your initial configuration and setup of the JAX-WS TCK 2.2, as well as to run the reverse tests which are explained further in Chapter 4 and Appendix B.

    The Standalone Sun JAX-WS 2.2 RI software contains the Sun JAX-WS 2.2 Reference Implementation and can be used with any web container that meets the minimum requirements for a container as defined in the JAX-WS 2.2 Specification such as the Apache Tomcat web container.

    If you use the Standalone Sun JAX-WS 2.2 RI software with the Apache Tomcat web container then you need to copy the jars/classes from the Standalone Sun JAX-WS 2.2 RI software to the correct location under the Apache Tomcat web container. Assuming the Apache Tomcat webcontainer is installed under: ${tomcat.home} then you would copy the jars/classes as follows:

    • cp jaxws-api.jar jsr181-api.jar jsr250-api.jar jsr173_api.jar activation.jar management-api.jar saaj-api.jar jaxb-api.jar ${tomcat.home}/common/endorsed

    • cp jaxws-rt.jar jaxws-tools.jar resolver.jar http.jar saaj-impl.jar FastInfoset.jar jaxb-impl.jar jaxb-xjc.jar woodstox.jar stax-ex.jar gmbal.jar mimepull.jar policy.jar streambuffer.jar ${tomcat.home}/shared/lib

  4. Install the JAX-WS 2.2 Vendor Implementation (VI) to be tested.

    Follow the installation instructions for the particular VI under test.

    Download, install, and configure the JAX-WS 2.2 VI configuration that is under test. To familiarize yourself with the JAX-WS TCK suite and the JavaTest software before you begin testing with your own implementation, you can optionally do a trial run using the Java EE 6 RI.

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