Der Befehlszeilenadapter gibt Ihnen die Möglichkeit, eine Zieltestmaschine zum Ausführen
von Befehlszeilenjobs zu verwenden. Für die Ausführung von Befehlszeilenscripts müssen
Sie den Adapter auf der Zieltestmaschine registrieren.
Vorbereitende Schritte
- Stellen Sie sicher, dass die Plattform, auf der Sie den Befehlszeilenadapter ausführen möchten,
mindestens Java ab Version 1.5 unterstützt.
- Die ausführbare Datei java.exe muss im Pfad auf der Zieltestmaschine zugänglich sein.
- Zum Starten des Adapters benötigen Sie die folgenden Informationen:
- Jazz-Repository-URL (in der Regel https://QM-Server:Port/qm)
- Benutzer-ID mit den für die Anmeldung als Adapter erforderlichen Lizenzen
- Kennwort für diese Benutzer-ID
- Name des Projektbereichs, sofern es sich nicht um den Standardprojektbereich "Quality
Management" handelt
- Die Anwendung "Quality Management" muss auf dem Server ausgeführt werden.
Wichtig: Sie können mehrere
Adapter auf einer Zieltestmaschine ausführen. Jedoch muss jeder Adapter ein gesonderter
Prozess mit einem eindeutigen Namen sein, der in der Option -adapterName angegeben ist.
Informationen zu diesem Vorgang
Der Befehlszeilenadapter muss auf der Zieltestmaschine konfiguriert und gestartet sein.
Vorgehensweise
Führen Sie die folgenden Schritte auf der Zieltestmaschine aus:
- Beschaffen Sie sich die Datei Installationsposition\JazzTeamServer\server\conf\qm\adapters\RQMCommmandLineAdapter.zip von der Installationsmaschine. Ein Serveradministrator
mit Lesezugriff auf den Server könnte Ihnen die komprimierte Datei beschaffen.
- Entpacken Sie die Datei RQMCommmandLineAdapter.zip in einem Ordner auf der Zieltestmaschine.
- Optional: Passen Sie die tatsächlichen Scriptergebnisse an.
Diese werden im Testfall- oder Testsuiteausführungsdatensatz angezeigt. Weitere Informationen hierzu finden Sie unter Befehlszeilenadapter anpassen.
- Wenn Sie Version 5.0 oder später verwenden und die Befehlszeilenadapter
mehrere Anforderungen gleichzeitig bedienen sollen, können Sie diese Funktion aktivieren.
Sie ist standardmäßig inaktiviert. Sie aktivieren die Funktion durch Hinzufügen
einer Eigenschaft. Wenn Sie die Eigenschaft nicht hinzufügen oder einen ungültigen Wert für diese
festlegen, werden Tests bei Übermittlung von mehreren Tests an einen Adapter in eine Warteschlange gestellt
und in der Reihenfolge ausgeführt, in der sie empfangen wurden.
Tipp: Die Verwendung des
Befehlszeilenadapters zum gleichzeitigen Ausführen von mehreren Tests eignet sich am besten für Tests mit langer Laufzeit. Der Adapter wählt Tests nacheinander basierend auf seiner
Kapazität zum Ausführen der einzelnen Tests aus. Er wählt ein Script aus, führt es aus und wählt anschließend
ein weiteres Script zum Ausführen aus. Wenn es sich um kurze Scripts handelt, erhält man den Eindruck, dass diese
nacheinander ausgeführt werden.
Gehen Sie wie folgt vor, um
die parallele Testausführung auf einem Befehlszeilenadapter zu aktivieren:- Öffnen Sie auf der Zieltestmaschine die Datei CommandLine.properties
oder eine funktional entsprechende Vorgabendatei.
- Fügen Sie die folgende Eigenschaft zur Datei hinzu: com.ibm.rqm.commandline.maxservedrequests=N
Dabei steht N für die maximale Anzahl von Tests,
die gleichzeitig ausgeführt werden sollen.
- Wenn der Befehlszeilenadapter aktiv ist, starten Sie ihn erneut.
Wird der angegebene maximale Wert erreicht, werden an den Adapter übermittelte Tests in eine
Warteschlange gestellt und ausgeführt, sobald die Kapazität verfügbar ist.
- Starten Sie den Befehlszeilenadapter.
- Gehen Sie wie
folgt vor, wenn Sie den Befehlszeilenadapter zum ersten Mal starten:
Führen Sie die Stapeldatei mit den folgenden Befehlszeilenargumenten aus:
C:\ start.bat -repository https://QM-Server:Port/qm -user Benutzer-ID -password Kennwort [-adapterName Adaptername]
[-projectArea Projektbereich] [-sleepTime Ruhezeit] [-configFile Konfigurationsdatei]
Weitere Informationen hierzu finden Sie unter
Befehlszeilenadapter anpassen.
Führen Sie
das Shell-Script mit den folgenden Befehlszeilenargumenten aus:
$ start.sh -repository https://QM-Server:Port/qm -user Benutzer-ID -password Kennwort [-adapterName Adaptername]
[-projectArea Projektbereich] [-sleepTime Ruhezeit] [-configFile Konfigurationsdatei]
Hierbei gilt Folgendes:
- qmserver ist der Hostname oder die IP-Adresse des
Qualitätsmanagementservers.
- Port ist der Port, an dem der
Qualitätsmanagementserver ausgeführt wird.
- Benutzer-ID ist eine registrierte Benutzer-ID für
Qualitätsmanagement, die über die Lizenz zum Ausführen eines Adapters verfügt.
- Kennwort ist das Kennwort der übergebenen Benutzer-ID.
- Adaptername ist der vom Benutzer zugeordnete Adaptername.
- Projektbereich ist der Name des Projekts, bei dem Sie sich
anmelden.
- Ruhezeit ist das Intervall zwischen Task-Abfragen. Die
Standardeinstellung ist 5 Sekunden.
- Konfigurationsdatei ist die Datei, aus der die Einstellungen für diesen Adapter gelesen werden. Der Name der Standarddatei ist config.ini.
Der Adapter generiert eine Konfigurationsdatei, in der Registrierungsinformationen gespeichert werden. Bei der Konfigurationsdatei handelt es sich entweder um die Datei config.ini
oder um die in der Option -configFile angegebene Datei.
Bei einem Neustart des Adapters werden diese
Informationen wiederverwendet.
- Gehen Sie wie
folgt vor, um den Befehlszeilenadapter über die Datei config.ini erneut zu starten:
Führen Sie die Stapeldatei wie folgt ohne Argumente aus:
C:\ start.bat
Führen Sie das Shell-Script wie folgt ohne Befehlszeilenargumente aus:
$ start.sh
Anmerkung: Es wird erwartet, dass sich die Konfigurationsdatei in dem Verzeichnis befindet, von dem aus der Adapter gestartet wird.
Ergebnisse
Das System generiert eine Nachricht ähnlich der folgenden:
Adapter wird gestartet…
Die Konfigurationsdatei adapterConfig.ini gibt es nicht. Der Adapter verwendet die übergebenen Argumente.
HTTP-Client erfolgreich erstellt.
Der Adapter ist nun verbunden.
Befehlszeilenadapter wurde erstellt.
Nächste Schritte
Sie können den Adapterstatus in der Qualitätsmanagementanwendung auf der Testermaschine überprüfen.
Klicken Sie dazu auf . Vergewissern Sie sich, dass der Status
grün ist, bevor Sie einen Test mit einem aktiven Befehlszeilenadapter ausführen.