[Harmony Wiki] Update of "JettyScenario" 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/JettyScenario

The comment on the change is:
Brief description of JettyScenario was added

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

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

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

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

Jetty scenario is the basic scenario that runs Jetty on top of Harmony. It starts Jetty, tries to access (via HTTP) several pages from standard Jetty's test application and then compares retrieved content with golden files.

[#Summary Back to Summary]

[[Anchor(HowTo)]]
=== How to run Jetty scenario ===

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

Make sure your PATH environment variable contains JDK 1.5 (use RI) and Apache
Ant (v1.6.5 or later), and 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 host> -Dhttp.proxyPort=<proxy port>"
}}}

Linux: {{{
    export ANT_OPTS="-Dhttp.proxyHost=<proxy host> -Dhttp.proxyPort=<proxy port>"
}}}

Edit your ''framework.local.properties'' file:
    * Specify JRE to run Jetty server on by setting value for property ''JettyScenario.parameters.required.jetty.server.jvm''.
    * Specify JRE to run HTMLUnit-based web client on by setting value for property ''JettyScenario.parameters.required.scenario.framework.jvm''.
    * Specify optional port number via ''JettyScenario.parameters.optional.jetty.server.port''. It defaults to ''7070''.
    * Specify optional Jetty server's stop port number via ''JettyScenario.parameters.optional.jetty.server.stop.port''. Defaults to ''4444''.    
    * Make sure the external locations for Jetty and HTMLUnit binaris are defined correctly in ''adaptors/JettyScenario/parameters.xml''    

[#Summary Back to Summary]

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

{{{
$ cd buildtest/infra
$ ant -Dtest.suites=JettyScenario install
$ ant -Dtest.suites=JettyScenario 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=JettyScenario run
}}}

[#Summary Back to Summary]

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

Results summary can be found at buildtest/infra/build/results/JettyScenario/

[#Summary Back to Summary]

[[Anchor(EOF)]]

[wiki:Self:DRLVMTestTracking Back to Test Tracking]