[Harmony Wiki] Update of "Tomcat scenario" by AlexeiZakharov

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Harmony Wiki" for change notification.

The following page has been changed by AlexeiZakharov:
http://wiki.apache.org/harmony/Tomcat_scenario

The comment on the change is:
Basic description of Tomcat scenario was added

New page:
[wiki:Self:DRLVMTestTracking Back to Test Tracking]

[[Anchor(Summary)]]
=== Summary ===

[#Status Mission and Status][[BR]]
[#HowTo How to run Tomcat scenario][[BR]]
1. [#Configuration Configuration][[BR]]
3. [#Setup Setup][[BR]]
3. [#Run Run][[BR]]
4. [#Results Results][[BR]]

[[Anchor(Status)]]
=== Mission and Status ===

Tomcat scenario is the most basic scenario that uses Apache Tomcat on top of Harmony. It starts Tomcat, tries to access a couple of standard Tomcat example pages via HTTP and then compares retrieved content with golden files.

[#Summary Back to Summary]

[[Anchor(HowTo)]]
=== How to run Tomcat tests ===

[[Anchor(Configuration)]]
==== 1. Configuration ====

Make sure that PATH environment variable contains JDK 1.5 (use RI) and Apache
Ant (v1.6.5 or later), and that JAVA_HOME and ANT_HOME are properly set up.
If you use proxy server, specify proxy settings by setting ANT_OPTS environment variable:

Windows:
    set ANT_OPTS="-Dhttp.proxyHost=proxy.com -Dhttp.proxyPort=1111"

Linux:
    export ANT_OPTS="-Dhttp.proxyHost=proxy.com -Dhttp.proxyPort=1111"

Edit your ''framework.local.properties'' file:
    * Specify JRE to test by setting value for property ''tomcat-scenario.parameters.required.tested.runtime''.
    * Specify optional port number via ''tomcat-scenario.parameters.optional.port.number''. It defaults to ''8091''.
    * Make sure the external location for Tomcat binary is defined correctly in ''adaptors/tomcat-scenario/parameters.xml''    

[#Summary Back to Summary]

[[Anchor(Setup)]]
==== 2. Setup ====

{{{
$ cd buildtest/infra
$ ant -Dtest.suites=tomcat-scenario install
$ ant -Dtest.suites=tomcat-scenario setup
}}}
The last command copies required parameters from ''framework.local.properties'' file to ''required-parameters.properties'' file. After each modification of ''framework.local.properties'' you should remove ''required-parameters.properties'' and run this command again.

[#Summary Back to Summary]

[[Anchor(Run)]]
==== 3. Run ====

{{{
$ cd buildtest/infra
$ ant -Dtest.suites=tomcat-scenario run
}}}

[#Summary Back to Summary]

[[Anchor(Results)]]
==== 4. Results ====

Results summary can be found at buildtest/infra/build/results/tomcat-scenario/

[#Summary Back to Summary]

[[Anchor(EOF)]]

[wiki:Self:DRLVMTestTracking Back to Test Tracking]