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

V systému Linux musí být k dispozici server X, a to i při spuštění z příkazového řádku. Další informace viz Spouštění testů z příkazového řádku v systému Linux.

Poznámka: V systému Mac OS X nelze spustit test z příkazového řádku.

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ář productInstallationDirectory/cmdline. Vaše automatické testovací skripty můžete nasměrovat na tento soubor ke spouštění testů nebo plánu.
  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_modulům_plugin -schedule relativní_cesta_k_plánu -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 soubor_výsledků -overwrite {true | false} -quiet -users nn -vmargs argumenty_JVM -exportlog úplná_cesta_k_protokolu -exportstats úplná_cesta_ke_statistikám -exportstatreportlist seznam_statistik -usercomments "libovolný komentář uživatele"

    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.
    -overwrite Volitelné. Určuje, zda bude přepsán soubor výsledků se stejným názvem. Výchozí hodnota true znamená, že soubor výsledků bude přepsán.
    -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é. Argumenty prostředí JVM (Java Virtual Machine), které se mají předat. Například -vmargs "-debug -Xmx512m". Hodnoty jsou uzavřeny v uvozovkách, protože obsahují mezery. Chcete-li zachycovat data monitorování prostředků, použijte nastavení -vmargs "-Drm.collect=true -Drm.collect.interval=číselná hodnota větší než 1000".
    -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.
    -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:
    • 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