====== Migración a otro sistema ======

{{indexmenu_n>21}}

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 ([[:es:documentation:pandorafms:installation:01_installing#entorno_monolito_pandora_fms_serverconsoledatabase|Entorno monolito Pandora FMS]]).

//**Ejemplos posibles:** //

   * Una nueva versión de Pandora FMS pudiera necesitar un sistema operativo diferente, por ejemplo, migrar de CentOS 7 a Rocky Linux 8 o 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 =====

<WRAP center round info 90%>

Generalmente la ruta completa a la Consola web PFMS es
<file>

/var/www/html/pandora_console

</file>

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

</WRAP>

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

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

</code>

  * 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 [[:es:documentation:pandorafms:technical_reference:05_anexo_server_plugins_development|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.

<WRAP center round important 90%>

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.

</WRAP>

==== Importación de datos ====

**2.-**  Instale el nuevo sistema Pandora FMS desde cero, se recomienda la [[:es:documentation:pandorafms:installation:01_installing#herramienta_de_instalacion_en_linea|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 [[:es:documentation:pandorafms:installation:06_server_management#arranque_y_parada_manual_de_los_servidores_de_pandora_fms|opciones adicionales en el arranque y parada manual]] de Entornos de Alta Disponibilidad HA):
<code>

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

</code>

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

<code>
/etc/init.d/apache2 stop

</code>

<code>
/etc/init.d/httpd stop

</code>

<code>
systemctl stop httpd.service

</code>

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

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

</code>

//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 [[:es:documentation:pandorafms:installation:02_anexo_upgrade#actualizar_una_version_mayor|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.
<code>

# mysql -u root -p> use pandora;
  Database changed> 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';

</code>

<WRAP center round important 90%>

//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''  ).

</WRAP>

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

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

</code>

**10.-**  Después de esto inicie todos los [[:es:documentation:pandorafms:introduction:03_glossary#demonio|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 [[:es:documentation:pandorafms:installation:05_configuration_agents#server_ip|server_ip]] en cada uno de ellos.

**12.-**  Utilice, en [[:es:documentation:pandorafms:complex_environments_and_optimization:01_massive_operations#operaciones_masivasagentes|Operaciones Masivas, la edición de agentes]] para finalizar cualquier detalle pendiente.

[[:es:documentation:start| Volver al índice de documentación de Pandora FMS]]