Skip to main content

Unix Search Process

Unix Search Process | Sybot Documentation

UNIX SEARCH PROCESS

  • Task type: ssh_searchprocess

Descrizione​

Il Task Unix Search Process consente di cercare un processo in esecuzione e recuperarne il PID (Process ID), eseguendo l’operazione sulla macchina locale (modalità Default) o su un server remoto tramite SSH.

È utilizzato per ottenere in modo dinamico l’identificativo di un processo, da utilizzare in task successivi (es. Unix Kill Process) o per verificarne la presenza.

Configurazione

La configurazione definisce la modalità di esecuzione (locale o remota) e il nome del processo da cercare. I campi di configurazione del Task possono essere valorizzati manualmente o tramite parametri e variabili del workflow.

Connessione al Server​

  • Modalità connessione: Definisce l’origine delle credenziali utilizzate per la connessione. Può assumere tre modalità operative:
  • Default: il comando viene eseguito dalla macchina locale.
  • Manuale: Consente l’inserimento manuale dei parametri di connessione SSH.
  • Environment: Utilizza un ambiente di connessione preconfigurato. In questa modalità viene visualizzato un menu che elenca le connessioni disponibili in base al ruolo associato al Workflow.
  • Indirizzo IP: Indirizzo IP del server remoto.
  • Hostname: Nome host del server remoto.
  • Utente: Nome utente utilizzato per stabilire la connessione SSH.
  • Password: Password associata all'utente di connessione.
  • Porta: Porta utilizzata per la connessione SSH (il valore predefinito è 22).

Esegui comando come altro utente​

Attivando questa checkbox, è possibile eseguire la ricerca con un utente diverso da quello utilizzato per la connessione SSH.

  • Utente: Nome dell'utente con cui verrà eseguito il comando.
  • Password: Password dell’utente utilizzato per l’esecuzione del comando.

Dettagli del Processo​

  • Nome Processo: Il nome (o una parte significativa del nome) del processo da cercare.

Parametri di Output

Al termine della ricerca, il Task espone i seguenti parametri di output:

  • pidList: Contiene l'elenco dei Process ID numerici trovati che corrispondono al Process Name specificato. Se viene trovato un solo processo, conterrà un singolo PID. Se vengono trovati più processi, potrebbe contenerli tutti (spesso separati da un a capo). Questo è il parametro principale da utilizzare nei Task successivi.
  • result: Contiene l'output testuale completo del comando di ricerca eseguito sul server o un messaggio di errore.
  • resultJson: Rappresenta il risultato dell’esecuzione del task in formato JSON, includendo informazioni generali, configurazioni e dettagli sull’esecuzione.
  • exitStatus: Restituisce il codice di uscita del comando di ricerca. Un valore di 0 indica che il comando è stato eseguito correttamente (anche se potrebbe non aver trovato alcun processo).

Note​

Il task stabilisce una connessione SSH con il server remoto ed esegue l'estrazione del PID del processo configurato. Se si utilizza l'autenticazione tramite chiavi SSH, è necessario che la chiave pubblica sia registrata sul server remoto. Se l'opzione "Esegui comando come altro utente" è abilitata, il comando viene eseguito con un utente diverso da quello della connessione SSH principale.