<!-- 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 CX solbook(>
<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 type="custom-text" targetptr="GBFVV">Chapter 4</olink> for
instructions on configuring your test environment.</para></highlights>
<sect1 id="GBFUD"><?Pub Dtl><title>Obtaining the &TechnologyShortName; &RIVersion; Reference
Implementation</title>
<para>You can obtain the Sun Microsystems &TechnologyShortName; Reference
Implementation (RI), Version &RIVersion; software from &JavaPartnerURL; Web site.
</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>&RequiredSoftware;
<task id="GBFVY"><title>To install the &TechnologyShortName; 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 the Sun Java EE 6 RI software which contains the Sun &TechnologyShortName; 
&RIVersion; Reference Implementation or install the Standalone Sun &TechnologyShortName; &RIVersion; RI software.</para>
<para>You can obtain the Sun Java EE 6 RI software and the Standalone Sun &TechnologyShortName; 
&RIVersion; RI software from &JavaPartnerURL; Web site.
</para>
<para>The Sun Java EE 6 RI software contains the Sun &TechnologyShortName; &RIVersion; 
Reference Implementation and is used to validate your initial configuration and setup of the 
&TCKShortName; &TechnologyVersion;, as well as to run the reverse tests which are 
explained further in Chapter 4 and Appendix B.</para>
<para>The Standalone Sun &TechnologyShortName; &RIVersion; RI software contains the
Sun &TechnologyShortName; &RIVersion Reference Implementation and can be used 
with any web container that meets the minimum requirements for a container as defined 
in the &TechnologyShortName; &TechnologyVersion; Specification such as the Apache
Tomcat web container.</para>
<para>If you use the Standalone Sun &TechnologyShortName; &RIVersion; RI software with
the Apache Tomcat web container then you need to copy the jars/classes from the Standalone Sun 
&TechnologyShortName; &RIVersion; RI software to the correct location under the Apache Tomcat 
web container. Assuming the Apache Tomcat webcontainer is installed under: ${tomcat.home}
then you would copy the jars/classes as follows:</para>
<itemizedlist>
<listitem><para><emphasis role="strong">cp jaxws-api.jar jsr181-api.jar jsr250-api.jar jsr173_api.jar activation.jar management-api.jar saaj-api.jar jaxb-api.jar ${tomcat.home}/common/endorsed</emphasis></para></listitem><listitem><para><emphasis role="strong">cp jaxws-rt.jar jaxws-tools.jar resolver.jar http.jar saaj-impl.jar FastInfoset.jar jaxb-impl.jar jaxb-xjc.jar woodstox.jar stax-ex.jar gmbal.jar mimepull.jar policy.jar streambuffer.jar ${tomcat.home}/shared/lib</emphasis></para></listitem></itemizedlist>
</step>
<step><para>Install the &TechnologyShortName; &TechnologyVersion; Vendor Implementation (VI) to
be tested.</para><para>Follow the installation instructions for the particular VI under test.
</para><para>Download, install, and configure the &TechnologyShortName; &TechnologyVersion; VI 
configuration that is under test. To familiarize yourself with the &TCKShortName; suite and
the JavaTest software before you begin testing with your own implementation,
you can optionally do a trial run using the Java EE 6 RI.
</para></step>
</procedure>
</task>
</sect1>
</chapter>
<?Pub *0000003805 0>
