UnixShell
Der UnixShell-Agent erlaubt es Ihnen, ein Shell-Skript auf einer Remote- Unix (Linux)-Maschine auszuführen. Um den UnixShell-Agenten aufzusetzen, folgen Sie bitte den nächsten Schritten.
Setup
Die folgenden Schritte benötigen grundlegendes Wissen über UnixShell. Für die angegebenen Befehle kann nicht garantiert werden, dass sie auf jeder Unix (Linux) Distribution funktionieren und müssen daher eventuell an Ihre Distribution angepasst werden.
Erstellen Sie einen Automatisierungsagenten in aqua und schreiben Sie den Zugriffscode auf (auch bekannt als Agentencode).
Überprüfen Sie, ob Java auf Ihrer Unix (Linux)-Maschine installiert ist, z.B. in dem Sie den folgenden Befehl ausführen:
java -version
Das Ergebnis sollte so ähnlich wie im folgenden Screenshot sein:
Wenn Java nicht auf Ihrer Maschine installiert ist, können Sie es installieren, indem Sie dem folgenden Leitfaden für Ihre Unix (Linux) Distribution folgen. Als Alternative können Sie eine Java Laufzeit-Umgebung (JRE) als *.tar.gz Paket herunterladen und dies in einen Ordner Ihrer Wahl entpacken (untar).
Die folgenden Befehle sind Beispiele für eine Ubuntu Distribution:
mkdir /usr/java cd /usr/java tar zxvf <path-to-your-java-tar.gz>
Laden Sie den aqua UnixShell-Agenten auf Ihre Unix (Linux)-Maschine hoch und entpacken Sie diesen in einen Ordner Ihrer Wahl (z.B. indem Sie den Befehl unzip in Ubuntu benutzen, der über sudo apt-get install unzip installieren können).
cd /usr unzip <path-to-UnixShell-agent-zip-file>
Bearbeiten Sie die Datei agent.properties (z.B. mit dem Befehl nano) und ändern Sie die Zeile agentCode (siehe Schritt 1) sowie aquaServiceUrl, sodass der Agent mit Ihrerm aqua Server kommunizieren kann.
cd <path to agent folder>
nano ./agent.properties Ein Beispiel können Sie hier sehen:
Wenn Sie Java installiert haben, folgen Sie dem alternativen Vorschlag, wie in Schritt 2 beschrieben; bitte bearbeiten Sie die Datei agent.sh und passen Sie den Pfad an den Java-Befehl an. Bitte beachten Sie die Option, den Agenten im Fenstermodus laufen zu lassen. Dies kann für Unix (Linux)-Maschinen geeignet sein, die eine GUI installiert haben.
Machen Sie die Datei agent.sh ausführbar.
sudo chmod +x ./agent.sh
Starten Sie den Agenten, indem Sie agent.sh ausführen.
cd <Pfad zum Agenten-Ordner>
./agent.sh
Wenn eine Exception ausgegeben wird, prüfen Sie bitte noch einmal in der Datei agent.properties, ob agentCode und aquaServiceUrl richtig gesetzt sind.
In aqua sollten Sie einen grünen Indikator für Ihren Agenten sehen.
Shell-Skripte schreiben, die das Ergebnis nach aqua zurückschicken
Um ein UnixShell-Skript in ALM auszuführen, erstellen Sie einen neuen Testfall, öffnen den Schrittplaner und wählen den Tab Automatisierung. Wählen Sie den Testschritt (Klick in das leere Feld des Schritts) und fügen ein neues UnixShell-Skript über den Skript-Button hinzu.
Im Skript-Bereich des Schritts können Sie nun ein Skript einfügen, welches auf der Remote-Maschine ausgeführt werden soll. Beispiel:
Wenn Sie mit Ihrem Skript fertig sind, können Sie Ihren Testfall speichern und ausführen. Für die Ausführung wird ein neuer Unterordner im temp-Ordner des Agenten erstellt. In diesem Unterordner wird automatisch ein weiterer Unterordner toAttach erstellt, sodass Sie Anhänge, wie im Beispiel beschrieben, hochladen können. Wenn Sie den temp-Folder nach der Ausführung öffnen wollen, setzen Sie bitte in der Datei agent.properties deleteTempFiles=false
und starten Sie Ihren Agenten neu.
Einschränkungen
Bilder können wie Anhänge hochgeladen werden. Es ist jedoch nicht möglich, Bilder so hochzuladen, dass sie direkt im aqua Ausführungs-Log angezeigt werden.
Die komplette Ausgabe der Konsole wird in den letzten Schritt des Ausführungs-Logs geschrieben und nicht als mehrere Ausführungs-Logeinträge.
Als Konsequenz der Einschränkung 2, können Sie das Log-Level einer einzelnen Ausführung-Log-Nachricht nicht bestimmen.
Last updated