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.
Under both UNIX and Windows systems, building Apache JMeter is very simple:
- move your current directory to /src
- type make
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.
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.