Actualización a la versión {current-major}

Las actualizaciones de Checkmk siempre deben realizarse desde la última versión de parche de la versión de origen hasta la última versión de parche de la versión de destino. Por lo tanto, una actualización de la 2.3.0p1 a la 2.4.0p24 sigue esta ruta:

2.3.0p1 2.3.0p45 2.4.0p24

No se pueden saltar versiones principales. Si quieres actualizar de la 2.2.0 a la 2.4.0, primero realiza una actualización a la versión 2.3.0.

Al igual que con cualquier actualización de software de producción, debes comprobar que tus copias de seguridad estén actualizadas antes de realizar la actualización de Checkmk.

¿Te afecta esto? Sí.

¿Qué tendrás que hacer? Si creas tus copias de seguridad automáticamente a través de Setup > Maintenance > Backups, check allí que tus copias de seguridad estén actualizadas y que los jobs de copia de seguridad más recientes se hayan completado sin errores.

Para más información, consulta los artículos sobre Copias de seguridad y sobre Cómo hacer copias de seguridad y restaurar sites.

Checkmk 2.4.0 requiere unos recursos del sistema ligeramente superiores a los de 2.3.0. Por lo tanto, es recomendable averiguar antes de actualizar qué capacidad libre tienen aún los servidores utilizados para Checkmk.

¿Te afecta esto? Sí, pero el grado en que te afecte depende en gran medida de cómo utilices Checkmk.

¿Qué tendrás que hacer? Asegúrate de que haya suficiente capacidad libre disponible. Para obtener información sobre los cambios previstos en el uso de los recursos de hardware, consulta la siguiente tabla:

Algunas distribuciones obsoletas dejarán de ser compatibles con la versión 2.4.0 de Checkmk.

¿Te afecta esto? Esto te afectará si alguna de las siguientes distribuciones de Linux —que aún son compatibles con la versión 2.3.0— está instalada en tu servidor Checkmk:

Checkmk 2.4.0 utiliza nuevas funciones de JavaScript que no están disponibles en navegadores antiguos. En los requisitos del sistema puedes consultar qué navegadores son compatibles y en qué versiones.

¿Te afecta esto? Normalmente tendrás habilitadas las actualizaciones automáticas a la última versión en los sistemas de escritorio.

¿Qué tienes que hacer? Check la versión del navegador que estás utilizando e instala uno más reciente si es necesario. Si utilizas ordenadores de placa única, televisores inteligentes o soluciones de señalización digital para mostrar dashboards y no tienes control sobre el navegador del sistema, comprueba que todos los dashboards necesarios se muestren correctamente antes de actualizar. Si es necesario, ponte en contacto con el fabricante del hardware para obtener actualizaciones.

