TURNKEYGNU / LINUX
Español

Documentación

Observium

Esta página de documentación proporciona información relacionada con TurnKey Linux Observium appliance. La versión actual de este doc fue escrita específicamente con TurnKey versión 18.x en mente, pero debe seguir siendo compatible con versiones más nuevas.

Por favor, proporcione comentarios y/o problemas con respecto a esta página de doc a través de la TurnKey Forums (requiere una cuenta gratuita de usuario del sitio web TurnKey Lnux). unificador de números TurnKey Linux.

Número conocido: "No se puede añadir el dispositivo manualmente a través de web, No se pudo ping יhostnameilo "

Como se ha señalado en el TurnKey Linux consolidado issue tracker, esta cuestión puede resolverse si se desea. Sin embargo, como también se señala (en un comentario en el tema) los documentos de observación de arriba recomiendan que no lo haga debido a implicaciones de seguridad; y en lugar de utilizar el CLI para añadir dispositivos. Así que depende de usted...

Actualización del observatorio

Todas estas instrucciones de actualización se basan en el funcionario Documentación de actualización de obervium. Hay detalles adicionales que se señalan aquí específicos para TurnKey Observium appliance. Independientemente, usted puede desear consultar la página de documentación oficial también - especialmente si usted actualización a una Edición de Suscripción.

Sumario:

Antes de empezar; ¡Atrás!

Un régimen automatizado de copia de seguridad (por ejemplo, mediante el uso de TKLBAM) siempre debe configurarse para cualquier sistema que contenga datos que usted se preocupe. La pérdida de datos del sistema siempre es cuestión de cuándo, no si. Se espera que el proceso de actualización del observatorio vaya sin problemas, por lo que una copia de seguridad reciente puede ser un pedazo suficiente de mente. Independientemente, siempre se recomienda una copia de seguridad manual inmediatamente antes de una actualización de software.

El proceso de actualización del observatorio (es) documentado a continuación guarda una copia de sus archivos antiguos del observatorio. Sin embargo, no guarda una copia de su base de datos original. Sin una copia de seguridad adecuada, es posible que no puedas volver a una versión anterior si algo sale mal. El único escenario en el que una copia de seguridad no es tan importante es si sólo ha establecido su servidor de observación y no tiene datos existentes. Incluso entonces, un respaldo podría ahorrar tiempo si las cosas van mal y necesitas volver a rodar.

Una nota importante para los usuarios de AWS Marketplace

La mayoría de los servidores TurnKey se desorientan por defecto para usar el usuario "root". Si es usted, lea. Para aquellos que usan TurnKey lanzado desde el mercado AWS, se desprendieron a un usuario "admin". Así que tendrás que cambiar al usuario de 'root' antes de que funcionen estas instrucciones. Podrías prefijar cada comando con 'sudo', pero eso es un dolor. En su lugar recomiendo que se conecte al usuario "root" para este proceso. Usted puede hacer eso así:

sudo su -

Cuando termines, vuelve al usuario de 'admin' emitiendo el comando 'exit'.

Actualización del observatorio CE usando script de actualización

Retrocede su sistema

Realizar un manual respaldo como se ha señalado anteriormente.

Actualización a través del script 'turnkey-update-observium' - incluido en el observatorio TurnKey appliance

Este script automatiza las instrucciones de actualización manual, además crea una copia de seguridad local de los archivos de observación (/opt/observium). El script está escrito en BASH y la fuente de la versión incluida con su servidor puede ser vista en /usr/local/bin/turnkey-update-observium o en el el último código fuente en GitHub.

Para ejecutar el script del CLI:

turnkey-update-observium

Hasta la fecha se ha recibido una retroalimentación limitada en relación con este script de actualización, aunque no se han registrado errores ni problemas. Sin embargo, debido a la reacción limitada cuando se ejecuta el script, informa que es "experimental". A pesar de ello, debe funcionar de forma fiable (ver nota abajo). Según cualquier actualización o cambios significativos de configuración, siempre se recomienda que tenga una copia de seguridad (por ejemplo, por ejemplo. TKLBAMEn caso de que algo salga mal.

Como se señaló al ejecutar el script:

Tenga en cuenta que este script comprobará la versión actual de los datos creados en el tiempo de construcción TurnKey appliance. Si el observatorio se ha actualizado a través de un método alternativo (o el archivo no existe) siempre se descargará y "actualizará" al último observatorio CE (Edición de la comunidad). Esto lo hará, incluso si ya está ejecutando la última versión CE; o han instalado a través de un canal alternativo!

Actualización manual del observatorio CE

Estas instrucciones se basan en el oficial Observium CE update docs - con algunos detalles adicionales relacionados específicamente con el TurnKey Linux Observium appliance. Todos los comandos deben ser ejecutados desde la línea de comandos como el usuario raíz.

Retrocede su sistema

Realizar un manual respaldo como se ha señalado anteriormente.

Disable Observium cronjobs (opcional)

Los trabajos de cron son tareas automatizadas que funcionan en un horario. Generalmente los trabajos de cron están relacionados con el observatorio "mantenimiento de la casa". Sin embargo, si no haces este paso, puedes obtener algunos errores de cron observados en tus registros. Si deshabilitas los trabajos de cron, asegúrate de que también re-enable después de la actualización (trabajos de cron re-enablign cubiertos más adelante en estas instrucciones).

Para desactivar los trabajos de cron de observatorio:

O edita manualmente el archivo cron - /etc/cron.d/observium - y comenta todas las líneas de cron activas. Es decir, añade un '#' carácter a cada línea que no empieza ya con un '#'. Si no tienes experiencia con este proceso, se sugiere que añadas un '#' a cada línea (así que todos los comentarios existentes están prefijados con '#').

También ejecute el comando sed inmediatamente debajo de la línea de comandos. Tenga en cuenta que este comando añadirá un '#' a cada línea en el archivo cron (como por instrucciones manuales anteriores). Este comando no es idempotente, así que haga NOT ¡Corre más de una vez! Si lo hace, entonces necesitará editar manualmente el archivo cron para descomponer las líneas cron y dejar los comentarios reales con un prefijo '#'.

sed -i "s|^|#|" /etc/cron.d/observium

Reemplaza archivos antiguos con la nueva versión

Los siguientes comandos mueven los archivos actuales de observación fuera del camino, descargan la versión más reciente y luego copian los archivos necesarios (archivo de archivo de archivos de archivos y directorios de registros de rdd) desde su instalación original de Observium.

Ejecute los siguientes comandos (como root):

cd /opt
mv observium observium_old
wget -Oobservium-community-latest.tar.gz https://www.observium.org/observium-community-latest.tar.gz
tar zxvf observium-community-latest.tar.gz
mv /opt/observium_old/rrd observium/
mv /opt/observium_old/logs observium/
mv /opt/observium_old/config.php observium/

Actualización del esquema DB

Actualizar el esquema DB para la nueva versión:

/opt/observium/discovery.php -u

Redescubrimiento de la fuerza (opcional)

Si ha pasado mucho tiempo desde que has actualizado (12 meses o más), es posible que desees forzar un redescubrimiento inmediato de todos los dispositivos para asegurarte de que las cosas estén actualizadas:

/opt/observium/discovery.php -h all

Cronjobs de observo (opcional)

Re-apoyo de cron sólo es necesario si usted los desactiva antes de hacer la actualización del observatorio. Si usted saltó ese paso inicial asegurar que usted hace NOT ¡Siga este paso! En lugar de saltar directamente a la siguiente sección.

Para re-enable manualmente los trabajos de cron, revertir el proceso hecho en la sección de empleos de cron deshabilitados arriba. uncomment las líneas de comando cron en el archivo del cron del observatorio - /etc/cron.d/observium .

Si usted deshabilita los trabajos de cron a través de la línea de sed indicada anteriormente - en la sección de empleos de cron deshabilitados anteriormente, entonces usted puede volver a habilitarlos con la línea de sed inferior. Eliminará el (primero) protagonista '#' de cada línea. NOT hacer esto a menos que usted utilizó el comando anterior de sed para desactivar los trabajos de cron. De acuerdo con el comando anterior de sed, no es idempotente, así que haga NOT ejecutarlo más de una vez! Si lo hace, entonces usted necesitará editar manualmente el archivo cron para comentar (add a leading '#' to) las líneas de comentarios intencionales en el trabajo de cron.

sed -i "s|^#||" /etc/cron.d/observium

Limpieza final (opcional)

Una vez que haya confirmado que la actualización funcionó como se esperaba, ahora puede eliminar los archivos antiguos de observación creados en el proceso de actualización de archivos arriba. I.e. eliminar el directorio observium_old:

rm -rf /opt/observium_old

Actualización del observatorio CE a la edición Pro/Enterprise

Estas instrucciones se basan en el CE - Observium Pro docs - con algunos detalles adicionales relacionados específicamente con el TurnKey Linux Observium appliance. Son relevantes tanto para las ediciones de suscripción Pro y Enterprise. Todos los comandos deben ser ejecutados desde la línea de comandos como el usuario root - tantos usuarios de TurnKey son buenos para ir. Los usuarios de AWS Marketplace necesitarán cambiar al usuario raíz primero.

sudo su -

Como se señala en la página pertinente del documento de observación:

El observatorio ha sido diseñado con facilidad de actualización y migración sin costuras en mente, permitiendo a los usuarios pasar sin problemas de la edición comunitaria al profesional o Edición de la empresa.

Retrocede su sistema

Realizar un manual respaldo como se ha señalado anteriormente.

Instala subversión

Las ediciones de suscripción de observium entregan el código inicial de instalación y las actualizaciones futuras a través del sistema de control de versiones SVN (subversion). El TurnKey Observium appliance no incluye el software de subversión requerido por defecto. Sin embargo, puede instalarse fácilmente apt (como usuario raíz):

apt update
apt install subversion

Empleos de cron de conservas desactivadas (recomendados)

Los trabajos de cron son tareas automatizadas que funcionan en un horario. Generalmente los trabajos de cron están relacionados con el "mantenimiento de la casa" de Observium, aunque incluyen otras funcionalidades. Se recomienda desactivar los empleos cron durante la actualización, aunque estrictamente hablando es opcional. Sin embargo si el contaminador de observatorio (triggered by a cron job) se ejecuta durante el proceso de revisión de códigos o al mover el directorio rdd puede tener consecuencias inesperadas. Si usted deshabilita los trabajos de cron, asegúrese de que también re-enable después de la actualización (los trabajos de cron que se pueden recuperar se cubren más adelante en estas instrucciones).

Para desactivar los trabajos de cron de observatorio:

O edita manualmente el archivo cron - /etc/cron.d/observium - y comenta todas las líneas de trabajo de cron. Es decir, añade un '#' carácter al comienzo de cada línea de trabajo de cron. Se recomienda añadir un '#' a cada línea. Eso significará que los comentarios intencionales existentes están prefijados con '#' y harán que vuelva a habilitar más confiable y menos proclive a errores.

Alternativamente puede ejecutar el comando sed inmediatamente debajo a través de la línea de comandos. Tenga en cuenta que este comando añadirá un '#' a cada línea en el archivo cron (como por recomendación en instrucciones manuales). Este comando de sed no es idempotent - significa que la re-corrección de este script causará cambios adicionales. NOT ¡Corre más de una vez! Si lo hace, entonces necesitará arreglar/editar manualmente el archivo cron para volver a habilitar trabajos de cron.

sed -i "s|^|#|" /etc/cron.d/observium

Migrar a SVN código de repositorio - reemplazar archivos antiguos con la versión SVN

Para migrar al código entregado por el repositorio SVN, debe comprobar una nueva copia del código y transferir su directorio de configuración y rrd existente a la nueva copia.

Los comandos a continuación instalarán el tren estable. Si prefiere utilizar el tren de rodadura, sustitúyase las ramas/estable en el tercer comando por tronco. Vea los docs del observatorio para más detalle.

Durante el proceso de actualización a continuación, se le pedirá un nombre de usuario y contraseña. Estas credenciales se pueden encontrar en el Portal de Suscripción de los observatorios.

Los siguientes comandos mueven los archivos de Observium actuales de la manera, descarga la versión de suscripción estable más reciente de Observium a través de la versión SVN y luego copia de nuevo la ficheros necesarios (archivos de archivo de archivos y directorios de registros rdd) de la instalación original de Observium.

cd /opt
mv observium observium-old
svn co https://svn.observium.org/svn/observium/branches/stable observium
cp observium-old/config.php observium
mv observium-old/rrd observium-old/logs observium
cd observium
./discovery.php -u

Trabajos de cron de observatorio re-enable (recomendados - requeridos si están discapacitados arriba)

Re-apoyo de cron es necesario si usted los deshabilita antes de la actualización del observatorio - como se recomienda. Si usted saltó ese paso inicial asegurar que usted hace NOT ¡Siga este paso! En lugar de saltar directamente a la siguiente sección.

Para re-enable manualmente los trabajos de cron, revertir el proceso hecho en los trabajos de cron deshabilitados paso arriba. eliminar el '#' del inicio de cada línea (excepto los comentarios intencionales) en el archivo del cron del observatorio - /etc/cron.d/observium .

Si usted deshabilita los trabajos de cron a través del comando de sed señalado en los trabajos iniciales de cron deshabilitado paso arriba, entonces usted puede volver a habilitarlos con la línea de sed abajo. Eliminará el (primero) protagonista '#' de cada línea. NOT Hazlo a) Usted utilizó el comando anterior de sed para desactivar los trabajos de cron. De acuerdo con el comando anterior de sed, este comando no es idempotente y hará cambios adicionales si se ejecutan más de una vez. Así que sí. NOT ejecutarlo más de una vez! Si lo hace, entonces usted necesitará editar / fix manualmente el archivo cron para ende que los comentarios intencionales están prefijados con '#.

sed -i "s|^#||" /etc/cron.d/observium

Si es necesario, el predeterminado archivo TurnKey Observium cron puede ser consultado si necesita arreglar su archivo cron.

Limpieza final (opcional)

Una vez que haya confirmado que la actualización de migración funcionó como se esperaba, ahora puede eliminar los archivos antiguos de observación creados en el proceso de actualización anterior. eliminar el directorio observium_old:

rm -rf /opt/observium_old

Actualización de la edición de suscripción a la última

Este proceso sólo se aplica si ya ha actualizado el observatorio a un edición de suscripción.

Retrocede su sistema

Antes de comenzar, realizar un manual respaldo como se ha señalado anteriormente.

Empleos de cron deshabilitados (opcionales pero recomendados)

Trabajos de cron de conservas como se documentó anteriormente.

Actualización de la versión más reciente de la versión estable

Actualizar ediciones de suscripción de Observium utilizando SVN es simple. Para actualizar Observium Subscription Edition a la última versión estable, utilice los comandos siguientes:

cd /opt/observium
svn update
./discovery.php -u

Opciones de actualización de Alternate/Additional Observium Pro/Enterprise

Tenga en cuenta que el software de la aplicación web no suele apoyar la reducción a una versión anterior. No puedo confirmar que es específicamente el caso de Observium, pero si usted se adhiere a esa regla de pulgar entonces usted es menos probable que golpee problemas. Así que la creación de un manual respaldo como se ha señalado anteriormente siempre se recomienda y se considera la mejor práctica.

Actualizar la Edición de Suscripción de Observio a revisión específica

En lugar de actualizar a la última establo, es posible que desee actualizar a una revisión específica, es decir, un lugar específico en el plazo de liberación estable. Actualización del observatorio a una revisión específica es muy similar al proceso y los comandos señalados en el Mejora instrucciones arriba. Sin embargo, el comando 'svn update' se adjunta con '-r יr n número de revisión de confianza.

svn update -r <revision number>

Por ejemplo, digamos que desea instalar/aprobar la versión 0.12.4.3049. La revisión SVN es el último número, por lo que ejecute lo siguiente:

svn update -r 3049

Por favor, veamos la corteza Subscripción de observio Edición actualización docs para más opciones y detalles.