1define(MC_TITLE,webstonegui)
2define(MC_DATE,98/05/14)
3include(mc_html_head.h)
4<!-- @(#) webstonegui.in 1.2@(#) -->
5</UL><FONT SIZE=+1><STRONG>NAME</STRONG></FONT><UL>
6WebStone GUI - run the WebStone benchmark from a Web browser
7</UL><FONT SIZE=+1><STRONG>SYNOPSIS</STRONG></FONT><UL>
8<STRONG>webstone -gui</STRONG>
9</UL><FONT SIZE=+1><STRONG>DESCRIPTION</STRONG></FONT><UL>
10<P>
11The
12<STRONG>webstone</STRONG>
13distribution includes a collection of Perl scripts to
14provide a graphical user interface for managing and running the
15<STRONG>WebStone</STRONG>
16benchmark.
17<P>
18Before trying to invoke the graphical user interface, unpack the
19WebStone distribution and run
20<STRONG>webstone -setup</STRONG>
21from the command line.
22<P>
23</UL><FONT SIZE=+1><STRONG>OPTIONS</STRONG></FONT><UL>
24<P>
25None.  The WebStone GUI is completely interactive.
26<P>
27</UL><FONT SIZE=+1><STRONG>DETAILS</STRONG></FONT><UL>
28<P>
29Here are the screens presented by the GUI.  Clicking on the WebStone
30logo in any of the screens returns you to the top level.
31<DL>
32<DT>WebStone<DD>This is the main screen, a list of links to the other screens.
33<DT>Configure WebStone<DD>Presents a form to let the user modify the
34run parameters.  The form is read from the <STRONG>conf/testbed</STRONG> file
35and writes the user's choices back to that file.
36<DT>Choose a URL List<DD>Displays the comment line from the file
37<STRONG>conf/filelist</STRONG> and a list of file names and comment
38lines from which to choose.  Click the radio button to select, click
39on the comment to see what's in the file.
40<DT>Run WebStone<DD>Presents a summary of the current test configuration and
41a big button to kick off a run.  The run output is displayed in the
42browser window.
43<DT>View WebStone Results<DD>Scans the <STRONG>bin/runs</STRONG> directory
44for run results and presents a tabular summary.
45<DT>Administer WebStone<DD>Lets the user rename the output directory
46or terminate a run.
47</DL>
48</UL><FONT SIZE=+1><STRONG>FILES</STRONG></FONT><UL>
49<DL>
50<P><DT><STRONG>bin/*.wpl</STRONG><DD>
51The Perl scripts that make up the WebStone GUI.  The special suffix
52("WebStone Perl") is to make sure the script is run by the GUI's
53own micro-server rather than by the browser.
54</DL>
55</UL><FONT SIZE=+1><STRONG>ENVIRONMENT</STRONG></FONT><UL>
56</UL><FONT SIZE=+1><STRONG>AUTHOR</STRONG></FONT><UL>
57include(copyright.h)
58</UL><FONT SIZE=+1><STRONG>LIMITATIONS</STRONG></FONT><UL>
59<LI>The GUI doesn't work on NT.
60<LI>The user has to know when to refresh/reload a screen.
61<LI><STRONG>Choose a URL List</STRONG>: The
62programmer has to keep the comments up to date if a configuration file is
63modified.
64<LI><STRONG>View WebStone Results</STRONG>: Names of subdirectories should
65be given in the table, so the user can identify sets of runs.
66<LI><STRONG>Administer WebStone</STRONG>: The "Clean up stray WebStone
67processes" option only works on UNIX systems.  The "Move Results Directory"
68should allow the user to choose a particular list of run directories
69and move them to a subdirectory of "bin/runs".
70</UL><FONT SIZE=+1><STRONG>SEE ALSO</STRONG></FONT><UL>
71<A href=runbench.html>runbench(1)</A>,
72<A href=webclient.html>webclient(1)<A>,
73<A href=webmaster.html>webmaster(1)</A>,
74<A href=webstone.html>webstone(1)</A>
75include(mc_html_foot.h)
76