設定和啟動指令行配接器

透過指令行配接器,您可以使用目標測試機器來執行指令行。您必須將配接器登錄在目標測試機器上,以執行指令行 Script。

開始之前

重要: 您可以在目標測試機器上執行多個配接器, 但是每一個配接器必須是個別的程序,並使用 -adapterName 選項中指定的唯一名稱。

關於這項作業

必須在目標測試機器上設定及啟動指令行配接器。
指令行執行的設定

程序

在目標測試機器上完成下列步驟:

  1. 從安裝機器取得 install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip 檔。 具有伺服器讀取權的伺服器管理者可能需要為您取得壓縮檔。
  2. 將 RQMCommmandLineAdapter.zip 檔解壓縮到目標測試機器上的資料夾。
  3. 選擇性的: 自訂實際的 Script 結果, 這些結果顯示在測試案例執行記錄或測試套組執行記錄中。如需相關資訊,請參閱 自訂指令行配接器。
  4. 如果您使用 5.0 版或更新版本,並且希望指令行配接器平行處理多項要求, 您可以啟用該項特性,依預設,該項特性是停用的。 新增內容來啟用特性。如果您沒有新增內容,或者您設為無效值, 當有多項測試傳送至配接器時,會依照其接收順序來排入執行佇列中。
    提示: 對於長時間執行的測試, 使用指令行配接器來平行執行測試是最好的作法。配接器會根據其容量,逐一選取測試來執行每一項測試。它會選取 Script,開始執行 Script, 然後選取另一個 Script 來執行。如果 Script 很簡短,可能看起來就像是依序執行。
    如果要對指令行配接器啟用平行執行測試,請執行下列動作:
    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 圖示
      按如下所示,執行 Shell Script 並使用指令行引數:
       $ 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 圖示
      :執行 Shell Script,並且不使用指令行引數:
      $ start.sh
      註: 會預期配置檔位於從中啟動配接器的目錄中。

結果

系統會產生類似如下的訊息:
正在啟動配接器…
adapterConfig.ini 配置檔不存在,配接器將使用所傳遞的引數
已順利建立 HTTP 用戶端
現在已連接配接器已建立指令行配接器

下一步

您可以按一下執行 > 配接器主控台,以便在測試人員機器上的「品質管理」應用程式中,驗證配接器的狀況。在您嘗試對正在執行的指令行配接器執行測試之前, 請確定狀態是綠色。

視訊圖示 觀看視訊

CLM 播放清單
Jazz.net 頻道
User Education 頻道

學習圖示 進一步瞭解

CLM 學習週期
敏捷技能學習週期
學習週期

詢問圖示 詢問問題

Jazz.net 討論區
developerWorks 討論區

支援圖示 取得支援

支援中心入口網站
Deployment Wiki
「支援中心」部落格