mstover1 01/03/29 05:03:43 Modified: docs running.html Added: xdocs running.xml Log: Updating Running.html documentation Revision Changes Path 1.11 +147 -62 jakarta-jmeter/docs/running.html Index: running.html =================================================================== RCS file: /home/cvs/jakarta-jmeter/docs/running.html,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- running.html 2000/09/08 01:57:55 1.10 +++ running.html 2001/03/29 13:03:43 1.11 @@ -1,22 +1,84 @@ -<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> -<html> +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> -<meta name="Author" content="Stefano Mazzocchi"> -<title>Running Apache JMeter</title> -</head> +<!-- Content Stylesheet for Site --> -<body bgcolor="#FFFFFF"> - -<h2 align="center"><img SRC="images/java-apache-project.gif" NOSAVE BORDER="0" -height="100" width="609"></h2> - -<h1 align="center">Running Apache JMeter</h1> - -<h2><a NAME="scripts"></a>Using system wrappers</h2> - -<blockquote> + +<!-- start the processing --> + <!-- ====================================================================== --> + <!-- Main Page Section --> + <!-- ====================================================================== --> + <html> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/> + + <meta name="author" value="Brendan Burns, et al."> + <meta name="email" value="[EMAIL PROTECTED]"> + + <title>JMeter - Running Apache JMeter</title> + </head> + + <body bgcolor="#ffffff" text="#000000" link="#525D76"> + <table border="0" width="100%" cellspacing="0"> + <!-- TOP IMAGE --> + <tr> + <td colspan="2"> +<a href="http://jakarta.apache.org"><img src="http://jakarta.apache.org/images/jakarta-logo.gif" align="left" border="0"/></a> +</td> + </tr> + </table> + <table border="0" width="100%" cellspacing="4"> + <tr><td colspan="2"> + <hr noshade="" size="1"/> + </td></tr> + + <tr> + <!-- LEFT SIDE NAVIGATION --> + <td valign="top" nowrap="true"> + <p><strong>About</strong></p> + <ul> + <li> <a href="./index.html">Overview</a> +</li> + <li> <a href="./user_manual/index.html">Usage</a> +</li> + <li> <a href="http://jakarta.apache.org/builds/jakarta-jmeter/">Download</a> +</li> + <li> <a href="./installing.html">Install</a> +</li> + <li> <a href="./running.html">Running</a> +</li> + <li> <a href="./extending/index.html">Extending</a> +</li> + <li> <a href="./changes.html">Changes</a> +</li> + <li> <a href="./bugs.html">Known Bugs</a> +</li> + <li> <a href="./license.html">License</a> +</li> + <li> <a href="./todo.html">TODO</a> +</li> + </ul> + <p><strong>Community</strong></p> + <ul> + <li> <a href="http://jakarta.apache.org/site/getinvolved.html">Get Involved</a> +</li> + <li> <a href="http://jakarta.apache.org/site/mail.html">Mailing Lists</a> +</li> + <li> <a href="http://jakarta.apache.org/site/cvsindex.html">CVS Repositories</a> +</li> + </ul> + </td> + <td align="left" valign="top"> + <table border="0" cellspacing="0" cellpadding="2" width="100%"> + <tr><td bgcolor="#525D76"> + <font color="#ffffff" face="arial,helvetica,sanserif"> + <strong>Running Apache JMeter</strong> + </font> + </td></tr> + <tr><td> + <blockquote> + <h1 align="center">Running Apache JMeter</h1> + <h2><a NAME="scripts" />Using system wrappers</h2> + <blockquote> <p>Apache JMeter comes with startup scripts to help you run the application. They are located in the directory /bin and are called jmeter for UNIX systems and jmeter.bat for Windows systems. Make sure the file <code>ApacheJMeter.jar</code> and <code>jmeter.properties</code> is located in the same @@ -24,70 +86,62 @@ <p>Since those scripts assumes you have your classpath already setup and the java interpreter in your path. It this is not the case, setup you Java environment first and edit the script to match your system.</p> - <P>In addition to the standard Java libraries that come with the JRE, you may need to download three other API's: -<ul> - <li><STRONG>XML</STRONG>: <A HREF="http://xml.apache.org/dist/xerces-j">xerces</A> from <A HREF="http://xml.apache.org">Apache</A>, - or <A HREF="http://java.sun.com/xml/download.html">JAXP</A> from <A HREF="http://java.sun.com">sun</A> -or any other SAX 1.0 compliant XML Parser.<BR> -To enable XML (which is necessary for saving your test samples and test scripts), add the xerces.jar (Xerces) or jaxp.jar + <p>In addition to the standard Java libraries that come with the JRE, you may need to download three other API's: +</p> <ul> + <li><STRONG>XML</STRONG>: <a HREF="http://xml.apache.org/dist/xerces-j">xerces</a> from <a HREF="http://xml.apache.org">Apache</a>, or <a HREF="http://java.sun.com/xml/download.html">JAXP</a> from <a HREF="http://java.sun.com">sun</a> or any other SAX 1.0 compliant XML Parser.<br /> +To enable XML (which is necessary for saving your test samples and test scripts), add the xerces.jar (Xerces) or jaxp.jar & parser.jar (JAXP) to your classpath or $JAVA_HOME/jre/lib/ext directory.<p> - Currrently, <strong>jmeter.properties</strong> is set to use the parser in xerces by default. To change to Sun's parser, + Currrently, <strong>jmeter.properties</strong> is set to use the parser in xerces by default. To change to Sun's parser, be sure to change the line in jmeter.properties that instructs JMeter which SAX parser to use. This line looks like this:</p> <p><code>xml.parser=org.apache.xerces.parsers.SAXParser</code></p></li> - <li><p><STRONG>Mail</STRONG>: <A HREF="http://java.sun.com/products/javamail/index.html">Java Mail<sup><font size=-2>tm</font></sup></a> API as well as the <a href=http://www.javasoft.com/beans/glasgow/jaf/>javax.activation</a> API</A> - from <A HREF="http://java.sun.com">Sun</A>.<BR> - To enable the MailVisualizer, add mail.jar and activation.jar from Sun's JavaMail download to your classpath or -$JAVA_HOME/jre/lib/ext directory.</p></li> - <li><p><strong>JSSE</strong>: <a href="http://java.sun.com/products/jsse/">JSSE</a> is available from <A HREF="http://java.sun.com">sun</A>.<br> - JSSE is an SSL encryption provider that is used to enable JMeter to test websites using the https protocol.</p> - <p>To turn SSL support on, make sure all the jars that come with JSSE are in your classpath (jsse.jar, jnet.jar, jcert.jar), and - modify <strong>jmeter.properties</strong> to instruct JMeter which SSL Provider you are using. For JSSE, set the line as - follows:</p> - <p>ssl.provider=com.sun.net.ssl.internal.ssl.Provider</p> + <li><STRONG>Mail</STRONG>: <a HREF="http://java.sun.com/products/javamail/index.html">Java Mail<sup><font size="-2">tm</font></sup></a> API as well as the <a href="http://www.javasoft.com/beans/glasgow/jaf">javax.activation</a> API from <a HREF="http://java.sun.com">Sun</a>.<br /> To enable the MailVisualizer, add mail.jar and activation.jar from Sun's +JavaMail download to your classpath or $JAVA_HOME/jre/lib/ext directory.</li> +<li><p><strong>JSSE</strong>: <a href="http://java.sun.com/products/jsse/">JSSE</a> is available from <a HREF="http://java.sun.com">sun</a>.<br /> JSSE +is an SSL encryption provider that is used to enable JMeter to test websites using the https protocol.</p> <p>To turn +SSL support on, make sure all the jars that come with JSSE are in your classpath (jsse.jar, jnet.jar, jcert.jar), and +modify <strong>jmeter.properties</strong> to instruct JMeter which SSL Provider you are using. For JSSE, set the line +as follows:</p> <p>ssl.provider=com.sun.net.ssl.internal.ssl.Provider</p></li> </ul> </blockquote> - -<h2><a NAME="command"></a>From the command line</h2> - -<blockquote> + <h2><a NAME="command" />From the command line</h2> + <blockquote> <p>If you don't like script you can use the command line as follows </p> <blockquote> - <tt><p>UNIX: <java interpreterer> <options> -classpath - $CLASSPATH:ApacheJMeter.jar org.apache.jmeter.Driver [properties file] - </tt> <br> - <tt>Windows: <java interpreter> <options> -classapth - %classpath%;ApacheJMeter.jar org.apache.jmeter.Driver [properties file] - </tt></p> + <tt>UNIX: <java interpreterer> <options> -classpath + $CLASSPATH:ApacheJMeter.jar org.apache.jmeter.Driver [properties file] + </tt> <br /> + <tt>Windows: <java interpreter> <options> -classapth + %classpath%;ApacheJMeter.jar org.apache.jmeter.Driver [properties file] + </tt> </blockquote> <p>where options are usually not needed. </p> <p><strong>In case you use the Java 2 platform you can type </strong></p> <blockquote> - <tt><p><strong>java -jar ApacheJMeter.jar</strong></tt></p> + <tt><strong>java -jar ApacheJMeter.jar</strong></tt> </blockquote> <p><strong>or double click on the file</strong>. </p> </blockquote> -<h2><a NAME="properties"></a>Modifying Properties</h2> - -<blockquote> + <h2><a NAME="properties" />Modifying Properties</h2> + <blockquote> <p>If you wish to modify the properties with which JMeter runs you need to either modify the jmeter.properties inside of the /bin directory or create - your own copy of the jmeter.properties and specify it in the command line + your own copy of the jmeter.properties and specify it in the command line (above). </p> <b>Properties to modify</b> <ul> - <li><b><tt>timer.*</tt></b> These properties define the implementations of the - <tt>org.apache.jmeter.timers.Timer</tt> interface that you wish to be + <li><b><tt>timer.*</tt></b> These properties define the implementations of the + <tt>org.apache.jmeter.timers.Timer</tt> interface that you wish to be available to JMeter.</li> - <li><b><tt>visualizer.*</tt></b> These properties define the implementations of - the <tt>org.apache.jmeter.visualizers.Visualizer</tt> interface that you + <li><b><tt>visualizer.*</tt></b> These properties define the implementations of + the <tt>org.apache.jmeter.visualizers.Visualizer</tt> interface that you wish to be available to JMeter.</li> - <li><b><tt>controller.*</tt></b> These properties define the implementations of - the <tt>org.apache.jmeter.samplers.SamplerController</tt> interface that + <li><b><tt>controller.*</tt></b> These properties define the implementations of + the <tt>org.apache.jmeter.samplers.SamplerController</tt> interface that you wish to be available to JMeter.</li> <li><b><tt>xml.parser</tt></b> The class name of the XML Parser implementing the <tt>org.xml.sax.Parser</tt> interface.</li> - <li><b><tt>xml.handler.*</tt></b> The class names of the implementations of + <li><b><tt>xml.handler.*</tt></b> The class names of the implementations of <tt>org.xml.sax.DocumentHandler</tt> interface that JMeter should be able to user</li> <li><b><tt>user.dir</tt></b> The directory JMeter should default to on startup as the working @@ -95,10 +149,41 @@ <li><b><tt>threads.max</tt></b> The maximum number of threads that can be selected for a single threadgroup</li> </ul> </blockquote> -<font size="-1"> -<p align="center">Copyright (c) 1998-99 <a href="http://java.apache.org">The Java Apache -Project</a>.<br> -$Id: running.html,v 1.10 2000/09/08 01:57:55 mstover Exp $</font> <br> + <p align="center"><font size="-1">Copyright (c) 1998-99 <a href="http://java.apache.org">The Java Apache +Project</a>.<br /> +$Id: running.html,v 1.11 2001/03/29 13:03:43 mstover1 Exp $</font> <br /> <font size="-1">All rights reserved.</font></p> -</body> -</html> + </blockquote> + </td></tr> + </table> + </td> + </tr> + + <!-- FOOTER --> + <tr><td colspan="2"> + <hr noshade="" size="1"/> + </td></tr> + <tr><td colspan="2"> + <div align="center"><font color="#525D76" size="-1"><em> + Copyright © 1999-2001, Apache Software Foundation + </em></font></div> + </td></tr> + </table> + </body> + </html> +<!-- end the processing --> + + + + + + + + + + + + + + + 1.1 jakarta-jmeter/xdocs/running.xml Index: running.xml =================================================================== <?xml version="1.0"?> <document> <properties> <author email="[EMAIL PROTECTED]">Brendan Burns, et al.</author> <title>Running Apache JMeter</title> </properties> <body> <section name="Running Apache JMeter"> <h1 align="center">Running Apache JMeter</h1> <h2><a NAME="scripts"></a>Using system wrappers</h2> <blockquote> <p>Apache JMeter comes with startup scripts to help you run the application. They are located in the directory /bin and are called jmeter for UNIX systems and jmeter.bat for Windows systems. Make sure the file <code>ApacheJMeter.jar</code> and <code>jmeter.properties</code> is located in the same directory and type <tt>jmeter [properties file]</tt> to start.</p> <p>Since those scripts assumes you have your classpath already setup and the java interpreter in your path. It this is not the case, setup you Java environment first and edit the script to match your system.</p> <p>In addition to the standard Java libraries that come with the JRE, you may need to download three other API's: </p> <ul> <li><STRONG>XML</STRONG>: <a HREF="http://xml.apache.org/dist/xerces-j">xerces</a> from <a HREF="http://xml.apache.org">Apache</a>, or <a HREF="http://java.sun.com/xml/download.html">JAXP</a> from <a HREF="http://java.sun.com">sun</a> or any other SAX 1.0 compliant XML Parser.<br/> To enable XML (which is necessary for saving your test samples and test scripts), add the xerces.jar (Xerces) or jaxp.jar & parser.jar (JAXP) to your classpath or $JAVA_HOME/jre/lib/ext directory.<p> Currrently, <strong>jmeter.properties</strong> is set to use the parser in xerces by default. To change to Sun's parser, be sure to change the line in jmeter.properties that instructs JMeter which SAX parser to use. This line looks like this:</p> <p><code>xml.parser=org.apache.xerces.parsers.SAXParser</code></p></li> <li><STRONG>Mail</STRONG>: <a HREF="http://java.sun.com/products/javamail/index.html">Java Mail<sup><font size="-2">tm</font></sup></a> API as well as the <a href="http://www.javasoft.com/beans/glasgow/jaf">javax.activation</a> API from <a HREF="http://java.sun.com">Sun</a>.<br/> To enable the MailVisualizer, add mail.jar and activation.jar from Sun's JavaMail download to your classpath or $JAVA_HOME/jre/lib/ext directory.</li> <li><p><strong>JSSE</strong>: <a href="http://java.sun.com/products/jsse/">JSSE</a> is available from <a HREF="http://java.sun.com">sun</a>.<br/> JSSE is an SSL encryption provider that is used to enable JMeter to test websites using the https protocol.</p> <p>To turn SSL support on, make sure all the jars that come with JSSE are in your classpath (jsse.jar, jnet.jar, jcert.jar), and modify <strong>jmeter.properties</strong> to instruct JMeter which SSL Provider you are using. For JSSE, set the line as follows:</p> <p>ssl.provider=com.sun.net.ssl.internal.ssl.Provider</p></li> </ul> </blockquote> <h2><a NAME="command"></a>From the command line</h2> <blockquote> <p>If you don't like script you can use the command line as follows </p> <blockquote> <tt>UNIX: <java interpreterer> <options> -classpath $CLASSPATH:ApacheJMeter.jar org.apache.jmeter.Driver [properties file] </tt> <br/> <tt>Windows: <java interpreter> <options> -classapth %classpath%;ApacheJMeter.jar org.apache.jmeter.Driver [properties file] </tt> </blockquote> <p>where options are usually not needed. </p> <p><strong>In case you use the Java 2 platform you can type </strong></p> <blockquote> <tt><strong>java -jar ApacheJMeter.jar</strong></tt> </blockquote> <p><strong>or double click on the file</strong>. </p> </blockquote> <h2><a NAME="properties"></a>Modifying Properties</h2> <blockquote> <p>If you wish to modify the properties with which JMeter runs you need to either modify the jmeter.properties inside of the /bin directory or create your own copy of the jmeter.properties and specify it in the command line (above). </p> <b>Properties to modify</b> <ul> <li><b><tt>timer.*</tt></b> These properties define the implementations of the <tt>org.apache.jmeter.timers.Timer</tt> interface that you wish to be available to JMeter.</li> <li><b><tt>visualizer.*</tt></b> These properties define the implementations of the <tt>org.apache.jmeter.visualizers.Visualizer</tt> interface that you wish to be available to JMeter.</li> <li><b><tt>controller.*</tt></b> These properties define the implementations of the <tt>org.apache.jmeter.samplers.SamplerController</tt> interface that you wish to be available to JMeter.</li> <li><b><tt>xml.parser</tt></b> The class name of the XML Parser implementing the <tt>org.xml.sax.Parser</tt> interface.</li> <li><b><tt>xml.handler.*</tt></b> The class names of the implementations of <tt>org.xml.sax.DocumentHandler</tt> interface that JMeter should be able to user</li> <li><b><tt>user.dir</tt></b> The directory JMeter should default to on startup as the working directory</li> <li><b><tt>threads.max</tt></b> The maximum number of threads that can be selected for a single threadgroup</li> </ul> </blockquote> <p align="center"><font size="-1">Copyright (c) 1998-99 <a href="http://java.apache.org">The Java Apache Project</a>.<br/> $Id: running.xml,v 1.1 2001/03/29 13:03:43 mstover1 Exp $</font> <br/> <font size="-1">All rights reserved.</font></p> </section> </body> </document> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
