Actualizaciones y ampliaciones

Al actualizar a una versión principal superior, siempre debes actualizar a la siguiente versión principal, y no saltarte ninguna versión principal intermedia. Si quieres actualizar de la 2.2.0 a la 2.4.0, primero actualiza a la 2.3.0. La razón de este procedimiento es sencilla: a veces hay tantos cambios entre dos versiones principales que saltarse una causaría problemas. Utiliza siempre la versión de parche más alta al actualizar.

Esto también se aplica a la versión del código fuente. Por lo tanto, una actualización de la 2.2.0p1 a la 2.4.0p24 sigue esta ruta:

2.2.0p1 2.2.0p47 2.3.0p45 2.4.0p24

El comando `omd update` también permite una «actualización» a una versión inferior. Este procedimiento solo está pensado para casos de regresión.

Tu sistema de monitorización se puede ampliar de forma bastante fácil y cómoda utilizando los paquetes de extensión de Checkmk (MKP). Por un lado, es posible que algunos MKP antiguos ya no reciban mantenimiento y, por lo tanto, puedan dejar de ser compatibles con las versiones más recientes de Checkmk. Por otro lado, seguimos añadiendo nuevos Plugins y extensiones funcionales a Checkmk, por lo que los MKP a veces quedan obsoletos. La funcionalidad de esos Plugins y extensiones ya la proporciona Checkmk de serie.

Por este motivo, al prepararte para una actualización, te recomendamos encarecidamente que revises todos los MKP instalados. Esto evitará que los paquetes incompatibles interfieran en la actualización o que, tras la misma, se dupliquen los servicios o, al menos, se creen servicios muy similares.

Para ello, compara tus MKP instalados con nuestro Catálogo de check plugins de Checkmk y elimina cualquier paquete que contenga funciones que ahora ofrece Checkmk de forma nativa. También puedes aprovechar esta oportunidad para eliminar los MKP que quizá solo se hayan instalado para una prueba. Puedes encontrar una lista en el menú «Setup» (Configuración > Extensiones), en «Maintenance > Extension packages» (Extensiones de Checkmk). En la línea de comandos, puedes mostrar las extensiones instaladas con el comando «mkp list». Revisa el resultado de este comando en busca de extensiones que ya no sean necesarias o que ni siquiera puedas identificar.

Checkmk admite la instalación de MKP para una versión más reciente que la que se está ejecutando actualmente, como preparación para futuras actualizaciones. Al realizar una actualización, el paquete de la versión anterior de Checkmk se desactiva y se activa el paquete de la versión superior. Los detalles se explican en el artículo sobre el uso de MKP.

Precaución: Si has realizado cambios locales en archivos que procedían originalmente de MKPs, vuelve a empaquetar el MKP después de aumentar el número de versión. Durante una actualización, los archivos que hayan sido modificados de cualquier otra forma serán sobrescritos por los contenidos en el MKP.

Los archivos locales te permiten personalizar y ampliar la funcionalidad que ofrece Checkmk. Estos archivos se encuentran en la parte local de la estructura de directorios del site, es decir, en ~/local. Los archivos locales pueden causar problemas al actualizar, ya que es posible que ya no sean compatibles con la nueva versión de Checkmk.

Dado que Checkmk no puede interceptar ni manejar las personalizaciones locales ni las extensiones de terceros durante una actualización, debes revisar tu site Checkmk antes de actualizar para ver si estás utilizando archivos locales y cuáles son.

Obtén una vista general de los archivos locales de tu sitio Checkmk ejecutando el siguiente comando como usuario del site (donde la opción -L garantiza que también se sigan los enlaces simbólicos):

En una instalación nueva de Checkmk, actualmente solo verás un archivo llamado README.TXT en la lista. Cualquier cosa más allá de eso debería estar en lo más alto de tu lista de resolución de problemas en caso de que tengas problemas al actualizar.

Lo ideal es que los archivos locales ya estén completamente empaquetados en MKP. Usa mkp find para identificar los archivos sin empaquetar. Para más detalles sobre la creación de paquetes, consulta nuestro artículo sobre paquetes de extensión de Checkmk. Una vez empaquetada, cada extensión se puede desactivar o reactivar como un elemento completo.

