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.

Procedimiento

Generalmente la ruta completa a la Consola web PFMS es

/var/www/html/pandora_console

y en las siguientes instrucciones está abreviada como $CONSOLE_PATH .

Exportación de datos

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.

Usted es el único responsable de la salvaguarda de sus datos. Anote en lápiz y papel el procedimiento que elegirá para la mudanza de datos. Tenga cuidado, use redundancia en cuanto a respaldos y procedimientos con varias personas que le ayuden en el proceso.

Importación de datos

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';

Estos PATH también hay que tenerlos en cuenta en los archivos de configuración del servidor y de la consola (ficheros 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 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