- Java Environment
A fully compliant Java 1.2 environment is required for Apache JMeter to execute. (hopefully this will be changed back to 1.1 in the final release) Since Apache JMeter uses only standard Java APIs (java.*), please, do not file in a bug report if your JRE fails to execute Apache JMeter because a class implementation is missing, or not fully compliant.- Java JFC (Swing components)
Swing GUI extentions are required for Apache JMeter. Due to incompatibility in the package names, the precompiled version works only with Swing placed under the package javax.swing which is its final destination found in the Java 2(tm) platform.- Java Compiler [optional]
A Java compiler is not needed since the distribution includes a precompiled java binary archive. Note that a compiler is required if you plan to recompile the source code or if you plan to build your own plugins.- SAX 1.0 XML Parser [optional]
The SAX 1.0 libraries and a SAX compliant parser are necassary for restoring of saved HTTPSamples and to compile Apache JMeter. In the spirit of solidarity we recomend Apache's own Xerces parser.- Java Mailtm & javax.activation [optional]
The javax.mail & javax.activation packages are required to use the MailVisualizer and to compile Apache JMeter.- JSSE [optional]
JSSE is used to provide an SSL implementation to enable testing of https protocol.
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 ant
JMeter has been configured to use the ant makefile replacement from the jakarta project. To build with ant:
- move to the base of the jmeter distribution
- run
ant install
Using makefiles
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.
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.11 2000/09/08 01:57:35 mstover Exp $
All rights reserved.