Amministrazione dell’istanza con omd

In alcuni casi è opportuno specificare anche l'ID utente/gruppo del nuovo utente da creare. Questo si può fare con le opzioni -u e -g, ad es:

Una panoramica delle altre opzioni può essere visualizzata con omd create --help. Le opzioni più importanti sono:

Per impostazione predefinita, la directory home di un nuovo sito viene creata all'indirizzo /omd/sites/ e riempita con i file predefiniti. Tuttavia, puoi anche far creare una directory home vuota, ad esempio per montare un volume esterno in questa posizione. Questo viene fatto con l'opzione --no-init:

Questa opzione omette anche l'integrazione con l'Apache di sistema, lasciando vuota /omd/apache/mysite.conf. Potrai quindi montare qualsiasi directory o volume e continuare la configurazione:

omd init si aggiorna con i due passaggi omessi, quindi aggiunge i file predefiniti e crea la configurazione di Apache.

Come utente dell'istanza puoi semplicemente chiamare la modalità interattiva con:

Quando modifichi un'impostazione mentre il sito è in funzione, OMD ti informa che il sito deve essere prima fermato e lo fa in base alle necessità:

Non dimenticare di riavviare il sito al termine del lavoro.omd config non lo farà automaticamente.

Chi non ama la modalità interattiva o preferisce lavorare con gli script, può impostare le singole impostazioni come variabili tramite la linea di comando. Per questo esiste il comando omd config set. L'esempio seguente imposta la variabile AUTOSTART a off:

Questa operazione può essere eseguita anche come root se il nome del sito viene aggiunto come argomento:

L'assegnazione attuale di tutte le variabili mostra come root il comando omd config mysite show e come utente dell'istanza omd config show:

L'output del comando è abbreviato per chiarezza e mostra solo le prime voci.

Ci sono numerose impostazioni in omd config. Le più importanti sono:

Nota: puoi vedere queste variabili con gli stessi nomi anche nella modalità interattiva.

A volte è utile creare una copia di un sito a scopo di test o per preparare un aggiornamento. Naturalmente si potrebbe semplicemente copiare la directory /omd/sites/mysite_old in /omd/sites/mysite_new. Questo però non funzionerà come desiderato, perché:

Per semplificare la copia di un sito, esiste il comando omd cp che tiene conto di tutto questo. Esegui il comando come root e inserisci semplicemente il nome del sito esistente seguito dal nome del nuovo sito. Ad esempio:

La copia può funzionare solo se

Entrambe le condizioni garantiscono che il sito sia in uno stato coerente al momento della copia e che non cambi durante l'operazione.

In origine, OMD poteva gestire solo i file creati durante la creazione del sito con omd create e che contenevano anche l'ID del sito ($OMD_SITE). Questi file possono essere trovati nella directory del sito ~/etc con questo comando:

In precedenza, OMD non poteva fare nulla con i file di configurazione creati successivamente attraverso il lavoro con l'istanza Checkmk (le configurazioni degli host aggiunti in un secondo momento, ad esempio). Da un punto di vista puramente tecnico, questo comportamento corrisponde esattamente allo scopo di OMD. Tuttavia, l'aspettativa della maggior parte degli utenti dell'istanza è che omd cp crei un sito completamente nuovo che possa continuare ad essere utilizzato in modo produttivo, compresa la sua configurazione di monitoraggio.

A partire dalla versione di Checkmk 2.1.0 OMD può ora personalizzare gli elementi più importanti della configurazione di Checkmk. A proposito, non devi fare nulla: l'intera migrazione descritta di seguito avviene automaticamente.

Un esempio tipico: nelle proprietà di un host puoi utilizzare l'attributo Monitored on site per specificare manualmente su quale sito questo host deve essere monitorato, ad esempio mysite_old. Dopo un omd cp mysite_old mysite_new il valore cambierà di conseguenza in mysite_new. (In precedenza questa procedura avrebbe portato alla voce Unknown site (mysite_old)).

