JAXR Technology Compatibility Kit, Version 1.0.x
Release Notes,June 2003


Kit Contents

The JAXR TCK, Version 1.0.x includes the following items:

Platform Notes

The JAXR TCK tests have been built and tested with the Java Web Services Developers Pack (JWSDP) 1.2 running on the JavaTM 2 Platform, Standard Edition SDK, Version 1.4.1_02. If you are using a different registry server, you will need to make adjustments to the procedures outlined in this document.

The JAXR TCK tests run on the following platforms:

In the instructions in this document, 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.

Installing, Setting Up, and Running the JAXR TCK

The following sections explain how to:

Installing the Required Software

Before you can run the JAXR TCK tests, you must install and set up the following software components: Complete the following steps to install the required software:
    Install the J2SE 1.4.1 software.
    Download and install the J2SE 1.4.1 software from the Java Software Web site (http://java.sun.com/products). Refer to the installation instructions that accompany the software for additional information.

    Install the Java Web Services Developers Pack 1.2 software.

    Download and install the Java Web Services Developers Pack 1.2 from the Project Web site (http://java.sun.com/webservices/downloads/webservicespack.html). Refer to the documentation included with the Java Web Services Developers Pack for specific installation instructions.

    Install the JAXR TCK software.

    Download the JAXR TCK software from the Java Partner Engineering Web site and install:

      Copy or download the JAXR TCK software to your local system.
      You can obtain the JAXR  TCK software from the Java Partner Engineering web site (http://javapartner.sun.com). The JAXR TCK software is located in the OPTPKG-XML/jaxr directory in the Web site's Download Center area.

      Change to the directory where you want to install the JAXR TCK software:

      cd <install_directory>

      Use the unzip command to extract the bundle:

      unzip jaxr-1_0_x-fr-tck.zip

      This will create the jaxrtck directory. The <install_directory>/jaxrtck directory will be TS_HOME.

Setting Up your Environment

Complete the following steps to set up your environment:
    Set the following environment variables in your shell environment:
    Change to the <TS_HOME>/bin directory.
    Edit your build.properties file and set the following environment variables:
       
      Set the local_classes property to point to the JAXR RI classes/jars and the TCK classes/jars (tsharness.jar, javatest.jar, jaxrtck.jar).
      For example, if you are running the Java Web Services Developers Pack on Solaris 8, set the following classpath:
      setenv LOCAL_CLASSES=${JWSDP_HOME}/jaxr/lib/jaxr-impl.jar:
      ${JWSDP_HOME}/jaxr/lib/jaxr-api.jar:
      ${JWSDP_HOME}/jaxr/lib/fscontext.jar:
      ${JWSDP_HOME}/jaxr/lib/castor-0.9.3.9-xml.jar:
      ${JWSDP_HOME}/jaxp/lib/jaxp-api.jar:
      ${JWSDP_HOME}/jaxp/lib/endorsed/xercesImpl.jar:
      ${JWSDP_HOME}/jaxp/lib/endorsed/xsltc.jar:
      ${JWSDP_HOME}/jaxp/lib/endorsed/xalan.jar:
      ${JWSDP_HOME}/jaxp/lib/endorsed/sax.jar:
      ${JWSDP_HOME}/jaxp/lib/endorsed/dom.jar:
      ${JWSDP_HOME}/saaj/lib/saaj-impl.jar:
      ${JWSDP_HOME}/saaj/lib/saaj-api.jar:
      ${JWSDP_HOME}/jwsdp-shared/lib/mail.jar:
      ${JWSDP_HOME}/jwsdp-shared/lib/providerutil.jar:
      ${JWSDP_HOME}/jwsdp-shared/lib/jaas.jar:
      ${JWSDP_HOME}/jwsdp-shared/lib/activation.jar:
      ${JWSDP_HOME}/jwsdp-shared/lib/commons-logging.jar:${TS_HOME}/lib/javatest.jar:${TS_HOME}/lib/tsharness.jar:
      ${TS_HOME}/lib/jaxrtck.jar
      Or, if are running the Java Web Services Developers Pack on Windows 2000/XP, you set the following classpath:
      set LOCAL_CLASSES=%JWSDP_HOME%\jaxr\lib\jaxr-impl.jar;
      %JWSDP_HOME%\jaxr\lib\jaxr-api.jar;
      %JWSDP_HOME%\jaxr\lib\fscontext.jar;
      %JWSDP_HOME%\jaxr\lib\castor-0.9.3.9-xml.jar;
      %JWSDP_HOME%\jaxp\lib\jaxp-api.jar;
      %JWSDP_HOME%\jaxp\lib\endorsed\xercesImpl.jar;
      %JWSDP_HOME%\jaxp\lib\endorsed\xsltc.jar;
      %JWSDP_HOME%\jaxp\lib\endorsed\xalan.jar;
      %JWSDP_HOME%\jaxp\lib\endorsed\sax.jar;
      %JWSDP_HOME%\jaxp\lib\endorsed\dom.jar;
      %JWSDP_HOME%\saaj\lib\saaj-impl.jar;
      %JWSDP_HOME%\saaj\lib\saaj-api.jar;
      %JWSDP_HOME%\jwsdp-shared\lib\mail.jar;
      %JWSDP_HOME%\jwsdp-shared\lib\providerutil.jar;
      %JWSDP_HOME%\jwsdp-shared\lib\jaas.jar;
      %JWSDP_HOME%\jwsdp-shared\lib\activation.jar;
      %JWSDP_HOME%\jwsdp-shared\lib\commons-logging.jar;
      %TS_HOME%\lib\javatest.jar;%TS_HOME%\lib\tsharness.jar;
      %TS_HOME%\lib\jaxrtck.jar;
     
    Edit your ts.jte file and modify the following environment settings:
      Set the registryURL property to the publish url for your Registry.

      The setting for the wspack RegistryServer is:
      registryURL=http://localhost:8080/RegistryServer.

      Set the queryManagerURL property to the query url for you Registry.

      The setting for the wspack RegistryServer is:
      queryManagerURL=http://localhost:8080/RegistryServer.

      Set the username and password properties for 2 accounts in your registry.

      The default settings for RegistryServer:
      jaxrUser=testuser
      jaxrPassword=testuser
      jaxrUser2=jaxr-sqe
      jaxrPassword2=jaxrsqe
       
       

Configuring and Starting Your Java Web Server

Follow the install instructions that come with the Java Web Services Developers Pack:

Complete the following steps to start the Java Web server:

    Change to the <JWSDP_HOME>/bin directory.

    Execute the ./startup.sh script or the startup.bat batch file.

    Wait for the web server to come up. Look at the file <JWSDP_HOME>/logs/launcher.server.log and wait until the messages stop printing to the file. You will see the following message when the web server has completed its startup:

    Starting service Internal Services
    Java Web Services Developer Pack/1.2-fcs
    Starting service Java Web Services Developer Pack
    Java Web Services Developer Pack/1.2-fcs

Running the JAXR TCK Tests

To run the JAXR TCK tests, complete the following steps. Note that you only need to complete steps 2-10 the first time you start the JavaTestTM test harness. After you complete these steps, you can either run all of the tests by completing Step 11 or run a subset of the tests by completing the steps in the section that follows this one.
    Change to the <TS_HOME>/bin directory and start the JavaTest test harness:
    cd <TS_HOME>/bin
    tsant gui

    The Welcome screen displays.

    Click on the Create Work Directory button, enter the name of the directory to which the JavaTest test harness will write temporary files (/tmp/JTwork, for example), and press the New Work Dir button when you are done.

    Otherwise select File->New Work Dir or File->Open Work Dir to do the same as above.

    Pull down Configuration and select Configuration Editor. The Welcome screen displays. Press the Next Question button (right arrow). You are prompted to select which tests to run. Accept the default setting (jaxr) and press the Next Question button.

    NOTE: Do not run the Parameter Editor before you run the Configuration Editor or you will lose all the default settings.

    You are asked if you want to specify an exclude list. Accept the default (yes) and press the Next Question button.

    Verify the default location of the exclude list and press the Next Question button.

    You are prompted for the location of the environment files. Accept the default file location and press the Next Question button.

    You are prompted to specify a test environment. Select either ts_unix or ts_win32 and press the Next Question button.

    You are prompted to specify a directory into which reports will be written. Accept the default (/tmp/JTreport) or enter a new directory location and press the Next Question button.

    You are prompted to create the directory. Accept the default answer (yes) and press the Next Question button.

    The Congratulations screen displays. Press the Finished button (check mark).

    Select Run then Start. The tests in the {TS_HOME}/src/com/sun/ts/tests/jaxr directory will be executed.

Running a Subset of the JAXR TCK Tests

To run a subset of the JAXR TCK tests, complete the following steps:
    Pull down Configuration and select Configuration Editor.
    On the left side of the screen, select the topmost directory and remove it.
    Click Add, select the new subdirectory or test that you want to run, and click Add File.

    For example, to run just the AttachmentPart API test, double click on jaxr, then double click on api, then double click on javax_xml_soap , then single click on AttachmentPart, then click Add File.

    Click the Finished button when you are done.

    Click Run and select Start to run the test. This will now only run the AttachmentPart api test.

Build/Deploy/Run the JAXR TCK Tests using tsant

Complete the following steps to set up your environment to build, deploy, and run the JAXR TCK tests using tsant. The following example is for the Solaris platform:
    Set the following environment variables in your shell environment to use the build infrastructure that comes with the TCK: Change to directory TS_HOME/install/jaxr and run ant to create and set up your TS_HOME/bin directory if it has not yet been setup.

    Change to directory TS_HOME/bin and edit the build.properties file to set the required properties needed for using Ant build environment.

To build the JAXR TCK tests using tsant, complete the following steps:
    To build a single test directory, type the following:
    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api/javax_xml_soap/AttachmentPart
    tsant clean build
    This will clean and build the tests in the AttachmentPart test directory.

    To list the classes directory for this test that was built, type the following:

     tsant lc or tsant llc
    To list the distribution directory of archives for this test that was built, type the following:
    tsant ld or tsant lld
    To build a subset of test directories, type the following:
    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api
    tsant clean build
    This will clean and build all the test directories under the api directory.
To deploy the JAXR TCK tests using tsant, complete the following steps:
    To deploy a single test directory, type the following:
    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api/javax_xml_soap/AttachmentPart
    tsant deploy
    This will deploy the WAR file built for the AttachmentPart test directory to the webapps directory.

    To deploy a subset of test directories, type the following:

    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api
    tsant deploy
    This will deploy all the test WAR files for the api directory.
To run the JAXR TCK tests using tsant, complete the following steps:
    To run a single test directory, type the following:
    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api/javax_xml_soap/AttachmentPart
    tsant runclient
    This will run all tests in the AttachmentPart test directory.

    To run a single test within a test directory, type the following:

    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api/javax_xml_soap/AttachmentPart
    tsant runclient -Dtest=getPropertyNamesTest1
    This will run only the getPropertyNamesTest1 in the AttachmentPart test directory. You select the test name to run by looking at the testName tags in the URLClient.java file.

    To run a subset of test directories type the following:

    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api
    tsant runclient
    This will run all the test directories under the api directory.

Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.