コマンド行アダプターを使用すると、1 つのマシンをコマンド行実行のターゲット・テスト・マシンとして使用できます。 コマンド行スクリプトを実行するには、ターゲット・テスト・マシン上にアダプターを登録する必要があります。
始める前に
コマンド行アダプターは、
Java バージョン 1.5 以降 をサポートする任意のプラットフォームで実行できます。
実行可能ファイル
java.exe がターゲット・テスト・マシン上のパス内でアクセス可能である必要があります。また、アダプターを開始するには、以下の情報が分かっていなければなりません。
- Jazz リポジトリー URL (通常、 https://qmserver:port/qm)
- アダプターとしてログインするために適切なライセンスを持つユーザー ID
- このユーザーのパスワード
- プロジェクト・エリアの名前 (デフォルトの Quality Manager プロジェクト・エリアでない場合)
最後に、「品質管理」アプリケーションがサーバー上で実行している必要があります。
注: 1 つのターゲット・テスト・マシン上で複数のアダプターを実行することもできますが、各アダプターは、-adapterName オプションで固有の名前が指定された別々のプロセスでなければなりません。
このタスクについて
コマンド行アダプターは、ターゲット・テスト・マシン上でセットアップされ、開始される必要があります。
ターゲット・テスト・マシン上で次のタスクを実行してください。
手順
- インストール・マシンから install-location¥JazzTeamServer¥server¥conf¥qm¥adapters¥RQMCommmandLineAdapter.zip ファイルを取得します。
注: 場合によっては、サーバーへの読み取り権限を持つサーバー管理者にこの圧縮ファイルを取得してもらう必要があります。
- RQMCommmandLineAdapter.zip ファイルを解凍して、ターゲット・テスト・マシン上のフォルダーに入れます。
- オプション: コマンド行アダプターのカスタマイズの説明に従って、実際のスクリプト結果 (テスト・ケース実行記録またはテスト・スイート実行記録に含まれます) をカスタマイズします。
- コマンド行アダプターを開始します。
コマンド行アダプターを初めて開始するには、次のようにします。
次のように、コマンド行引数を指定してバッチ・ファイルを実行します。
C:¥ start.bat -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
コマンド行アダプターのカスタマイズ
次のように、コマンド行引数を指定してシェル・スクリプトを実行します。
$ start.sh -repository https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
[-projectArea project area] [-sleepTime sleep
time] [-configFile configuration file]
各変数の意味は次のとおりです。
- qmserver: 「品質管理」サーバーのホスト名または IP アドレス
- port: 「品質管理」サーバーが稼働しているポート
- userid: アダプターを実行するライセンスを持っている、「品質管理」用の登録済みユーザー ID
- password: 処理依頼されたユーザー ID のパスワード
- adapter-name: ユーザーが割り当てたアダプター名
- project area: ログインするプロジェクトの名前
- sleep time: タスクをポーリングするポーリング間隔。 デフォルト設定は 5 秒です。
- configuration file: このアダプター用の設定値を保管および読み取るためのファイル。 デフォルトのファイル名は config.ini です。
アダプターは、登録情報を収容するための構成ファイル (
config.ini ファイル、または
-configFile オプションで指定されるファイル) を生成します。 アダプターが再始動されるときには、この情報が再使用されます。
config.ini ファイルからコマンド行アダプターを再始動するには、次のようにします。
: 以下のように引数を指定せずにバッチ・ファイルを実行します。
C:¥ start.bat
: 以下のようにコマンド行引数を指定せずにシェル・スクリプトを実行します。
$ start.sh
注: アダプターが開始されたディレクトリーに構成ファイルが入っているという想定です。
タスクの結果
システムは次のようなメッセージを生成します。
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
次のタスク
をクリックして、テスター・マシン上の「品質管理」アプリケーションでのアダプターの状態を検証できます。 実行中のコマンド行アダプターに対してテストを実行する場合は、その前に状況が緑であることを確認するようにしてください。