Installing Apache JMeter

System Requirements

Installing Apache JMeter

If your system meets the above requirements, thanks to the beauty of Java you don't have to do anything else: under the directory /bin you will find the binary application and the system wrappers you need to run Apache JMeter. You may want to go the running instructions to continue.

If the precompiled binary doesn't match your system (Swing package incompatibility) or you simply want to recompile the source code, you may use the makefile that matches your operating system under the directory /src or do it by hand.

Using makefiles

Under both UNIX and Windows systems, building Apache JMeter is very simple:

Since those makefiles assume you have both javac and javadoc installed in your path, if this is not the case or you simply want to use other tools, you have to edit those files by hand and follow internal instructions.

When the make process is complete, a file named ApacheJMeter.jar will be placed under the /bin directory. You may go to next section to see how to start the application you just built.

Doing it by hand

This section assumes knowledge about Java compilers and Java tools, such as javac, javadoc and jar.

First thing you have to do is to compile the source files. To do this, you create a temporary directory (say ./src/temp), more to the /src directory and execute the following command (all in one line)

javac -d ./temp ./org/apache/jmeter/timers/*.java ./org/apache/jmeter/visualizers/*.java ./org/apache/jmeter/samplers/*.java ./org/apache/jmeter/*.java

This should create all the right class files under the ./temp directory. If this doesn't work, check to see if the package swingall.jar resides in your classpath and if the Swing classes reside under the com.sun.java.swing directories.

When your done compiling the classes, you should copy all resources in the right place executing

cp ./org/apache/jmeter/images/* ./temp/org/apache/jmeter/images/*
cp ./org/apache/jmeter/*.properties ./temp/org/apache/jmeter/*.properties

(of course windows users should change this a little to match system settings). Now you are ready to build the jar archive by typing

jar cmf0 ./MANIFEST ../bin/ApacheJMeter.jar ./temp/.

that will create the archive.

To create the javadoc documentation simply type this other command

javadoc -d ..\docs\api org.apache.jmeter org.apache.jmeter.timers org.apache.jmeter.visualizers org.apache.jmeter.samplers

Now that everything is built, just go on to the next section to see how to run it.

Copyright (c) 1998-99 The Java Apache Project.
$Id: installing.html,v 1.5 1999/02/24 15:33:56 stefano Exp $
All rights reserved.