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 ejemplobackup_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
ydbpass
) 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
ydbpass=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.