XML ファイルのテスト変数を初期化するために、コマンド行インターフェースから varfile オプションを使用してテストを実行できます。
始める前に
- IBM® Rational® Performance Tester を使用して変数を宣言します。
コマンド行からスケジュールまたはテストを実行しようとする前に、サポートされている Java 実行可能ファイル (
java.exe) がパスに含まれていることを確認してください。サポートされている Java 実行可能ファイルはこの製品とともに提供されます。
- UNIX オペレーティング・システムでは、実行可能ファイルはデフォルトでは /opt/IBM/SDP/jdk/bin/ ディレクトリーにインストールされます。
- Windows オペレーティング・システムでは、実行可能ファイルはデフォルトでは C:¥Program Files¥IBM¥SDP¥jdk¥bin¥ ディレクトリーにインストールされます。
- Linux では、コマンド行から実行する場合でも、X サーバーが使用可能である必要があります。 詳しくは、「Running tests from the command line on Linux」を参照してください。
- 値を持つ変数を含む XML ファイルを作成します。XML ファイルは、次の画像のような構造になります。
手順
- コマンド行からスケジュールまたはテストを実行するには、cmdline.bat ファイルと cmdline.sh ファイルがあるディレクトリーに移動します。Windows オペレーティング・システムでは、このディレクトリーは通常、C:¥Program Files¥IBM¥IBMIMShared¥plugins¥com.ibm.rational.test.lt.cmdlineexecuteversion_date です。
- 次のコマンドを実行します。
cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_path -suite suite_rel_path -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite
{true | false} -quiet -users nn -vmargs JVM_args -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list -usercomments "any
user comment"
値にスペースが含まれる場合は、値を引用符で囲んでください。このコマンドのオンライン・ヘルプを表示するには、この .bat ファイルが存在するディレクトリーから cmdline -help と入力します。
次の表に、各オプションの説明を示します。
オプション |
説明 |
-workspace |
必須。 Eclipse ワークスペースへの完全なパス。 |
-project |
必須。 プロジェクトのファイル名を含むパス (ワークスペースが基準)。 |
-eclipsehome |
必須。 eclipse.exe が含まれているディレクトリーの絶対パス。 |
-plugins |
必須。 プラグインが存在するフォルダーの絶対パス。 Windows オペレーティング・システムでは通常、このフォルダーの場所は C:¥Program Files¥IBM¥IBMIMShared¥plugins です。 |
-schedule |
オプションですが、-schedule オプション、-suite オプション、または -servicename オプションのいずれかを指定する必要があります。 実行するスケジュールのファイル名を含むパス (プロジェクトが基準)。 |
-suite |
オプションですが、-schedule オプション、-suite オプション、または -servicename オプションのいずれかを指定する必要があります。 実行するテストのファイル名を含むパス (プロジェクトが基準)。 |
-varfile |
オプション。 変数の名前と値のペアが含まれている XML ファイルの絶対パス。 |
-servicename |
オプションですが、-schedule オプション、-suite オプション、または -servicename オプションのいずれかを指定する必要があります。 実行するサービスの名前。 スケジュールまたはパフォーマンス・テストを実行する代わりに、指定されたサービスが使用可能になると、そのサービスが実行されます。 |
-serviceargs |
オプション。 -servicename オプションによって指定されたサービスに渡す一連の引数。 例えば、-serviceargs "-myserviceparm1 myserviceparm1value" のように指定します。 値はスペースを含むため引用符で囲みます。 |
-configfile |
オプション。 スケジュールまたはテスト実行用のパラメーターが含まれているファイルの絶対パス。 各パラメーターは 1 行で指定しなければなりません。
構成ファイルを作成するには、行を折り返さないエディターを使用してください。
必須であれオプションであれ、どのパラメーターも構成ファイルで設定できます。 コマンド行パラメーターは、このファイルの値をオーバーライドします。 注: このファイルでは引用符を使用しないでください。スペースを含む値であっても同様です。
|
-results |
オプション。 結果ファイルの名前。 デフォルトの結果ファイルは、スケジュールまたはテストの名前にタイム・スタンプを追加したものです。 |
-overwrite |
オプション。 同じ名前の結果ファイルを上書きするかどうかを決定します。 デフォルト値は true で、これは結果ファイルが上書きされることを意味します。 |
-quiet |
オプション。 ランチャーからのすべてのメッセージ出力をオフにし、実行または試行が完了するとコマンド・シェルに戻ります。 |
-users |
オプション。 実行でのデフォルトの仮想ユーザー数をオーバーライドします。 スケジュールの場合、デフォルトは、スケジュール・エディターで指定されたユーザーの数です。 テストの場合、デフォルトは 1 人の仮想ユーザーです。 このオプションでは、指定した数のユーザーを含むスケジュールの新しいコピーが作成されます。 |
-vmargs |
オプション。 渡される Java 仮想マシンの引数。
例えば、-vmargs "-debug -Xmx512m" のように指定します。 値はスペースを含むため引用符で囲みます。 |
-exportlog |
オプション。 エクスポートされた HTTP テスト・ログを格納するファイルの絶対パス。 |
-exportstats |
オプション。 エクスポートされた統計レポート・データを格納するディレクトリーの絶対パス。 統計レポート・データは、コンマ区切り値 (CSV) 形式で保管され、レポート名から派生したファイル名が付けられます。
-exportstatreportlist オプションが指定されない場合は、「パフォーマンス・テスト・レポート」設定の「レポートのエクスポート」ページで指定されたレポートがエクスポートされます。 |
-exportstatreportlist |
オプション。 -exportstats オプションを使用して統計レポート・データをエクスポートするときに使用する、カスタム・レポート形式ファイル (.view ファイル) の絶対パスのコンマ区切りのリスト。 このパラメーターは、ワークスペース設定をオーバーライドします。 例えば、-exportstatreportlist
c:/customreport.view,c:/customreport2.view と入力します。 |
-usercomments |
オプション。 二重引用符で囲んだテキストを追加すると、レポートの「ユーザー・コメント」行に表示されます。 |
注: - -quiet オプションを指定しない場合、テストまたはスケジュールの起動時および完了時に、そのことを示すメッセージが表示されます。
- コマンドを発行すると、ワークスペースがロックされます。 実行中にスケジュールまたはテストの進行状況を確認するには、別のワークスペースを呼び出し、そのワークスペースを介してプロジェクトを開きます。
例
cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:¥Program Files¥IBM¥SDP¥eclipse.exe -schedule MySchedule -varfile C:/Assets/testProjVar.xml