Pandora: Documentation es: Actualizacion

From Pandora FMS Wiki
Jump to: navigation, search

Volver a Indice de Documentacion Pandora FMS

1 Actualización manual

Es importante comprender los componentes básicos en que se divide Pandora FMS. Fundamentalmente distinguiremos: consola, servidor y base de datos. En instalaciones Opensource 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.

El desglose de componentes es el siguiente. En instalaciones de la versión Opensource:

  • 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. Vamos a organizar las actualizaciones 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.

1.1 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:

1. Realizar un backup de la base de datos. Ej:

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

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

3. Realizar un backup 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.

1.1.1 Desde paquetes RPM

  • Actualización de la consola Open:
rpm -U pandorafms_console_package.rpm
  • Actualización de la consola Enterprise:
rpm -U pandorafms_console_enterprise_package.rpm
  • Actualización del servidor Open:
rpm -U pandorafms_server_package.rpm
  • Actualización del servidor Enterprise:
rpm -U pandorafms_server_enterprise_package.rpm

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

1.1.2 Desde paquetes DEB

  • Actualización de la consola Open:
dpkg -i pandorafms_console_package.deb
  • Actualización de la consola Enterprise:
dpkg -i pandorafms_console_enterprise_package.deb
  • Actualización del servidor Open:
dpkg -i pandorafms_server_package.deb
  • Actualización del servidor Enterprise:
tar zxvf pandorafms_server_enterprise_package.tar.gz
cd pandora_server/
./pandora_server_installer --install

Si hubiese problemas de dependencias, resuelvalos directamente con:

apt-get install -f

1.1.3 Desde Tarball / Fuentes

  • Actualización de la consola Open:
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:
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

1.1.4 Versión 7.0NG ( Rolling Release )

Si decidimos actualizar de modo manual la Consola de Pandora FMS en la versión 7.0NG, (mediante rpms, tarball o deb ) podemos encontrarnos ante 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, los usuarios administradores podrán ver un aviso en la pestaña de notificaciones indicando este problema:

Mr message.png

Para solucionar este problema, deben entrar mediante una shell al servidor donde esté ubicada la consola de Pandora y ubicarse en el directorio /var/www/html/pandora_console/extras/mr . Dentro de este directorio aparecerá otro directorio denominado updated. Dentro del directorio updated 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. Vamos a poner el ejemplo de ejecución del MR1. En este caso no tenemos ningún MR aplicado sobre la base de datos y en el footer de la consola de Pandora aparecerá el MR0. Hemos instalado la versión 704 de forma manual y tendriamos que aplicar el MR1 ejecutando el sql que encontraremos en /var/www/html/pandora_console/extras/mr/ llamado 1.sql. Lo tendremos que 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, desaparecerá el mensaje de warning de la consola de Pandora 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/


1.2 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 6.1 a 7.0.

1.2.1 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 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 podremos encontrarlos aquí:

/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: backup de la base de datos, backup 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:
mysql -u username -p -D databasename

Ejemeplo:

mysql -u pandora -p -D pandora 

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

source /yourconsolepath/extras/pandoradb_migrate_X.Y_to_Z.T.mysql.sql;
  • Actualización de la base de datos Enterprise:
mysql -u username -p -D databasename

Ejemplo:

mysql -u pandora -p -D pandora 

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

source /yourconsolepath/enterprise/pandoradb_migrate_vX.Y_to_vZ.T.mysql.sql;

Para salir del cli de MySQL ejecute el comando "quit". Ya estará actualizada la base de datos a la versión correspondiente.

En caso de necesitar una vuelta atrás, podemos restaurar el backup 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;

2 Actualización automática con Update Manager

2.1 Actualizaciones openSource

Desde la versión 4.0.2, Pandora FMS permite actualizar -desde la versión OpenSource- de actualizaciones semanales semiautomáticas. Para ello se basa en una mejora del sistema Update Manager, antes sólo 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 (nº 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 25MB).
  • Las actualizaciones son automáticas: no están revisadas por el equipo, y aunque en el 99% de los casos no deberia 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.

2.1.1 Proceso a seguir para actualizar su consola

Es bastante sencillo. Simplemente vaya a extensiones -> Update manager. En la pantalla principal podrá ver si hay alguna actualización pendiente, disponible para instalar, así como la versión actual de la consola. Pulse para instalar.

Um online open actualizar es.png

Después del proceso de descarga del paquete, aparecerá un dialogo en el que se le dará la opción de aceptar la actualización de la consola o rechazar.

Dialog um principal es.png

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

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

Dialog hay mr es.jpg

Llegados a este punto, tenemos dos opciones, o bien aplicar el cambio en base de datos, tras el cuál se actualizará la consola, o bien podemos rechazar esta actualización en la base de datos, 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.

Info.png

Para utilizar Update Manager necesita que su consola tenga salida a Internet. Por defecto utilizará WGET para bajarse los paquetes (más rapido), puede utilizar el método CURL (esto se cambia en la configuracion de Pandora) pero este es algo más lento.

 


Después de este proceso, se mostrará la página principal del actualizador con la versión de la consola actualizada. Enhorabuena, ya ha actualizado la versión!.

Um online open finalizado.png

