Il secondario di CSP
Questa pagina è per l'amministratore dei due server: il primario, con CSP (Central Syslog), e il secondario, con CSPH (Central Syslog Headless). Il secondario riceve gli stessi log del primario e glieli rende quando il primario non ha potuto riceverli.
L'installazione del secondario
Il secondario è un server a parte, con CSPH (vedi L'installazione):
esapanel-setup --modules=csph
CSP e CSPH non possono stare sullo stesso server: il secondario ascolta sulle porte del suo primario. Il modulo deve essere anche nella licenza del secondario.
All'inizio il secondario non ascolta su nessuna porta: le riceve dal primario quando lo abbini. Il firewall del secondario le apre da solo; se il secondario è dietro un firewall esterno o un NAT, lì le porte vanno aperte a mano.
Tieni sincronizzati gli orologi dei due server (NTP): i log recuperati hanno l'ora in cui li ha ricevuti il secondario.
L'abbinamento
- Sul secondario, in Organizzazione › Account API, crea un account con il ruolo Master server e una sua chiave. La chiave si vede una volta sola.
- Sul primario, in Moduli › Secondario di CSP, scrivi l'Indirizzo del pannello del secondario, con la porta, come lo apri nel browser (per esempio
https://csph.example.com:9943), e la Chiave dell'account API. Premi Salva l'abbinamento.
Il primario dà al secondario le sue porte e la sua licenza: il secondario si mette in ascolto e le mostra nella sua pagina. Quando il primario assegna porte nuove, le dà anche al secondario.
Se il certificato del secondario non è firmato da un'autorità riconosciuta, la pagina del primario mostra il Certificato del secondario, l'unico accettato (impronta SHA-256): l'impronta di quello che ha risposto quando hai abbinato. Il primario accetta solo quello; se il secondario riceve un certificato nuovo, salva di nuovo l'abbinamento. Con un certificato di un'autorità, come Let's Encrypt, non c'è nessuna impronta da fissare.
Con la chiave il primario può dare le porte e leggere i log ricevuti, ma non può cancellarli né cambiare per quanti giorni il secondario li tiene. Un secondario ha un solo primario.
Togli l'abbinamento stacca il secondario dal primario; il secondario tiene i log che ha per i suoi giorni.
Sul secondario: Secondario di CSP (CSPH)
La pagina Moduli › Secondario di CSP (CSPH) del secondario mostra:
- il Primario: il suo Server e l'Account API con cui si è abbinato. Finché nessun primario si è abbinato, la pagina spiega come farlo;
- le Porte ricevute, con l'Ultimo invio delle porte dal primario e l'Ultimo recupero dei log;
- la Ricezione: "In ricezione" con l'ora dell'ultima sonda, oppure "Non riceve: nessuna sonda negli ultimi minuti": controlla che rsyslog sia attivo, per esempio con
systemctl status rsyslog; - i Giorni conservati: il primo e l'ultimo giorno di log che il secondario ha.
Giorni da conservare, da 3 a 30, dice per quanti giorni i log restano sul secondario prima di essere cancellati. Il primario può recuperare un'interruzione solo dentro questi giorni: un'interruzione più lunga si riempie solo in parte. Lo decide solo il secondario.
La licenza del secondario
La licenza del secondario deve coprire quella del primario: lo stesso livello o più alto; fra due Company, almeno gli apparati del primario; fra due Integrator, almeno i suoi clienti. Se non la copre, la pagina lo dice e il secondario rifiuta le porte nuove; quelle che ha già continuano a ricevere. Lo stesso problema compare nella pagina del primario.
Sul primario: Secondario di CSP
La pagina Moduli › Secondario di CSP del primario mostra, dopo l'abbinamento, lo Stato del secondario: l'Ultimo controllo, il Server, la Ricezione (in ricezione o no) e i Giorni che ha, con quanti ne conserva.
Ogni cinque minuti il primario controlla che il secondario risponda, riceva e abbia la stessa ora. Quando comincia un problema ricevi l'avviso "Un problema del secondario di CSP", e un altro quando finisce:
- non risponde;
- non riceve: la sua sonda non arriva da alcuni minuti;
- il suo orologio è diverso da quello del primario di qualche secondo: i log recuperati avrebbero un'ora sbagliata;
- la sua licenza non copre quella del primario.
Finché il problema dura, ciò che il primario non riceve non si può recuperare dal secondario.
Il recupero
Da solo. Alla fine di ogni interruzione della ricezione, il primario chiede al secondario i log di quell'intervallo, con un margine prima e dopo, e li passa alle subscription come se fossero appena arrivati, con l'ora in cui li ha ricevuti il secondario. I log che il primario ha già sono lasciati fuori, così non ci sono doppioni. In Moduli › Ricezione log l'interruzione dice "recuperati: … log".
Accanto a un'interruzione. Se un'interruzione non è stata recuperata, per esempio perché il secondario non rispondeva, in Ricezione log c'è Recupera dal secondario.
Un intervallo. In Secondario di CSP, Recupera un intervallo recupera i log fra Dal e Al: per un'interruzione che il pannello non ha registrato, o dopo un disaster recovery del primario, dal momento del backup in avanti. Entro i giorni che il secondario conserva.
Un apparato che invia solo al primario non ha niente da recuperare: per lui resta la riga dell'interruzione nei log.
Le istruzioni per i clienti
Quando il primario ha un secondario, le istruzioni di ogni apparato, nella sua pagina e nell'aggiunta di un apparato, hanno la riga Server secondario: "anche a …, porta …, gli stessi log". I file per rsyslog e per NXLog che il pannello prepara inviano a tutti e due i server, ciascuno con la sua coda. Gli apparati che i clienti hanno già configurato vanno aggiornati: chiedi ai clienti di aggiungere il secondario.