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. Introduction

Il existe plusieurs méthodes recommandées pour mettre à niveau la version de la distribution Linux sur un serveur Checkmk. Le choix de la méthode la plus adaptée dépend des capacités de votre environnement informatique, de l'inventaire des données sur l'installation Checkmk et de la période de maintenance prévue. Nous vous présentons ici les différentes méthodes ainsi que leurs exigences respectives.

Essentiellement, l’une des méthodes consiste à effectuer la mise à jour sur place, parfois appelée « in situ » (du latin). L’autre méthode utilise une sauvegarde comme archive, sur laquelle s’effectuent la réinstallation du système de base et, enfin, la restauration de cette même archive, parfois appelée « ex situ ». En anglais, les termes analogues « in-place » ou « out-of-place » sont parfois utilisés pour désigner ces deux méthodes.

Des combinaisons des méthodes présentées ici sont également possibles, par exemple si vous avez placé /opt/omd ou /opt/omd/sites sur un point de montage distinct.

Nous allons ici vous montrer comment effectuer la mise à niveau de version en prenant comme exemple le passage d'Ubuntu 22.04 (Jammy) à 24.04 (Noble). Pour d'autres distributions, les instructions de mise à niveau et de gestion des paquets peuvent différer de celles-ci dans une mesure plus ou moins grande.

Notre système d'exemple n'utilise qu'une seule instance. Si vous gérez plusieurs instances sur le système à mettre à niveau (par exemple, une pour la production et une pour les tests), répétez les instructions spécifiques à chaque instance pour chacune d'entre elles.

Si vous souhaitez ou devez combiner une mise à niveau de version de la distribution Linux avec une mise à jour de version de Checkmk (par exemple parce qu’une ancienne version de Checkmk n’est plus proposée pour une version plus récente de la distribution Linux), utilisez notre matrice de mise à jour pour déterminer l’ordre approprié à suivre.

2. Quelques remarques sur les sauvegardes

En tant que professionnels de l’informatique, nous n’avons pas vraiment besoin d’expliquer l’importance d’une sauvegarde des données suffisamment complète, dont la cohérence est également vérifiée. Dans le scénario idéal — par exemple, lorsque Checkmk est exécuté dans une machine virtuelle —, une sauvegarde complète s’effectue facilement en copiant des images de disque dur.

Au minimum, nous recommandons :

  • De créer une sauvegarde à l’aide des outils fournis par Checkmk, soit via la ligne de commande à l’aide de l’instruction omd, soit via la configuration. Cette opération peut être effectuée à titre de préparation pendant que le système est encore en cours d’exécution.

  • Une sauvegarde du contenu de `/opt/omd/sites` à l'aide des outils du système d'exploitation après avoir arrêté l'instance et démonté le système de fichiers `/tmp` spécifique à l'instance. Cette opération peut être effectuée pendant la mise à niveau.

Conservez la sauvegarde séparément de la machine en cours de mise à niveau et testez-la avant d'apporter les premières modifications au système productif.

Si vous avez choisi un système de fichiers de type « copy-on-write » (copie à l'écriture) tel que ZFS ou BTRFS lors de l'installation du serveur Checkmk, vous devriez effectuer des snapshots avant la mise à niveau. Ceux-ci ne remplacent pas une sauvegarde stockée séparément, mais peuvent contribuer à réduire considérablement la période de maintenance lors de la restauration du système à sa condition d'origine si la mise à niveau échoue.

3. Mise à niveau sur place

Cette méthode s’avère souvent utile lorsque l’on utilise Checkmk sur du matériel dédié avec des ensembles de données volumineux, où le fait de copier une archive dans les deux sens pour la restaurer augmenterait considérablement la période de maintenance.

3.1. Préparation

La préparation consiste principalement à supprimer tous les paquets Checkmk qui sont déjà redondants. Vous éviterez ainsi les problèmes de gestion des paquets lors de la mise à niveau proprement dite. De plus, vous devriez avoir déjà téléchargé le paquet d'installation Checkmk adapté à la nouvelle version de la distribution.

  1. Commencez par obtenir un aperçu de toutes les versions de Checkmk actuellement installées…​

    root@linux# omd versions
    2.4.0p1.cee
    2.4.0p2.cee (default)
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  2. …​ puis des versions qui sont effectivement utilisées :

    root@linux# omd sites
    SITE      VERSION        COMMENTS
    mysite    2.4.0p2.cee    default version
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

    Pour cela, vous devrez télécharger les paquets d'installation de la nouvelle version du système d'exploitation. Important : l'édition et le numéro de version de Checkmk doivent être exactement les mêmes que ceux utilisés jusqu'à présent.

  3. Désinstallez maintenant toutes les versions inutilisées de Checkmk. Dans l’instruction suivante, le paramètre « --purge » garantit que les anciens fichiers de configuration sont également supprimés.

    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) ...
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

