Azure Marketplace "Load Tester (standalone) Powered by Apache JMeter™" Users manual.

Last updated:

Select a language: [English] [日本語]


This is the simplified manual for “Load Tester (standalone) Powered by Apache JMeter™” from Azure Marketplace.

What’s Load Tester (standalone) Powered by Apache JMeter™

“Load Tester (standalone) Powered by Apache JMeter™” performs stress tests from a single server.

* If multiple servers are required for stress tests, Please use “Load Tester (multiple remote servers) Powered by Apache JMeter™

Main feature of Load Tester (standalone) Powered by Apache JMeter™

  • Apache JMeter 5.6.3, 5.6.2, 5.6, 5.5, 5.4.3, 5.4.2, 5.4.1, 5.4, 5.3
  • Can connect from Microsoft Remote Desktop client. (xrdp installed)
  • Added Japanese, Korean, Chinese fonts.
  • Ubuntu 20.04 LTS
  • Provided as Azure virtual machine image.

System requirements

  • Virtual machine can connect through TCP/3389. (If you want to operate with GUI in Windows Remote Desktop)
  • Virtual machine can connect through TCP/22. (If you want to operate with CLI in SSH)

How to build

Access to “Create Load Tester (standalone) Powered by Apache JMeter™” and Create.

Network Security Group (NSG) is applied to the NIC on the Azure virtual machines.

The following rules have been added to the NSG inbound security rules:

  • Allow RDP(TCP/3389) from any connection source
  • Allow SSH(TCP/22) from any connection source

You should change this NSG settings to only allow connections from where you need it.

If you have created a Public IP address, you permit these connections from all over the Internet by default.

How to use

Select your preferred type of operation, GUI with Remote Desktop or CLI with SSH.

* “How to use Apache JMeter” is not included in this document.

Use for GUI

  1. Remote Desktop Connection

    1. Connect with Remote Desktop (RDP) from the client PC.

      • Computer field : Input the Public IP Address found from the previous ‘How to use’ Section. It can also be found on the Summary Blade.
    2. The Remote Desktop screen appears and a dialog box of “Login to (virtual machine name)” is displayed. Set the following information and click [OK]

      • Session : Xorg
      • username : The user name you specified when you deployed from Marketplace
      • password : The password you specified when you deployed from Marketplace
  2. Start JMeter application

    1. Double-click [JMeter] on the remote desktop screen.

    2. You can change the display language from [Choose Language] on the [Options] menu.

If you specified “SSH Shared key” as the Authentication type at the time of deployment, you need to log in to virtual machine with ssh and set the password before logging in with the GUI.

(login from ssh)
$ sudo passwd $USER
New password: <<enter password>>
Retype new password: <<re-enter password>>
passwd: password updated successfully

Use for CLI

Please connect and operate with SSH.

JMeter Path: /usr/local/jmeter

Change JAVA version

By default JMeter works on JRE 8.

The following JRE has been installed on the virtual machine and can be changed to any version.

  • JRE 8 (default)
  • JRE 11
  • JRE 17

Add the JAVA_HOME setting to the “~/.loadtester” on the virtual machine.

  • Using JRE 11: export JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

Example using for JRE 11.

export JAVA_HOME="/usr/lib/jvm/java-11-openjdk-amd64"

After that, logout from the virtual machine and then login again.


Update for softwares

For the software version of Ubuntu and JMeter, the latest version at the time of registration in Marketplace has already been applied.

Please update Ubuntu and software as necessary.


  • Can’t connect to virtual machine with Remote Desktop

    • You need to be able to connect to virtual macine via TCP/3389 port. Please check the following.
      • Is it set to allow TCP/3389 inbound rule with Azure NSG assigned to subnet or NIC?
      • In the case of via Azure LoadBalancer, is the LoadBalancer properly forwarding to TCP/3389 of the virtual machine?
  • OS does not start normally / Can’t login to Remote Desktop

    • 2GB or more of OS memory is required to operate the virtual machine normally

      Change the Azure Virtual machine to the appropriate size.

  • Apache JMeter™ does not start due to lack of memory

    • Adjust the heap memory size used by JMeter by specifying -Xms and -Xms in the JVM_ARGS environment variable

      Example of setting -Xms and -Xmx of JVM_ARGS environment variables to 64MB and 128MB in ~/.loadtester

      export JVM_ARGS="-Xms64m -Xmx128m"


Support is available at a charge.

  • Supported inquiries example
    • The target solution can not be deployed.
    • Virtual machines does not work properly after deployment
  • The following are not supported

If you wish to support services, please contact below.

Apache®, Apache JMeter™, JMeter, and the feather logo are either registered trademarks or trademarks of the Apache Software Foundation in the United States and/or other countries. No endorsement by The Apache Software Foundation is implied by the use of these marks.