Installing Apache JMeter

Apache JMeterをインストールする

System Requirements

動作環境

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環境
Apache JMeterを実行するには、完全準拠のJava1.2の環境が必要です。 (たぶん最終リリースでは1.1にも移植されるでしょう) Apache JMeterは標準のJava API (java.*)しか使用していないので、お使いのJREでクラスが実装されていなかったり、完全に仕様に準拠してないため、 Apache JMeterが動作しないからといって、バグレポートに書かないでください。

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 JFC (Swingコンポーネント)
Apache JMeterにはSwing GUI拡張が必要です。パッケージ名に互換性がないため、コンパイル済みバージョンはjavax.swingパッケージの下においてあるSwingのみ有効です。このパッケージがJava 2(tm)プラットフォームで見つかる、Swingの最終的な置き場所です。

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.

Javaコンパイラー [オプション]
配布物にコンパイル済みのjavaバイナリーのアーカイブが含まれていれば、 Javaコンパイラーは必要ありません。ソースコードからコンパイルしなおすか、独自のプラグインをビルドする場合のみ、必要です。

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.

SAX 1.0 XMLパーサー [オプション]
保存したHTTPSampleを復元したり、Apache JMeterをコンパイルするには、 SAX 1.0ライブラリーとSAX準拠のパーサーが必要です。連帯の精神から、Apache独自のXerces パーサーを推薦します。

Java Mail^tm & javax.activation [optional]
The javax.mail & javax.activation packages are required to use the MailVisualizer and to compile Apache JMeter.

Java Mail^tm & javax.activation [オプション]
MailVisualizerを使ったり、Apache JMeterをコンパイルするには、 javax.mailパッケージとjavax.activationパッケージが必要です。

JSSE [optional]
JSSE is used to provide an SSL implementation to enable testing of https protocol.
JSSE [オプション]
httpsプロトコルのテストを可能にするSSL実装を使うには、JSSEが使われます。

Installing Apache JMeter

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.

お使いのシステムが上記の要求を満たしていれば、Javaのすばらしさのおかげで他に何もすることはありません: /binディレクトリの下に、バイナリーアプリケーションとApache JMeterを実行するのに必要なシステムラッパーを見つけられるでしょう。引き続き実行に関する説明に進んでください。

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.

コンパイル済みのバイナリーがシステムに合わない (Swingパッケージに互換性がない)場合や、ソースコードをコンパイルしなおしたい場合は、/srcディレクトリにある、お使いのOSにあったmakefileを使って、手動でコンパイルすることができます。

Using ant

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

JMeterは、jakartaプロジェクトが生み出した antのmakefileを代わりに使用するように設定されています。antを使ってビルドするには:

jmeterの配布物がある基本ディレクトリーに移動する

ant installを実行する

Using makefiles

makefileを使う

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

move your current directory to /src

type make

UNIXやWindowsでは、Apache JMeterを簡単にビルドできます:

/srcディレクトリにカレントディレクトリを移動する

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.

makefileは、javacとjavadocがパスの通っている場所にインストールされていると仮定するので、もしそうでなかったり、他のツールを使用したい場合は、ファイルの中に書いてある指示に従い、手でファイルを編集する必要があります。

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.

makeが完了すると、ApacheJMeter.jarという名前のファイルが/binディレクトリの下にできます。ビルドしたアプリケーションを立ち上げる方法を知るには、次の章に行きましょう。

Doing it by hand

手動で行う

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

このセクションでは、javacやjavadoc、jarといった、 JavaコンパイラーとJavaのツールについて知識があることを想定しています。

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)

まず最初にソースファイルをコンパイルしなければいけません。コンパイルするにはまず一時ディレクトリ (たとえば./src/temp) を作り、 /srcディレクトリへ移動して以下のコマンドを実行します(すべて一行で記述します)

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.

これで、適切なクラスファイルが./temp ディレクトリの下にできます。もし動作しなければ、swingall.jarパッケージがクラスパスに存在するか、 Swingクラスがcom.sun.java.swingディレクトリの下にあるかチェックしてください。

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

(もちろんwindowsユーザーはシステムの設定に応じて若干変更してください)。さあ、以下のようにタイプして、jarアーカイブをビルドしましょう

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

that will create the archive.

これでアーカイブができます。

To create the javadoc documentation simply type this other command

javadocドキュメントを作るには、以下のコマンドを打つだけです

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.

さあ、すべてビルドされました。実行方法を知るため、次の章へ行きましょう。