Spuštění testu nebo plánu z příkazového řádku

Test nebo plán můžete spustit z příkazového řádku mimo pracovní prostor Eclipse a automaticky exportovat výsledky.

Než začnete

Spuštění testu nebo plánu v systému Linux vyžaduje server X Windows, i když je test spuštěn z příkazového řádku. Další informace viz Spouštění testů z příkazového řádku v systému Linux.

Pokud sdílíte shell IBM® Rational Test Workbench Web UI Tester nebo IBM Rational Performance Tester s produktem IBM Rational Test Workbench Mobile Test Edition a spouštíte mobilní test, nastavte klienta mobilního testu do pasivního režimu a zavřete produkt.

Informace o této úloze

Chcete-li monitorovat test, můžete přistoupit k sestavám z webového prohlížeče. Viz Vzdálený přístup k sestavám
Poznámka: Příkazový řádek neumožňuje žádný způsob zadání hesla zabezpečeného úložiště pro monitorování prostředků. Heslo musíte zadat na pracovní ploše a před pokusem o provedení plánu z příkazového řádku se ujistit, že je uloženo a trvale uchováváno v plánu.

Postup

  1. Chcete-li spustit test nebo plán z příkazového řádku, přejděte do adresáře, který obsahuje soubory cmdline.bat a cmdline.sh. V operačních systémech Windows se zpravidla jedná o adresář adresář_instalace_produktu/cmdline, např. C:\Program Files\IBM\SDP\cmdline.
  2. Zadejte následující příkaz:

    cmdline -workspace úplná_cesta_k_pracovnímu_prostoru -project relativní_cesta_k_projektu -eclipsehome úplná_cesta_k_eclipse -plugins úplná_cesta_k_modulu_plug-in -schedule sched_rel_path -suite relativní_cesta_k_sadě -varfile úplná_cesta_k_souboru_proměnných -servicename služba -serviceargs argumenty_služby -configfile úplná_cesta_k_souboru -results výsledný_soubor -overwrite {true | false} -quiet -users nn -vmargs argumenty_JVM_ -exportlog úplná_cesta_k_protokolu -exportstats cesta_k_lokálnímu_adresáři -exportstatshtml cesta_k_lokálnímu_adresáři -compare "result_path1, result_path2"-exportstatreportlist seznam_statistik -usercomments "libovolný uživatelský komentář"

    Pokud hodnota obsahuje mezery, uzavřete ji do uvozovek. Chcete-li zobrazit nápovědu online pro tento příkaz v případě, že jste v adresáři obsahujícím soubor .bat, zadejte příkaz cmdline -help.

    Následující tabulka vysvětluje jednotlivé volby:

    Volba Popis
    -workspace Povinné. Úplná cesta k pracovnímu prostoru Eclipse.
    -project Povinné. Cesta k projektu včetně názvu souboru relativní vzhledem k pracovnímu prostoru.
    -eclipsehome Povinné. Úplná cesta k adresáři, který obsahuje soubor eclipse.exe.
    -plugins Povinné. Úplná cesta ke složce, která obsahuje moduly plug-in. V operačních systémech Windows je umístění této složky zpravidla C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Volitelné, ale musíte zadat volbu -schedule, volbu -suite, nebo volbu -servicename. Cesta k plánu, který se má spustit, včetně názvu souboru, relativní vzhledem k projektu.
    -suite Volitelné, ale musíte zadat volbu -schedule, volbu -suite, nebo volbu -servicename. Cesta k testu, který se má spustit, včetně názvu souboru, relativní vzhledem k projektu.
    -varfile Volitelné. Úplná cesta k souboru XML, který obsahuje dvojice názvu a hodnoty proměnné.
    -servicename Volitelné, ale musíte zadat volbu -schedule, volbu -suite, nebo volbu -servicename. Název služby, která se má spustit. Namísto spuštění testu výkonu se spustí určená služba, jakmile bude k dispozici.
    -serviceargs Volitelné. Posloupnost argumentů, které se mají předat službě určené volbou -servicename. Například -serviceargs "-myserviceparm1 myserviceparm1value". Hodnoty jsou uzavřeny v uvozovkách, protože obsahují mezery.
    -configfile Volitelné. Úplná cesta k souboru, který obsahuje parametry pro spuštění testu nebo plánu. Každý parametr musí být na samostatném řádku. K vytvoření konfiguračního souboru použijte editor, který nezalamuje řádky. V konfiguračním souboru lze zadat libovolné povinné nebo volitelné parametry. Parametry příkazového řádku potlačí hodnoty v tomto souboru.
    Poznámka: Soubor musí být ve formátu UTF-8. V tomto souboru nepoužívejte uvozovky, a to ani pro hodnoty, které obsahují mezery.
    -results Volitelné. Název souboru výsledků. Výchozí soubor výsledků je název testu nebo plánu s připojeným časovým razítkem. Pro ukládání výsledků testu uveďte název složky, která je relativní vzhledem k projektu. Např. -results folder/resultname.
    -overwrite Volitelné. Určuje, zda bude přepsán soubor výsledků se stejným názvem. Výchozí hodnota false znamená, že se vytvoří nový soubor výsledků. Je-li hodnota true, soubor se přepíše a uchová si stejný název souboru.
    -quiet Volitelné. Vypne veškerý výstup zpráv ze spouštěcího programu a při dokončení spuštění nebo pokusu se vrátí do příkazového shellu.
    -users Volitelné. Potlačí výchozí počet virtuálních uživatelů ve spuštění. V případě plánu je výchozí hodnota počet uživatelů zadaný v editoru plánů. V případě testu je výchozí hodnota jeden uživatel. Tato volba vytvoří novou kopii plánu, která obsahuje zadaný počet uživatelů.
    -vmargs Volitelné.

    K určení maximální velikosti haldy prostředí Java pro proces Java, který řídí přehrávání příkazového řádku, použijte volbu -vmargs s argumentem -Xmx. Například použitím argumentu -vmargs -Xmx4096m určíte maximální velikost haldy 4096 MB. Tento způsob je obdobou zadání parametru -Xmx4096m v souboru eclipse.ini pro pracovní plochu při přehrávání testu z uživatelského rozhraní.

    V případě spuštění v cloudu zadejte parametr -vmargs -Dcloudcostconfirm.

    -exportlog Volitelné. Úplná cesta k souboru, do kterého se má ukládat exportovaný protokol testu HTTP.
    -exportstats Volitelné. Úplná cesta k adresáři, do kterého se mají ukládat exportovaná data statistické sestavy. Data statistické sestavy se ukládají ve formátu hodnot oddělených čárkami (CSV) s názvem souboru odvozeným od názvu sestavy. Pokud není zadána volba -exportstatreportlist, exportují se sestavy zadané na stránce Exportovat sestavy předvoleb Zprávy o testu výkonu.

    K exportu dat ze specifického časového rozsahu z běhu použijte atribut -timerange spolu s volbou -exportstats. Hodnotou je časový rozsah uvedený v časovém plánu. Například "5 Users,10 Users". Časové rozsahy oddělte čárkami, a pokud časový rozsah obsahuje mezeru, použijte dvojité uvozovky.

    -exportstatshtml

    Volbu -exportstatshtml použijte pouze v případě, že chcete exportovat výsledky webové analýzy. Výsledky se vyexportují do určeného adresáře. Výsledky analyzujte ve webovém prohlížeči bez použití testovací pracovní plochy.

    -compare

    K exportu výsledku v režimu porovnání použijte atribut -compare spolu s volbou -exportstatshtml. Hodnotou mohou být cesty k běhům, relativní k pracovnímu prostoru. Cesty oddělte čárkami.

    -exportstatreportlist Volitelné. Čárkami oddělený seznam absolutních cest k souborům formátu vlastních sestav (soubory .view) pro použití při exportu dat statistické sestavy pomocí volby -exportstats. Tento parametr potlačí předvolby pracovního prostoru. Například -exportstatreportlist c:/customreport.view,c:/customreport2.view.
    -usercomments Volitelné. Přidejte text v uvozovkách, který se má zobrazit v řádku Komentář uživatele sestavy.
    Poznámka: Chcete-li v systému Windows přidat komentáře v nativním jazyku, který možná nepodporuje znaky Unicode, je ke spuštění příkazu doporučeno použití souboru CommandLine.exe.
    Poznámka:
    • Pokud nepřidáte volbu -quiet, zobrazují se zprávy označující spuštění a dokončení testu nebo plánu.
    • Zadání příkazu uzamkne pracovní prostor. Chcete-li zkontrolovat průběh testu nebo plánu během spuštění, vyvolejte jiný pracovní prostor a otevřete projekt prostřednictvím tohoto pracovního prostoru.

Příklad

Poznámka: Konfigurační soubor musí obsahovat informace ve dvojicích volba=hodnota. Ačkoli na příkazovém řádku musí být cesty, které obsahují mezery, uzavřeny do uvozovek, v konfiguračním souboru mezery do uvozovek neuzavírejte. Ukázka konfiguračního souboru vypadá následovně:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

Jak pokračovat dále

Po spuštění testu nebo plánu možná budete chtít exportovat výsledky. Další informace viz Automatický export čítačů sestav.

Váš názor