Jakarta Registries Technology Compatibility Kit, Version 1.0
Release Notes, September 2019


Kit Contents

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

Platform Notes

The Jakarta Registries TCK tests have been built and tested with the Java Web Services Developers Pack (JWSDP) 1.2 running on the JavaTM 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 Jakarta Registries 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. In addition, the forward slashes (/) used in all of the examples need to be replaced with backslashes (\) for Windows.

Installing, Setting Up, and Running the Jakarta Registries TCK

The following sections explain how to:

Installing the Required Software

Before you can run the Jakarta Registries 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 Jakarta Registries TCK software.

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

      Copy or download the Jakarta Registries TCK software to your local system.
      You can obtain the Jakarta Registries  TCK software from the Java Partner Engineering web site (http://javapartner.sun.com). The Jakarta Registries 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 Jakarta Registries 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 Jakarta Registries 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, 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 Jakarta Registries TCK Tests

To run the Jakarta Registries TCK tests, complete the following steps. Note that you only need to complete steps 2-10 the first time you start the JT Harness. The online version of the JT Harness version 5.0 documentation is available here.

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
    ant 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 Jakarta Registries TCK Tests

To run a subset of the Jakarta Registries 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 Jakarta Registries TCK Tests using ant

Complete the following steps to set up your environment to build, deploy, and run the Jakarta Registries TCK tests using ant. 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 Jakarta Registries TCK tests using ant, 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
    ant 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:

     ant lc or ant llc
    To list the distribution directory of archives for this test that was built, type the following:
    ant ld or ant lld
    To build a subset of test directories, type the following:
    cd <TS_HOME>/src/com/sun/ts/tests/jaxr/api
    ant clean build
    This will clean and build all the test directories under the api directory.
To deploy the Jakarta Registries TCK tests using ant, 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
    ant 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
    ant deploy
    This will deploy all the test WAR files for the api directory.
To run the Jakarta Registries TCK tests using ant, 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
    ant 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
    ant 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
    ant runclient
    This will run all the test directories under the api directory.

Copyright (c) 2003, 2019 Oracle and/or its affiliates. All rights reserved.