Skip to main content

Unix Reboot System

Unix Reboot System | Sybot Documentation

UNIX REBOOT SYSTEM

  • Task type: ssh_rebootsystem

Descrizione​

Il Task Unix Reboot System consente di eseguire il riavvio del sistema operativo su una macchina locale (modalità Default) o su un server remoto tramite SSH, tramite invio di un comando di reboot.

È utilizzato per automatizzare attività di manutenzione, applicare aggiornamenti che richiedono un riavvio o ripristinare il sistema in modo controllato.

Configurazione

La configurazione definisce la modalità di esecuzione (locale o remota), i parametri relativi al riavvio e l’eventuale messaggio di notifica per gli utenti. 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 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).

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 Riavvio​

  • Timeout (Minuti): Specifica dopo quanti minuti dall'esecuzione del Task il server verrà effettivamente riavviato. Questo non è un timeout di connessione, ma il tempo di attesa prima del riavvio.
  • Messaggio: Il messaggio di notifica che verrà inviato a tutti gli utenti attualmente connessi al server tramite terminale per avvisarli dell'imminente riavvio.

Parametri di Output

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

  • 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 di riavvio. Un valore di 0 indica che il comando è stato schedulato con successo.

Esempio parametro resultJson​

{

 "id": 19971,

 "name": "Unix Service Control",

 "description": "",

 "type": "ssh_checkservice",

 "type_name": "Unix Service Control",

 "type_description": "Verifica Servizi",

 "config": {

 "verb": "status",

 "service": "example.service",

 "operation": "checkservice",

 "connection": {

 "ip": "",

 "port": "",

 "user": "",

 "hostname": "",

 "password": "",

 "use_password": "N",

 "connection_mode": "default",

 "hidden_task_pwd": "0",

 "env_connection_name": "---"

 },

 "output_links": []

 },

 "run_info": {

 "run_id": 1513335,

 "start_datetime": "2026-04-30 13:06:41",

 "end_datetime": "2026-04-30 13:06:41",

 "start_epoch": 1777554401.647588,

 "end_epoch": 1777554401.781377,

 "duration": 0,

 "status": "Completed",

 "cmd_text": "",

 "run_result": "Success",

 "result_text": "● example.service - example Service\n Loaded: loaded (/etc/systemd/system/example.service; enabled...",

 "full_result_text": "● example.service - example Service\n Loaded: loaded (/etc/systemd/system/example.service; enabled; preset: disabled)\n Active: active (running) since Tue 2026-04-28 18:05:03 CEST; 1 day 19h ago\n Main PID: 3989430 (example)\n Tasks: 76 (limit: 1233272)\n Memory: 232.4M\n CPU: 1min 15.088s\n CGroup: /system.slice/example.service\n └─3989430 /usr/bin/example serve"

 },

 "output_parameters": {

 "exitStatus": "0"

 }

}

Note Importanti​

Il task stabilisce una connessione SSH con il server remoto ed esegue il comando di riavvio del server come 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.