2.2 Actualizaciones Enterprise

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

  • 100% testadas 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).


Para poder usar Update Manager en la versión enterprise, primero ha debido configurar correctamente el actualizador, el cuál tiene su propia sección en el menú:

Opciones um es.png

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, sino aparecerá la de la versión Open.

Um online pag principal es.png

Desde esta página se muestra el número de versión en el que esta 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.

Este proceso, lanzará un dialogo que nos permitirá elegir si proseguir con la actualización o rechazarla.

Dialog um principal es.png

Si decidimos continuar con ella, pueden pasar dos cosas, la primera es que se actualice directamente la consola y terminemos el proceso, y la segunda es que la actualización cuente con cambios en la base de datos, si es así se nos mostrará un dialogo brindándonos la posibilidad de elegir si actualizar la base de datos o no.

Dialog hay mr es.jpg

Si decidimos actualizarla, el proceso continuará de manera normal, pero si la rechazamos, 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 actualizador aparecerá con la versión actual instalada en pandora.

2.2.1 Actualizaciones "offline"

Puede descargarse los actualizaciones "offline" de Pandora, que son unos ficheros con extension .OUM. Para ello vaya a la página de soporte oficial de Pandora FMS, y descargue los ficheros .OUM.

Súbalo a la consola usando este control:

Um offline pag principal es.png

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

Um offline pag principal cargado es.png

La actualización se aplicará siguiendo el mismo flujo de operaciones que en el caso online, mostrando los dialogos correspondientes a la actualización de la consola y de la base de datos en el caso de que hubiera cambios en ésta.

Info.png

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

 


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

Para que Open Update Manager se ejecute correctamente, éste 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 256M, al menos.

La linea es:

memory_limit = 256M	; Maximum amount of memory a script may consume (16MB)

Generalmente, en sistemas Debian/Ubuntu, este fichero está en el directorio /etc/php5/apache2.

Volver a Indice de Documentacion Pandora FMS

3 Migración a otro sistema

Nos podemos ver ante la circunstancia de que queremos usar una nueva versión de Pandora en otro sistema/distribución diferente o más nueva, por ejemplo migrar de un SUSE 11 a un SUSE 12 o de un Ubuntu a CentOS.

Para realizar esto, lo único que tenemos que hacer es instalar en el nuevo sistema Pandora FMS desde cero, o descargar directamente la ISO que proporcionamos e instalarla.

1. Una vez este funcionando Pandora FMS en el nuevo sistema, procederemos a realizar un backup de la base de datos del anterior sistema:

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

2. Despúes enviaremos del modo que nos sea más sencillo el archivo backup_pandora_X.Y.sql del sistema viejo al nuevo.

3. Cerramos todos los procesos que esten corriendo excepto mysql.

/etc/init.d/pandora_server stop 
/etc/init.d/pandora_agent_daemon stop 
/etc/init.d/tentacle_serverd stop 
/etc/init.d/apache2 stop  o /etc/init.d/httpd stop (parar servidor apache, variará dependiendo de la distribución que usemos)

4. Entramos en mysql con usuario root. Accedemos a la base de datos de pandora en el sistema nuevo, por defecto "pandora" e importaremos la base de datos.

#mysql -u root -p
mysql>use pandora
Database changed
mysql>source /home/artica/backup_pandora_X.Y.sql ( esta ruta variará dependiendo el directorio donde tengamos el backup )

5. 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.

6. 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 querys. 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)

7. Una vez migrada la base de datos, tenemos que 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, 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, podemos volver a arrancar todos los demonios de nuevo y ya podremos acceder a la Consola de Pandora, con todos los agentes, módulos, alertas,... que teniamos configurados y si cambiamos la IP del nuevo Host por la del anterior, todos los agentes locales reportaran a este nuevo sistema.

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

4 Actualización del cliente Windows desde el instalador

En el ejecutable de instalación de la consola y el servidor existe una nueva opción que permite actualizar Pandora FMS si está instalada en el equipo una versión anterior.

Inicie el instalador (.exe) como si fuera a realizar una instalación limpia y seleccione el idioma:

Pandora agent 3.0 RC3 install windows 01.png

Siga los pasos del instalador:

Pandora server install windows 01.png

Acepte los términos de la licencia:

Pandora server install windows 02.png

En el apartado Selección de componentes, escoja únicamente la opción de actualizar la versión instalada.

Pandora server update windows 01.png

Seleccione la ruta de instalación que desee y continúe. El instalador le preguntará la IP o el nombre del servidor de Pandora FMS.

Pandora server install windows 05.png

Tras esto empezarán a instalarle los componentes. Aparecerá un aviso recordándole que se necesita Microsoft Visual C++ para que los módulos funcionen adecuadamente.

Pandora server install windows 06 2.png

Cuando haga clic en Terminar, la instalación continuará hasta su finalización.

Pandora server install windows 08.png

Pandora está actualizado y listo para su uso.

Info.png

Con estos pasos, el código de Pandora será actualizado a la última versión, entre cuyos cambios se encuentra la sustitución de Apache por Nginx como servidor Web. En el caso de que se quiera mantener la instalación con Apache, deberá actualizar la consola a través de los paquetes OUM o el Update Manager Online.