Running Apache JMeter

Apache JMeterを実行する

Using system wrappers

システムラッパーを使う

Apache JMeter comes with startup scripts to help you run the application. They are located in the directory /bin and are called jmeter for UNIX systems and jmeter.bat for Windows systems. Make sure the file ApacheJMeter.jar and jmeter.properties is located in the same directory and type jmeter [properties file] to start.

Apache JMeterには、アプリケーションの実行を手助けするスタートアップスクリプトが付属しています。 /binディレクトリの中に置かれていて、UNIXではjmeter、Windowsではjmeter.batという名前が付いています。 実行するには、ApacheJMeter.jarとjmeter.propertiesが同じディレクトリにあることを確認し、 jmeter [プロパティファイル]とタイプします。

Since those scripts assumes you have your classpath already setup and the java interpreter in your path. It this is not the case, setup you Java environment first and edit the script to match your system.

このスクリプトは、クラスパスがすでに設定されていて、javaインタープリターがパスに含まれていることを前提とします。 もしそうでなければ、まずJavaの環境を設定し、システムにあうようにスクリプトを編集してください。

In addition to the standard Java libraries that come with the JRE, you may need to download three other API's:

JREに付属している標準Javaライブラリーに加え、3つのAPIをダウンロードする必要があります:

• XML: xerces from Apache, or JAXP from sun or any other SAX 1.0 compliant XML Parser.
  To enable XML (which is necessary for saving your test samples and test scripts), add the xerces.jar (Xerces) or jaxp.jar & parser.jar (JAXP) to your classpath or $JAVA_HOME/jre/lib/ext directory.

  Currrently, jmeter.properties is set to use the parser in xerces by default. To change to Sun's parser, be sure to change the line in jmeter.properties that instructs JMeter which SAX parser to use. This line looks like this:

  xml.parser=org.apache.xerces.parsers.SAXParser

• XML: xercesはApacheから、 JAXPはsunから入手できます。 他のSAX 1.0準拠のXMLパーサーでもかまいません。
  (テストサンプルやテストスクリプトを保存するのに必要な) XMLを有効にするには、 クラスパスか$JAVA_HOME/jre/lib/extディレクトリにxerces.jar (Xerces)かjaxp.jar & parser.jar (JAXP) を追加します。

  現在、jmeter.propertiesはデフォルトでxercesに含まれているパーサーを使うように設定されています。 Sunのパーサーに変更する場合は、jmeter.propertiesに含まれる、 JMeterにどのSAXパーサーを使うのか教える行を変更します。 この行は以下のようになります:

  xml.parser=org.apache.xerces.parsers.SAXParser

• Mail: Java Mail^tm API as well as the javax.activation API from Sun.
  To enable the MailVisualizer, add mail.jar and activation.jar from Sun's JavaMail download to your classpath or $JAVA_HOME/jre/lib/ext directory.

• Mail: Java Mail^tm APIとjavax.activation APIは、 Sunから入手できます。
  MailVisualizerを有効にするには、SunのJavaMailダウンロードページから入手したmail.jarとactivation.jarを、 クラスパスか$JAVA_HOME/jre/lib/extに追加します。

• JSSE: JSSE is available from sun.
  JSSE is an SSL encryption provider that is used to enable JMeter to test websites using the https protocol.

  To turn SSL support on, make sure all the jars that come with JSSE are in your classpath (jsse.jar, jnet.jar, jcert.jar), and modify jmeter.properties to instruct JMeter which SSL Provider you are using. For JSSE, set the line as follows:

  ssl.provider=com.sun.net.ssl.internal.ssl.Provider

• JSSE: JSSEはsun から入手可能です。
  JSSEはSSLによる暗号化を提供します。これにより、JMeterはhttpsプロトコルを使ったウェブサイトのテストができます。

  SSLサポートを有効にするには、JSSEに付属するjarファイル(jsse.jar, jnet.jar, jcert.jar)が、 すべてクラスパスに含まれていることを確認し、どのSSLプロバイダーを使用するのかを指定するため、 jmeter.propertiesを変更します。 JSSEを使うには、以下のように一行書き込みます:

  ssl.provider=com.sun.net.ssl.internal.ssl.Provider

From the command line

コマンドラインから

If you don't like script you can use the command line as follows

スクリプトが好きでなければ、以下のようにコマンドラインを使用することもできます

UNIX: <java interpreterer> <options> -classpath $CLASSPATH:ApacheJMeter.jar org.apache.jmeter.Driver [properties file]
Windows: <java interpreter> <options> -classapth %classpath%;ApacheJMeter.jar org.apache.jmeter.Driver [properties file]

UNIX: <java インタープリター> <オプション> -classpath $CLASSPATH:ApacheJMeter.jar org.apache.jmeter.Driver [プロパティファイル]
Windows: <java インタープリター> <オプション> -classapth %classpath%;ApacheJMeter.jar org.apache.jmeter.Driver [プロパティファイル]

where options are usually not needed.

オプションは普通必要ありません。

In case you use the Java 2 platform you can type

Java 2プラットフォームを使用している場合、次のようにタイプします

java -jar ApacheJMeter.jar

or double click on the file.

または、ファイルをダブルクリックします.

Modifying Properties

プロパティを変更する

If you wish to modify the properties with which JMeter runs you need to either modify the jmeter.properties inside of the /bin directory or create your own copy of the jmeter.properties and specify it in the command line (above).

JMeterを実行するときに使用するプロパティを変更したい場合、 /binディレクトリの中にあるjmeter.propertiesを変更するか、 jmeter.propertiesのコピーを作成して、（上記）コマンドラインで指定します。

Properties to modify 変更するプロパティ

• timer.* These properties define the implementations of the org.apache.jmeter.timers.Timer interface that you wish to be available to JMeter.
• timer.* このプロパティでは、JMeterで使いたいと思っている org.apache.jmeter.timers.Timerインターフェイスの実装クラスを定義します。
• visualizer.* These properties define the implementations of the org.apache.jmeter.visualizers.Visualizer interface that you wish to be available to JMeter.
• visualizer.* このプロパティでは、JMeterで使いたいと思っている org.apache.jmeter.visualizers.Visualizerインターフェイスの実装クラスを定義します。
• controller.* These properties define the implementations of the org.apache.jmeter.samplers.SamplerController interface that you wish to be available to JMeter.
• controller.* このプロパティでは、JMeterで使いたいと思っている org.apache.jmeter.samplers.SamplerControllerインターフェイスの実装クラスを定義します。
• xml.parser The class name of the XML Parser implementing the org.xml.sax.Parser interface.
• xml.parser org.xml.sax.Parserインターフェイスを実装している、 XMLパーサーのクラス名です。
• xml.handler.* The class names of the implementations of org.xml.sax.DocumentHandler interface that JMeter should be able to user
• xml.handler.* JMeterが使うorg.xml.sax.DocumentHandler インターフェイスを実装しているクラス名です。
• user.dir The directory JMeter should default to on startup as the working directory
• user.dir JMeterが起動時に作業ディレクトリとして設定するディレクトリです。
• threads.max The maximum number of threads that can be selected for a single threadgroup
• threads.max ひとつのスレッドグループで選択されるスレッドの最大数です。

Copyright (c) 1998-99 The Java Apache Project.
$Id: running.html,v 1.1.1.1 2003/04/14 11:47:38 ami Exp $
All rights reserved.