コマンド行アダプターのセットアップと開始

コマンド行アダプターを使用すると、コマンド行実行のためにターゲット・テスト・マシンを使用できます。コマンド行スクリプトを実行するには、ターゲット・テスト・マシン上にアダプターを登録する必要があります。

始める前に

重要: 1 つのターゲット・テスト・マシン上で複数のアダプターを実行することができますが、各アダプターは、-adapterName オプションで指定されている固有の名前を持つ別々のプロセスである必要があります。

このタスクについて

コマンド行アダプターは、ターゲット・テスト・マシン上でセットアップされ、開始される必要があります。
コマンド行実行のセットアップ

手順

ターゲット・テスト・マシン上で以下のステップを実行します。

  1. インストール・マシンから install-location¥JazzTeamServer¥server¥conf¥qm¥adapters¥RQMCommmandLineAdapter.zip ファイルを取得します。 サーバーに対する読み取り権限を持つサーバー管理者にこの圧縮ファイルを取得してもらうことが必要になる可能性もあります。
  2. RQMCommmandLineAdapter.zip ファイルを解凍して、ターゲット・テスト・マシン上のフォルダーに入れます。
  3. オプション: 実際のスクリプト結果をカスタマイズします。これらの結果は、テスト・ケース実行記録またはテスト・スイート実行記録で示されるものです。詳しくは 、コマンド行アダプターのカスタマイズを参照してください。
  4. バージョン 5.0 以降を使用していて、コマンド行アダプターが複数の要求に並列処理で対応できるようにする必要がある場合、デフォルトでは使用不可になっているその機能を使用可能にすることができます。 その機能を使用可能にするにはプロパティーを追加します。プロパティーを追加しない場合、あるいはプロパティーを無効な値に設定した場合には、複数のテストがアダプターに送信されると、 受け取られた順番で実行するように、キューに格納されます。
    ヒント: コマンド行アダプターを使用してテストを並列実行するのは、長期的なテストにとって最適です。アダプターは、各テストを実行するためのキャパシティーに基づいて、テストを 1 つずつ選択します。それはスクリプトを選択し、その実行を開始すると、次に別のスクリプトを選択して実行します。スクリプトが短い場合には、順次に実行しているように思われることがあります。
    並列テスト実行をコマンド行アダプターで可能にするには、以下のようにします。
    1. テスト・ターゲット・マシンで、CommandLine.properties ファイル、またはこれに相当する設定ファイルを開きます。
    2. 次のプロパティーをファイルに追加します。com.ibm.rqm.commandline.maxservedrequests=N

      この中の N は、同時に実行するテストの最大数です。

    3. コマンド行アダプターがアクティブになっている場合は、再始動します。
    指定した最大値に達すると、アダプターに送信されるテストは、スペースが使用可能になったときに実行するためにキューに格納されます。
  5. コマンド行アダプターを開始します。
    • コマンド行アダプターを初めて開始するには、次のようにします。
      Windows アイコン
      次のようにコマンド行引数を指定してバッチ・ファイルを実行します。
      C:¥ start.bat -repository  https://qmserver:port/qm -user userid -password password [-adapterName adapter-name]
      [-projectArea project area] [-sleepTime sleep
      time]	[-configFile configuration file]
      詳しくは 、コマンド行アダプターのカスタマイズを参照してください。
      Linux アイコン
      Unix アイコン
      次のようにコマンド行引数を指定してシェル・スクリプトを実行します。
       $ 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 ファイルからコマンド行アダプターを再始動するには、次のようにします。
      Windows アイコン
      : 以下のように引数を指定せずにバッチ・ファイルを実行します。
      C:¥ start.bat
      Linux アイコン
      Unix アイコン
      : 以下のようにコマンド行引数を指定せずにシェル・スクリプトを実行します。
      $ 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

次のタスク

「実行」 > 「アダプター・コンソール」をクリックして、テスター・マシン上の「品質管理」アプリケーションでのアダプターの状態を検証できます。 実行中のコマンド行アダプターに対してテストを実行しようとする場合は、その前に状況が緑色であることを確認してください。

ビデオ・アイコン ビデオを見る

CLM 再生リスト
Jazz.net チャンネル
User Education チャンネル

学習アイコン 詳細情報

CLM Learning Circle
Agile Learning Circle
Learning circles

質問アイコン 質問する

Jazz.net フォーラム
developerWorks フォーラム

サポート・アイコン サポートを受ける

サポート・ポータル
Deployment Wiki
サポートのブログ