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. Introducción

Existen varios métodos recomendados para actualizar la versión de la distribución Linux en un servidor Checkmk. Cuál es el más adecuado para ti depende de las capacidades de tu entorno informático, del inventario de datos de la instalación Checkmk y del tiempo de mantenimiento previsto. Aquí presentamos los distintos métodos con sus respectivos requisitos.

Básicamente, un método consiste en actualizar in situ, lo que a veces se denomina in situ (del latín). El otro método utiliza una copia de seguridad como archivo, sobre el que se realiza la reinstalación del sistema básico y, finalmente, la restauración del mismo archivo, lo que a veces se denomina ex situ. En inglés, a veces se utilizan los términos análogos in-place, o out-of-place para estos dos métodos.

También son posibles combinaciones de los métodos presentados aquí, por ejemplo, si has colocado /opt/omd o /opt/omd/sites en un punto de montaje distinto.

Demostraremos aquí la actualización de versiones utilizando como ejemplo el cambio de Ubuntu 20.04 (Focal) a 22.04 (Jammy). Para otras distribuciones, los comandos de actualización y administrador de paquetes pueden diferir de éste en mayor o menor medida.

Nuestro sistema de ejemplo utiliza un único site. Si tienes varios sites en el sistema que vas a actualizar (por ejemplo, uno para producción y otro para pruebas), repite los comandos específicos de site adecuados para cada uno.

Si quieres o necesitas combinar una actualización de la versión de la distribución de Linux con una actualización de la versión de Checkmk (por ejemplo, porque una versión anterior de Checkmk ya no se ofrece para una versión más reciente de la distribución de Linux), utiliza nuestra matriz de actualización para determinar el orden adecuado en que debe realizarse.

2. Algunas notas sobre las copias de seguridad

Los profesionales informáticos no necesitamos explicar la importancia de una copia de seguridad de los datos suficientemente completa, cuya coherencia también se compruebe. En el escenario ideal -por ejemplo, cuando se ejecuta Checkmk en una máquina virtual-, una copia de seguridad completa se consigue fácilmente copiando imágenes del disco duro.

Como mínimo, recomendamos

  • Crear una copia de seguridad utilizando las herramientas proporcionadas por Checkmk, ya sea a través de la línea de comandos mediante el comandoomd o a través del Setup. Esto se puede hacer en la preparación mientras el sistema sigue funcionando.

  • Una copia de seguridad del contenido de /opt/omd/sites utilizando las herramientas del sistema operativo tras detener el site y desmontar el sistema de archivos /tmp específico del site. Esto puede hacerse durante la actualización.

Mantén la copia de seguridad separada de la máquina que se está actualizando y prueba la copia de seguridad antes de hacer los primeros cambios en el sistema productivo.

Si elegiste un sistema de archivos de copia en escritura como ZFS o BTRFS cuando instalaste el servidor Checkmk, debes hacer instantáneas antes de actualizar. Éstas no sustituyen a una copia de seguridad almacenada por separado, pero pueden ayudar a reducir significativamente el tiempo de mantenimiento al restaurar el sistema a su condición original si falla la actualización.

3. Actualizar in situ

Este método suele ser útil cuando se utiliza Checkmk en hardware dedicado con grandes conjuntos de datos, donde copiar un archivo de un lado a otro para restaurarlo aumentaría significativamente el tiempo de mantenimiento.

3.1. Preparación

La preparación consiste principalmente en eliminar todos los paquetes de Checkmk que ya sean redundantes. De este modo evitarás problemas de gestión de paquetes durante la actualización real. Además, ya deberías haber descargado el paquete de instalación de Checkmk correcto para la nueva versión de distribución.

  1. Primero obtén una vista general de todas las versiones de Checkmk instaladas actualmente...

    root@linux# omd versions
    2.2.0p25.cre
    2.3.0p1.cee
    2.3.0p2.cee (default)
  2. ... y luego qué versiones están realmente en uso:

    root@linux# omd sites
    SITE      VERSION        COMMENTS
    mysite    2.3.0p2.cee    default version

    Para ellas tendrás que descargar los paquetes de instalación para la nueva versión del sistema operativo. Importante: El número de edición y versión de Checkmk debe ser exactamente el mismo que el utilizado hasta ahora.

  3. Ahora desinstala todas las versiones de Checkmk que no utilices. En el siguiente comando, el parámetro --purge garantiza que también se borren los archivos de configuración antiguos.

    root@linux# apt-get remove --purge -y check-mk-enterprise-2.3.0p1
    Reading package lists... Done
    Building dependency tree
    Reading state information... Done
    The following packages will be REMOVED:
      check-mk-enterprise-2.3.0p1*
    0 upgraded, 0 newly installed, 1 to remove and 1 not upgraded.
    After this operation, 884 MB disk space will be freed.
    (Reading database ... 125980 files and directories currently installed.)
    Removing check-mk-enterprise-2.3.0p1 (0.focal) ...
    (Reading database ... 89444 files and directories currently installed.)
    Purging configuration files for check-mk-enterprise-2.3.0p1 (0.focal) ...
    Processing triggers for systemd (245.4-4ubuntu3.21) ...

