<!-- Fragment document type declaration subset:
Arbortext, Inc., 1988-2008, v.4002
<!DOCTYPE SOLBOOK PUBLIC "-//Sun Microsystems//DTD SolBook 3.1//EN" [
<!ENTITY % TCKentities SYSTEM "TCKentities.ent">
%TCKentities;
]>
-->
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub CX solbook(book(title()subtitle()bookinfo()chapter()>
<chapter id="GBFTP"><title>Installation</title>
<highlights>
<para>This chapter explains how to install the &TCKFullName; &TechnologyVersion; (&TCKShortName;)
software. After installing the software according to the instructions in this
chapter, proceed to <olink targetptr="GBFVV">Chapter&nbsp;4, Setup and Configuration
</olink> for instructions on configuring your test environment.</para>
</highlights>
<sect1 id="GBFUD"><title>Obtaining the &TechnologyShortName; &RIVersion; Reference
Implementation (Jersey &TechnologyVersion;)</title>
<para>You can obtain the Sun Microsystems &TechnologyShortName; Reference
Implementation (RI), Version &RIVersion; (Jersey &TechnologyVersion;) software
from &JavaPartnerURL;.</para></sect1>
<sect1 id="GBFTS"><title>Installing the Software</title>
<para>Before you can run the &TCKShortName; tests, you must install and set
up the following software components:</para>
<itemizedlist>
<listitem><para>&J2EEversion; RI</para></listitem>
<listitem><para>Java SE 5 or higher</para></listitem>
<listitem><para>Jersey 1.1</para></listitem>
<listitem><para>JAX-RS TCK version 1.1, which includes:</para>
<itemizedlist>
<listitem><para>Apache httpclient 3.1</para></listitem>
<listitem><para>Apache Ant 1.7.1</para></listitem>
<listitem><para>Apache logging 1.1.1</para></listitem>
<listitem><para>Apache codec 1.3</para></listitem>
<listitem><para>JDOM1.0</para></listitem>
</itemizedlist>
</listitem>
<listitem><para>The JAX-RS 1.1 Vendor Implementation (VI)</para></listitem>
</itemizedlist>
<task id="GBFVY"><?Pub Caret1><title>To Install the &TCKShortName; Software</title>
<procedure>
<step><para>Install the &J2SEversion; software, if it is not already installed.</para>
<para>Download and install the &J2SEversion; software from the <ulink
url="http://java.sun.com/products" type="text_url">Java Software</ulink> Web
site. Refer to the installation instructions that accompany the software for
additional information.</para></step>
<step><para>Install the &TCKShortName; &TechnologyVersion; software.</para>
<substeps>
<step><para>Copy or download the &TCKShortName; software to your local system.</para>
<para>You can obtain the &TCKShortName; software from the &JavaPartnerURL; Web
site. The &TCKShortName; software is located in the &TCKPackagePath; directory
in the Web site's Download Center area.</para></step>
<step><para>Use the <literal>unzip</literal> command to extract the bundle
in the directory of your choice:</para>
<literallayout><command>unzip</command> &TCKPackageName;</literallayout><para>This
creates the &TCKinstalldir; directory. The <varname>&lt;install_directory></varname><filename>
/</filename>&TCKinstalldir; directory is the test suite home, <literal>&lt;TS_HOME>
</literal>.</para></step></substeps>
</step>
<step><para>Install&J2EEversion; RI software (the servlet Web container used
for running the &TCKShortName; with  Sun's &TechnologyShortName; &TechnologyVersion; RI),
if it is not already installed.</para><para>Download and install &J2EEversion; RI
software from the &JavaLicenseeEngineeringShort; Web site. Refer to any installation
instructions that accompany the software for additional information.</para>
</step>
<step><para>Install the Sun &TechnologyShortName; &RIVersion; Reference Implementation.
</para><para>The Sun Reference Implementation is used to validate your initial
configuration and setup of the &TCKShortName; &TechnologyVersion; tests, which
are explained further in <olink targetptr="GBFVV">Chapter&nbsp;4, Setup and
Configuration</olink>.</para><para>Sun's &TechnologyShortName; RI can be obtained
from the Jersey Web site at &RIdocURL;.</para></step>
<step><para>Install a Web server on which the &TCKShortName; test applications
can be published for testing the VI.</para></step>
<step><para>Install the &TechnologyShortName; Vendor Implementation (VI) to
be tested.</para><para>Follow the installation instructions for the particular
VI under test.</para></step>
</procedure>
</task>
</sect1>
</chapter>
<?Pub *0000004375 0>