3.2. Exécution

Et maintenant, place à la phase critique, pendant laquelle le serveur Checkmk n'est pas disponible.

  1. Arrêtez votre instance Checkmk :

    root@linux# omd stop mysite
    Copiez les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  2. Renommez le lien symbolique pointant vers l'installation Checkmk que vous utilisez. L'instruction suivante le fait passer de version à _version :

    root@linux# mv -v /opt/omd/sites/mysite/{,_}version
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  3. Vous pouvez désormais désinstaller Checkmk. Dans ce cas, vous conservez les fichiers de configuration existants :

    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*
    ...
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  4. Effectuez la mise à niveau de Linux en suivant les instructions fournies par le distributeur concerné. Dans le cas d'Ubuntu, cela donnerait :

    root@linux# do-release-upgrade
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

    Si un redémarrage est recommandé, suivez cette recommandation avant de passer à l'étape suivante.

  5. Désenregistrez le lien symbolique pointant vers l'installation Checkmk que vous utilisez. L'instruction suivante permet de le faire passer de _version à version :

    root@linux# mv -v /opt/omd/sites/mysite/{_,}version
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  6. Installez maintenant le paquet Checkmk correspondant à la nouvelle version de la distribution que vous utilisez. Dans le cas d'Ubuntu, l'instruction suivante suffit à ce stade :

    root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

    Lors de la réinstallation de Checkmk, suivez les instructions d'installation détaillées correspondant à votre distribution.

  7. Redémarrez votre instance Checkmk :

    root@linux# omd start mysite
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

4. Archivage, réinstallation et restauration (mise à niveau hors site)

Cette méthode s’avère souvent utile lors de l’utilisation de Checkmk dans des environnements virtualisés, où il est possible, à titre de préparation, de « déployer » un deuxième serveur avec la nouvelle version de la distribution et d’effectuer les premiers tests avec celui-ci en parallèle. De plus, cette approche offre une plus grande flexibilité, car elle permet également de changer simultanément de distribution Linux. Techniquement, cela correspond à la procédure à suivre en cas de panne du système.

4.1. Préparation

L'étape préparatoire la plus importante consiste à télécharger le paquet d'installation Checkmk adapté à la nouvelle version de la distribution.

Obtenez un aperçu des versions de Checkmk actuellement utilisées par les instances :

root@linux# omd sites
SITE      VERSION        COMMENTS
mysite    2.4.0p2.cee    default version
Copier les instructions dans le presse-papiers
Instruction(s) copiée(s) avec succès dans le presse-papiers !
L'accès en écriture au presse-papiers a été refusé !

En fonction des informations relatives à l'instance(s), vous devrez télécharger les paquets d'installation adaptés à la nouvelle version du système d'exploitation.

Important : l'édition et le numéro de version de Checkmk doivent être exactement les mêmes que ceux utilisés précédemment.

4.2. Exécution

Les étapes, présentées ici dans l'ordre, peuvent souvent être effectuées en partie en parallèle, ce qui permet de réduire au minimum les périodes de maintenance, par exemple lorsque vous utilisez des machines virtuelles ou si l'acquisition d'un nouveau matériel est de toute façon prévue.

  1. Arrêtez votre instance Checkmk — cette étape n'est pas obligatoire, mais elle est recommandée pour garantir la cohérence des données :

    root@linux# omd stop mysite
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  2. Créez une archive (ou une sauvegarde dans d'autres contextes) de l'instance. Notre exemple utilise un partage réseau comme destination, qui sera également disponible ultérieurement sur la nouvelle installation.

    OMD[mysite]:~$ omd backup /mnt/someshare/mysite.tgz
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  3. Préparez maintenant le système cible et configurez-y les logiciels requis pour Checkmk, par exemple le système de courrier électronique. Utilisez le même nom de domaine et l'adresse IP que pour le système source.

  4. Installez la version de Checkmk téléchargée précédemment, adaptée à la nouvelle distribution.

    Dans le cas d'Ubuntu, l'instruction suivante suffira à ce stade :

    root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  5. Créez une nouvelle instance portant le même nom que l’instance sauvegardée :

    root@linux# omd create --admin-password t0p53cr3t mysite
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  6. À présent, en tant qu'utilisateur de l'instance, effectuez une restauration à partir de l'archive :

    OMD[mysite]:~$ omd restore /mnt/someshare/mysite.tgz
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !
  7. Redémarrez votre instance Checkmk :

    OMD[mysite]:~$ omd start
    Copier les instructions dans le presse-papiers
    Instruction(s) copiée(s) avec succès dans le presse-papiers !
    L'accès en écriture au presse-papiers a été refusé !

Last modified: Thu, 15 Jan 2026 09:55:58 GMT via commit 64178e032
Sur cette page