JMeter Download and Installation Guide

Before you download and install JMeter, your should ensure that your computer meets the basic requirements for its installation. JMeter runs on most operating systems however its good to check if your operating system is supported to avoid any issues.

Java Virtual Machine

JMeter is developed in the Java programming language. Therefore, it requires a fully compliant JVM 6 or higher.

Operating System

JMeter can run on any operating system which is supported by Java.

The latest version of JMeter works well in Linux, Solaris, OS X and Windows. If your computer uses above OS, you should be able to get JMeter running using the steps below.

This topic will guide you how to install and launch JMeter in Window 7, Java SDK 8.x but the steps are similar on all operating systems.

Getting Started

The following figure describes the steps required to install and launch JMeter. JMeter_Installation_Steps_Windows

Step 1. Java Installation

If you do not have Java installed on your machine, you can download the Java runtime from Click on the Free Java Download button on the homepage as shown below.JMeter_Java_Download_Installation_Tutorial1

This will open the Java download page. You may see a warning message if your browser does not support Java in a standard manner. However you can ignore this and click on the Agree and Start Free Download button.JMeter_Java_Download_Installation_Tutorial2

You will be prompted to save the downloaded file. Save the file to your preferred location on your computer. After the file is completely downloaded, you need to run the file and follow the instructions given by the installer to install Java.

After downloading and installing Java, you can verify whether Java is installed succesfully in your operating system.

Open Start > Run > Type the command CMD to launch the command prompt and enter: java –version.JMeter_Installation_Java_Check_windows

If Java is installed, you will see the version information of Java displayed as shown above. You can now proceed to Step 2.

Step 2. Download JMeter

The latest version of JMeter at present is 2.13. You can download JMeter from the link below

Apache offer you 2 options when downloading JMeter. You can choose either binary files or source code.JMeter_Installation_Binaries_Package

If you are a developer and you want to customize the JMeter source code, you can download the package listed under Source. You can use this to build JMeter on your machine and customize it as per your requirements.

In this tutorial, we will download the binary version of JMeter listed under Binaries. Click on the file to download the zip file.

Step 3. JMeter Installation

After you download and extract the zip file, you can browse the JMeter directory. It contains the folder structure as shown in the image below.JMeter_Directory_Folder_Structure

Details of the folders are given in the table below.

Directory Description
\bin JMeter binary files (for launching JMeter)
\docs JMeter APIs documentation. Also useful if you want to customize JMeter source code and want to understand the existing API before you proceed.
\lib Required Java libraries for JMeter.
\licenses License information related to 3rd party library which JMeter uses
\printable_docs JMeter manual and guide that can be printed

Step 4. Launch JMeter

You can run JMeter in 3 different modes depending on your requirements.

1. In GUI mode

In Windows, you can start the JMeter by double clicking the ApacheJMeter.jar file. If you have installed JMeter and Java correctly, you should see the JMeter application interface. JMeter_Application_GUI_Introduction

It double clicking on the ApacheJMeter.jar file does not work, you can also launch Jmeter by running the jmeter.bat file. This file is located under in the “bin” folder.JMeter_Batch_File_Windows

2. In Server mode

JMeter can not only run locally but also run remotely. You can execute the test via many other computers. Using this feature you can simulate a very large load on the server.

You can start JMeter in server mode by launching the file jmeter-server.bat in the windows command prompt. JMeter will launch as shown in the figure below.JMeter_Installation_Server_Mode

3. In Command line or non-GUI mode

Using JMeter in GUI mode is convenient for user but it consumes significant amount of memory. To overcome this problem, JMeter allows you to launch it in command line mode as well.

Many people use the GUI mode to create the load test plans and test it. Once they are sure the test plan is correct, they use the command line mode to execute the actual test. You can run JMeter in non-GUI mode by running the following command:

java -jar ApacheJMeter.jar -n -t mytestfilename.ext

The command line mode in JMeter accepts the following parameters:

  • -n: Run JMeter in command line
  • -t [Name of Test Plan file]
  • -l [Name of log sample results]
  • -r: Run the test in server mode

If you want to see the detailed options available in JMeter, you can use the command “jmeter –h”

It will display a brief help text with all the options available in JMeter.JMeter_Command_Line_Help

In the next topic we will go through an overview of all the elements in JMeter and the features they provide.