Hasta Checkmk 2.2.0, todos los usuarios de automatización podían iniciar sesión con un nombre de usuario y una contraseña pasados a través de parámetros GET. Esta opción se ha reducido a partir de Checkmk 2.3.0 y se eliminará por completo en la versión 2.5.0 (Werk #16223). A medio plazo, por lo tanto, debes switchar tus scripts a la autenticación mediante encabezados HTTP.

En primer lugar, 2.3.0 hizo que la opción de iniciar sesión mediante el parámetro GET fuera configurable. Sin embargo, la configuración global Enable automation user authentication via HTTP parameters utilizaba inicialmente on como valor predeterminado. En Checkmk 2.4.0, el valor predeterminado cambia ahora a off.

¿Te afecta esto? Este cambio afecta principalmente a los usuarios que visualizan dashboards utilizando ordenadores de placa única, televisores inteligentes o soluciones de señalización digital sin un teclado con conexión.

¿Qué tendrás que hacer? Si utilizas el inicio de sesión automático mediante parámetros GET, debes cambiar la configuración global Automation user authentication via HTTP parameters a on. Dado que la opción de iniciar sesión mediante parámetros GET se eliminará por completo con Checkmk 2.5.0, deberías switch el inicio de sesión de dichos dashboards a Basic Auth (por ejemplo, mediante una extensión del navegador).

Checkmk 2.3.0 es la última versión que admite ntopng en las versiones 5.x y 6.x (Werk #16483). Con Checkmk 2.4.0 , se deja de admitir ntopng 5.x y solo se admitirá ntopng 6.x.

¿Te afecta esto? Este cambio afecta a los usuarios de las ediciones comerciales que utilizan la integración con ntopng.

¿Qué tendrás que hacer? Actualiza tus instalaciones de ntopng a la versión 6.x antes de actualizar Checkmk a 2.4.0.

Si hay agentes especiales configurados para un host, en Checkmk 2.4.0 se ejecutarán todos estos agentes especiales. En versiones anteriores solo se ejecutaba un agente especial, concretamente el primero en el orden alfabético.

¿Te afecta esto? Este cambio solo es relevante para los hosts en cuyas propiedades el atributo «Checkmk agent / API integrations» esté establecido en «API integrations if configured, else Checkmk agent».

Es posible que hayas creado sin darte cuenta reglas que han asignado más agentes especiales a los hosts de los necesarios. Estas reglas adicionales se ignoraban anteriormente si aparecían alfabéticamente después de la primera. Ejemplo: has creado reglas para agent_acme y reglas para agent_cyberdyne y has asignado estas reglas a los mismos hosts debido a un pequeño descuido. En Checkmk 2.4.0, ahora no solo se ejecutará agent_acme, sino también agent_cyberdyne para estos hosts.

La versión 2.4.0 de Checkmk actualiza Python a la versión 3.12.3. Esta actualización afecta a los módulos instalados en un site de Checkmk. En muchos casos, los módulos instalados posteriormente son incompatibles con Python 3.12.3. En el peor de los casos, los módulos obsoletos sobrescriben la funcionalidad de los módulos proporcionados por Checkmk.

¿Te afecta esto? Esto te afectará si se han instalado módulos de Python en tu site. Este puede ser el caso, por ejemplo, si has instalado previamente módulos de Python para agentes especiales o check plugins basados en agentes que hayas escrito tú mismo u obtenido del Exchange.

El uso de la comprobación activa check_sql para la monitorización de bases de datos Oracle también requiere una consideración cuidadosa: Hasta Checkmk 2.3.0 p27 tenías que instalar el módulo oracledb para poder utilizar esta comprobación. Desde 2.3.0 p28 este módulo se suministra con Checkmk (Werk #17370).

Para saber si se han instalado módulos de Python en tu site, busca los directorios dist-info y egg-info:

Si el resultado de la búsqueda no es una lista vacía, tendrás que tomar medidas.

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, y pueden estar ubicados en paquetes de extensión o simplemente «por ahí». Los archivos locales pueden causar problemas durante una actualización si ya no son compatibles con la nueva versión de Checkmk.

¿Te afecta esto? Dado que Checkmk no puede garantizar totalmente la compatibilidad de las adaptaciones locales durante una actualización, deberías revisar tu site Checkmk antes de actualizar para ver si se utilizan archivos locales, cuáles son y cómo están organizados.

En primer lugar, utiliza mkp list para buscar paquetes de extensión (MKPs) presentes en el site.

Utiliza también mkp find para obtener una vista general de los archivos locales sin empaquetar en tu site de Checkmk.

Si el resultado de uno o ambos comandos no está vacío, tendrás que tomar medidas.

En Checkmk 2.3.0, algunas interfaces de programación (API) que se definieron de forma ad hoc en versiones anteriores ya fueron sustituidas por otras versionadas y bien especificadas. Las API antiguas podían seguir utilizándose en paralelo. Con Checkmk 2.4.0 no se toman más medidas para mantener la compatibilidad con las API antiguas (Werk #17201). Esto significa que los Plugins que utilizan las API antiguas ya no funcionarán con Checkmk 2.4.0.

¿Te afecta esto? El tema de las API te afecta si has ampliado los check plugins que vienen con Checkmk con tus propios plugins escritos por ti mismo y/o si utilizas plugins de otras fuentes.

Los endpoints o parámetros obsoletos de la API-REST de Checkmk están marcados en la documentación de la API-REST con el icono .

¿Te afecta esto? Esto puede afectarte si utilizas la API-REST de Checkmk en tus propios scripts, por ejemplo.

¿Qué tendrás que hacer? Abre la documentación de la API-REST en Help > Developer Resources > REST API documentation. Busca Deprecated en el navegador en la página, check si estás utilizando elementos obsoletos en tus scripts y sustitúyelos antes de actualizar. En la documentación de la API-REST, normalmente encontrarás instrucciones sobre cómo sustituir las funciones que ya no existen en la nueva versión.

Al igual que en todas las versiones de Checkmk, también hay cambios en el software de la versión actual de 2.4.0 que pueden afectar a tu instalación de Checkmk; en Checkmk, estos cambios se organizan y documentan en lo que llamamos Checkmk Werks. Un cambio denominado «incompatible» requiere que realices modificaciones manuales para que las funciones existentes sigan funcionando como de costumbre y/o para poder utilizar las nuevas funciones.

¿Te afecta esto? En general, habrá cambios incompatibles que también afectarán a tu instalación de Checkmk; sin embargo, es imposible hacer una afirmación general. En este artículo hemos recopilado aquellos problemas que se aplican a todas o a la mayoría de las instalaciones de Checkmk. En cualquier caso, puede haber cambios adicionales que te afecten, por ejemplo, en las comprobaciones que utilizas en tu instalación.

¿Qué tendrás que hacer? Después de cada actualización —incluidas las versiones de parche—, Checkmk te mostrará el número y el contenido de los cambios incompatibles y te pedirá que los checkes y tomes nota de ellos. Antes de realizar la actualización es el momento adecuado para comprobar si hay algún cambio de la versión 2.3.0 que pueda afectar a la actualización. Desde Checkmk 2.3.0 , estos Werks ya no se transfieren, sino que se eliminan durante la actualización tras aceptar un diálogo de confirmación (Werk #15292).

También es buena idea hacerse una vista general de los cambios incompatibles en la versión 2.4.0 antes de la actualización: Abre la lista de Werks en el sitio web de Checkmk. En la descripción de un Werk, encontrarás información sobre lo que puede que tengas que hacer para que el cambio sea compatible.

Una vez realizada la actualización, el número y el contenido de los cambios incompatibles se mostrarán en la interfaz de Checkmk y se te pedirá que los checkes y tomes nota de ellos. Los enlaces te ayudan a checkearlo, de modo que con solo unos clics puedas averiguar si estás utilizando un componente afectado. Si tienes la certeza de que un Werk no tiene ningún impacto o has realizado los cambios necesarios, confirma el Werk con Acknowledge.

En esta sección describimos las mejores prácticas que seguimos incluso al actualizar entornos Checkmk de gran tamaño. Ciertamente, no son obligatorias en todos los entornos, pero pueden facilitarte el proceso de actualización.

Hay dos procedimientos diferentes para realizar una actualización de todos los sites incluidos en una monitorización distribuida:

En particular, si quieres actualizar mientras el sistema está en funcionamiento, debes leer las notas del artículo general sobre Actualizaciones y Actualizaciones de versión.

No ha cambiado nada fundamental en la actualización propiamente dicha del software en Checkmk 2.4.0 , es decir, instalas la nueva versión, realizas la actualización del site de Checkmk, resuelves cualquier posible conflicto y compruebas y confirmas los cambios incompatibles.

Realiza el procedimiento de actualización tal y como se describe en el artículo sobre Actualizaciones y Actualizaciones mayores.

La interfaz de usuario (GUI) de Checkmk, que se rediseñó por completo con la versión 2.0.0, no ha sufrido cambios fundamentales en la versión 2.4.0. Los procedimientos generales, con los que ya estás familiarizado de las versiones 2.0.0 a 2.3.0, también se pueden utilizar tal cual en 2.4.0. Sin embargo, se han modificado los menús, los elementos de menú, los iconos y otros detalles para ofrecer nuevas funciones y mejorar las ya existentes.

Te presentaremos estos cambios en los artículos del Manual de usuario, y en la Guía para principiantes encontrarás una introducción detallada, que incluye los elementos más importantes de la interfaz de usuario.

Al igual que con cada versión principal, Checkmk 2.4.0 introduce un conjunto completamente nuevo de check plugins. Si no utilizas la «comprobación de descubrimiento», es decir, la actualización automática de la configuración del servicio a través del descubrimiento de servicios periódico, tendrás que buscar los servicios en un buen número de hosts.

Si tus hosts están organizados adecuadamente (por ejemplo, en carpetas), normalmente puedes usar la función «Bulk discovery» para ello. Esta función se encuentra en «Setup > Hosts > Hosts» y, a continuación, en el menú «Hosts > Run bulk service discovery».

En algunos casos, ha sido necesario eliminar algunos check plugins o switch a nuevas API.

¿Te afecta esto? Existe el riesgo de que te veas afectado si realizas la monitorización del hardware con un ciclo de vida muy largo, especialmente con agentes especiales. Durante los preparativos para la actualización de 2.3.0 a 2.4.0, por ejemplo, nos dimos cuenta de que los agentes especiales para muchos dispositivos NetApp tenían que pasar de la ZAPI, ya descatalogada, a la API-REST más moderna (Werk #16767). Por motivos de licencia, tuvimos que trasladar el agente para Dell PowerConnect a un paquete independiente disponible en el Exchange (Werk #15359).

¿Qué tendrás que hacer? Si los servicios desaparecen tras la actualización, busca en los Werks el fabricante de los productos supervisados. En la mayoría de los casos, tendrás que switchar a nuevas API o, en casos excepcionales, utilizar paquetes del Exchange para realizar la monitorización de un componente específico de hardware o software.

¿Te afecta esto? Esto solo te afectará si has instalado explícitamente módulos de Python para agentes especiales o check plugins basados en agentes que hayas escrito tú mismo u obtenido del Exchange y los hayas eliminado durante la preparación para la actualización.

Desde la versión 2.3.0, Checkmk ya incluye una nueva comprobación activa para conexiones HTTP y certificados. La comprobación «Check HTTP web service» se encuentra en Setup > Services > HTTP, TCP, Email, …​, en la caja «Networking». La nueva comprobación ofrece un rendimiento significativamente mejor, es más robusta y más fácil de configurar que la anterior Check HTTP service. Además, ahora es posible realizar la monitorización de varios aspectos a la vez con una sola regla, por ejemplo, el código de respuesta HTTP, el tiempo de respuesta y la validez del certificado.

En Checkmk 2.4.0 se han añadido a la nueva comprobación algunas opciones poco utilizadas de la antigua comprobación para facilitar la migración. Además, proporcionamos un script de migración que realiza el mapeo de las llamadas existentes y los servicios resultantes de forma 1:1. Utiliza este script para convertir los servicios de la antigua comprobación a la nueva comprobación activa, ya que con Checkmk 2.5.0 no se pueden configurar nuevas reglas para la antigua comprobación. Esta se eliminará por completo más adelante.

Una vez completada la migración, puedes obtener importantes mejoras de rendimiento agrupando varias reglas, lo que permite que una sola ejecución de la check genere múltiples resultados, reduciendo así la sobrecarga de la CPU. En muchos casos, también puedes generar múltiples servicios utilizando una sola regla en la nueva check.

Puedes encontrar información general sobre la nueva check en los dos Werks #15514 y #15515. El Werk #17725 describe el script de migración. Un artículo detallado del blog explica los detalles de las posibilidades, limitaciones y mejores prácticas para preparar y dar seguimiento a la migración.

Si te encuentras con aplicaciones en las que la nueva check no puede sustituir a la antigua, puedes mostrar la línea de comandos utilizada de la misma manera que en el procedimiento descrito aquí. Entonces tendrás la opción de llamar a la check antigua o a un «check_http» instalado en todo el sistema a través de Setup > Other services > Integrate Nagios plugins.

El término «placa de gestión» hace referencia a tarjetas Plugin independientes o a la funcionalidad ampliada del BIOS (Baseboard Management Controller/BMC, Management Engine/ME, Lights Out Management/LOM) para la monitorización y gestión del hardware además del sistema operativo instalado.

Hasta la versión Checkmk 2.4.0, las placas de gestión se pueden configurar de dos maneras: Como propiedad del host o como un host independiente. Dado que la configurabilidad como propiedad del host es muy limitada, en el futuro esta opción ya no estará disponible.

Se ha añadido y mejorado la compatibilidad con placas de gestión compatibles con Redfish durante el ciclo de vida de Checkmk 2.3.0 , inicialmente como un MKP opcional (Werk #16589). En Checkmk 2.4.0 , la monitorización de Redfish es parte integral del software (Werk #17404). Explicamos información adicional y posibles alternativas en el artículo del blog «Monitorización de placas de gestión».