No hace falta que te recordemos la importancia de crear una copia de seguridad justo antes de cualquier actualización, para que no corras el riesgo de perder gran parte de tu historial de monitorización en caso de que se produzca un fallo durante la actualización. Lo relevante en este punto es que una copia de seguridad periódica también te puede ser muy útil para realizar pruebas de una actualización pendiente. Esta práctica te permite restaurar la copia de seguridad con un nombre alternativo y, a continuación, utilizar el site newsite para probar la actualización antes de que se active:

Como alternativa, también puedes copiar tu site a través de omd cp. Para ello, sin embargo, hay que detener el site en producción durante un breve periodo de tiempo:

A continuación, ejecuta primero la actualización en este nuevo site clonado, por ejemplo, para comprobar que los cambios locales mencionados anteriormente se han realizado en el nuevo entorno. Si las pruebas con el site clonado han sido satisfactorias, lo normal es que quieras eliminarlo o, al menos, detenerlo antes de la actualización real del site de producción por motivos de espacio y rendimiento.

Como se describe en la introducción, el primer paso para una actualización es instalar la nueva versión de Checkmk que quieras. Esto se hace exactamente igual que en la instalación inicial; sin embargo, será un poco más rápido, ya que la mayoría de los paquetes necesarios ya están instalados. En el siguiente ejemplo, vamos a instalar un paquete para Ubuntu 24.04 (Noble Numbat):

Nota: Al instalar un paquete local mediante apt install, debes indicar la ruta de descarga del archivo .deb.

Puedes ver una lista de tus versiones instaladas de Checkmk en cualquier momento con el comando omd versions:

Una de estas versiones de la lista está marcada con (default). Esta versión predeterminada se utilizará automáticamente al crear nuevos sites, siempre que no se especifique otra versión con omd -V myversion create .... La versión predeterminada actual se puede consultar con omd version, y se puede modificar con omd setversion:

La versión predeterminada no influye a la hora de gestionar sitios existentes. El comando omd siempre se ejecuta con la versión adecuada para el site para el que se invoca el comando.

El comando omd sites proporciona una lista de los sitios actuales y las versiones que utilizan:

Una vez instalada la nueva versión deseada, se puede actualizar el site. Para ello no se requieren permisos de root. La mejor forma de hacerlo es como usuario del site:

Asegúrate de que el site se ha detenido:

La actualización —que, en realidad, supone switchar a una versión diferente— ahora se puede realizar simplemente con el comando «omd update»:

Si hay más de una versión de destino disponible, se abrirá una lista de selección:

En la siguiente caja de diálogo, confirma la actualización seleccionada a la nueva versión:

Por seguridad, cuando realices una actualización de edición de una Checkmk Community a una de las ediciones comerciales al mismo tiempo que la actualización de versión, se te recordará este hecho de nuevo:

Una parte importante de una actualización es la actualización de los archivos de configuración proporcionados originalmente. Aquí, los cambios que el usuario haya podido realizar en estos archivos no se descartarán simplemente, sino que se agruparán. Esto funciona de manera muy similar a los sistemas de control de versiones, que intentan agrupar los cambios realizados en un mismo archivo simultáneamente por varios desarrolladores.

En ocasiones —cuando los cambios afectan a la misma ubicación del archivo— esto no funcionará y se producirá un conflicto. Más adelante se explica cómo resolver estos conflictos.

La actualización proporciona una lista de todos los archivos y directorios modificados (abreviada en el siguiente ejemplo):

Si aparece la línea «Completed verifying site configuration» resaltada en la salida anterior, el site se ha switchado a la nueva versión:

… y luego se puede iniciar:

El desarrollo de software, por supuesto, consiste en cambios. Como siempre estamos trabajando activamente para mantener Checkmk al día, a veces es inevitable eliminar elementos obsoletos y realizar cambios que resultan ser incompatibles. Esto significa que, al actualizar, puede que tengas que adaptar tu configuración, o al menos deberías revisarla.

Un ejemplo típico de esta situación son los nuevos check plugins que sustituyen a los plugins existentes. Si utilizas uno de los plugins afectados, será necesario realizar un nuevo descubrimiento de servicios en el host afectado.

Puedes encontrar una vista general de todos los cambios en Checkmk, incluida una función de búsqueda, en línea en nuestro Werks.

Sin embargo, aún más práctica es la función de búsqueda integrada en Checkmk. Una vez que hayas iniciado sesión en el site, encontrarás un enlace resaltado en rojo en la parte superior del menú «Help» con el número de cambios incompatibles y aún no confirmados:

Checkmk realiza un seguimiento de los cambios incompatibles que se produjeron durante la actualización a la versión actual y te pide que los revises y luego los reconozcas:

Si abres esta página a través del enlace rojo del menú «Help», solo verás los «Werk» (es decir, los cambios) para los que hay que hacer algo y que, por lo tanto, están marcados con «Incompatible - TODO». Puedes abrir cada Werk individualmente, verlo, confirmarlo con un clic del ratón y, así, reducir sucesivamente el número de cambios incompatibles pendientes. Además, el elemento de menú «Help > Change log (works)» te da acceso al historial completo de cambios de la versión principal actual.

¿Tienes curiosidad por saber qué ocurre exactamente «entre bastidores» durante una actualización? ¿O han aparecido conflictos de datos mientras se ejecuta «omd update»? Si es así, aquí tienes más información.

Durante la ejecución de «omd update» se llevan a cabo tres acciones:

¿Te gustaría automatizar las actualizaciones de software de Checkmk? Es posible que al principio tengas dificultades con las respuestas interactivas de omd update. Hay una solución sencilla para este caso. El comando tiene opciones que se han diseñado especialmente para su uso en scripts:

Los valores posibles para --conflict= son:

A continuación tienes un ejemplo del comando completo para una actualización automática a la versión 2.4.0p24.cre de mysite:

Al incluir «&&» antes de «omd start», se evitará que el site se reinicie si la omd update se interrumpe por un error. Sustituye «&&» por un punto y coma (;) si definitivamente se debe intentar el inicio incluso en tal situación.

Si estás seguro de que solo hay un site de Checkmk en ejecución en el servidor, el nombre que se va a utilizar en un script shell se puede guardar simplemente en una variable:

Esto permite que la línea anterior sea independiente del nombre del site. Por ejemplo, un pequeño script shell podría tener este aspecto:

La razón técnica del enfoque de actualización descrito anteriormente radica en los protocolos utilizados: El site central accede a los datos de los sitios remotos principalmente mediante lectura a través de Livestatus y, en el caso de una configuración central, con acceso de escritura adicional a través de una API HTTP no pública. En ambas situaciones, las nuevas versiones introducen superconjuntos reales de los protocolos utilizados. Por lo tanto, un site central más antiguo utiliza solo un subconjunto real de la funcionalidad de los sitios remotos más nuevos. Si el site central se actualizara primero, podría enviar llamadas a la API o solicitudes de Livestatus a los sitios remotos que estos aún no «entienden».

La diferencia máxima de una versión principal se debe, una vez más, a que la eliminación de interfaces va acompañada de un periodo de gracia de exactamente una versión.

Para facilitar estas actualizaciones por fases, Checkmk ofrece la posibilidad de almacenar paquetes de extensión con el mismo nombre en diferentes versiones —una que tenga una coincidencia con el site central más antiguo y otra con los sitios remotos más nuevos—, por ejemplo. Se activará la versión adecuada para cada sitio. Los detalles se describen en el artículo sobre paquetes de extensión (MKPs).

Con la extensión de sitios del visor, estos sitios solo se pueden actualizar después de los sitios cuyos datos muestran. Si un sitio del visor solo muestra datos de sitios remotos, se puede actualizar tan pronto como estos se actualicen. Si, por el contrario, también muestra datos del site central, la actualización del sitio del visor solo puede realizarse en último lugar.

Este capítulo trata principalmente de la actualización a Checkmk Pro des. También puedes actualizar a Checkmk Ultimate en un solo paso, pero en este caso, consulta también las notas de la siguiente sección.

