Zum Hauptinhalt springen

Unix-Verbindungsprüfung

Aktuelle Konfiguration des Tasks „Unix Check Connection“ im Workflow Designer
  • Aufgabentyp: ssh_checkconnection

Beschreibung​

Die Aufgabe Unix Check Connection ermöglicht es dem Workflow, die Erreichbarkeit eines Zielhosts zu überprüfen, sowohl von der lokalen Maschine (Modus Default) als auch von einem entfernten Server über SSH.

Im entfernten Modus arbeitet die Aufgabe in zwei Schritten:

  • Es wird eine Verbindung zu einem Quellserver über SSH hergestellt.
  • Vom Quellserver wird überprüft, ob ein zweiter Host erreichbar ist.

Dies ist nützlich, um die Konnektivität zwischen Systemen innerhalb privater oder geschützter Netzwerke zu überprüfen.

Konfiguration​

Die Konfiguration besteht aus zwei Teilen: dem Ausführungs-/Verbindungsmodus und der Adresse des Zielhosts. Die Felder können manuell oder über Workflow-Parameter und -Variablen. ausgefüllt werden.

Verbindung zum Server​

  • Verbindungsmodus: Definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi angenommen werden:
  • Default: Die Überprüfung wird von der lokalen Maschine durchgeführt.
  • Manuell: Ermöglicht die manuelle Eingabe der SSH-Verbindungsparameter.
  • Environment: Verwendet eine vordefinierte Verbindungsumgebung. In diesem Modus wird ein Menü angezeigt, das die verfügbaren Verbindungen basierend auf der dem Workflow zugeordneten Rolle auflistet.
  • IP-Adresse: IP-Adresse des entfernten Servers.
  • Hostname: Hostname des entfernten Servers.
  • Benutzer: Benutzername, der für die SSH-Verbindung verwendet wird.
  • Passwort: Passwort, das mit dem Verbindungskonto verknüpft ist.
  • Port: Port, der für die SSH-Verbindung verwendet wird (der Standardwert ist 22).

Befehl als anderer Benutzer ausführen​

Durch Aktivieren dieses Kontrollkästchens kann die Suche mit einem Benutzer durchgeführt werden, der von dem für die SSH-Verbindung verwendeten Benutzer abweicht.

  • Benutzer: Name des Benutzers, mit dem der Befehl ausgeführt wird.
  • Passwort: Passwort des Benutzers, der für die Ausführung des Befehls verwendet wird.

Zielhost​

  • Host: Die IP-Adresse oder der Hostname der Zielmaschine, deren Erreichbarkeit überprüft werden soll.

Ausgabe-Parameter​

Die Ausgabe-Parameter für diese Aufgabe sind:

  • result: Enthält eine Textnachricht, die das Ergebnis der Überprüfung beschreibt (z. B. „PING www.google.com (216.58.204.132) 56(84) Bytes von Daten. 64 Bytes von etc...“) oder eine Fehlermeldung.
  • resultJson: Stellt das Ergebnis der Ausführung der Aufgabe im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.
  • exitStatus: Gibt den Exit-Code des ausgeführten Netzwerkbefehls zurück. Ein Wert von 0 gibt an, dass der Host erfolgreich erreicht wurde, während ein Wert ungleich Null anzeigt, dass er nicht erreichbar ist.

Beispiel-Parameter resultJson​

{
  "run_info": {
    "status": "Completed",
    "run_result": "Success"
  },
  "output_parameters": {
    "exitStatus": "0"
  }
}

Anmerkung​

Die Aufgabe stellt eine SSH-Verbindung mit dem entfernten Server her und überprüft, ob der Zielhost erreichbar ist. Wenn die Option „Befehl als anderer Benutzer ausführen“ aktiviert ist, wird die Überprüfung mit einem Benutzer durchgeführt, der von dem Haupt-SSH-Verbindungsbenutzer abweicht.