<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY UTE "GTEE">
]>

<sect1 id="ute_usage_gtee">
  <title>Usage with GTEE</title>
  <sect2 id="ute_usage_gtee_overview">
    <title>Overview</title>
    <para>
      UTE provides <code>Run.sh</code> which may be used as <emphasis>GTEE suite.</emphasis>
      In GTEE installation, UTE suite is usually available as <code>ute</code>
      and is specified in job definition file as
<screen>
&lt;workspacename&gt;ute&lt;/workspacename&gt;
</screen>
      In this case, UTE is configured naturally: user-defs and other elements in job definition file
      are transformed to UTE settings. There are two mandatory settings in job definition
      file for UTE: <code>HARNESS</code> and <code>TESTBASE.</code> Some harness modules may also
      require other settings.  Refer to <xref linkend="ute_harness_modules_common"/> for description
      of common settings and to corresponding section under <xref linkend="ute_harness_modules"/>
      for settings specific to harness module.
    </para>
  </sect2>
  <sect2 id="ute_usage_gtee_examples">
    <title>Examples of UTE usage with GTEE</title>
    <para>
      Refer to <xref linkend="ute_harness_modules"/> for description of the settings.
    </para>
    <para>
      <itemizedlist>
        <listitem>
	  Job definition file fragment for <code>vm</code> component (refer to
	  <ulink url="http://sqeweb.sfbay/nfs/comp/vm/testbase/sqe/vm/6/build/execution/vm/docs/">VM Testbase 6 documentation</ulink>):
<screen>
	&lt;user-defs key="HARNESS" value="tonga"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/vmsqe.russia/export/testbase/sqe/vm/6/build/nightly/vm"/&gt;
	&lt;user-defs key="TONGA_JAR" value="/net/vmsqe.russia/export/tool/tonga/tonga.jar"/&gt;
	&lt;user-defs key="TONGA_OPTS" value="-suiteDir src -localTZ"/&gt;
	&lt;user-defs key="JCK12a" value="/net/vmsqe.russia/export/testbase/jck/1.2"/&gt;
	&lt;user-defs key="JCK122" value="/net/vmsqe.russia/export/testbase/jck/1.2.2"/&gt;
	&lt;user-defs key="JCK60" value="/net/vmsqe.russia/export/testbase/jck/6a/dist"/&gt;
	&lt;user-defs key="JCK60_LIB_PATH" value="/net/vmsqe.russia/export/testbase/jck/6a/jckjni"/&gt;
	&lt;user-defs key="DISPLAY" value="vmsqe-p4-08:1"/&gt;
...
	&lt;testlistset includes="spb.nightly.testlist"&gt;
</screen>
	</listitem>
	<listitem>
	  Job definition file fragments for <code>HS_REGRESION</code> and <code>JDI_REGRESSION</code> subsets of Java SE regression tests:
<screen>
	&lt;user-defs key="HARNESS" value="jtreg"/&gt;
	&lt;user-defs key="JTREG_HOME" value="/net/sqenfs-1.sfbay/export1/comp/vm/tool/jtreg_4.0"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/sqenfs-1.sfbay/export1/comp/vm/testbase/jtreg/7"/&gt;
...
	&lt;testlistset includes="HS_REGRESSION,JDI_REGRESSION"/&gt; 
</screen>
	</listitem>
	<listitem>
	  Job definition file fragment for <code>quick</code> suite of <code>runThese:</code>
<screen>
	&lt;user-defs key="HARNESS" value="runThese"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/sqenfs-1.sfbay/export1/comp/vm/testbase/runThese"/&gt;
...
	&lt;testlistset includes="quick"&gt;
</screen>
	</listitem>
	<listitem>
	  Job definition file fragment for <code>realtime</code> component:
<screen>
	&lt;user-defs key="HARNESS" value="tonga"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/vmsqe.russia/export/testbase/sqe/realtime/build/execution"/&gt;
	&lt;user-defs key="TONGA_JAR" value="/net/vmsqe.russia/export/tool/tonga/tonga.jar"/&gt;
	&lt;user-defs key="TONGA_OPTS" value="-suiteDir src"/&gt;
</screen>
	</listitem>
	<listitem>
	  Job definition file fragment for <code>javarts</code> tests:
<screen>
	&lt;user-defs key="HARNESS" value="javatest_simple"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/mackdrive.france/export/jrts_sqe/testbase/jrts"/&gt;
...
	&lt;testlistset includes="testlist"&gt;
</screen>
	</listitem>
	<listitem>
	  Job definition file fragment for 10 iterations of <code>specjbb2005 (refworkload):</code>
<screen>
	&lt;user-defs key="HARNESS" value="refworkload"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/vmsqe.russia/export/testbase/refworkload"/&gt;
	&lt;user-defs key="BENCHMARK" value="specjbb2005"/&gt;
	&lt;user-defs key="ITERATIONS" value="10"/&gt;
</screen>
	</listitem>
	<listitem>
	  Job definition file fragment for 120 hours of <code>Tomcat</code> bigapp:
<screen>
	&lt;user-defs key="HARNESS" value="bigapps"/&gt;
	&lt;user-defs key="HARNESS_LOCATION" value="/net/vmsqe.russia/export/tool/runbigapp.sh"/&gt;
	&lt;user-defs key="TESTBASE" value="/net/vmsqe.russia/export/testbase/bigapps/Tomcat/apache-tomcat-5.5.26"/&gt;
	&lt;user-defs key="BIGAPP" value="Tomcat"/&gt;
	&lt;user-defs key="DURATION" value="7200"/&gt;
</screen>
	</listitem>
      </itemizedlist>
    </para>
  </sect2>
</sect1>
