Zum Hauptinhalt springen

Unix-Prozess beenden

Aktuelle Konfiguration des Tasks `Unix Kill Process` im Workflow Designer
  • Aufgabentyp: ssh_killprocess

Der Task Unix-Prozess beenden ermöglicht es, einen Prozess über dessen PID (Process ID) zu beenden, indem die Operation auf der lokalen Maschine (Modus Standard) oder auf einem entfernten Server über SSH ausgeführt wird.

Er dient dazu, laufende Prozesse auf Unix/Linux-Systemen zu stoppen.

Konfiguration​

Die Konfiguration definiert den Ausführungsmodus (lokal oder remote) und die notwendigen Parameter zur Identifizierung des zu beendenden Prozesses. Die Felder können manuell oder über Workflow-Parameter und -Variablen. ausgefüllt werden.

Serververbindung​

  • Verbindungsmodus: Definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi angenommen werden:
  • Standard: Der Befehl wird von der lokalen Maschine ausgeführt.
  • Manuell: Ermöglicht die manuelle Eingabe der Verbindungsparameter.
  • Umgebung: 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 für den Verbindungskonto.
  • Port: Port, der für die SSH-Verbindung verwendet wird (der Standardwert ist 22).

Befehl als anderer Benutzer ausführen​

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

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

Prozessdetails​

  • Signal: Das Beendigungs-Signal, das an den Prozess gesendet werden soll. Die Wahl des Signals bestimmt die „Art“, wie der Prozess aufgefordert wird, zu stoppen:
  • SIGTERM: (Standard) Standard-Beendigungs-Signal. Es bittet den Prozess höflich, sich zu schließen und ihm die Möglichkeit gibt, Bereinigungsarbeiten durchzuführen. Dies ist die bevorzugte Methode.
  • SIGKILL: Erzwingendes Beendigungs-Signal. Stoppt den Prozess sofort, ohne ihm die Möglichkeit zur Bereinigung zu geben. Sollte verwendet werden, wenn SIGTERM nicht funktioniert.
  • SIGINT: Unterbrechungs-Signal (entspricht dem Drücken von Strg+C).
  • SIGQUIT: „Quit“-Signal von der Tastatur.
  • SIGHUP: „Hang up“-Signal, oft verwendet, um eine Konfiguration bei einem Daemon neu zu laden.
  • PID Prozess: Die numerische Kennung (Process ID) des zu beendenden Prozesses. Es können mehrere PIDs angegeben werden, indem sie durch ein Leerzeichen getrennt werden.

Ausgabe-Parameter​

Nach Abschluss der Ausführung stellt der Task die folgenden Ausgabe-Parameter bereit:

  • result: Enthält eine Textnachricht, die das Ergebnis der Operation oder eine Fehlermeldung beschreibt (z. B. “Missing server address”).
  • resultJson: Stellt das Ergebnis der Task-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 Kill-Befehls auf dem entfernten Server zurück. Typischerweise gibt ein Wert von 0 an, dass der Befehl erfolgreich ausgeführt wurde.

Beispiel-Parameter resultJson​

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

Wichtige Hinweise

  • Der für die SSH-Verbindung verwendete Benutzer (oder der in „Als“ angegebene Benutzer) muss die erforderlichen Berechtigungen haben, um Signale an den Zielprozess zu senden.
  • Die PID eines Prozesses kann dynamisch über andere Tasks abgerufen werden, wie z.B. „Unix Search Process“ oder durch Ausführen eines ps-Befehls über einen allgemeinen SSH-Task, wodurch der gesamte Stoppvorgang vollständig automatisiert wird.
  • Wenn Sie die Authentifizierung per SSH-Schlüsseln verwenden, muss der öffentliche Schlüssel auf dem Remote-Server registriert sein. Wenn die Option „Befehl als anderer Benutzer ausführen“ aktiviert ist, wird der Befehl mit einem Benutzer ausgeführt, der von dem Haupt-SSH-Verbindungsbenutzer abweicht.