L'implementazione tecnica di questa migrazione è la seguente: OMD rileva le modifiche all'ID del sito ed esegue il comando post-rename-site -v -o mysite_new. Le singole fasi della migrazione vengono poi processate in modo completamente automatico tramite i cosiddetti plugin per le azioni di rinomina, che puoi trovare all'indirizzo cmk/post_rename_site/plugins/actions nel repository Git.

La migrazione comprende anche l'informazione su tutto ciò che non può essere migrato automaticamente.

Ecco un esempio concreto: stai utilizzando il monitoraggio distribuito e rinomini sia il sito centrale che un sito remoto.

Sito centrale: Il plug-in sites.py rileva che si tratta di un sito centrale e aggiorna, tra le altre cose, il valore URL prefix, che si trova nelle impostazioni di connessione del sito locale sotto Setup > General > Distributed Monitoring.

Sito remoto: Il plug-in warn_remote_site.py riconosce che si tratta di un sito remoto e di conseguenza indica che il sito centrale deve essere controllato e, se necessario, personalizzato manualmente. Questo significa che nelle impostazioni del monitoraggio distribuito sul sito centrale, il nuovo nome del sito remoto deve essere inserito nelle impostazioni di connessione al sito remoto rinominato - OMD ovviamente non può farlo da un computer remoto.

OMD stesso ti informa dettagliatamente sull'intera procedura nel terminale. Qui puoi vedere un esempio di messaggi di migrazione dall'output di omd cp quando si rinomina un sito centrale - separati in messaggi di successo e messaggi di avvertimento. I processi di rename action plugins sono numerati singolarmente. Prima l'output delle attività di migrazione eseguite automaticamente (qui abbreviato):

La seconda parte dell'output contiene ora suggerimenti sulle impostazioni che potresti dover configurare manualmente (qui molto abbreviati):

L'elemento Warn about configurations to review…​ include note generali su singoli aspetti che in genere devono essere rivisti manualmente durante una migrazione, come ad esempio i filtri codificati per le visualizzazioni:

Ecco una panoramica dei sei plug-in attualmente attivi: l'ordine corrisponde alla numerazione dell'output di cui sopra:

Se stai monitorando un gran numero di host con il sito, il volume di dati da copiare può essere piuttosto consistente. La maggior parte di questi è prodotta dai valori misurati archiviati nei Round Robin Database (RRD), ma anche i file di log contenenti gli eventi storici possono produrre volumi di dati più grandi.

Se lo storico non è necessario (ad esempio, perché vuoi testare rapidamente qualcosa), è possibile ometterlo dalla copia. In questi casi, le seguenti opzioni possono essere aggiunte a omd cp:

L'ordine delle opzioni è importante:

La ridenominazione di un sito si esegue con il comando omd mv. Questa operazione è simile alla copia di un sito, ha gli stessi prerequisiti e comprende anche la migrazione della configurazione. Le opzioni per limitare il volume dei dati non sono disponibili poiché i dati vengono solo spostati in un'altra directory e non vengono duplicati.

Esempio:

Quando si rinomina un sito con omd mv, il nome del sito viene modificato, ma alcuni attributi del sito non vengono modificati, tra cui l'ID del sito. Questo comando non è quindi adatto per operare su un sito che è stato duplicato, ad esempio da un backup, contemporaneamente alla sua versione originale in un monitoraggio distribuito, anche se i siti coinvolti hanno nomi diversi dopo l'esecuzione di omd mv.

Come per la creazione di un sito, la copia e la ridenominazione creano un nuovo utente Linux. Per questo motivo omd cp e omd mv hanno anche alcune delle stesse opzioni di omd create, ad es. per specificare gli ID degli utenti e dei gruppi. Per informazioni più dettagliate, usa i comandi omd cp --help e omd mv --help.

La gestione dei siti in Checkmk dispone di un meccanismo integrato per il backup e il ripristino dei siti Checkmk. I comandi omd backup e omd restore sono le basi per impacchettare tutti i dati del sito in un archivio tar e, rispettivamente, per estrarre tali dati per un ripristino.

Nota: Checkmk offre anche la possibilità di eseguire backup e ripristini senza utilizzare la riga di comando, tramite la GUI all'indirizzo Setup > Maintenance > Backups. Qui puoi anche creare backup criptati e richieste di backup programmate. Consulta l'articolo sui backup per sapere come fare.

