Zum Hauptinhalt springen

Unix Service Control

Aktuelle Konfiguration des Tasks `Unix Service Control` im Workflow Designer
  • Aufgabentyp: ssh_checkservice

Beschreibung​

Die Aufgabe Unix Service Control ermöglicht die Verwaltung des Status eines Dienstes oder Dämons auf einer lokalen Maschine (Modus Default) oder auf einem entfernten Server über SSH.

Sie ermöglicht die Ausführung standardmäßiger Operationen an Diensten, wie Starten, Stoppen und Statusprüfung, ohne dass die Befehle des Betriebssystems manuell angegeben werden müssen.

Konfiguration​

Die Konfiguration definiert den Ausführungsmodus (lokal oder remote) und den zu verwaltenden Dienst. Die Konfigurationsfelder der Aufgabe können manuell oder über Workflow-Parameter und -Variablen. ausgefüllt werden.

Server Connection (Serververbindung)​

  • Verbindungsmodus: definiert die Quelle der Anmeldeinformationen und den Ausführungsart. Er kann drei Betriebsmodi annehmen:
  • Default: Die Befehle werden auf der lokalen Maschine ausgeführt, ohne SSH-Verbindung.
  • Manuell: Ermöglicht die manuelle Eingabe der SSH-Verbindungsparameter.
  • Environment: Verwendet eine voreingestellte 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 für den Verbindungskonto.
  • Port: Port, der für die SSH-Verbindung verwendet wird (der Standardwert ist 22).

Run command as another user (Befehl als anderer Benutzer ausführen)​

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

  • User: Der Benutzername, mit dem der Befehl ausgeführt wird (z. B. root).
  • Password: Das Passwort des oben angegebenen Benutzers.

Operation Details (Betriebsdetails)​

  • Operation: Ein Menü zur Auswahl der Aktion, die am Dienst ausgeführt werden soll:
  • Status: Überprüft den aktuellen Status des Dienstes (z. B. aktiv, inaktiv, wird geladen).
  • Start: Startet den Dienst.
  • Stop: Stoppt den Dienst.
  • Service Name: Der Name des Dienstes, auf den gewirkt werden soll, wie er vom Betriebssystem bekannt ist (z. B. httpd, apache2, postgresql, sshd).

Output-Parameter​

Nach Abschluss der Ausführung stehen die folgenden Output-Parameter zur Verfügung, die als Eingabe in nachfolgende Aufgaben des Workflows verwendet werden können.

  • result: Enthält eine Textnachricht, die das Ergebnis der Operation oder eine Fehlermeldung beschreibt (z. B. “Missing server address”).
  • resultJson: Stellt das Ergebnis der Aufgaben-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.
  • exitStatus: Gibt den Exit-Code des ausgeführten Befehls zurück. Ein Wert von 0 deutet typischerweise darauf hin, dass die Operation erfolgreich war. Unterschiedliche Codes können verschiedene Zustände anzeigen (z. B. „Dienst bereits gestoppt“ oder „Dienst nicht gefunden“).

Hinweise​

Die Aufgabe stellt eine SSH-Verbindung zum entfernten Server her und führt den Stop-/Start-/Status-Befehl des angegebenen Dienstes auf dem konfigurierten Server aus. Wird eine Authentifizierung mittels SSH-Schlüsseln verwendet, muss der öffentliche Schlüssel auf dem entfernten Server registriert sein. Ist die Option „Befehl als anderer Benutzer ausführen“ aktiviert, wird der Befehl mit einem Benutzer ausgeführt, der von dem Haupt-SSH-Verbindungsbenutzer abweicht.