Befehlszeilenadapter konfigurieren und starten

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

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.
Konfiguration der Befehlszeilenausführung

Vorgehensweise

Führen Sie die folgenden Schritte auf der Zieltestmaschine aus:

  1. 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.
  2. Entpacken Sie die Datei RQMCommmandLineAdapter.zip in einem Ordner auf der Zieltestmaschine.
  3. Optional: Passen Sie die tatsächlichen Scriptergebnisse an. Diese werden im Testfall- oder Testsuiteausführungsdatensatz angezeigt. Weitere Informationen hierzu finden Sie unter Befehlszeilenadapter anpassen.
  4. 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:
    1. Öffnen Sie auf der Zieltestmaschine die Datei CommandLine.properties oder eine funktional entsprechende Vorgabendatei.
    2. 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.

    3. 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.
  5. Starten Sie den Befehlszeilenadapter.
    • Gehen Sie wie folgt vor, wenn Sie den Befehlszeilenadapter zum ersten Mal starten:
      Windows-Symbol
      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.
      Linux-Symbol
      UNIX-Symbol
      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:
      Windows-Symbol
      Führen Sie die Stapeldatei wie folgt ohne Argumente aus:
      C:\ start.bat
      Linux-Symbol
      UNIX-Symbol
      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 Ausführung > Adapterkonsole. Vergewissern Sie sich, dass der Status grün ist, bevor Sie einen Test mit einem aktiven Befehlszeilenadapter ausführen.

Videosymbol Videos anschauen

CLM-Wiedergabeliste
Jazz.net-Kanal
Kanal 'User Education'

Lernsymbol Weitere Informationen

CLM-Lernkreis
Agile-Lernkreis
Lernkreise

Fragesymbol Fragen stellen

Jazz.net-Forum
developerWorks-Foren

Unterstützungssymbol Unterstützung anfordern

Support Portal
Deployment Wiki
Support-Blog