Skip to main content

Unix Service Control

Unix Service Control | Sybot Documentation

UNIX SERVICE CONTROL

  • Task type: ssh_checkservice

Descrizione​

Il Task Unix Service Control consente di gestire lo stato di un servizio o demone su una macchina locale (modalità Default) o su un server remoto tramite SSH.

Permette l’esecuzione di operazioni standard sui servizi, come avvio, arresto e verifica dello stato, senza la necessità di specificare manualmente i comandi del sistema operativo.

Configurazione

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

Server Connection (Connessione al Server)​

  • Modalità connessione: definisce l’origine delle credenziali e il tipo di esecuzione. Può assumere tre modalità operative:
  • Default: I comandi vengono eseguiti sulla macchina locale, senza connessione SSH.
  • 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).

Run command as another user (Esegui comando come altro utente)​

Attivando questa checkbox, è possibile eseguire il comando di gestione del servizio con un utente diverso da quello utilizzato per la connessione SSH.

  • User: Il nome dell'utente con cui verrà eseguito il comando (es. root).
  • Password: La password dell'utente specificato sopra.

Dettagli dell'Operazione​

  • Operation: Un menu per selezionare l'azione da eseguire sul servizio:
  • Status: Verifica lo stato corrente del servizio (es. attivo, inattivo, in caricamento).
  • Start: Avvia il servizio.
  • Stop: Arresta il servizio.
  • Service Name: Il nome del servizio su cui agire, così come è conosciuto dal sistema operativo (es. httpd, apache2, postgresql, sshd).

Parametri di Output

Al completamento dell’esecuzione, il task rende disponibili i seguenti Parametri di Output, utilizzabili come input nei task successivi del Workflow.

  • result: Contiene un messaggio testuale che descrive l'esito dell'operazione o un messaggio di errore (es. “Missing server address”).
  • 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 eseguito. Un valore di 0 indica tipicamente che l'operazione è stata eseguita con successo. Codici diversi possono indicare vari stati (es. "servizio già fermo" o "servizio non trovato").

Note​

Il task stabilisce una connessione SSH con il server remoto ed esegue il comando di stop/start/status del servizio specificato sul server 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.