Dado que las ediciones comerciales tienen bastantes módulos y funciones adicionales, hay algunas cosas que debes tener en cuenta tras cualquier actualización. El punto crucial es que, al crear nuevos sitios en Checkmk Community o en una de las ediciones comerciales, se establecen diferentes configuraciones predeterminadas.

En lo que respecta al core de monitorización y al sistema de notificaciones, no hay diferencias entre Checkmk Pro y Checkmk Ultimate. Dependiendo del enfoque para distribuir, a menudo solo utilizarás el conjunto de funciones más amplio al añadir nuevos hosts. Sin embargo, en algunos casos sigue siendo recomendable revisar la configuración existente.

Para obtener una vista general completa de las funcionalidades adicionales, consulta el artículo sobre Checkmk Ultimate.

Ten en cuenta que, en entornos distribuidos, siempre hay que realizar primero la actualización de la versión antes de poder pasar a la actualización de la edición. No se admite una secuencia diferente ni un crossgrade (actualización de la versión y de la edición en una sola acción). Como procedimiento general, recomendamos la actualización offline, en la que puedes pasar de cualquier edición inferior a cualquier edición superior.

Para dos escenarios de actualización muy solicitados (de Checkmk Community a Checkmk Pro y de Checkmk Pro a Checkmk Ultimate), es posible el funcionamiento mixto durante un periodo de tiempo limitado.

Para preparar la degradación de Checkmk Ultimate a Checkmk Pro, debes realizar al menos los siguientes cambios:

Además, algunos servicios en la nube y dashboards dejarán de estar disponibles. Por lo tanto, tendrás que eliminar los servicios que ya no existen.

Si en Checkmk Ultimate utilizabas el Plugin de Grafana de la «Grafana Store», tendrás que sustituirlo por uno instalado desde el archivo zip.

En el artículo sobre Checkmk Ultimate se ofrece una vista general de las diferencias entre Checkmk Ultimate y Checkmk Pro.

Para preparar el cambio de Checkmk Pro a Checkmk Community, tendrás que realizar al menos los siguientes cambios:

Además, algunos dashboards, configuraciones gráficas, Plugins de notificación y agentes especiales ya no estarán disponibles. Con el artículo de Checkmk Pro puedes determinar cuántas funcionalidades de Checkmk Pro se perderán en caso de una degradación a Checkmk Community y dónde puede que tengas que hacer ajustes adicionales.

Los escenarios de cambio a una edición inferior presentados en las dos secciones anteriores también se pueden llevar a cabo en entornos distribuidos. Ten en cuenta que, en entornos distribuidos, siempre hay que realizar primero la actualización de la versión antes de poder pasar al cambio a una edición inferior. No se admite una secuencia diferente ni un cambio cruzado (actualización de la versión y cambio a una edición inferior en una sola acción).

No existe ningún escenario de cambio a una edición anterior en el que Checkmk admita una operación mixta entre ediciones diferentes. Por este motivo, te recomendamos encarecidamente que realices el cambio a una edición anterior sin conexión. Para ello, procede de la siguiente manera:

Por supuesto, puedes esperar a que todos los sites hayan sido actualizados a una versión anterior antes de reiniciarlos, lo que reducirá en cierta medida el número de notificaciones generadas.

La desinstalación de las versiones de Checkmk que ya no se necesitan se realiza mediante el administrador de paquetes del sistema operativo. Para ello, introduce el nombre del paquete instalado, no el nombre del archivo RPM/DEB original.
Importante: ¡Elimina solo las versiones de Checkmk que ya no esté utilizando ningún site!

Los sitios de Checkmk que ya no se necesitan se pueden eliminar simplemente con «omd rm» (¡lo que también borrará todos los datos!):

Usa lo siguiente para identificar qué paquetes están instalados:

La desinstalación se realiza con «dpkg --purge»:

A continuación te explicamos cómo identificar qué paquetes de Checkmk se están utilizando en sistemas basados en RPM:

La eliminación se realiza con «rpm -e»: