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 realiza con las opciones -u y -g, por ejemplo:

Una vista general de las opciones adicionales se puede mostrar 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 llena con archivos predeterminados. Sin embargo, también puedes hacer que se cree 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. Entonces podrías montar cualquier directorio o volumen y continuar la configuración:

omd init entonces se pone al día con los dos pasos omitidos, por lo que añade los archivos por defecto y crea la configuración de Apache.

Como usuario del site puedes simplemente llamar al modo interactivo con:

En cuanto cambies una configuración mientras el site está en funcionamiento, OMD te informará de que tu site debe detenerse primero y lo hará cuando sea necesario:

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

A quienes no les guste el modo interactivo, o prefieran trabajar con scripts, pueden 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 realizar como root si se añade el nombre del site como argumento:

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

La salida del comando anterior está abreviada para mayor claridad y sólo 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 de un site con fines de prueba o cuando se prepara una actualización. Por supuesto, se podría simplemente copiar el directorio /omd/sites/mysite_old en /omd/sites/mysite_new. Sin embargo, eso no funcionará como se desea, 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 sólo puede funcionar si

Ambos garantizan que el site se encuentra en un estado consistente en el momento de la copia y no cambia durante la operación.

Originalmente, OMD sólo podía manejar los archivos que se crearon realmente durante la creación del site con omd create, y que también contenían el ID del site ($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 a través del trabajo con el sitio Checkmk (las configuraciones de los host que se habían añadido posteriormente, por ejemplo). Desde un punto de vista puramente técnico, este comportamiento corresponde exactamente al ámbito de OMD. Sin embargo, la expectativa de la mayoría de los usuarios es que omd cp cree un sitio completamente nuevo que pueda seguir utilizándose 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 tiene lugar automáticamente.

Un ejemplo típico: En las propiedades de un host puedes utilizar el atributo Monitored on site para especificar manualmente en qué site debe ser monitorizado este host, por ejemplo mysite_old. Después de omd cp mysite_old mysite_new el valor cambiará a mysite_new en consecuencia. (Anteriormente este procedimiento habría dado lugar a 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 ejecuta el comando post-rename-site -v -o mysite_new. Los pasos individuales de la migración se procesan posteriormente de forma completamente automática a través de los llamados plugins de acciones de renombramiento, que puedes encontrar en cmk/post_rename_site/plugins/actions en el repositorio Git.

La migración también incluye informarte sobre cualquier cosa que no pueda migrarse automáticamente.

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

site 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 los ajustes de conexión del site local en Setup > General > Distributed Monitoring.

site remoto: El plugin warn_remote_site.py reconoce que se trata de un site remoto y, en consecuencia, indica que hay que comprobar el site central y personalizarlo manualmente si es necesario. Esto significa, a su vez, que en los ajustes de monitorización distribuida del site central, hay que introducir el nuevo nombre del site remoto en los ajustes de conexión al site remoto renombrado - OMD, por supuesto, no puede hacerlo desde un ordenador remoto.

El propio OMD te informa detalladamente de todo el procedimiento en el terminal. Aquí puedes ver un ejemplo de los mensajes de migración de la salida omd cp al renombrar un site central - separados en mensajes de éxito y de advertencia. Los rename action plugins procesados están numerados individualmente. Primero la salida de las tareas de migración realizadas automáticamente (abreviada aquí):

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

El item Warn about configurations to review…​ incluye notas generales sobre aspectos individuales que generalmente deberán revisarse manualmente durante una migración, como los filtros codificados para las vistas:

Vista general de los seis Plugin actualmente activos: el orden aquí corresponde a la numeración de la salida anterior:

Si estás monitorizando un gran número de host con el site, el volumen de datos a copiar puede ser bastante considerable. La mayor parte lo producen 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 producir volúmenes de datos mayores.

Si el historial no es necesario (por ejemplo, porque sólo quieres probar algo rápidamente), pueden omitirse de la copia. En tales casos, pueden añadirse las siguientes opciones a omd cp:

El orden de las opciones es importante:

Renombrar un site se realiza con el comando omd mv. Esto se hace de forma similar a copiar un site, tiene los mismos requisitos previos y también se hace incluyendo la migración de la configuración. Las opciones para restringir el volumen de datos no están disponibles, ya que los datos sólo se mueven a otro directorio y no se duplican.

Ejemplo:

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

Al igual que al crear un site, al copiar y renombrar cada uno de ellos 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, utiliza los comandos omd cp --help y omd mv --help.

La gestión de sitios en Checkmk tiene un mecanismo integrado para hacer copias de seguridad y restaurar sitios 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 utilizar 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 trabajos 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 root. Un usuario del site puede realizarla. Basta con 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 tiene permisos de escritura para un usuario del site, también puedes hacer 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 bajo ~/tmp/. Con el comando tar tzf se puede echar un vistazo fácilmente al contenido del archivo:

La mayor parte de los datos que hay que mover durante una copia de seguridad de un site son los valores medidos y los archivos de registro con eventos históricos. Esto es igual de cierto tanto al hacer una copia de seguridad como al copiar un site. Si no necesitas absolutamente estos datos, puedes omitirlos y así hacer la copia de seguridad mucho más rápida y el archivo de salida resultante mucho más pequeño.

omd backup proporciona las mismas opciones para omitir estos datos que omd cp al copiar. En el siguiente ejemplo, la copia de seguridad se crea sin datos de medición y sin el historial almacenado en los archivos de registro:

También se puede crear una copia de seguridad de un site en ejecución. Para garantizar un estado coherente de las Bases de datos Round Robin (RRD) utilizadas para registrar los datos de medición, el comando omd backup altera automáticamente la caché de Round Robin a un modo con el que las actualizaciones en ejecución sólo se escriben en el diario, y ya no en las RRD. Los archivos del diario son los últimos de los que se hace copia de seguridad, con lo que se consigue que se incluya también en la copia de seguridad la mayor cantidad posible de datos de medición que se hayan generado durante 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 tanto, para que la restauración funcione, debe estar instalada en el servidor esta misma versión.

El site se vacía completamente y se vuelve a llenar. Antes de omd restore hay que parar el site y después reiniciarlo:

Una restauración también puede ser realizada por un usuario de root. A diferencia de cuando es llamada por el usuario del site, el site se recreará con la copia de seguridad.

Por tanto, si todavía existe un site con el mismo nombre, tendrás que eliminarlo antes de la restauración. Esto puede realizarse con un omd rm, o simplemente incluyendo la opción --reuse con el omd restore. Un --kill garantiza además que el site ya existente se detiene antes de proceder a la restauración. No necesitas especificar el nombre del site en el comando, porque está contenido en la copia de seguridad:

Como root, también puedes restaurar un site con un nombre distinto 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 ocurren aquí tiene la misma función que para copiar y renombrar sites descrita anteriormente. El nombre del site se incluye en numerosos ficheros de configuración, y con este procedimiento cualquiera de esas apariciones será reemplazada automáticamente por el nuevo nombre.

Los comandos omd backup y omd restore pueden -siguiendo la 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 (-).

Cuanto mayor sea la copia de seguridad, más ventajoso será esto, ya que no se necesitará espacio temporal en el sistema de archivos del servidor del que se ha hecho la copia.

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

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

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

Y ahora de nuevo todo el asunto con acceso SSH invertido - esta vez de nuevo desde el sistema de origen al sistema de destino: