設定和啟動指令行配接器

透過指令行配接器,您可以將機器當成執行指令行時的目標測試機器。您必須將配接器登錄在目標測試機器上,以執行指令行 Script。

開始之前

指令行配接器會在至少支援 Java 1.5 版或更新版本的任何平台上執行。必須能夠在目標測試機器上的路徑中存取執行檔 java.exe。您也必須知道下列資訊,才能啟動配接器: 最後,「品質管理」應用程式必須正在伺服器上執行。
註: 您可以在目標測試機器上執行多個配接器,但是每一個配接器必須是個別的程序,並使用 -adapterName 選項中指定的唯一名稱。

關於這項作業

必須在目標測試機器上設定及啟動指令行配接器。
指令行執行的設定
在目標測試機器上完成這項作業。

程序

  1. 從安裝機器取得 install-location\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip 檔。
    註: 具有伺服器讀取權的伺服器管理者,可能需要為您取得壓縮檔。
  2. 將 RQMCommmandLineAdapter.zip 檔解壓縮到目標測試機器上的資料夾。
  3. 選擇性的: 按照自訂指令行配接器的說明,來自訂實際 Script 結果(出現在測試案例執行記錄或測試套組執行記錄中)。
  4. 啟動指令行配接器。

    如果是第一次啟動指令行配接器:

    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 用戶端
現在已連接配接器已建立指令行配接器

下一步

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


有問題或疑問嗎?請至 Jazz.net 討論區發表。