Administración de sites con omd

En algunos casos, también es conveniente especificar el ID de usuario/grupo del nuevo usuario que se va a crear. Esto se hace con las opciones -u y -g, por ejemplo:

Puedes ver una vista general de las demás opciones con omd create --help. Las opciones más importantes son:

Por defecto, el directorio de inicio de un nuevo site se crea en /omd/sites/ y se rellena con archivos predeterminados. Sin embargo, también puedes crear un directorio de inicio vacío, por ejemplo, para montar un volumen externo en esta ubicación. Esto se hace mediante la opción --no-init:

Esta opción también omite la integración con el sistema Apache, dejando /omd/apache/mysite.conf vacío. A continuación, podrías montar cualquier directorio o volumen y continuar con la configuración:

omd init luego recupera los dos pasos omitidos, por lo que añade los archivos predeterminados y crea la configuración de Apache.

Como usuario del site, puedes activar el modo interactivo simplemente con:

En cuanto cambies una configuración mientras el site está en funcionamiento, OMD te informará de que primero debes detener el site y lo hará según sea necesario:

No te olvides de reiniciar el site una vez finalizado el trabajo. « omd config» no lo hará automáticamente por ti.

Si no te gusta el modo interactivo o prefieres trabajar con scripts, puedes establecer los ajustes individuales como variables a través de la línea de comandos. Para ello, existe el comando `omd config set`. El siguiente ejemplo establece la variable `AUTOSTART` en `off`:

Esto también se puede hacer con `root` si se añade el nombre del site como argumento:

La asignación actual de todas las variables se muestra como root, el comando omd config mysite show y como usuario del site omd config show:

La salida anterior se ha abreviado para mayor claridad y solo muestra las primeras entradas.

Hay numerosos ajustes en omd config. Los más importantes son:

Nota: También puedes ver estas variables con los mismos nombres en el modo interactivo.

A veces resulta útil crear una copia del site con fines de prueba o cuando te estás preparando para una actualización. Por supuesto, podrías simplemente copiar el directorio /omd/sites/mysite_old a /omd/sites/mysite_new. Sin embargo, eso no funcionará como esperas, porque:

Para simplificar la copia de un site, existe en su lugar el comando omd cp, que tiene en cuenta todo esto. Ejecuta el comando como root e introduce simplemente el nombre del site existente seguido del nombre del nuevo. Por ejemplo:

La copia solo funcionará si:

Ambas condiciones garantizan que el site se encuentre en un estado coherente en el momento de la copia y no cambie durante la operación.

Originalmente, OMD solo podía manejar los archivos que se creaban realmente durante la creación del sitio con omd create y que también contenían el ID del sitio ($OMD_SITE). Estos archivos se pueden encontrar en el directorio del site ~/etc con este comando:

Anteriormente, OMD no podía hacer nada con los archivos de configuración que se creaban posteriormente al trabajar con el site de Checkmk (por ejemplo, las configuraciones de los hosts que se habían añadido más tarde). Desde un punto de vista puramente técnico, este comportamiento se ajusta exactamente al ámbito de OMD. Sin embargo, la mayoría de los usuarios esperan que una «omd cp» cree un site completamente nuevo que se pueda seguir utilizando de forma productiva, incluida su propia configuración de monitorización.

A partir de la versión 2.1.0 de Checkmk, OMD ahora también puede personalizar los elementos más importantes de la configuración de Checkmk. Por cierto, no tienes que hacer nada, toda la migración que se describe a continuación se lleva a cabo automáticamente.

Un ejemplo típico: En las propiedades de un host puedes usar el atributo «Monitored on site» para especificar manualmente en qué site se debe realizar la monitorización de este host, por ejemplo, mysite_old. Tras un «omd cp mysite_old mysite_new», el valor cambiará a mysite_new en consecuencia. (Anteriormente, este procedimiento habría dado como resultado la entrada Unknown site (mysite_old)).

La implementación técnica real de esta migración es la siguiente: OMD detecta los cambios en el ID del site y, a continuación, ejecuta el comando post-rename-site -v -o mysite_new. Los pasos individuales de la migración se procesan posteriormente de forma totalmente automática a través de los denominados plugins de acciones de renombramiento, que puedes encontrar en cmk/post_rename_site/plugins/actions en el repositorio de Git.

La migración también incluye informarte de cualquier cosa que no se pueda migrar automáticamente.

Aquí tienes un ejemplo concreto: estás utilizando la monitorización distribuida y renombras tanto el site central como un site remoto.

Sitio central: El Plugin sites.py detecta que se trata de un site central y actualiza, entre otras cosas, el valor URL prefix, que se encuentra en la configuración de conexión del sitio local en Setup > General > Distributed Monitoring.

Sitio remoto: El Plugin warn_remote_site.py reconoce que se trata de un sitio remoto e indica, en consecuencia, que hay que comprobar el site central y personalizarlo manualmente si es necesario. Esto significa, a su vez, que en la configuración de monitorización distribuida del site central, hay que introducir el nuevo nombre del sitio remoto en la configuración de conexión al sitio remoto renombrado —por supuesto, OMD no puede hacer esto desde un ordenador remoto.

El propio OMD te informa detalladamente sobre todo el procedimiento en la terminal. Aquí puedes ver un ejemplo de los mensajes de migración de la salida de omd cp al renombrar un site central —separados en mensajes de éxito y de advertencia. Los archivos de migración procesados (rename action plugins) se numeran individualmente. Primero, la salida del proceso de migración realizado automáticamente (acortada aquí):

La segunda parte de la salida contiene ahora consejos sobre ajustes que quizá tengas que configurar manualmente (aquí muy abreviados):

El item «Warn about configurations to review…​» incluye notas generales sobre aspectos concretos que, por lo general, deberán revisarse manualmente durante una migración, como los filtros codificados de forma fija para las vistas de tabla:

Aquí tienes una vista general de los seis Plugins activos actualmente; el orden aquí corresponde a la numeración de la salida anterior:

Si estás realizando la monitorización de un gran número de hosts con el site, el volumen de datos que hay que copiar puede ser bastante considerable. La mayor parte de esto la generan los valores medidos almacenados en las bases de datos Round Robin (RRD). Pero los archivos de registro que contienen eventos históricos también pueden generar grandes volúmenes de datos.

Si no necesitas el historial (por ejemplo, porque solo quieres probar algo rápidamente), puedes omitirlos de la copia. En esos casos, puedes añadir las siguientes opciones a omd cp:

El orden de las opciones es importante:

Para cambiar el nombre de un site, usa el comando `omd mv`. Se hace de forma similar a copiar un site, tiene los mismos requisitos previos y también incluye la migración de la configuración. Las opciones para limitar el volumen de datos no están disponibles, ya que los datos solo se mueven a otro directorio y no se duplican.

Ejemplo:

Al renombrar un sitio con omd mv, se cambiará el nombre del sitio, pero algunos atributos del sitio no se modificarán, incluido el ID del sitio. Por lo tanto, este comando no es adecuado para gestionar un sitio que se ha duplicado, por ejemplo, mediante una copia de seguridad, simultáneamente con su versión original en una monitorización distribuida, incluso si los sitios en cuestión tienen nombres diferentes tras ejecutar un omd mv.

Al igual que al crear un site, al copiarlo y renombrarlo se crea un nuevo usuario de Linux. Por lo tanto, omd cp y omd mv también tienen algunas de las mismas opciones que omd create, por ejemplo, para especificar los ID de usuario y de grupo. Para obtener información más detallada, usa los comandos omd cp --help y omd mv --help.

La gestión de sitios en Checkmk cuenta con un mecanismo integrado para realizar copias de seguridad y restaurar sitios de Checkmk. Los comandos omd backup y omd restore son los básicos para empaquetar todos los datos del sitio en un archivo tar y, respectivamente, extraer esos datos para una restauración.

Nota: Checkmk también ofrece la posibilidad de realizar copias de seguridad y restauraciones sin usar la línea de comandos, a través de la GUI en Setup > Maintenance > Backups. Allí también puedes crear copias de seguridad cifradas y jobs de copia de seguridad programados. Consulta el artículo Copias de seguridad para saber cómo hacerlo.

Hacer una copia de seguridad de un site con omd backup no requiere permisos de administrador (root). Cualquier usuario del site puede hacerlo. Solo tienes que introducir como argumento el nombre del archivo de copia de seguridad que se va a crear:

Ten en cuenta que:

