Zum Hauptinhalt springen

Unix-Suchprozess

Aktuelle Konfiguration des Tasks `Unix Search Process` im Workflow Designer
  • Aufgabentyp: ssh_searchprocess

Beschreibung​

Der Task Unix Search Process ermöglicht die Suche nach einem laufenden Prozess und die Abfrage seiner PID (Process ID). Die Operation wird entweder auf der lokalen Maschine (Modus Default) oder auf einem entfernten Server über SSH ausgeführt.

Er wird verwendet, um dynamisch die Kennung eines Prozesses zu ermitteln, die in nachfolgenden Tasks (z. B. Unix Kill Process) genutzt oder um dessen Existenz zu überprüfen.

Konfiguration​

Die Konfiguration definiert den Ausführungsmodus (lokal oder remote) und den zu suchenden Prozessnamen. Die Konfigurationsfelder des Tasks können manuell oder über Workflow-Parameter und -Variablen. befüllt werden.

Serververbindung​

  • Verbindungsmodus: Definiert die Quelle der für die Verbindung verwendeten Anmeldeinformationen. Es können drei Betriebsmodi angenommen werden:
  • Default: Der Befehl wird von der lokalen Maschine ausgefü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 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 dieses Kontrollkästchens kann die Suche mit einem Benutzer durchgeführt werden, der von dem für die SSH-Verbindung verwendeten Benutzer abweicht.

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

Prozessdetails​

  • Prozessname: Der Name (oder ein signifikanter Teil des Namens) des zu suchenden Prozesses.

Ausgabe-Parameter​

Nach Abschluss der Suche stellt der Task die folgenden Ausgabe-Parameter bereit:

  • pidList: Enthält die Liste der gefundenen numerischen Process IDs, die mit dem angegebenen Prozessnamen übereinstimmen. Wird nur ein Prozess gefunden, enthält es eine einzelne PID. Werden mehrere Prozesse gefunden, können alle enthalten sein (oft durch einen Zeilenumbruch getrennt). Dies ist der Hauptparameter, der in nachfolgenden Tasks zu verwenden ist.
  • result: Enthält die vollständige Textausgabe des ausgeführten Suchbefehls auf dem Server oder eine Fehlermeldung.
  • 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 Suchbefehls zurück. Ein Wert von 0 zeigt an, dass der Befehl erfolgreich ausgeführt wurde (auch wenn kein Prozess gefunden wurde).

Hinweise​

Der Task stellt eine SSH-Verbindung zum entfernten Server her und führt die Extraktion der PID des konfigurierten Prozesses durch. 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.