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

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

Básicamente, un método consiste en actualizar sobre la marcha, 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 lleva a cabo la reinstalación del sistema básico y, finalmente, la restauración del mismo archivo, lo que a veces se conoce como ex situ. En inglés, a veces se utilizan los términos análogos in-place o out-of-place para referirse a estos dos métodos.

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

Aquí te mostraremos la actualización de versión usando el cambio de Ubuntu 22.04 (Jammy) a 24.04 (Noble) como ejemplo. Para otras distribuciones, los comandos de actualización y administrador de paquetes pueden diferir de esto en mayor o menor medida.

Nuestro sistema de ejemplo utiliza un solo sitio. Si ejecutas varios sitios en el sistema que vas a actualizar (por ejemplo, uno para producción y otro para pruebas), repite los comandos específicos de cada sitio para cada uno de ellos.

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

2. Algunas notas sobre las copias de seguridad

A los profesionales de TI no nos hace falta explicar la importancia de una copia de seguridad de datos lo suficientemente completa, cuya coherencia también se compruebe. En el escenario ideal —por ejemplo, al ejecutar Checkmk en una máquina virtual— se consigue fácilmente una copia de seguridad completa copiando imágenes del disco duro.

Como mínimo, te recomendamos:

  • Crear una copia de seguridad utilizando las herramientas que ofrece Checkmk, ya sea a través de la línea de comandos con el comando omd o mediante la configuración. Esto se puede hacer de forma preventiva mientras el sistema sigue en funcionamiento.

  • Una copia de seguridad del contenido de /opt/omd/sites utilizando las herramientas del sistema operativo después de detener el sitio y desmontar el sistema de archivos específico del sitio /tmp. Esto se puede hacer durante la actualización.

Mantén la copia de seguridad separada de la máquina que se va a actualizar y comprueba la copia de seguridad antes de realizar los primeros cambios en el sistema productivo.

Si elegiste un sistema de archivos de copia en escritura (copy-on-write) como ZFS o BTRFS al instalar el servidor Checkmk, deberías tomar instantáneas antes de actualizar. Estas 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 la actualización falla.

3. Actualización in situ

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

3.1. Preparación

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

  1. Primero, hazte una vista general de todas las versiones de Checkmk instaladas actualmente…​

    root@linux# omd versions
    2.4.0p1.cee
    2.4.0p2.cee (default)
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  2. …​ y luego qué versiones se están utilizando realmente:

    root@linux# omd sites
    SITE      VERSION        COMMENTS
    mysite    2.4.0p2.cee    default version
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

    Para ello, tendrás que descargar los paquetes de instalación de 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 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 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) ...
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

3.2. Ejecución

Y ahora viene la fase crítica, durante la cual el servidor Checkmk no estará disponible.

  1. Detén tu site Checkmk:

    root@linux# omd stop mysite
    Copia los comandos al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  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
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  3. Ahora puedes desinstalar Checkmk. En este caso, conservarás los archivos de configuración existentes:

    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*
    ...
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  4. Realiza la actualización de Linux siguiendo las instrucciones proporcionadas por el distribuidor correspondiente. En el caso de Ubuntu, sería:

    root@linux# do-release-upgrade
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

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

  5. Desregistra el 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
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  6. Ahora instala el paquete de Checkmk que corresponda a 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.4.0p2_0.noble_amd64.deb
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

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

  7. Reinicia tu site Checkmk:

    root@linux# omd start mysite
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

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

Este método suele ser útil cuando usas Checkmk en entornos virtualizados, en los que, como preparación, puedes «montar» un segundo servidor con la nueva versión de la distribución y realizar pruebas iniciales con él en una operación paralela. Además, la flexibilidad de este enfoque es mayor, ya que 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 importante es descargar el paquete de instalación de Checkmk adecuado para la nueva versión de la distribución.

Consigue una vista general de las versiones de Checkmk que utilizan actualmente los sitios:

root@linux# omd sites
SITE      VERSION        COMMENTS
mysite    2.4.0p2.cee    default version
Copiar comando(s) al portapapeles
¡Comandos copiados correctamente al portapapeles!
¡Se ha denegado el acceso de escritura al portapapeles!

Según la información de los sitios, 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 se muestran aquí en secuencia, a menudo se pueden realizar 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 la adquisición de nuevo hardware.

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

    root@linux# omd stop mysite
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  2. Crea un archivo (en otros contextos, una copia de seguridad) del site. En nuestro ejemplo se 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
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  3. Ahora prepara el sistema de destino y configura allí el software necesario para Checkmk, por ejemplo, el sistema de correo electrónico. Usa el mismo nombre del host y la misma dirección IP que en el sistema de origen.

  4. Instala la versión de Checkmk que descargaste anteriormente, adecuada para la nueva distribución.

    En el caso de Ubuntu, en este punto bastará con el siguiente comando:

    root@linux# apt install /tmp/check-mk-enterprise-2.4.0p2_0.noble_amd64.deb
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  5. Crea un nuevo site con el mismo nombre que el site del que has hecho la copia de seguridad:

    root@linux# omd create --admin-password t0p53cr3t mysite
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  6. Ahora, como usuario del site, realiza una restauración desde el archivo:

    OMD[mysite]:~$ omd restore /mnt/someshare/mysite.tgz
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!
  7. Reinicia tu site Checkmk:

    OMD[mysite]:~$ omd start
    Copiar comando(s) al portapapeles
    ¡Comandos copiados correctamente al portapapeles!
    ¡Se ha denegado el acceso de escritura al portapapeles!

Last modified: Thu, 15 Jan 2026 09:55:58 GMT via commit 64178e032
En esta página