Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- sviluppo:itadaemon [2017/07/25 16:24] – f.margiotta
+++ sviluppo:itadaemon [2024/10/15 09:45] (versione attuale) – modifica esterna 127.0.0.1
@@ Linea 12: / Linea 12: @@
   * **executeStop($args)** Il metodo viene eseguito una sola volta, alla distruzione del demone, ovvero quando questo viene fermato o nel caso avvenga un'eccezione.
   * **getSleepTime()** questa funzione dovrà semplicemente restituire un integer che rappresenta il tempo in secondi fra un'esecuzione di executeStart e la successiva.
+E' inoltre possibile, ma non necessario, implementare i seguenti metodi:
+  * **checkStartPreconditions($args)** Il metodo viene eseguito una sola volta alla creazione del demone, in maniera simile ad un costruttore.
+  * **checkStopPreconditions($args)** Il metodo viene eseguito una volta prima di executeStop()
 **n.b.** //Un crash completo del demone (come ad esempio quello provocato da un sigkill) non porta all'esecuzione di executeStop.//
@@ Linea 19: / Linea 22: @@
   * Ogni sezione rappresenta un demone, con il nome della sezione che deve assumere il nome del demone
   * All'interno di ogni sezione sono presenti due parametri:
+  - //label//: Stringa di testo che rappresenta il nome esteso del demone, viene visualizzato nella console dei demoni
   - //autostart//: può assumere valore true o false ed indica se il demone parte automaticamente all'avvio del servizio di gestione
-  - //parameters//: sono parametri aggiuntivi che vengono passati sia alla creazione che alla distruzione del demone. E' possibile passare più parametri dividendoli dal carattere di pipe ( | )
+  - //emailLog//: parametro facoltativo, se inserito indica il livello di errore oltre il quale vengono inviate email all'amministratore di sistema. Il sistema è basato sul sistema di logging di itaEngine e invia email all'email amministratore di default.
+  - //parameters//: sono parametri aggiuntivi che vengono passati sia alla creazione che alla distruzione del demone. E' possibile passare più parametri sotto forma di array
+  - //timeWarning//: parametro facoltativo che indica il tempo di inattività del demone dopo il quale viene lanciato un warning (se non è specificato viene preso il valore della costante //itaDaemonOptions::UNRESPONSIVE_TIME_WARNING//)
+  - //timeError//: parametro facoltativo che indica il tempo di inattività del demone dopo il quale viene dato per morto e rilanciato da itaDaemonAutostart (se attivo). Se non è specificato viene preso il valore della costante //itaDaemonOptions::UNRESPONSIVE_TIME_ERROR//)
+<code>[dummy]
+label = 'Dummy daemon'
+autostart = false
+emailLog = CRITICAL
+parameters[] = 1
+parameters[] = true
+parameters[] = "ciao"
+timeWarning = 180
+timeError = 1800
+</code>
 ===== Utilizzo del demone =====
@@ Linea 66: / Linea 83: @@
 Il controllo dei demoni gestiti da itaDaemonAutostart può essere fatto tramite lo script itaDaemonController.php.
 In particolare lo script accetta questa sintassi:
-php itaDaemonController.php <comando> <parametri addizionali>
+php itaDaemonController.php <demone> <comando> <parametri addizionali>
 dove comando può essere:
   * start
@@ Linea 72: / Linea 89: @@
   * pause
   * resume
+  * status
+Inoltre se al posto del nome del demone verrà passata la string all il comando verrà eseguito per tutti i demoni (utile per avere lo status di tutti i demoni presenti, avviarli o fermarli tutti, etc). Esempio: php itaDaemonController.php all start
-**Nota:** C'è possibilità di interscambio dei metodi di controllo, risulterà dunque possibile controllare tramite la classe itaDaemonManager un demone lanciato tramite itaDaemonAutostart e viceversa. Questo vale anche per il wrap dello script php in un demone o un servizio descritti di seguito.
+**Nota:** C'è possibilità di interscambio dei metodi di controllo, risulterà dunque possibile controllare tramite la classe itaDaemonManager un demone lanciato tramite itaDaemonAutostart e viceversa.
 ==== Wrap dello script itaDaemonExecutor.php in un demone (Linux) ====
@@ Linea 108: / Linea 127: @@
 **Nota:** A differenza che per i metodi precedenti il wrap dello script php in un demone/servizio potrebbe causare delle incompatibilità con gli altri metodi di controllo e non è stato testato. Mentre a livello teorico il sistema dovrebbe continuare a funzionare è raccomandabile non usare l'ultimo metodo descritto per dei demoni che si desida poter gestire tramite interfaccia grafica di itaEngine.
-**Nota:** Il modo più robusto e compatibile per lanciare e gestire i demoni di itaEngine è effettuare il wrap di itaDaemonAutostart.php in un demone/servizio e poi controllare i demoni tramite la classe itaDaemonManager o tramite la riga di comando con itaDaemonController
+**Nota:** Il modo più robusto e compatibile per lanciare e gestire i demoni di itaEngine è effettuare il wrap di itaDaemonAutostart.php in un demone/servizio e poi controllare i demoni tramite la classe itaDaemonManager o tramite la riga di comando con itaDaemonController{{counter}} visualizzazioni.