インストール手順（Linux） | Oracle/MySQL向け負荷テスト・性能測定ツール

JREのインストール・環境変数の
設定
TGのインストール先ディレクトリの決定
JREへのシンボリックリンクの作成
TG起動シェルスクリプト
"tg.sh"の編集
TGの起動チェック
JDBCドライバのロードテスト
TGCの起動テスト

ここではLinux環境へのTGのインストール方法を紹介します。

JRE付きのTGパッケージを使用している場合は、『2. TGのインストール先ディレクトリの決定』以降の手順を実行して下さい。

1. JREのインストール・環境変数の設定

ここでは例としてOracle社（旧Sun Microsystem's 社）からダウンロードしたパッケージ「jre-1_5_0_18-linux-i586.bin」を「/home/oracle/tg」ディレクトリにインストールするものとします。まずは該当パッケージ・ファイルに実行権限が付与されていることを確認してください。もし、付与されていない場合は「chmod」コマンドを使用して実行権限を付与してから、該当ファイルを実行してください。


[oracle@dbsrv1 tg]$ pwd
/home/oracle/tg
[oracle@dbsrv1 tg]$ ls -l
total 16820
-rw-r--r-- 1 oracle oinstall 17198684 Nov 28 22:00 jre-1_5_0_18-linux-i586.bin
[oracle@dbsrv1 tg]$ chmod 755 jre-1_5_0_18-linux-i586.bin
[oracle@dbsrv1 tg]$ ls -l
total 16820
-rwxr-xr-x 1 oracle oinstall 17198684 Nov 28 22:00 jre-1_5_0_18-linux-i586.bin
[oracle@dbsrv1 tg]$ ./jre-1_5_0_18-linux-i586.bin
Sun Microsystems, Inc. Binary Code License Agreement

for the JAVA 2 PLATFORM STANDARD EDITION RUNTIME ENVIRONMENT
5.0

SUN MICROSYSTEMS, INC. ("SUN") IS WILLING TO LICENSE THE
SOFTWARE IDENTIFIED BELOW TO YOU ONLY UPON THE CONDITION
THAT YOU ACCEPT ALL OF THE TERMS CONTAINED IN THIS BINARY
CODE LICENSE AGREEMENT AND SUPPLEMENTAL LICENSE TERMS
(COLLECTIVELY "AGREEMENT"). PLEASE READ THE AGREEMENT

                        ( * * * * 中略 * * * * ) 

For inquiries please contact: Sun Microsystems, Inc., 4150 Network Circle,
Santa Clara, California 95054, U.S.A.
(LFI#130039/Form ID#011801)

Do you agree to the above license terms? [yes or no]
yes <-- YESと入力
Unpacking...
Checksumming...

                        ( * * * * 中略 * * * * ) 

Creating jre1.5.0_18/lib/plugin.jar
Creating jre1.5.0_18/lib/javaws.jar
Creating jre1.5.0_18/lib/deploy.jar

Done.

[oracle@dbsrv1 tg]$ ls
jre1.5.0_18 jre-1_5_0_18-linux-i586.bin
[oracle@dbsrv1 tg]$

続いて「java」コマンドを実行し、コマンドが正常に実行可能か確認して下さい。


[oracle@dbsrv1 tg]$ cd jre1.5.0_18/bin
[oracle@dbsrv1 bin]$ ./java -version
java version "1.5.0_18"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_18-b02)
Java HotSpot(TM) Client VM (build 1.5.0_18-b02, mixed mode, sharing)
[oracle@dbsrv1 bin]$

2. TGのインストール先ディレクトリの決定

適当なディレクトリにTGのZIPファイル（J2RE付属パッケージの場合は"tar.gz"ファイル）を解凍します。ここでは例として「/home/oracle/tg」を使用したとします。


[oracle@dbsrv1 tg]$ pwd
/home/oracle/tg
[oracle@dbsrv1 tg]$ unzip tg09X.zip
　Archive: tg09X.zip
　inflating: tg09X/clean.bat
　creating: tg09X/conf/

                        ( * * * * 中略 * * * * ) 

　inflating: tg09X/tgc.init
　extracting: tg09X/tgc.jar
[oracle@dbsrv1 tg]$ cd tg09X
[oracle@dbsrv1 tg09X]$

ディレクトリ「/home/oracle/tg/tg09X」には以下のようなファイルが配置されます。

tgc.bat	Windows環境でのTGC起動用バッチファイル
tgc.sh	UNIX環境でのTGC起動用シェルスクリプト
tgc.jar	TGC本体
tg.sh	UNIX環境でのTG起動用シェルスクリプト
tg.conf	TGパラメータファイル
tg.jar	TG本体
jobs	JOBとして実行されるスクリプトが格納されるディレクトリ
lib	JDBCドライバ等Java関連ライブラリが格納されるディレクトリ
conf	TGに登録されたコンフィグレーションファイル（tg.conf）が格納されるディレクトリ（tg.conf.<config-name>）
j2re	TG同梱のJava実行環境ディレクトリへのシンボリックリンク(※)

本ディレクトリはJREが予め付属しているパッケージを使用したときのみ存在します。

3. JREへのシンボリックリンクの作成

本手順はJREがあらかじめ付属しているパッケージ「TG Package with J2RE」を使用した場合、実行する必要はありません。次の手順「4. TG起動シェルスクリプト"tg.sh"の編集」に進んでください。

「/home/oracle/tg/j2re1.5.0_18」のディレクトリに対して、「/home/oracle/tg/tg09X/j2re」の名前でシンボリックリンクを作成します。作成後、該当シンボリックリンク経由で「java」コマンドへアクセス可能であることを確認して下さい。


[oracle@dbsrv1 tg09X]$ pwd
/home/oracle/tg/tg09X
[oracle@dbsrv1 tg09X]$ ln -s ../jre1.5.0_18 j2re
[oracle@dbsrv1 tg09X]$ ./j2re/bin/java -version
java version "1.5.0_18"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_18-b02)
Java HotSpot(TM) Client VM (build 1.5.0_18-b02, mixed mode, sharing)
[oracle@dbsrv1 tg09X]$

4. TG起動シェルスクリプト"tg.sh"の編集

TG起動用シェルスクリプトである「tg.sh」を編集し、JDBCドライバファイルへの環境変数「CLASSPATH」を設定して下さい。

必要に応じて、その他の環境変数「LD_LIBRARY_PATH」や「TNS_ADMIN」を設定してください。


#! /bin/sh
# -- TG - Transaction Generator - [ Version 0.X ] initialization script v.X --

OPTION1=$1
OPTION2=$2
OPTION3=$3

PATH=./j2re/bin:${PATH}
export PATH

# MySQL JDBC DRIVER :
CLASSPATH=./lib/mysql-connector-java-5.1.6-bin.jar:${CLASSPATH}

# PostgreSQL JDBC DRIVER :
CLASSPATH=./lib/postgresql-8.2-508.jdbc3.jar:${CLASSPATH}

# ORACLE JDBC DRIVER :
CLASSPATH=${ORACLE_HOME}/jdbc/lib/ojdbc5.jar:${CLASSPATH}

# General setting :
CLASSPATH=./tg.jar:.:${CLASSPATH}
export CLASSPATH

java -Xmx512m tg ${OPTION1} ${OPTION2} ${OPTION3}

exit

編集後、「tg.sh」へ実行権限を付与します。


[oracle@dbsrv1 tg09X]$ chmod 755 tg.sh

5. TGの起動チェック

TG起動用シェルスクリプト「tg.sh」を実行してください。JREおよびCLASSPATHの設定が正常に行われていれば、以下のような起動メッセージが表示されます。


[oracle@dbsrv1 tg09X]$ ./tg.sh
Transaction Generator 0.9X Wed Jun 13 23:49:11 JST 2007

Loading configuration file... Failed.
ERROR : Configuration file does not exist. : /home/oracle/tg/tg090/tg.conf

type "HELP" or "h" to print help messages.

TG>

上記の出力例はTGのコンフィグレーションファイル「tg.conf」が未作成の状況を想定しているため、"Loading configuration file... Failed."のメッセージが出力されています。「tg.conf」の記載要領については「Command-line mode」および「Parameter reference」のページを参照してください。

6. JDBCドライバのロードテスト

TGのコマンドプロンプトより「check driver oracle」と入力し、リターンキーを押下してください。JDBCドライバの読み込みが正常に行われれば、以下のようなメッセージが出力されます。


TG> check driver oracle
Loading JDBC driver "oracle.jdbc.driver.OracleDriver" ... OK.

TG>

もし、ロードがうまくいかないような場合は、『3. TG起動シェルスクリプト"tg.sh"の編集』を参照し、TG起動シェルスクリプト（tg.sh）の環境変数「CLASSPATH」を適宜修正して下さい。

7. TGCの起動テスト

GUIを利用することが可能な場合は、TGの管理ツールであるTGC - TG Controller - より、TGの操作を行うことができます。TGCの利用にあたっては、まずSWTのライブラリをLinux用のものに置き換え、切り替えます。

本手順はJREがあらかじめ付属しているパッケージを使用した場合、実行する必要はありません。


[oracle@dbsrv1 tg09X]$ cd lib
[oracle@dbsrv1 lib]$ rm swt.jar
[oracle@dbsrv1 lib]$ ln -s swt.jar.linux swt.jar

続いて、TGCの起動シェルスクリプトである「tgc.sh」を実行してください。


[oracle@dbsrv1 tg09X]$ chmod 755 tgc.sh
[oracle@dbsrv1 tg09X]$ ./tgc.sh

もし以下の出力がされた場合、XのアクセスコントロールによりTGCの起動が失敗しています。コマンド「xhost +」をrootユーザにて実行し、再度「tgc.sh」を実行してください。


Xlib: connection to ":0.0" refused by server
Xlib: No protocol specified
Exception in thread "main" org.eclipse.swt.SWTError: No more handles
[gtk_init_check() failed]
    at org.eclipse.swt.SWT.error(Unknown Source)
    at org.eclipse.swt.widgets.Display.createDisplay(Unknown Source)
    at org.eclipse.swt.widgets.Display.create(Unknown Source)
    at org.eclipse.swt.graphics.Device.<init>(Unknown Source)
    at org.eclipse.swt.widgets.Display.<init>(Unknown Source)
    at org.eclipse.swt.widgets.Display.<init>(Unknown Source)
    at tgc.<init>(tgc.java:585)
    at tgc.main(tgc.java:581)


[oracle@dbsrv1 tg09X]$ su -
Password:
[root@dbsrv1 ~]# xhost +
access control disabled, clients can connect from any host
[root@dbsrv1 ~]# exit
[oracle@dbsrv1 tg09X]$

以上で、Linux環境へのTGのインストールは完了です。