3.2. Ejecución

Y ahora la fase caliente, durante la cual el servidor Checkmk no está disponible.

  1. Detén tu site Checkmk:

    root@linux# omd stop mysite
  2. Cambia el nombre del soft link que apunta a la instalación de Checkmk que estás utilizando. El siguiente comando lo cambia de version a _version:

    root@linux# mv -v /opt/omd/sites/mysite/{,_}version
  3. Ahora puedes desinstalar Checkmk. En este caso conservas los archivos de configuración existentes:

    root@linux# apt-get remove -y check-mk-enterprise-2.3.0p2
    Reading package lists... Done
    Building dependency tree
    Reading state information... Done
    The following packages will be REMOVED:
      check-mk-enterprise-2.3.0p2*
    ...
  4. Realiza la actualización de Linux según las instrucciones proporcionadas por el respectivo distribuidor, que en el caso de Ubuntu serían:

    root@linux# do-release-upgrade

    Si se recomienda un reinicio, sigue la recomendación antes de continuar con el siguiente paso.

  5. Da de baja el soft link que apunta a la instalación de Checkmk que estás utilizando. El siguiente comando lo cambia de nuevo de _version a version:

    root@linux# mv -v /opt/omd/sites/mysite/{_,}version
  6. Instala ahora el paquete de Checkmk que coincida con la nueva versión de la distribución que estés utilizando. En el caso de Ubuntu, el siguiente comando es suficiente en este punto:

    root@linux# apt install /tmp/check-mk-enterprise-2.3.0p2_0.jammy_amd64.deb

    Cuando reinstales Checkmk, sigue las instrucciones detalladas de instalación correspondientes a tu distribución concreta.

  7. Reinicia tu site Checkmk:

    root@linux# omd start mysite

4. Archivar, reinstalar y restaurar (actualización fuera de lugar)

Este método suele ser útil cuando se utiliza Checkmk en entornos virtualizados, en los que, como preparación, es posible "arrancar" un segundo servidor con la nueva versión de distribución y realizar con él las pruebas iniciales en una operación paralela. Además, la flexibilidad de este método es mayor, porque también es posible cambiar simultáneamente la distribución de Linux. Técnicamente, esto se corresponde con el procedimiento en caso de fallo del sistema.

4.1. Preparación

El paso preparatorio más esencial es descargar el paquete de instalación de Checkmk adecuado para la nueva versión de distribución.

Obtén una Vista general de las versiones de Checkmk que utilizan actualmente los sites:

root@linux# omd sites
SITE      VERSION        COMMENTS
mysite    2.3.0p2.cee    default version

Basándote en la información del site o sites, tendrás que descargar los paquetes de instalación adecuados para la nueva versión del sistema operativo.

Importante: La edición y el número de versión de Checkmk deben ser exactamente los mismos que los utilizados anteriormente.

4.2. Ejecución

Los pasos, que aquí se muestran en secuencia, a menudo pueden realizarse parcialmente en paralelo, lo que ayuda a minimizar el tiempo de mantenimiento, por ejemplo, cuando se utilizan máquinas virtuales o si de todos modos está prevista una nueva adquisición de hardware.

  1. Detén tu site Checkmk - aquí este paso no es obligatorio, pero se recomienda para mantener la coherencia de los datos:

    root@linux# omd stop mysite
  2. Crea un archivo (en otros contextos, una copia de seguridad) del site. Nuestro ejemplo utiliza un recurso compartido de red como destino, que también estará disponible más adelante en la nueva instalación.

    OMD[mysite]:~$ omd backup /mnt/someshare/mysite.tgz
  3. Ahora prepara el sistema de destino, y configura allí el software necesario para Checkmk, por ejemplo, el sistema de correo electrónico. Utiliza el mismo nombre del host y la misma dirección IP que en el sistema de origen.

  4. Instala la versión de Checkmk descargada previamente, adecuada para la nueva distribución.

    En el caso de Ubuntu, el siguiente comando será suficiente en este punto:

    root@linux# apt install /tmp/check-mk-enterprise-2.3.0p2_0.jammy_amd64.deb
  5. Crea un nuevo site con el mismo nombre que el site del que se ha hecho la copia de seguridad:

    root@linux# omd create mysite
  6. Ahora, como usuario del site, realiza una restauración desde el archivo:

    OMD[mysite]:~$ omd restore /mnt/someshare/mysite.tgz
  7. Reinicia tu site Checkmk:

    OMD[mysite]:~$ omd start
En esta página