Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Mirror of Apache JMeter
Java HTML XSLT Other

This branch is 45 commits ahead, 6601 commits behind trunk

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
docs
extras
lib
src
test/src/org/apache
xdocs
KEYS.txt
LICENSE
LICENSE(XPP3).txt
LICENSE(XStream).txt
LICENSE(htmlparser).txt
LICENSE(jCharts).txt
LICENSE(jdom).txt
LICENSE(jtidy).txt
MANIFEST
NOTICE
README
STATUS
build.properties
build.xml
eclipse.classpath
eclipse.readme
fb-csv.xsl
fb-excludes.xml

README

                         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.
Something went wrong with that request. Please try again.