如果要起始設定來自 XML 檔案的測試變數,您可以使用 varfile 選項,從指令行介面來執行測試。
開始之前
- 使用 IBM® Rational® Performance Tester 宣告變數。
在您嘗試從指令行執行排程或測試之前,請先驗證支援的 Java 執行檔 (
java.exe) 位在您的路徑中。支援的 Java 執行檔隨附在本產品中:
- 在 UNIX 作業系統中,該執行檔預設位於 /opt/IBM/SDP/jdk/bin/ 安裝目錄。
- 在 Windows 作業系統中,該執行檔預設位於 C:\Program
Files\IBM\SDP\jdk\bin\ 安裝目錄。
- 在 Linux 上,必須有可用的 X 伺服器,即使是從指令行執行也一樣。
如需相關資訊,請參閱從 Linux 的指令行執行測試。
- 建立包含變數及值的 XML 檔案。XML 檔案的結構類似下列影像檔
程序
- 如果要從指令行執行排程或測試,請移至包含 cmdline.bat 及 cmdline.sh 檔案的目錄。
在 Windows 作業系統上,此目錄通常是 C:\Program Files\IBM\IBMIMShared\plugins\com.ibm.rational.test.lt.cmdlineexecuteversion_date。
- 發出下列指令:
cmdline -workspace workspace_full_path -project proj_rel_path -eclipsehome eclipse_full_path -plugins plugin_full_path -schedule sched_rel_path -suite suite_rel_path -varfile variable_file_full_path -servicename service -serviceargs service_args -configfile file_full_path -results result_file -overwrite
{true | false} -quiet -users nn -vmargs JVM_args -exportlog log_full_path -exportstats stats_full_path -exportstatreportlist stats_list -usercomments "any
user comment"
如果值含有空格,請將值括在引號中。如果要查看此指令的線上說明,當您在包含 .bat 檔的目錄中時,請輸入 cmdline -help。
下表說明每一個選項:
選項 |
敘述 |
-workspace |
必要的。Eclipse 工作區的完整路徑。 |
-project |
必要的。相對於工作區的專案路徑,包括檔名。 |
-eclipsehome |
必要的。包含 eclipse.exe 的目錄完整路徑。 |
-plugins |
必要的。包含外掛程式的資料夾完整路徑。一般而言,在 Windows 作業系統上,此資料夾位置是 C:\Program Files\IBM\IBMIMShared\plugins。 |
-schedule |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
包括要執行之排程的檔名的路徑,相對於專案。 |
-suite |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
包括要執行之測試的檔名的路徑,相對於專案。 |
-varfile |
選用。包含變數名稱/值配對的 XML 檔完整路徑。 |
-servicename |
選用,但您必須指定 -schedule 選項、-suite 選項或 -servicename 選項。
要執行的服務名稱。不執行排程或效能測試,而是執行變成可用的指定服務。 |
-serviceargs |
選用。傳遞至 -servicename 選項所指定服務的一連串引數。例如,-serviceargs
"-myserviceparm1 myserviceparm1value"。值用引號括住,是因為它們包含空格。 |
-configfile |
選用。包含排程或測試執行之參數的檔案完整路徑。每一個參數必須各佔一行。
如果要建立配置檔,請使用不換行的編輯器。任何參數,不論是必要的或選用的,都可以設定在配置檔中。指令行參數會置換這個檔案中的值。 註: 請勿在此檔案中使用引號,即使是包含空格的值也一樣。
|
-results |
選用。結果檔的名稱。預設結果檔案是有附加時間戳記的排程或測試名稱。 |
-overwrite |
選用。決定是否改寫具有相同名稱的結果檔案。預設值 true 表示要改寫結果檔案。 |
-quiet |
選用。當執行或嘗試完成之後,會關閉來自啟動程式的任何訊息輸出,並回到指令 Shell。 |
-users |
選用。置換執行中的虛擬使用者的預設數目。
以排程而言,預設值是在排程編輯器中指定的使用者數目。以測試而言,預設值是一位使用者。
此選項建立一個包含所指定使用者數目之排程的新副本。 |
-vmargs |
選用。要傳入的 Java 虛擬機器引數。例如,-vmargs "-debug
-Xmx512m"。值用引號括住,是因為它們包含空格。 |
-exportlog |
選用。其中儲存所匯出之 HTTP 測試日誌的檔案完整路徑。 |
-exportstats |
選用。其中儲存所匯出之統計報告資料的目錄完整路徑。統計報告資料是以逗點區隔值 (CSV) 格式儲存,其檔名是衍生自報告名稱。如果未指定 -exportstatreportlist 選項,則會匯出在「效能測試報告」喜好設定的「匯出報告」頁面上指定的報告。 |
-exportstatreportlist |
選用。使用 -exportstats 選項匯出統計報告資料時,要使用的自訂報告格式檔案(.view 檔案)的絕對路徑清單(以逗點區隔)。此參數置換工作區喜好設定。例如,-exportstatreportlist
c:/customreport.view,c:/customreport2.view。 |
-usercomments |
選用。新增用雙引號括住的文字,以便將它顯示在報告的「使用者意見」列中。 |
註: - 除非您包括了 -quiet 選項,否則會顯示訊息,指出測試或排程何時啟動及何時完成。
- 發出指令會鎖定工作區。如果要在執行期間檢查測試或排程的進度,請呼叫另一個工作區,並透過該工作區開啟專案。
範例
cmdline -workspace C:/RPTWorkspace -project testProj -eclipsehome C:\Program
Files\IBM\SDP\eclipse.exe -schedule MySchedule -varfile
C:/Assets/testProjVar.xml