Il backup di un sito con omd backup non richiede i permessi di root. Un utente dell'istanza può eseguirlo. Basta inserire come argomento il nome del file di backup da creare:

Nota che:

Se la directory di destinazione del backup non è scrivibile per un utente dell'istanza, puoi eseguire il backup anche come root. In questo caso è necessario un argomento aggiuntivo, come sempre, che specifichi il nome del sito di cui eseguire il backup:

Il backup contiene tutti i dati del sito, ad eccezione dei dati volatili che si trovano in ~/tmp/. Con il comando tar tzf si può facilmente dare un'occhiata al contenuto del file:

La maggior parte dei dati da spostare durante il backup di un sito sono i valori misurati e i file di log con i dati storici. Questo vale sia per il backup che per la copia di un sito. Se non hai assolutamente bisogno di questi dati, puoi ometterli e rendere così il backup molto più veloce e il file di output risultante molto più piccolo.

omd backup offre le stesse opzioni per omettere questi dati che omd cp offre per la copia. Nell'esempio seguente, il backup viene creato senza i dati di misurazione e senza la cronologia archiviata nei file di log:

Per garantire uno stato coerente dei Database Round Robin (RRD) utilizzati per registrare i dati di misurazione, il comando omd backup modifica automaticamente la cache Round Robin in una modalità in cui gli aggiornamenti in corso vengono scritti solo nel diario e non più negli RRD. I file del diario sono gli ultimi a essere sottoposti a backup: in questo modo si può ottenere che la maggior parte possibile dei dati di misurazione generati durante il backup sia inclusa nel backup.

Il ripristino di un backup è semplice come la creazione di un backup. Il comando omd restore ripristina un sito da un backup - nella versione di Checkmk utilizzata per il backup del sito. Pertanto, affinché il ripristino funzioni, questa stessa versione deve essere installata sul server Checkmk.

Il sito viene completamente svuotato e riempito. Prima di omd restore il sito deve essere fermato e successivamente deve essere riavviato:

Il ripristino può essere eseguito anche da un utente di root. A differenza di quando viene chiamato dall'utente dell'istanza, il sito verrà ricreato con il backup.

Quindi, se esiste ancora un sito con lo stesso nome, dovrai eliminarlo prima del ripristino. Questo può essere eseguito con un comando omd rm, oppure semplicemente includendo l'opzione --reuse con il comando omd restore. Un comando --kill assicura inoltre che il sito già esistente venga fermato prima di procedere al ripristino. Non è necessario specificare il nome del sito nel comando, perché è contenuto nel backup:

Come root, puoi anche ripristinare un sito con un nome diverso da quello del backup: per farlo, specifica il nome desiderato come argomento dopo la parola restore:

Il lungo elenco di conversioni che avvengono in questo caso ha la stessa funzione della copia e della ridenominazione dei siti descritta in precedenza. Il nome del sito è incluso in numerosi file di configurazione e con questa procedura tutte le occorrenze saranno sostituite automaticamente dal nuovo nome.

I comandi omd backup e omd restore, come da tradizione Unix, possono funzionare anche tramite input/output standard invece che tramite file. Al posto del percorso del file tar, è sufficiente inserire un trattino (-).

In questo modo è possibile creare una pipe e trasmettere i dati direttamente a un altro computer senza bisogno di file intermedi. Quanto più grande è il backup, tanto più vantaggioso sarà questo metodo, poiché non sarà necessario spazio temporaneo nel file system del server sottoposto a backup.

Il seguente comando esegue il backup di un sito su un altro computer utilizzando SSH:

Se vuoi annullare l'accesso SSH, cioè preferire la connessione dal server Checkmk al sito, questo è possibile, come mostra l'esempio seguente. A tal fine, è necessario prima consentire un login SSH come utente dell'istanza Checkmk.

Se sei intelligente e combini quanto sopra con un omd restore che legge i dati dallo standard input, puoi copiare un sito completo e funzionante da un file server all'altro, senza bisogno di spazio aggiuntivo per un file di backup:

E ora di nuovo il tutto con un accesso SSH annullato, questa volta dal sistema di origine a quello di destinazione: