Actualización

Actualización manual

Es importante comprender los componentes básicos en que se divide Pandora FMS. Fundamentalmente se compone de: Servidor, Base de datos y Consola.

//Diseño estándar de Pandora FMS//

En instalaciones Open source actualizaremos estos tres componentes de forma rápida, pero en instalaciones Enterprise el proceso tendrá algunos pasos más, ya que los componentes llevan funcionalidades Enterprise extendidas que es necesario actualizar aparte.

En instalaciones de la versión Open source:

  • Consola Web.
  • Servidor.
  • Base de datos.

En instalaciones de la versión Enterprise:

  • Consola Web Open.
  • Consola Web Enterprise (funcionalidades extendidas en la Consola).
  • Servidor Open.
  • Servidor Enterprise (funcionalidades extendidas en el Servidor).
  • Base de datos (tablas adicionales de la versión Enterprise).

Las actualizaciones siempre incluirán cambios en la consola, ocasionalmente cambios en el servidor y raramente cambios en la base de datos. Las actualizaciones están organizadas en dos grandes categorías: actualizaciones de versión menores, sin cambios en la base de datos, y actualizaciones de versión mayores, con cambios en la base de datos.

Actualizar una versión menor

No incluyen cambios en la base de datos, siempre serán de consola y en ocasiones también contendrán cambios en el servidor. Ejemplos son actualizaciones de la 6.1 SP1 a la 6.1 SP2.

Precauciones iniciales: en este enlace tiene el procedimiento detallado para respaldar y restaurar a Pandora FMS. Un resumen del procedimiento de respaldar es el siguiente:

1. Realizar un respaldo de la base de datos. Ejemplo:

mysqldump -u root -p pandora > backup_pandora_X.Y.sql

2. Realizar un respaldo de los ficheros de configuración: pandora_server.conf, config.php, pandora_agent.conf.

3. Realizar un respaldo de los plugins de Servidor y Agente, ubicados en:

 /etc/pandora/plugins
 pandora_console/attachment/plugin
 /usr/share/pandora_server/util/plugin

4. Detener los servicios: pandora_server, tentacle_serverd, httpd, pandora_agent y mysqld.

5. Proceder a realizar la actualización.

Desde paquetes RPM

  • Actualización de la Consola Open Source:
rpm -U pandorafms_console_package.rpm
  • Actualización de la Consola Enterprise:
rpm -U pandorafms_console_enterprise_package.rpm
  • Actualización del servidor Open Source:
rpm -U pandorafms_server_package.rpm
  • Actualización del servidor Enterprise con tar.gz:
 tar -xvzf pandorafms_server_enterprise_package.tar.gz
 cd pandora_server
 ./pandora_server_installer --install

En todo momento, antes y después de la actualización, podrá conocer sus versiones instaladas mediante la ejecución del comando:

  rpm -qa | grep -i pandora

Desde Tarball / Fuentes

  • Actualización de la Consola Open Source:
 tar xvzf pandorafms_console_package.tar.gz
 cd pandora_console
 ./pandora_console_upgrade -p /yourconsolepath
  • Actualización de la Consola Enterprise:
 tar xvzf pandorafms_console_enterprise_package.tar.gz
 cd pandora_console
 ./pandora_console_upgrade -p /yourconsolepath
  • Actualización del servidor Open Source:
 tar xvzf pandorafms_server_package.tar.gz
 cd pandora_server
 ./pandora_server_upgrade --upgrade
  • Actualización del servidor Enterprise:
 tar xvzf pandorafms_server_enterprise_package.tar.gz
 cd pandora_server
 ./pandora_server_upgrade --upgrade
  • Actualización del Agente:
 tar xvzf pandorafms_agent_package.tar.gz
 cd pandora_agent
 ./pandora_agent_installer --force-install

Versión 7.0NG ( Rolling Release )

Si decide actualizar de modo manual la Consola de Pandora FMS en la versión 7.0 NG, (mediante rpm, tarball o deb) puede encontrar la necesidad de aplicar manualmente los scripts de migración entre las diferentes versiones. Para evitar este comportamiento en la versión 7 recomendamos siempre actualizar la Consola mediante Update Manager.

En el caso de que tengamos la base de datos desactualizada (un error poco frecuente que no debería ocurrir en condiciones normales), los usuarios administradores podrán ver un aviso en la pestaña de notificaciones indicando este problema:

Para solucionar este problema, deben entrar mediante una shell al servidor donde esté ubicada la Consola de Pandora FMS y ubicarse en el directorio:

/var/www/html/pandora_console/extras/mr

Dentro de este directorio aparecerá otro directorio denominado updated. Allí deben almacenarse todos los sql que ya estén aplicados y fuera del mismo los que no. Por lo que, una vez apliquemos los sql en la base de datos, debemos moverlos al directorio updated.

Un buen ejemplo de ejecución es acerca del MR1. En este caso no existe ningún MR aplicado sobre la base de datos y en el pie de página (footer) de la Consola de Pandora FMS aparecerá el MR0. Si hemos instalado la versión 704 de forma manual, tendríamos que aplicar el MR1 ejecutando el sql que encontraremos en /var/www/html/pandora_console/extras/mr/ llamado 1.sql. Se debe ejecutar así:

[[email protected] mr]# cat 1.sql | mysql -u root -p pandora

Siendo root el usuario de MySQL y pandora el nombre de la base de datos.

Una vez aplicado, debe actualizar el valor del MR dentro de la tabla de MySQL tconfig para cambiar el valor del footer al actual. Se debe realizar con el siguiente mandato dentro de la línea de comandos de MySQL:

 mysql> use pandora;
 mysql> update tconfig set value= XX where token='MR';

Una vez realizado, desaparecerá el mensaje de advertencia de la Consola de Pandora FMS y en el footer de la Consola podremos ver el MR1 aplicado. El siguiente paso será mover el sql dentro de la carpeta updated.

[[email protected] mr]# mv 1.sql updated/

Para conocer los MR que se deben aplicar, por favor vaya al siguiente enlace.

Actualizar una versión mayor

Las actualizaciones de versión mayores siempre incluyen cambios en la base de datos, por lo que necesitará actualizar su esquema de base de datos. Casos de este tipo serían actualizaciones de versión 6.0 a 6.1 o de 6.1 a 7.0, por ejemplo.

Actualización de la base de datos (Versiones "mayores")

Para realizar la actualización de la base de datos será necesario haber actualizado primero la Consola Open Source y la Enterprise (solo para clientes Enterprise), ya que estas actualizaciones nos descargarán los ficheros sql necesarios.

Una vez actualizada completamente la Consola, los scripts sql de actualización de la base de datos se encontrarán en los directorios /extras y /enterprise (solo para instalaciones Enterprise) de la Consola. En una instalación estándar en CentOS puede encontrarlos en estas ubicaciones:

/var/www/html/pandora_console/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql
/var/www/html/pandora_console/enterprise/pandoradb_migrate_vX.Y_to_vZ.T.mysql.sql

Antes de proceder a la actualización se recomienda seguir las precauciones iniciales anteriormente descritas: respaldo de la base de datos y respaldo de los ficheros de configuración. También será necesario detener el servicio del server de Pandora FMS:

service pandora_server stop
  • Actualización de la base de datos Open Source:
mysql -u username -p -D databasename

Ejemplo:

mysql -u pandora -p -D pandora

Una vez en la línea de comando de MySQL ejecute el siguiente comando:

source /yourconsolepath/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql;

Al ejecutar el migrate de la versión Open Source, se actualizará también la versión Enterprise.

Para salir del cliente de MySQL ejecute el comando quit. Así ya estará actualizada la base de datos a la versión correspondiente.

En caso de necesitar una vuelta atrás, puede restaurar el respaldo de la base de datos mediante este procedimiento:

 mysql -u username -p databasename> drop database databasename;
> create database newdatabasename;
> use newdatabasename;
> source backup_pandora_X.Y.sql

Ejemplo:

 mysql -u root -p pandora> drop database pandora;
> create database pandora;
> use pandora;
> source backup_pandora_X.Y.sql;

Actualización automática con Update Manager

Actualizaciones Open Source

Desde la versión 4.0.2, Pandora FMS permite realizar -desde la versión Open Source- actualizaciones semanales semiautomáticas. Para ello, se basa en una mejora del sistema Update Manager, que antes estaba solo disponible para la versión Enterprise; de esta forma, podrá consultar online si existe una actualización y, bajo petición, descargarla y actualizar automáticamente su Consola, de forma cómoda y automática.

Esta actualización tiene las siguientes características:

  • Necesitará estar conectado a Internet desde su Consola de Pandora FMS (hacia fuera).
  • Update manager contactará a nuestros servidores para buscar la última versión disponible (en Sourceforge). Enviará datos estadísticos de uso anónimos (numero de Agentes).
  • Se descargará la actualización desde Sourceforge, del directorio de actualizaciones semanales.
  • Las actualizaciones semanales no son incrementales, son el contenido completo de la Consola, por lo que el proceso puede ser largo (el paquete suele rondar los 25 megabytes).
  • Las actualizaciones son automáticas: no están revisadas por el equipo y, aunque en el 99% de los casos no debería haber problema, no podemos dar una garantía de que así sea.
  • Las actualizaciones son solo para la Consola, no para los Agentes y/o el Servidor.

Proceso a seguir para actualizar la Consola

Vaya a Update managerUpdate manager online. En la pantalla principal podrá ver si hay alguna actualización pendiente, disponible para instalar, así como la versión actual de la consola.

Si existe alguna actualización, pulse Ok para instalar. Después del proceso de descarga del paquete, aparecerá un diálogo en el que se le dará la opción de aceptar la actualización de la Consola o rechazar.

Pulse el botón de confirmación Ok para comenzar el proceso de actualización.

Algunas de las actualizaciones llevan consigo modificaciones en base de datos. El propio proceso de actualización mostrará un diálogo avisando de que existen estos cambios, como se muestra en la siguiente captura:

Llegados a este punto tenemos dos opciones, o bien aplicar el cambio en base de datos, tras el cual se actualizará la Consola, o bien podemos rechazar esta actualización en la base de datos, y en consecuencia no se actualizará ni la base de datos ni la consola, ya que algunos cambios introducidos en la propia consola necesitan de estos cambios en base de datos.

Para utilizar Update Manager necesita que su Consola tenga salida a Internet. Por defecto, utilizará WGET para descargar los paquetes (más rápido); puede utilizar el método CURL (esto se cambia en la configuración de Pandora FMS) pero este es algo más lento.

Después de este proceso, se mostrará la página principal del software para actualizaciones con la versión de la Consola al día. ¡Enhorabuena, ya hemos actualizado la versión!

Actualizaciones Enterprise

A diferencia de las actualizaciones Open Source, estas tienen algunas características adicionales:

  • 100% probadas y comprobadas por el equipo de desarrollo para que pueda disfrutar de actualizaciones al día (a veces de unas pocas horas tras abrir una incidencia).
  • Actualizaciones específicas (incrementales) que permiten actualizar solo lo que está desactualizado, sin descargar paquetes pesados de Internet.
  • Permite actualizaciones offline, descargando paquetes de la página de soporte, para instalaciones de Pandora FMS que no dispongan de conexión a Internet (por seguridad).

Configuración

Versión Enterprise.

Para poder usar Update Manager en la versión Enterprise, primero ha debido configurar correctamente dicho software para actualizaciones, el cual tiene su propia sección en el menú:

Actualizaciones en línea

Desde la sección de actualización se puede acceder al Update Manager. Si dispone de la versión Enterprise instalada, podrá utilizar esta interfaz; si no, aparecerá la de la versión Open Source.

Desde esta página se muestra el número de versión en el que está en Pandora FMS y se notificará la existencia de nuevas actualizaciones.

Para actualizar a la última versión pulse en el enlace que muestra la imagen en su Consola de Pandora FMS.

Este proceso lanzará un diálogo que permitirá elegir si proseguir con la actualización o rechazarla.

Si decide continuar con ella, se pueden presentar dos posibilidades: la primera es que se actualice directamente la Consola y finalice el proceso y la segunda es que la actualización cuente con cambios en la base de datos; si es así se mostrará un diálogo brindándonos la posibilidad de elegir si actualizar la base de datos o no.

Si decide actualizar, el proceso continuará de manera normal, pero si la rechaza no se actualizará ni la base de datos ni la Consola, ya que algunos cambios en base de datos pueden tener importancia crítica en cambios de la Consola de esa misma actualización.

Después del proceso, el software para actualizaciones aparecerá con la versión actual instalada en Pandora FMS.

Actualizaciones fuera de línea

Puede descargar las actualizaciones offline de Pandora FMS, que son unos ficheros con extensión .OUM. Para ello, vaya a la página de soporte oficial de Pandora FMS y descárguelos.

Súbalo a la consola usando este control:

Al subirlo, aparecerá el fichero cargado, dándonos la posibilidad de pinchar en él y comenzar el proceso de actualización.

La actualización se aplicará siguiendo el mismo flujo de operaciones que en el caso online, mostrando los diálogos correspondientes a la actualización de la Consola y de la base de datos, en el caso de que hubiera cambios en esta.

También desde el mismo modo con los OUM, puede actualizar la Consola de Pandora FMS por medio de archivos zip generados por nuestros técnicos.

En caso de actualizar una instalación con Alta Disponibilidad (HA), será necesario tener en cuenta lo indicado en esta sección.

Configuración adicional del motor PHP para la operación de Update Manager

Para que Open Update Manager se ejecute correctamente, este necesita más memoria que la asignada de forma predeterminada. Para asignar más memoria a la ejecución de PHP y que el Open Update Manager funcione, debe editar el fichero php.ini y establecer la memoria reservada a 800M, al menos.

La línea es:

memory_limit = 800M    ; Maximum amount of memory a script may consume

Para conocer la ubicación del fichero php.ini ejecute:

php -i | grep php.ini

Además, dependiendo de la versión de Pandora FMS que usted tenga instalada, puede conseguir más información para actualizar a la versión PHP 7 en este enlace.

Migración a otro sistema

Puede suceder la circunstancia de que necesite una nueva versión de Pandora FMS en otro sistema/distribución diferente o más nueva; por ejemplo, migrar de un CentOS 6 a 8 o de RHEL a CentOS.

1. Proceda a realizar un respaldo de la base de datos del anterior sistema:

mysqldump -u root -p pandora> backup_pandora_X.Y.sql

2. Instale el nuevo sistema Pandora FMS desde cero, o descargue directamente la ISO de Pandora FMS e instale.

3. Después envíe o copie, del modo que sea más sencillo, el archivo backup_pandora_X.Y.sql del sistema viejo al nuevo.

4. Cierre todos los procesos que estén corriendo en el sistema nuevo, excepto mysql; comience por Pandora FMS:

 /etc/init.d/pandora_server stop
 /etc/init.d/pandora_agent_daemon stop
 /etc/init.d/tentacle_serverd stop


A partir de la versión NG 754 dispone de opciones adicionales en el arranque y parada manual de Entornos de Alta Disponibilidad (HA).

5. Para detener el servidor Apache dependerá de la distribución que esté utilizando:

/etc/init.d/apache2 stop
/etc/init.d/httpd stop
systemctl stop httpd.service

6. Entre en mysql con usuario root. Acceda a la base de datos de Pandora FMS en el sistema nuevo, por defecto “pandora” e importe la base de datos.

 # mysql -u root -p
 mysql>use pandora
 Database changed
 mysql>source /home/<your_user>/backup_pandora_X.Y.sql

Esta ruta variará dependiendo del directorio donde tenga el respaldo del sistema anterior.

7. En el caso de que fuese una migración a una versión mayor, en la que cambia la estructura de la base de datos, este sería el momento de ejecutar los scripts de migración tal y como se indica en el procedimiento de actualización mayor de versión.

8. Si hemos realizado un cambio de distribución tenemos que tener en cuenta que el PATH de la consola se ha modificado y en ese caso hay algunos campos en la base de datos que también se han modificado, como son en tconfig attachment_store y fontpath. Para modificar estos campos debemos introducir estas query. El ejemplo es para una migración a CentOS; en otras distribuciones cambiar el path del directorio Apache.

#mysql -u root -p
mysql>use pandora
Database changed
mysql>UPDATE tconfig SET value = '/var/www/html/pandora_console/attachment' WHERE token LIKE 'attachment_store'
mysql>UPDATE tconfig SET value = '/var/www/html/pandora_console/include/fonts/smallfont.ttf' WHERE token LIKE 'fontpath'

Estos PATH también hay que tenerlos en cuenta en los archivos de configuración del servidor y de la consola (config.php y pandora_server.conf)

9. Una vez migrada la base de datos, debe comprobar si los ficheros …/pandora_console/include/config.php y /etc/pandora/pandora_server.conf anterior y los nuevos tienen los mismos datos en los campos dbname, dbuser y dbpass. En el caso de que sean iguales no debemos hacer nada más. Si son diferentes, podemos hacer dos cosas:

a. Sustituir los nuevos ficheros por los antiguos o en su defecto los datos de los ficheros viejos por los que están en los nuevos.

b. Dar permisos a la base de datos con los datos de la nueva instalación. Imaginando que la nueva instalación tiene estos datos: dbname = pandora, dbuser = pandora1 y dbpass = pandora2, se realizaría de este modo:

 #mysql -u root -p
 mysql>grant all privileges on pandora.* to 'pandora1'@'localhost' identified by 'pandora2';
 mysql>flush privileges;

Después de esto, puede volver a arrancar todos los demonios de nuevo y ya podrá acceder a la Consola de Pandora FMS, con todos los Agentes, Módulos, alertas, etc., que tenía configurados y si cambiamos la IP del nuevo Host por la del anterior, todos los Agentes locales reportarán a este nuevo sistema.

En el caso de que se trate de una versión Enterprise, se seguirá el mismo proceso.

Actualización a una versión anterior

Para poder realizar una actualización a una versión menor, bastará con bajar de versión la Consola de Pandora FMS. Se recomienda como precaución realizar una copia de seguridad de la base de datos y de los ficheros de configuración de Pandora FMS, como se ha explicado en secciones anteriores. Siempre tendremos que realizar la instalación del paquete Open Source y posteriormente de la versión Enterprise.

Desde paquetes RPM

  • Actualización de la Consola Open:
rpm -i --force pandorafms_console_package.rpm
  • Actualización de la Consola Enterprise:
rpm -i --force pandorafms_console__enterprise_package.rpm

Desde Tarball/Fuentes

  • Actualización de la consola Open Source:
 tar -xvzf pandorafms_console_package.tar.gz
 mv –f ./pandora_console/* /yourconsolepath
  • Actualización de la consola Enterprise:
 tar -xvzf pandorafms_console_package.tar.gz
 mv -f ./enterprise /yourconsolepath

Volver al Índice de Documentación Pandora FMS