A P A C H E J M E T E R What is it? ----------- Apache JMeter is a 100% pure Java application designed to test and measure performance. It may be used as a highly portable server benchmark as well as multiclient load generator. The Latest Version ------------------ Details of the latest version can be found on the Java Apache Project web site (http://jakarta.apache.org/jmeter). Requirements ------------ The following requirements exist for running Apache JMeter: o Java Interpreter: A fully compliant Java 1.4 (or later) Runtime Environment is required for Apache JMeter to execute. o Optional jars: Some jars are not included with JMeter. If required, these should be downloaded and placed in the lib directory BeanShell (bsh.jar) - www.beanshell.org JavaMail (activation.jar, mail.jar) - java.sun.com JMS (jms.jar) - java.sun.com o Java Compiler [OPTIONAL]: A Java compiler is not needed since the distribution includes a precompiled java binary archive. Note that a compiler is required if you plan to build plugin classes for Apache JMeter. Installation Instructions ------------------------- Note that spaces in directory names can cause problems. - Release builds Unpack the binary archive into a suitable directory structure. - Nightly builds Unpack BOTH the _bin and _lib archives into the SAME directory structure Running JMeter -------------- Change to the bin directory and run the jmeter (Un*x) or jmeter.bat (Windows) file. For Windows, there are also some other scripts: jmeter-n.bat - drop a JMX file on this and it will run it as a non-GUI test jmeter-t.bat - drop a JMX file on this and it will open the file for running a GUI test Documentation ------------- The documentation available as of the date of this release is also included, in HTML format, in the printable_docs/ directory, and it may be browsed starting from the file called index.html. Build instructions ------------------ Please note: To avoid unnecessary duplication, the source archives do not contain the source files also needed to run JMeter (for example properties files and scripts). - Release builds Unpack both the binary and source archives into the same directory structure. - Nightly builds Unpack the _src, _bin and _lib archives into the same directory structure. Any optional jars (see above) should be placed in lib/opt and/or lib. Jars in lib/opt will be used for building JMeter and running the unit test, but won't be used at run-time. [This is useful for testing what happens if the optional jars are not downloaded by other JMeter users]. JMeter is built using Ant. Change to the top-level directory and issue the command: ant This will compile the application and enable you to run jmeter from the bin directory. ant test [-Djava.awt.headless=true] This will compile and run the unit tests. The optional property definition is required if the system does not have a suitable GUI display. Licensing and legal issues -------------------------- For legal and licensing issues, please look the files: LICENSE NOTICE lib/LICENSE* Thanks for using Apache JMeter.