コマンド行アダプターを使用すると、コマンド行実行のためにターゲット・テスト・マシンを使用できます。コマンド行スクリプトを実行するには、ターゲット・テスト・マシン上にアダプターを登録する必要があります。
始める前に
- コマンド行アダプターを実行することを計画しているプラットフォームが、必ず Java バージョン 1.5 以降 をサポートしているようにしてください。
- java.exe 実行可能ファイルがターゲット・テスト・マシン上のパス内でアクセス可能である必要があります。
- アダプターを開始するには、以下の情報が必要です。
- Jazz リポジトリー URL (通常は、 https://qmserver:port/qm)
- アダプターとしてログオンするための適切なライセンスを持つユーザー ID
- このユーザーのパスワード
- プロジェクト・エリアの名前 (ただし、デフォルトの Quality Management プロジェクト・エリアではない場合)
- 「品質管理」アプリケーションをサーバー上で実行している必要があります。
重要: 1 つのターゲット・テスト・マシン上で複数のアダプターを実行することができますが、各アダプターは、-adapterName オプションで指定されている固有の名前を持つ別々のプロセスである必要があります。
このタスクについて
コマンド行アダプターは、ターゲット・テスト・マシン上でセットアップされ、開始される必要があります。
手順
ターゲット・テスト・マシン上で以下のステップを実行します。
- インストール・マシンから install-location¥JazzTeamServer¥server¥conf¥qm¥adapters¥RQMCommmandLineAdapter.zip ファイルを取得します。 サーバーに対する読み取り権限を持つサーバー管理者にこの圧縮ファイルを取得してもらうことが必要になる可能性もあります。
- RQMCommmandLineAdapter.zip ファイルを解凍して、ターゲット・テスト・マシン上のフォルダーに入れます。
- オプション: 実際のスクリプト結果をカスタマイズします。これらの結果は、テスト・ケース実行記録またはテスト・スイート実行記録で示されるものです。詳しくは
、コマンド行アダプターのカスタマイズを参照してください。
- バージョン 5.0 以降を使用していて、コマンド行アダプターが複数の要求に並列処理で対応できるようにする必要がある場合、デフォルトでは使用不可になっているその機能を使用可能にすることができます。 その機能を使用可能にするにはプロパティーを追加します。プロパティーを追加しない場合、あるいはプロパティーを無効な値に設定した場合には、複数のテストがアダプターに送信されると、
受け取られた順番で実行するように、キューに格納されます。
ヒント: コマンド行アダプターを使用してテストを並列実行するのは、長期的なテストにとって最適です。アダプターは、各テストを実行するためのキャパシティーに基づいて、テストを 1 つずつ選択します。それはスクリプトを選択し、その実行を開始すると、次に別のスクリプトを選択して実行します。スクリプトが短い場合には、順次に実行しているように思われることがあります。
並列テスト実行をコマンド行アダプターで可能にするには、以下のようにします。- テスト・ターゲット・マシンで、CommandLine.properties ファイル、またはこれに相当する設定ファイルを開きます。
- 次のプロパティーをファイルに追加します。com.ibm.rqm.commandline.maxservedrequests=N
この中の N は、同時に実行するテストの最大数です。
- コマンド行アダプターがアクティブになっている場合は、再始動します。
指定した最大値に達すると、アダプターに送信されるテストは、スペースが使用可能になったときに実行するためにキューに格納されます。
- コマンド行アダプターを開始します。
タスクの結果
システムは次のようなメッセージを生成します。
Launching Adapter…
Configuration file adapterConfig.ini does not exist, adapter will use the arguments passed
Successfully created an HTTP client
The adapter is now connected
Created Commandline Adapter
次のタスク
をクリックして、テスター・マシン上の「品質管理」アプリケーションでのアダプターの状態を検証できます。 実行中のコマンド行アダプターに対してテストを実行しようとする場合は、その前に状況が緑色であることを確認してください。