Installation

## 3 Installation

This chapter explains how to install the Java API for XML Registries TCK software.

After installing the software according to the instructions in this chapter, proceed to Chapter 4, "Setup and Configuration," for instructions on configuring your test environment.

### 3.1 Obtaining the Reference Implementation

You can obtain the JAXR Reference Implementation (RI) (GlassFish 5.0) software from Java Licensee Engineering (https://javapartner.oracle.com).

### 3.2 Installing the Software

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

- Java Web Services Developer Pack (WSDP) Registry Server, Version 1.0

- Java SE 8

- JAXR 1.0 RI, which is GlassFish 5.0

- JAXR TCK version 1.0, which includes:

  - JDOM 1.0

  - Apache Commons HTTP Client 3.1

  - Apache Commons Logging 1.1.1

  - Apache Commons Codec 1.3

  - Apache Ant 1.8.4

- The JAXR 1.0 Vendor Implementation (VI)

Follow these steps:

1. Install the Java SE 8 software, if it is not already installed.
   Download and install the Java SE 8 software from http://www.oracle.com/technetwork/java/javase/downloads/index.html. Refer to the installation instructions that accompany the software for additional information.

2. Install the JAXR TCK 1.0 software.

   1. Copy or download the JAXR TCK software to your local system.
      You can obtain the JAXR TCK software from the Java Licensee Engineering (https://javapartner.oracle.com) Web site. The JAXR TCK software is located in the Web site’s Download Center area.

   2. Use the `unzip` command to extract the bundle in the directory of your choice:
      `unzip jaxr-1_0-tck.zip`
      This creates the TCK directory. The TCK is the test suite home, `<TS_HOME>`.

3. Install the UDDI registry that comes with the Web Services Developer Pack, download the Web Services Developer Pack software from the Java Software web site and install. This installs the UDDI V2 registry. The username and password for the default account are “testuser” and “testuser.” See the installation instructions that accompany the software for JAXR 1.0 Technology Compatibility Kit User’s Guide • June 2002 additional information about installing the software. You will also need to create a second account. See the “Adding New Users to the Registry” section in the Java Web Services Tutorial for information about creating this account.

4. Install the JAXR 1.0 Reference Implementation.
   The Reference Implementation is used to validate your initial configuration and setup of the JAXR TCK 1.0 tests, which are explained further in Chapter 4, "Setup and Configuration."
   The JAXR RI can be obtained from Java Licensee Engineering (https://javapartner.oracle.com).

5. Install or get access to a UDDI V2-compliant registry.
   To use a UDDI V2 registry from IBM or Microsoft, you need to go to their sites and register. When you register, you will get your own username and password.
   To get a username to use with the IBM registry, go to http://www.ibm.com/ services/uddi and click on the beta v2 register button. Scroll down and you will see a place to get a username and password.
   To get a username for the Microsoft UDDI registry, go to http:// uddi.rte.microsoft.com and click register. You need to use Internet Explorer V5.0 or higher as your browser for this procedure.
   When you modify the ts.jte file, as described in Section 4.2, you need to specify the publish and query urls for the registry that you will be using.

6. Install the JAXR Vendor Implementation (VI) to be tested.
   Follow the installation instructions for the particular VI under test.

Copyright © 2018, Oracle and/or its affiliates. All rights reserved.