Uruchamianie testu lub harmonogramu z poziomu wiersza komend

Test lub harmonogram można uruchomić z wiersza komend poza obszarem roboczym Eclipse i automatycznie wyeksportować wyniki.

Zanim rozpoczniesz

W systemie Linux musi być dostępny serwer X-Windows nawet w przypadku uruchamiania z wiersza komend. Więcej informacji na ten temat zawiera sekcja Uruchamianie testów z poziomu wiersza komend w systemie Linux.

Uwaga: W systemie Mac OS X nie można uruchomić testu z wiersza komend.

Procedura

  1. Aby uruchomić test lub harmonogram z poziomu wiersza komend, przejdź do katalogu zawierającego pliki cmdline.bat i cmdline.sh. W systemach operacyjnych Windows ten katalog to zwykle katalog_instalacyjny_produktu/cmdline. Zautomatyzowane skrypty testowe mogą korzystać z tego pliku, aby uruchamiać testy lub harmonogram.
  2. Uruchom następującą komendę:

    cmdline -workspace pełna_ścieżka_do_obszaru_roboczego -project ścieżka_względna_do_projektu -eclipsehome pełna_ścieżka_do_środowiska_Eclipse -plugins pełna_ścieżka_do_wtyczek -schedule ścieżka_względna_do_harmonogramu -suite ścieżka_względna_do_zestawu -varfile pełna_ścieżka_do_pliku_zmiennych -servicename usługa -serviceargs argumenty_usługi -configfile pełna_ścieżka_do_pliku -results plik_wyników -overwrite {true | false} -quiet -users liczba -vmargs argumenty_maszyny_JVM -exportlog pełna_ścieżka_do_dziennika -exportstats pełna_ścieżka_do_statystyk -exportstatreportlist lista_statystyk -usercomments "Dowolny komentarz użytkownika"

    Jeśli wartość zawiera spacje, należy ją ująć w cudzysłów. Aby zapoznać się z pomocą elektroniczną dla tej komendy, będąc w katalogu zawierającym plik .bat, należy wpisać komendę cmdline -help.

    Następująca tabela zawiera objaśnienia wszystkich opcji:

    Opcja Opis
    -workspace Wymagana. Pełna ścieżka do obszaru roboczego Eclipse.
    -project Wymagana. Ścieżka (włącznie z nazwą pliku) do projektu względem obszaru roboczego.
    -eclipsehome Wymagana. Pełna ścieżka do katalogu, który zawiera plik eclipse.exe.
    -plugins Wymagana. Pełna ścieżka do folderu zawierającego wtyczki. Zazwyczaj w systemie operacyjnym Windows położenie tego folderu to C:\Program Files\IBM\IBMIMShared\plugins.
    -schedule Opcjonalna, ale należy określić opcję -schedule, -suite lub -servicename. Ścieżka z nazwą pliku harmonogramu do uruchomienia określona względem projektu.
    -suite Opcjonalna, ale należy określić opcję -schedule, -suite lub -servicename. Ścieżka z nazwą pliku testu do uruchomienia określona względem projektu.
    -varfile Opcjonalna. Pełna ścieżka do pliku XML zawierającego pary nazwy i wartości zmiennej.
    -servicename Opcjonalna, ale należy określić opcję -schedule, -suite lub -servicename. Nazwa usługi do uruchomienia. Zamiast uruchamiania testu wydajności zostanie uruchomiona określona usługa, gdy stanie się dostępna.
    -serviceargs Opcjonalna. Seria argumentów do przekazania do usługi określonej przez opcję -servicename. Na przykład -serviceargs "-moj_parametr_uslugi1 moja_wartosc_parametru_uslugi1". Wartości są umieszczone w cudzysłowie, ponieważ zawierają spacje.
    -configfile Opcjonalna. Pełna ścieżka do pliku zawierającego parametry dla uruchomienia testu lub harmonogramu. Każdy parametr musi znajdować się w oddzielnym wierszu. Aby utworzyć plik konfiguracyjny, należy użyć edytora, który nie zawija wierszy. W pliku konfiguracyjnym można ustawić dowolne parametry, wymagane lub opcjonalne. Parametry wiersza komend przesłaniają wartości znajdujące się w tym pliku.
    Uwaga: Plik musi być w formacie UTF-8. W pliku nie należy używać znaków cudzysłowu, nawet w przypadku wartości zawierających spacje.
    -results Opcjonalna. Nazwa pliku wyników. Domyślna nazwa pliku wyników to nazwa testu lub harmonogramu z dołączonym znacznikiem czasu.
    -overwrite Opcjonalna. Określa, czy plik wyników o takiej samej nazwie zostanie nadpisany. Wartość domyślna true oznacza, że plik wyników zostanie nadpisany.
    -quiet Opcjonalna. Umożliwia wyłączenie komunikatów wyjściowych programu uruchamiającego i powrót do powłoki komend po zakończeniu wykonania lub próby.
    -users Opcjonalna. Umożliwia przesłonięcie domyślnej liczby użytkowników wirtualnych w wykonaniu. W przypadku harmonogramu wartość domyślna to liczba użytkowników określona w edytorze harmonogramów. W przypadku testu wartość domyślna to jeden użytkownik. Ta opcja umożliwia utworzenie nowej kopii harmonogramu, która zawiera określoną liczbę użytkowników.
    -vmargs Opcjonalna. Argumenty wirtualnej maszyny Java do przekazania do komendy. Na przykład -vmargs "-debug -Xmx512m". Wartości są umieszczone w cudzysłowie, ponieważ zawierają spacje. Aby przechwycić dane monitorowania zasobu, należy użyć parametru -vmargs "-Drm.collect=true -Drm.collect.interval=liczba_większa_od_1000".
    -exportlog Opcjonalna. Pełna ścieżka do pliku, w którym ma zostać zapisany wyeksportowany dziennik testu HTTP.
    -exportstats Opcjonalna. Pełna ścieżka do katalogu, w którym mają zostać zapisane wyeksportowane dane raportu statystycznego. Dane raportu statystycznego są zapisywane w formacie CSV (wartości rozdzielane przecinkami), a nazwa pliku jest określana na podstawie nazwy raportu. Jeśli opcja -exportstatreportlist nie zostanie podana, eksportowane są raporty określone na stronie Eksport raportów okna preferencji Raport testu wydajności.
    -exportstatreportlist Opcjonalna. Rozdzielana przecinkami lista pełnych ścieżek do plików niestandardowego formatu raportu (plików .view) używana podczas eksportowania danych raportów statystycznych z opcją -exportstats. Ten parametr przesłania preferencje obszaru roboczego. Na przykład -exportstatreportlist c:/raport_niestandardowy.view,c:/raport_niestandardowy2.view.
    -usercomments Opcjonalna. Dla tej opcji należy określić tekst ujęty w cudzysłów, który zostanie wyświetlony w wierszu Komentarze użytkownika raportu.
    Uwaga:
    • Wyświetlane są komunikaty w celu wskazania, kiedy test lub harmonogram został uruchomiony, a kiedy zakończony, o ile nie zostanie podana opcja -quiet.
    • Uruchomienie komendy powoduje zablokowanie obszaru roboczego. Aby sprawdzić postęp testu lub harmonogramu podczas wykonywania, należy wywołać inny obszar roboczy i otworzyć projekt przy użyciu tego obszaru roboczego.

Przykład

Uwaga: Plik konfiguracyjny musi zawierać informacje w postaci par opcja=wartość. Choć ścieżki zawierające spacje należy ująć w cudzysłów w wierszu komend, nie należy ujmować w cudzysłów wartości ze spacjami znajdujących się w pliku konfiguracyjnym. Przykładowy plik konfiguracyjny wygląda następująco:
workspace=D:\My Workspace
eclipsehome=C:\Program Files\IBM\SDP
plugins=C:\Program Files\IBM\IBMIMShared\plugins
project=myProject
schedule=mySchedule.testsuite

Co dalej

Po wykonaniu testu lub harmonogramu można wyeksportować wyniki. Więcej informacji na ten temat zawiera sekcja Automatyczne eksportowanie liczników raportu.

Opinia