Aller au contenu principal

Processus de Recherche Unix

Configuration actuelle de la tâche Unix Search Process dans le Workflow Designer
  • Type de tâche: ssh_searchprocess

Description​

La tâche Unix Search Process permet de rechercher un processus en cours d'exécution et de récupérer son PID (Process ID), en exécutant l'opération sur la machine locale (mode Default) ou sur un serveur distant via SSH.

Elle est utilisée pour obtenir dynamiquement l'identifiant d'un processus, à utiliser dans des tâches suivantes (par exemple, Unix Kill Process) ou pour vérifier sa présence.

Configuration​

La configuration définit le mode d'exécution (local ou distant) et le nom du processus à rechercher. Les champs de configuration de la tâche peuvent être définis manuellement ou via paramètres et variables du flux de travail.

Connection au Serveur​

  • Mode de connexion: Définit la source des identifiants utilisés pour la connexion. Il peut prendre trois modes d'opération :
  • Default: la commande est exécutée depuis la machine locale.
  • Manuelle: Permet d'entrer manuellement les paramètres de connexion SSH.
  • Environment: Utilise un environnement de connexion préconfiguré. Dans ce mode, un menu est affiché listant les connexions disponibles en fonction du rôle associé au Workflow.
  • Adresse IP: Adresse IP du serveur distant.
  • Hostname: Nom d'hôte du serveur distant.
  • Utilisateur: Nom d'utilisateur utilisé pour établir la connexion SSH.
  • Mot de passe: Mot de passe associé à l'utilisateur de connexion.
  • Port: Port utilisé pour la connexion SSH (la valeur par défaut est 22).

Exécuter la commande en tant qu'autre utilisateur​

En activant cette case à cocher, il est possible d'exécuter la recherche avec un utilisateur différent de celui utilisé pour la connexion SSH.

  • Utilisateur: Nom de l'utilisateur avec lequel la commande sera exécutée.
  • Mot de passe: Mot de passe de l'utilisateur utilisé pour l'exécution de la commande.

Détails du Processus​

  • Nom du Processus: Le nom (ou une partie significative du nom) du processus à rechercher.

Paramètres de Sortie​

À la fin de la recherche, la tâche expose les paramètres de sortie suivants :

  • pidList: Contient la liste des Process ID numériques trouvés qui correspondent au Process Name spécifié. Si un seul processus est trouvé, il contiendra un seul PID. Si plusieurs processus sont trouvés, il peut les contenir tous (souvent séparés par un saut de ligne). C'est le paramètre principal à utiliser dans les tâches suivantes.
  • result: Contient la sortie textuelle complète de la commande de recherche exécutée sur le serveur ou un message d'erreur.
  • resultJson: Représente le résultat de l'exécution de la tâche au format JSON, incluant des informations générales, des configurations et des détails sur l'exécution.
  • exitStatus: Retourne le code de sortie de la commande de recherche. Une valeur de 0 indique que la commande a été exécutée correctement (même si elle n'a pas trouvé de processus).

Notes​

La tâche établit une connexion SSH avec le serveur distant et exécute l'extraction du PID du processus configuré. Si l'authentification est effectuée via des clés SSH, il est nécessaire que la clé publique soit enregistrée sur le serveur distant. Si l'option "Exécuter la commande en tant qu'autre utilisateur" est activée, la commande est exécutée avec un utilisateur différent de celui de la connexion SSH principale.