Installation

## 3 Installation

This chapter explains how to install the Java API for XML-based RPC 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 JAX-RPC Reference Implementation (RI) (Eclipse Glassfish 5.0) software from Java Licensee Engineering (https://javapartner.oracle.com).

### 3.2 Installing the Software

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

- Java EE 8 RI or, at a minimum, a Web server with a Servlet container

- Java SE 8

- JAX-RPC 1.1 RI, which is Eclipse Glassfish 5.0

- JAX-RPC TCK version 1.1, 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 JAX-RPC 1.1 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 JAX-RPC TCK 1.1 software.

   1. Copy or download the JAX-RPC TCK software to your local system.
      You can obtain the JAX-RPC TCK software from the Java Licensee Engineering (https://javapartner.oracle.com) Web site. The JAX-RPC 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 jaxrpc-1_1-fr-tck.zip`
      This creates the TCK directory. The TCK is the test suite home, `<TS_HOME>`.

3. Install the Java EE 8 RI software (the servlet Web container used for running the JAX-RPC TCK with the JAX-RPC 1.1 RI), if it is not already installed.
   Download and install the Servlet Web container with the JAX-RPC 1.1 RI used for running the JAX-RPC TCK 1.1, represented by the Java EE 8 RI. This software can be obtained from the Java Licensee Engineering Web site. Refer to any installation instructions that accompany the software for additional information.

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

5. Install a Web server on which the JAX-RPC TCK test applications can be published for testing the VI.

6. Install the JAX-RPC 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.