Migración a otro sistema

Pueden ser muchas las razones para migrar un servidor PFMS y su Consola web, los cuales generalmente están en una misma máquina real o máquina virtual (Entorno monolito Pandora FMS).

Ejemplos posibles:

• Una nueva versión de Pandora FMS pudiera necesitar un sistema operativo diferente, por ejemplo, migrar de Rocky Linux 8 a RedHat Enterprise (RHEL) 8.
• También pudiera ser el caso de migrar de un proveedor de servicios web a otro: son menos datos los que utiliza Pandora FMS que el acto de realizar una imagen de todo el sistema operativo.
• Para el caso de auditorías o para probar nuevas funcionalidades se necesita tener una copia del servidor principal.

1.- Realice un respaldo de la base de datos del anterior sistema. Son varios los pasos, abra una ventana terminal con derechos de administrador ( usuario root ):

• Comience por hacer una copia lógica de la base da datos con el siguiente comando:

mysqldump --single-transaction --max_allowed_packet=512M -u root -p pandora> backup_pandora_X.Y.sql

• El fichero anterior resultante ( backup_pandora_X.Y.sql ) será comprimido con los siguientes datos a fin de tener un solo fichero para la mudanza. Por ejemplo backup_pandora_X.Y.tar.gz , formato comprimido el cual conserva los valores intrínsecos de cada archivo.
• Comprima todos los ficheros de configuración existentes en el directorio /etc/pandora/*.conf .
• Comprima el directorio y subdirectorios completos de $CONSOLE_PATH/attachment/ .
• Las imágenes e iconos personalizados en $CONSOLE_PATH/images/ , de existir alguno(s).
• Comprima todo el directorio /var/spool/pandora/data_in/ .
• Comprima todos los plugin de servidor ubicados en /usr/share/pandora_server/util/plugin/. Si tienen algún o algunos plugin de servidor ubicado(s) en otro directorio que no esté indicado también los deben comprimir.
• Comprima todas las dependencias instaladas en el servidor origen, que sean necesarias para el correcto funcionamiento de scripts / plugins instalados en el servidor origen y no se encuentren en el servidor destino. Sistemas avanzados necesitarán instalar por completo los entornos de desarrollo integrado ( o entorno de desarrollo interactivo, en inglés Integrated Development Environment, IDE ).
• Comprima todos los certificados SSL y la configuración personalizada del servidor Apache web ubicados en /etc/httpd/ , en caso de existir alguno(s) de ese tipo de ficheros.

2.- Instale el nuevo sistema Pandora FMS desde cero, se recomienda la herramienta de instalación en línea.

3.- Cierre todos los procesos que estén corriendo en el sistema nuevo, excepto mysql; comience por Pandora FMS (a partir de la versión NG 754 dispone de opciones adicionales en el arranque y parada manual de Entornos de Alta Disponibilidad HA):

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

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

5.- Después, envíe o copie, del modo que sea más sencillo, el archivo backup_pandora_X.Y.tar.gz del sistema viejo al nuevo. Descomprima los ficheros en sus correspondientes lugares.

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

USE pandora;
SOURCE ~/backup_pandora_X.Y.sql;

Esta ruta variará dependiendo del directorio donde tenga el respaldo del sistema anterior, aquí se asume que lo tiene en su directorio de usuario ($HOME).

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 guiones (scripts) de migración tal y como se indica en el procedimiento de actualización mayor de versión.

8.- Si ha realizado un cambio de distribución, tenga en cuenta que la ruta o PATH de la Consola web se ha modificado y en ese caso hay algunos campos en la base de datos que también se han modificado, tales como la tabla tconfig y sus campos attachment_store y fontpath. Para modificar estos campos debe introducir estas instrucciones (query). El ejemplo es para una migración a Rocky Linux 8; en otras distribuciones cambiar el path del directorio Apache.

mysql -u root -p> use pandora;

UPDATE tconfig SET VALUE = '/var/www/html/pandora_console/attachment' WHERE token LIKE 'attachment_store';
UPDATE tconfig SET VALUE = '/var/www/html/pandora_console/include/fonts/smallfont.ttf' WHERE token LIKE 'fontpath';

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 vaya al paso número 10.
• Si son diferentes elija una sola de las siguientes opciones:
  • Opción ( a ): Sustituya los nuevos ficheros por los antiguos.
  • Opción ( b ): Copie los datos ( dbname, dbuser y dbpass ) de los ficheros viejos en los nuevos.
  • Opción ( c ): Conceda permisos a la base de datos con los datos de la nueva instalación. Asumiendo que la nueva instalación tiene estos datos: dbname=pandora, dbuser=pandora1 y dbpass=pandora2, el ejemplo toma esta forma:

mysql -u root -p

GRANT ALL privileges ON pandora.* TO 'pandora1'@'localhost' IDENTIFIED BY 'pandora2';
FLUSH privileges;

10.- Después de esto inicie todos los daemon de nuevo y ya podrá acceder a la Consola de Pandora FMS, con todos los Agentes, Módulos, alertas, etcétera.

11.- Si en el nuevo host han cambiado la dirección IP o URL todos los Agentes locales reportarán a este nuevo sistema. Para los Agentes Software deberá modificar el parámetro server_ip en cada uno de ellos.

12.- Utilice, en Operaciones Masivas, la edición de agentes para finalizar cualquier detalle pendiente.

Volver al índice de documentación de Pandora FMS