jmeter

JMETER(1)                         User Commands                        JMETER(1)



NAME
       jmeter - Apache JMeter - Load testing tool

SYNOPSIS
       jmeter [options]


DESCRIPTION
       Apache JMeter is a Java application designed to load test functional
       behavior and measure performance. It was originally designed for testing
       Web Applications but has since expanded to other test functions.

       Apache JMeter may be used to test performance both on static and dynamic
       resources (files, Servlets, Perl scripts, Java Objects, Data Bases and
       Queries, FTP Servers and more). It can be used to simulate a heavy load
       on a server, network or object to test its strength or to analyze overall
       performance under different load types. You can use it to make a
       graphical analysis of performance or to test your server/script/object
       behavior under heavy concurrent load.


OPTIONS
       -h, --help

              print usage information and exit

       -v, --version

              print the version information and exit

       -p, --propfile <argument>

              the jmeter property file to use

       -q, --addprop <argument>

              additional JMeter property file(s)

       -t, --testfile <argument>

              the jmeter test(.jmx) file to run

       -l, --logfile <argument>

              the file to log samples to

       -j, --jmeterlogfile <argument>

              jmeter run log file (jmeter.log)

       -n, --nongui

              run JMeter in nongui mode

       -s, --server

              run the JMeter server

       -H, --proxyHost <argument>

              Set a proxy server for JMeter to use

       -P, --proxyPort <argument>

              Set proxy server port for JMeter to use

       -N, --nonProxyHosts <argument>

              Set nonproxy host list (e.g. *.apache.org|localhost)

       -u, --username <argument>

              Set username for proxy server that JMeter is to use

       -a, --password <argument>

              Set password for proxy server that JMeter is to use

       -J, --jmeterproperty <argument>=<value>

              Define additional JMeter properties

       -G, --globalproperty <argument>=<value>

              Define Global properties (sent to servers) e.g. -Gport=123

              or -Gglobal.properties

       -D, --systemproperty <argument>=<value>

              Define additional system properties

       -S, --systemPropertyFile <argument>

              additional system property file(s)

       -L, --loglevel <argument>=<value>

              [category=]level e.g. jorphan=INFO or jmeter.util=DEBUG

       -r, --runremote

              Start remote servers (as defined in remote_hosts)

       -R, --remotestart <argument>

              Start these remote servers (overrides remote_hosts)

       -d, --homedir <argument>

              the jmeter home directory to use

       -X, --remoteexit

              Exit the remote servers at end of test (non-GUI)


EXAMPLES
       Run Apache JMeter in GUI mode:

              jmeter [-p property-file]


       Run Apache JMeter in NON_GUI mode:

              jmeter -n -t test-file [-p property-file] [-l log-file]


       Tell Apache JMeter to use a proxy server:

              jmeter -H [your.proxy.server] -P [your proxy server port]


       Run Apache JMeter in server mode:

              jmeter -s

       or     jmeter-server

HOMEPAGE
       http://jmeter.apache.org



                                    July 2013                          JMETER(1)