Si el directorio de destino de la copia de seguridad no es escribible para un usuario del site, también puedes realizar la copia de seguridad como root. En este caso, se requiere un argumento adicional, como siempre, especificando el nombre del site del que se va a hacer la copia de seguridad:

La copia de seguridad contiene todos los datos del site, excepto los datos volátiles que se encuentran en ~/tmp/. Con el comando tar tzf puedes echar un vistazo fácilmente al contenido del archivo:

La mayor parte de los datos que se mueven durante una copia de seguridad del sitio son los valores medidos almacenados en las bases de datos Round Robin (RRD) y los archivos de registro con eventos históricos. Otra parte importante de los datos que se mueven durante una copia de seguridad del sitio son los paquetes de agentes, que Agent bakery almacena en el directorio ~/var/check_mk/agents, pero que se pueden volver a crear fácilmente si es necesario.

omd backup ofrece las mismas opciones que omd cp a la hora de copiar para excluir estos datos. En el siguiente ejemplo, la copia de seguridad se crea completamente sin estos datos:

Al hacer la copia de seguridad, también puedes especificar cuáles de los datos anteriores quieres excluir. Usa omd backup --help para ver las opciones disponibles.

También se puede crear una copia de seguridad desde un site en funcionamiento. Para garantizar un estado coherente de los RRD utilizados para registrar los datos de medición, el comando omd backup cambia automáticamente la caché Round Robin a un modo en el que las actualizaciones en curso se escriben solo en el diario, y ya no en los RRD. Los archivos de diario son los últimos en copiarse; de este modo, se consigue que la mayor parte posible de los datos de medición generados durante la copia de seguridad también se incluyan en la misma.

Restaurar una copia de seguridad es tan sencillo como crearla. El comando omd restore restaura un site a partir de una copia de seguridad, en la versión de Checkmk que se utilizó para hacer la copia de seguridad del site. Por lo tanto, para que la restauración funcione, debe estar instalada esta misma versión en el servidor.

El site se vacía por completo y se vuelve a llenar. Antes de ejecutar «omd restore», debes detener el site y, después, reiniciarlo:

Un usuario de root también puede realizar una restauración. A diferencia de cuando la realiza el usuario del site, este se recreará a partir de la copia de seguridad.

Así que, si todavía hay un site con el mismo nombre, tendrás que eliminarlo antes de la restauración. Esto se puede hacer con un comando `omd rm`, o simplemente incluyendo la opción `--reuse` con el comando `omd restore`. Además, el comando `--kill` garantiza que el site ya existente se detenga antes de que continúe la restauración. No necesitas especificar el nombre del site en el comando, porque ya está incluido en la copia de seguridad:

Como root, también puedes restaurar un site con un nombre diferente al de la copia de seguridad. Para ello, especifica el nombre deseado como argumento después de la palabra restore:

La larga lista de conversiones que se realizan aquí tiene la misma función que la descrita anteriormente para copiar y renombrar sitios. El nombre del site aparece en numerosos archivos de configuración y, con este procedimiento, todas esas apariciones se sustituirán automáticamente por el nuevo nombre.

Los comandos omd backup y omd restore pueden —siguiendo la buena vieja tradición de Unix— funcionar también a través de la entrada/salida estándar en lugar de archivos. En lugar de una ruta para el archivo tar, simplemente introduce un guión (-).

De esta forma, se puede crear una tubería y los datos se «transmiten» directamente a otro ordenador sin necesidad de archivos intermedios. Cuanto más grande sea la copia de seguridad, más ventajoso resultará esto, ya que no se necesitará espacio temporal en el sistema de archivos del servidor del que se hace la copia.

El siguiente comando realiza una copia de seguridad de un site en otro ordenador mediante SSH:

Si quieres invertir el acceso SSH, es decir, si prefieres realizar la conexión desde el servidor de copia de seguridad al site de Checkmk, también es posible, como muestra el siguiente ejemplo. Para ello, primero debe permitirse el inicio de sesión SSH como usuario del site.

Si eres espabilado y combinas lo anterior con un `omd restore` que lee los datos de la entrada estándar, puedes copiar un site completo y en funcionamiento de un servidor a otro, y sin necesidad de espacio adicional para un archivo de copia de seguridad:

Y ahora, de nuevo, todo el proceso con el acceso SSH invertido, esta vez del sistema de origen al sistema de destino: