Checkmk
to checkmk.com
Important

This is a machine translation based on the English version of the article. It might or might not have already been subject to text preparation. If you find errors, please file a GitHub issue that states the paragraph that has to be improved.

1. Introduzione

Esistono diversi metodi consigliati per aggiornare la versione della distribuzione Linux su un server Checkmk. Quale sia quello giusto per te dipende dalle capacità del tuo ambiente IT, dall'inventario dei dati presenti nell'installazione di Checkmk e dal tempo di manutenzione programmata previsto. Qui ti presentiamo i vari metodi con i rispettivi requisiti.

In sostanza, un metodo consiste nell'aggiornamento in loco, talvolta indicato come in situ (dal latino). L'altro metodo utilizza un backup come archivio, sul quale avviene la reinstallazione del sistema di base e infine il ripristino dello stesso archivio, talvolta indicato come ex situ. In inglese, per questi due metodi vengono talvolta utilizzati i termini analoghi in-place o out-of-place.

Sono possibili anche combinazioni dei metodi qui presentati, ad esempio se hai posizionato /opt/omd o /opt/omd/sites su un mount point separato.

Qui mostreremo l'aggiornamento della versione usando come esempio il passaggio da Ubuntu 22.04 (Jammy) a 24.04 (Noble). Per altre distribuzioni, i comandi di aggiornamento e gestione dei pacchetti potrebbero differire da questi in misura maggiore o minore.

Il nostro sistema di esempio utilizza un solo sito. Se sul sistema da aggiornare sono in esecuzione più istanze (ad esempio, una per la produzione e una per i test), ripeti i comandi specifici per ciascuna istanza.

Se vuoi o devi combinare un aggiornamento della versione della distribuzione Linux con un aggiornamento di Checkmk (ad esempio perché una versione precedente di Checkmk non è più disponibile per una versione più recente della distribuzione Linux), usa la nostra matrice di aggiornamento per determinare l'ordine corretto da seguire.

2. Alcune note sui backup

Noi professionisti IT non abbiamo davvero bisogno di spiegare l'importanza di un backup dei dati sufficientemente completo, che venga anche verificato per garantirne la coerenza. Nello scenario ideale — ad esempio, quando si esegue Checkmk in una macchina virtuale — è facile ottenere un backup completo copiando le immagini del disco rigido.

Come minimo, ti consigliamo di:

  • Creare un backup utilizzando gli strumenti forniti da Checkmk, tramite la riga di comando con il comando omd o tramite il Setup. Questo può essere fatto in preparazione mentre il sistema è ancora in esecuzione.

  • Un backup del contenuto di /opt/omd/sites utilizzando gli strumenti del sistema operativo dopo aver arrestato l'istanza e smontato il file system /tmp specifico dell'istanza. Questo può essere fatto durante l'aggiornamento.

Tieni il backup separato dalla macchina che stai aggiornando e verifica il backup prima di apportare le prime modifiche al sistema di produzione.

Se hai scelto un file system copy-on-write come ZFS o BTRFS durante l'installazione del server Checkmk, dovresti creare delle istantanee prima dell'aggiornamento. Questi non sostituiscono un backup archiviato separatamente, ma possono aiutare a ridurre significativamente il tempo di manutenzione programmata quando si effettua il ripristino del sistema alle condizioni originali se l'aggiornamento fallisce.

3. Aggiornamento in loco

Questo metodo è spesso utile quando si utilizza Checkmk su hardware dedicato con grandi set di dati, dove copiare un archivio avanti e indietro per effettuare il ripristino aumenterebbe significativamente il tempo di manutenzione programmata.

3.1. Preparazione

La preparazione consiste principalmente nel rimuovere tutti i pacchetti Checkmk che sono già ridondanti. In questo modo puoi evitare problemi di gestione dei pacchetti durante l'aggiornamento vero e proprio. Inoltre, dovresti aver già effettuato lo scaricamento del pacchetto di installazione Checkmk corretto per la nuova versione della distribuzione.

  1. Per prima cosa, ottieni una panoramica di tutte le versioni di Checkmk attualmente installate…​

    root@linux# omd versions
    2.4.0p1.cee
    2.4.0p2.cee (default)
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  2. …​ e poi quali versioni sono effettivamente in uso:

    root@linux# omd sites
    SITE      VERSION        COMMENTS
    mysite    2.4.0p2.cee    default version
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

    Per questi dovrai effettuare lo scaricamento dei pacchetti di installazione per la nuova versione del sistema operativo. Importante: l'edizione e il numero di versione di Checkmk devono essere esattamente gli stessi di quelli utilizzati finora.

  3. Ora disinstalla tutte le versioni di Checkmk inutilizzate. Nel comando seguente, il parametro --purge assicura che vengano cancellati anche i vecchi file di configurazione.

    root@linux# apt purge -y check-mk-enterprise-2.4.0p1
    Reading package lists... Done
    Building dependency tree... Done
    Reading state information... Done
    The following packages will be REMOVED:
      check-mk-enterprise-2.4.0p1*
    0 upgraded, 0 newly installed, 1 to remove and 8 not upgraded.
    After this operation, 1321 MB disk space will be freed.
    (Reading database ... 183773 files and directories currently installed.)
    Removing check-mk-enterprise-2.4.0p1 (0.jammy) ...
    (Reading database ... 127417 files and directories currently installed.)
    Purging configuration files for check-mk-enterprise-2.4.0p1 (0.jammy) ...
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

3.2. Esecuzione

E ora passiamo alla fase critica, durante la quale il server Checkmk non è disponibile.

  1. Arresta la tua istanza Checkmk:

    root@linux# omd stop mysite
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  2. Rinomina il soft link che punta all'installazione di Checkmk che stai utilizzando. Il seguente comando lo cambia da version a _version:

    root@linux# mv -v /opt/omd/sites/mysite/{,_}version
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  3. Ora puoi effettuare la disinstallazione di Checkmk. In questo caso manterrai i file di configurazione esistenti:

    root@linux# apt remove -y check-mk-enterprise-2.4.0p2
    Reading package lists... Done
    Building dependency tree... Done
    Reading state information... Done
    The following packages will be REMOVED:
      check-mk-enterprise-2.4.0p2*
    ...
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  4. Esegui l'aggiornamento di Linux seguendo le istruzioni fornite dal rispettivo distributore. Nel caso di Ubuntu, sarebbe:

    root@linux# do-release-upgrade
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

    Se viene consigliato un riavvio, segui la raccomandazione prima di passare al passaggio successivo.

  5. Rimuovi il soft link che punta all'installazione di Checkmk che stai utilizzando. Il seguente comando lo riporta da _version a version:

    root@linux# mv -v /opt/omd/sites/mysite/{_,}version
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  6. Ora effettua l'installazione del pacchetto di Checkmk corrispondente alla nuova versione della distribuzione che stai utilizzando. Nel caso di Ubuntu, a questo punto è sufficiente il seguente comando:

    root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

    Quando reinstalli Checkmk, segui le istruzioni di installazione dettagliate relative alla tua distribuzione specifica.

  7. Riavvia la tua istanza Checkmk:

    root@linux# omd start mysite
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

4. Archiviazione, reinstallazione e ripristino (aggiornamento fuori sede)

Questo metodo è spesso utile quando si utilizza Checkmk in ambienti virtualizzati, nei quali, come preparazione, è possibile "avviare" un secondo server con la nuova versione della distribuzione ed eseguire i test iniziali con questo in un'operazione parallela. Inoltre, la flessibilità di questo approccio è maggiore, poiché è possibile cambiare contemporaneamente anche la distribuzione Linux. Tecnicamente, ciò corrisponde alla procedura da seguire in caso di guasto del sistema.

4.1. Preparazione

Il passo preparatorio più importante è l'scaricamento del pacchetto di installazione Checkmk appropriato per la nuova versione della distribuzione.

Ottieni una panoramica delle versioni di Checkmk attualmente utilizzate dalle istanze:

root@linux# omd sites
SITE      VERSION        COMMENTS
mysite    2.4.0p2.cee    default version
Copia i comandi negli appunti
Comandi copiati con successo negli appunti!
L'accesso in scrittura agli appunti è stato negato!

In base alle informazioni relative all'istanza o alle istanze, dovrai effettuare lo scaricamento dei pacchetti di installazione appropriati per la nuova versione del sistema operativo.

Importante: l'edizione e il numero di versione di Checkmk devono essere esattamente gli stessi di quelli utilizzati in precedenza.

4.2. Esecuzione

I passaggi, qui mostrati in sequenza, possono spesso essere eseguiti in parte in parallelo, il che aiuta a ridurre il tempo di manutenzione programmata, ad esempio quando si utilizzano macchine virtuali o se è comunque previsto l'acquisto di nuovo hardware.

  1. Arresta la tua istanza Checkmk — qui questo passaggio non è obbligatorio, ma è consigliato per garantire la coerenza dei dati:

    root@linux# omd stop mysite
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  2. Crea un archivio (in altri contesti un backup) dell'istanza. Il nostro esempio utilizza una condivisione di rete come destinazione, che sarà disponibile anche in seguito sulla nuova installazione.

    OMD[mysite]:~$ omd backup /mnt/someshare/mysite.tgz
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  3. Ora prepara il sistema di destinazione e configura lì il software necessario per Checkmk, ad esempio il sistema di e-mail. Usa lo stesso nome host e lo stesso indirizzo IP del sistema di origine.

  4. Esegui l'installazione della versione di Checkmk scaricata in precedenza, adatta alla nuova distribuzione.

    Nel caso di Ubuntu, a questo punto sarà sufficiente il seguente comando:

    root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  5. Crea una nuova istanza con lo stesso nome dell'istanza di cui hai eseguito il backup:

    root@linux# omd create --admin-password t0p53cr3t mysite
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  6. Ora, come utente dell’istanza, esegui un ripristino dall’archivio:

    OMD[mysite]:~$ omd restore /mnt/someshare/mysite.tgz
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!
  7. Riavvia la tua istanza Checkmk:

    OMD[mysite]:~$ omd start
    Copia i comandi negli appunti
    Comandi copiati con successo negli appunti!
    L'accesso in scrittura agli appunti è stato negato!

Last modified: Thu, 15 Jan 2026 09:55:58 GMT via commit 64178e032
In questa pagina