OS Manuals

/usr/lib/jmeter/bin/jmeter-server

Apache JMeter is a Java-based load and performance testing tool for measuring service performance.

From jmeter 5.6.3-r8 (enterprise-packages), captured 2026-11-09 by running jmeter-server --usage (exit 0). permalink

2026-11-09T14:51:28.641326237Z main WARN The use of package scanning to locate Log4j plugins is deprecated.
Please remove the `packages` attribute from your configuration file.
See https://logging.apache.org/log4j/2.x/faq.html#package-scanning for details.
2026-11-09T14:51:28.673316478Z main WARN Some custom `Core` Log4j plugins are not properly registered:
	org.apache.jmeter.gui.logging.GuiLogEventAppender
Please consider reporting this to the maintainers of these plugins.
See https://logging.apache.org/log4j/2.x/manual/plugins.html#plugin-registry for details.
Error: Unknown option --usage
Usage
	--?
		print command line options and exit
	-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. "-t LAST" will load last
		used file
	-l, --logfile <argument>
		the file to log samples to
	-i, --jmeterlogconf <argument>
		jmeter logging configuration file (log4j2.xml)
	-j, --jmeterlogfile <argument>
		jmeter run log file (jmeter.log)
	-n, --nongui
		run JMeter in nongui mode
	-s, --server
		run the JMeter server
	-E, --proxyScheme <argument>
		Set a proxy scheme to use for the proxy 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)
	-f, --forceDeleteResultFile
		force delete existing results files and web report folder if
		 present before starting the test
	-L, --loglevel <argument>=<value>
		[category=]level e.g. jorphan=INFO, jmeter.util=DEBUG or com
		.example.foo=WARN
	-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)
	-g, --reportonly <argument>
		generate report dashboard only, from a test results file
	-e, --reportatendofloadtests
		generate report dashboard after load test
	-o, --reportoutputfolder <argument>
		output folder for report dashboard

Error: Unknown option --usage
Options (30)
OptionDescriptionSource
--?print command line options and exithelp
-h, --helpprint usage information and exithelp
-v, --versionprint the version information and exithelp
-p, --propfile argumentthe jmeter property file to usehelp
-q, --addprop argumentadditional JMeter property file(s)help
-t, --testfile argumentthe jmeter test(.jmx) file to run.help
-l, --logfile argumentthe file to log samples tohelp
-i, --jmeterlogconf argumentjmeter logging configuration file (log4j2.xml)help
-j, --jmeterlogfile argumentjmeter run log file (jmeter.log)help
-n, --nonguirun JMeter in nongui modehelp
-s, --serverrun the JMeter serverhelp
-E, --proxyScheme argumentSet a proxy scheme to use for the proxy serverhelp
-H, --proxyHost argumentSet a proxy server for JMeter to usehelp
-P, --proxyPort argumentSet proxy server port for JMeter to usehelp
-N, --nonProxyHosts argumentSet nonproxy host list (e.g. *.apache.org|localhost)help
-u, --username argumentSet username for proxy server that JMeter is to usehelp
-a, --password argumentSet password for proxy server that JMeter is to usehelp
-J, --jmeterproperty argument>=<valueDefine additional JMeter propertieshelp
-G, --globalproperty argument>=<valueDefine Global properties (sent to servers) e.g. -Gport=123 or -Gglobal.propertieshelp
-D, --systemproperty argument>=<valueDefine additional system propertieshelp
-S, --systemPropertyFile argumentadditional system property file(s)help
-f, --forceDeleteResultFileforce delete existing results files and web report folder if present before starting the testhelp
-L, --loglevel argument>=<value[category=]level e.g. jorphan=INFO, jmeter.util=DEBUG or com .example.foo=WARNhelp
-r, --runremoteStart remote servers (as defined in remote_hosts)help
-R, --remotestart argumentStart these remote servers (overrides remote_hosts)help
-d, --homedir argumentthe jmeter home directory to usehelp
-X, --remoteexitExit the remote servers at end of test (non-GUI)help
-g, --reportonly argumentgenerate report dashboard only, from a test results filehelp
-e, --reportatendofloadtestsgenerate report dashboard after load testhelp
-o, --reportoutputfolder argumentoutput folder for report dashboardhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.