Difference between revisions of "Pandora: Documentation es: Actualizacion"

From Pandora FMS Wiki
Jump to: navigation, search
(Servidor Enterprise de Pandora)
(Actualizaciones "offline")
 
(77 intermediate revisions by 14 users not shown)
Line 1: Line 1:
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
  
= Actualizar desde una version anterior=
+
= Actualización manual =
 +
 
 +
Es importante comprender los componentes básicos en que se divide Pandora FMS. Fundamentalmente distinguiremos entre 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.
 +
 
 
== Actualizar una versión menor ==
 
== Actualizar una versión menor ==
  
Una versión menor es por ejemplo cuando se actualiza de la 5.1 a la 5.1 SP1, o cuando pasamos de la 4.0.1 a la 4.0.2. También se puede llamar actualizar una versión menor a pasar por ejemplo de v4.1 Build PC130712 a v4.1 Build PC130920. Una version mayor, p.e: 5.0 a 5.1 o 5.1 a 6.0 se ve en el siguiente apartado.
+
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.
  
La actualización/migración entre versiones que son del mismo nivel (no tienen cambios en el esquema de datos). Sólo tiene que reemplazar su instalación actual por el software nuevo, que actualiza los programas, sin alterar los datos. Para ello, y por la seguridad de su información siga siempre los siguientes pasos:
+
Precauciones iniciales:  
 
 
1. Haga un Backup de su base de datos ( sólo como precaución, no debería ser necesario).
 
  
 +
1. Realizar un backup de la base de datos. Ej:
 
  mysqldump -u root -p pandora > backup_pandora_X.Y.sql
 
  mysqldump -u root -p pandora > backup_pandora_X.Y.sql
  
2. Haga un Backup de sus ficheros de configuración, que son los siguientes:
+
2. Realizar un backup de los ficheros de configuración: pandora_server.conf, config.php, pandora_agent.conf.
  
/etc/pandora/pandora_server.conf
+
3. Realizar un backup de los plugins de servidor y agente, ubicados en:
{Directorio Root de la consola de Pandora}/include/config.php
 
/etc/pandora/pandora_agent.conf
 
  
3. Haga un backup de sus plugins de servidor y de agente (sólo como precaución, no debería ser necesario). Estos ficheros están ubicados generalmente en:
 
 
 
  /etc/pandora/plugins
 
  /etc/pandora/plugins
  {Directorio Root de la consola de Pandora}/attachment/plugin
+
  pandora_console/attachment/plugin
 
  /usr/share/pandora_server/util/plugin
 
  /usr/share/pandora_server/util/plugin
  
4. Detenga todos los procesos que se estén ejecutando de Pandora FMS: pandora_server, pandora_agent, tentacle y mysql. Recordad que podemos tener corriendo el pandora_watchdog.sh y que al parar el pandora_server vuelva a levantarse automáticamente, para ello pararemos también el pandora_watchdog
+
4. Detener los servicios: pandora_server, tentacle_serverd, httpd, pandora_agent y mysqld.
 +
 
 +
5. Proceder a realizar la actualización.
  
/etc/init.d/pandora_server stop
+
=== Desde paquetes RPM ===
/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)
 
/etc/init.d/mysqld stop
 
  
5. Utilice el método que prefiera para actualizar: RPM, DEB o Tarball / Fuente. El proceso de actualización en cada caso se explica despúes.
+
* Actualización de la consola Open:
  
=== Desde paquetes RPM ===
+
rpm -U pandorafms_console_package.rpm
  
Primero debe saber si es una actualización o una reinstalación. Para ello primero mire la versión del paquete instalado en su sistema:
+
* Actualización de la consola Enterprise:
  
  rpm -q -a | grep pandora
+
  rpm -U pandorafms_console_enterprise_package.rpm
  
Si tiene instalados paquetes de pandora, aparecerán como una lista del nombre del paquete y version, p.e:
+
* Actualización del servidor Open:
  
  pandorafms_console-3.0.0-1
+
  rpm -U pandorafms_server_package.rpm
  
Esto significa que tiene instalado el paquete "pandorafms_console" en la version "3.0.0-1". Si quiere instalar la misma versión que ya tiene instalada, puede "reinstalar", escribiendo el comando:
+
* Actualización del servidor Enterprise:
  
  rpm -i --force <nombre_paquete.rpm>
+
  rpm -U pandorafms_server_enterprise_package.rpm
  
A veces se liberan "actualizaciones" de versión con el mismo nombre y numero de version (porque son correcciones de desarrollo, etc), para ello tendra que reinstalar, forzando la instalacion con --force.
+
En todo momento, antes y después de la actualización, podrá conocer sus versiones instaladas mediante la ejecución del comando:
  
Si es el mismo paquete, pero de una versión superior, puede actualizarlo mediante el comando:
+
rpm -qa | grep -i pandora
  
rpm -U <nombre_paquete.rpm>
+
=== Desde paquetes DEB ===
  
Para forzar una actualizaciónde una versión que ya tiene instalada, algo muy similar a la reinstalación, pero que mantendrá sus ficheros originales si han sido modificados y la nueva versión tenía la misma versión que los paquetes que originalmente instaló, puede forzar la actualización:
+
* Actualización de la consola Open:
  
  rpm -U --force <nombre_paquete.rpm>
+
  dpkg -i pandorafms_console_package.deb
  
Tenga especial precaución antes de reinstalar o actualizar ningun paquete y realice copias de seguridad de:
+
* Actualización de la consola Enterprise:
  
* /etc/pandora/pandora_server.conf: En el caso del paquete del servidor de Pandora FMS.
+
dpkg -i pandorafms_console_enterprise_package.deb
* /etc/pandora/pandora_agent.conf: En el caso del paquete del agente Pandora FMS.
 
  
=== Desde paquetes DEB ===
+
* Actualización del servidor Open:
  
Si está utilizando un sistema Debian o Ubuntu, u otro sistema que utilice paquetes .deb, instale el nuevo paquete. Este proceso desinstalará automáticamente el anterior, por ejemplo:
+
dpkg -i pandorafms_server_package.deb
  
  dpkg -i nombrepaquete.deb.
+
* Actualización del servidor Enterprise:
 +
   
 +
tar zxvf pandorafms_server_enterprise_package.tar.gz
 +
cd pandora_server/
 +
./pandora_server_installer --install
  
Si tiene problemas de dependencias, resuelvalos directamente con:
+
Si hubiese problemas de dependencias, resuélvalos directamente con:
  
 
  apt-get install -f
 
  apt-get install -f
Line 75: Line 89:
 
=== Desde Tarball / Fuentes ===
 
=== Desde Tarball / Fuentes ===
  
==== Consola WEB ====
+
* Actualización de la consola Open:
  
En linux (también se aplica a Vmware image o CD Appliance). Una vez descargado el tarball como root:
+
  tar xvzf pandorafms_console_package.tar.gz
 
  tar xvzf <fichero_tarball>
 
 
  cd pandora_console
 
  cd pandora_console
  ./pandora_console_upgrade -p {Directorio Root de la consola de Pandora}
+
  ./pandora_console_upgrade -p /yourconsolepath
  
El segundo parámetro (p.e: ''/srv/www/htdocs/pandora_console'', es el path donde tiene instalada su consola de Pandora FMS). Varia en funcion de la distro de Linux que tenga y el path que usted haya configurado.
+
* Actualización de la consola Enterprise:
  
==== Servidor ====
+
tar xvzf pandorafms_console_enterprise_package.tar.gz
 +
cd pandora_console
 +
./pandora_console_upgrade -p /yourconsolepath
  
Para el servidor, primero descomprima el fichero tarball que contiene el servidor de Pandora FMS, como root:
+
* Actualización del servidor Open:
  
cd /tmp
+
  tar xvzf pandorafms_server_package.tar.gz  
  tar xvzf pandorafms_server_xxxx.tar.gz  
+
cd pandora_server
 +
./pandora_server_upgrade --upgrade
  
Proceda a hacer la actualización
+
* Actualización del servidor Enterprise:
  
 +
tar xvzf pandorafms_server_enterprise_package.tar.gz
 
  cd pandora_server
 
  cd pandora_server
 
  ./pandora_server_upgrade --upgrade
 
  ./pandora_server_upgrade --upgrade
  
==== Agente ====
+
* Actualización del agente:
 
 
Descomprimir el fichero tarball y ejecutar lo siguiente como root:
 
 
 
cd /tmp
 
tar xvzf pandorafms_unix_agent_xxx.tar.gz
 
 
 
Ejecute la herramienta de instalación que volverá a instalar el agente en su totalidad, así como las herramientas y plugins que contiene. Este instalador hace una copia de seguridad automática de sus archivos de configuración en''/etc/pandora/pandora_agent.conf.yyyy-mm-dd''. Simplemente ejecute el script y copie el contenido de su copia de seguridad del fichero de configuración en /etc/pandora/pandora_agent.conf.
 
  
 +
tar xvzf pandorafms_agent_package.tar.gz
 
  cd pandora_agent
 
  cd pandora_agent
 
  ./pandora_agent_installer --force-install
 
  ./pandora_agent_installer --force-install
cp /etc/pandora/pandora_agent.conf.xxxxxxx /etc/pandora/pandora_agent.conf
 
  
Ya puede borrar de forma segura los ficheros temporales:
+
=== Versión 7.0NG ( Rolling Release ) ===
  
rm -Rf /tmp/pandora_agent
+
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.
  
{{Tip|'''Para expertos''', puede reemplazar solo el ejecutable del agente /usr/bin/pandora_agent o c:\program files\pandora_agent\pandoraAgent.exe para actualizar el agente. Pare antes el proceso/servicio para reemplazar el ejecutable. De esta manera no tiene que actualizar todo el agente, solo su ejecutable.}}
+
En el caso de que tengamos la base de datos desactualizada (un error poco frecuente que no debería ocurrir en condiciones normales), los usuarios administradores podrán ver un aviso en la pestaña de notificaciones indicando este problema:
  
 +
<center>
 +
[[image:mr_message.png|center]]
 +
</center>
  
Recuerde que entre el lanzamiento de las versiones "menores" no existen cambios en el esquema de la base de datos, asi que bastará con reemplazar los ficheros tal y como se ha descrito arriba. Las versiones "mayores", por ejemplo 3.0 a 3.1, 2.1 a 3.0, tienen cambios en el esquema de la base de datos y requirirán una conversión de la base de datos. Consulte el apartado de la documentación para obtener más detalles.
+
Para solucionar este problema, deben entrar mediante una shell al servidor donde esté ubicada la consola de Pandora FMS 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 FMS aparecerá el MR0. Hemos instalado la versión 704 de forma manual y tendríamos 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í:
=== Actualizar versión Enterprise ===
 
  
==== Agente ====
+
[[email protected] mr]# cat 1.sql | mysql -u root -p pandora
  
Solo es necesario para los agentes Android, que tienen un .APK especial, diferente del OpenSource. El resto de agentes no tienen versión enterprise.
+
Siendo root el usuario de MySQL y pandora el nombre de la base de datos.
  
==== Consola ====
+
Una vez aplicado, deberemos actualizar el valor del MR dentro de la tabla de MySQL tconfig para cambiar el valor del footer al actual. Se debe realizar con el siguiente mandato dentro del mysql:
  
Tendrá disponible en la web de soporte de Artica, o a través de su partner, acceso a los paquetes RPM (centos/redhat), DEB (debian/ubuntu), o RPM (suse/opensuse). El proceso de actualizacion del paquete enterprise de la consola es exactamente igual que el procedimiento de actualizacion del paquete Open. Recuerde que primero tiene que hacer el procedimiento sobre el paquete Open y luego sobre el enterprise.
+
mysql> use pandora;
 +
mysql> update tconfig set value= XX where token='MR';
  
==== Servidor ====
+
Una vez realizado, desaparecerá el mensaje de warning de la consola de Pandora FMS y en el footer de la consola podremos ver el MR1 aplicado. El siguiente paso será mover el sql dentro de la carpeta updated. Para conocer que MRs se deben aplicar, por favor vaya al siguiente [[Pandora:Documentation_es:Versiones| enlace.]]
  
El procedimiento se realiza sobre el fichero tarball de 32 o 64 bit, en función de la arquitectura de su sistema. Una vez que tenga el tarball, ejecute como root:
+
[root@localhost mr]# mv 1.sql updated/
 
 
# ./pandora_server_installer --install
 
 
 
En el caso de que el binario del servidor de Pandora no se encuentre en el directorio por defecto (/usr/bin) habrá que indicar el directorio de la siguiente forma:
 
 
 
# PREFIX=/usr/local ./pandora_server_installer --install
 
 
 
Esto debería actualizar correctamente su versión enterprise.
 
 
 
Al igual que en la version open, el servidor debe ser reiniciado después de actualizarlo.
 
 
 
=== Actualizando de la versión 5.1SP1 a la 5.1SP2 ===
 
 
 
==== Servidor Enterprise de Pandora ====
 
 
 
El Servidor ICMP Enterprise ahora utiliza Fping en vez de Nmap para ejecutar las peticiones de ping. Asegúrese de que está instalado y configurado en pandora_server.conf:
 
 
 
# Path to the fping binary. Used by the Enterprise ICMP Server.
 
fping /usr/bin/fping
 
 
 
 
 
Para instalar fping puede utilizar el gestor de paquetes de su distribución de Linux.
 
 
 
Por ejemplo:
 
 
 
En el caso de los basados en RHEL/Centos/Fedora:
 
 
 
sudo yum install fping
 
 
 
==== Servidor Satélite ====
 
 
 
El Servidor Satélite ahora utiliza Fping en vez de Nmap para ejecutar las peticiones de ping. Asegúrese de que está instalado y configurado en satellite_server.conf:
 
 
 
# Path to the fping binary.
 
fping /usr/bin/fping
 
  
 
== Actualizar una versión mayor ==
 
== Actualizar una versión mayor ==
  
Este es el mismo proceso que para una versión menor, pero '''además necesitará actualizar su esquema de base de datos'''.  
+
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.
  
 
=== Actualización de la base de datos (Versiones "mayores")  ===
 
=== Actualización de la base de datos (Versiones "mayores")  ===
  
Siempre que hay una actualización de una version "Mayor", por ejemplo, 3.0 a 3.1 o 3.x a 4.x, es necesario actualizar el esquema de la Base de datos. Esta actualización es siempre '''manual y se hace desde la línea de comandos'''.  
+
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.
  
Esta actualización convierte toda la información (datos y estructura de la BBDD) al formato de la version más actual (ahora mismo la 3.1). No se debería perder información de ningún tipo en el upgrade desde una versión a otra, pero en cualquier caso '''SIEMPRE''' haga una copia de seguridad, no sólo de sus datos (base de datos), y haga una copia de sus ficheros de configuración y código de la consola. Para actualiar, siga los en orden los pasos descritos a continuación:
+
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í:
  
Los scripts .sql de actualización de la base de datos están contenidos en el directorio /extras de la consola y de la consola enterprise. Antes de actualizar la base de datos tiene que actualizar la consola y la consola enterprise. Esta actualización puede ser mediante RPM, DEB o Tarball/Fuente. Primero actualice el software, ANTES de comenzar la actualización de la base de datos.  
+
/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
  
Si ha realizado bien este paso, encontrará en el directorio {PANDORA_CONSOLE}/extras fichero llamado  ''pandoradb_migrate_vX.Y_to_vX.Z.sql''. Siendo {PANDORA_CONSOLE} el directorio donde tiene instalado la consola, por ejemplo /srv/www/htdocs/pandora_console en sistemas SUSE.
+
Antes de proceder a la actualización se recomienda seguir las precauciones iniciales anteriormente descritas: backup de la base de datos y backup de los ficheros de configuración. También será necesario detener el servicio del server de Pandora FMS:
  
Este fichero, tiene todo el código SQL necesario para transformar su base de datos en formato X.Y al formato X.Z, para dejarla lista para usar con un Pandora FMS de la version X.Z. Los pasos necesarios para la conversión de versión son:
+
service pandora_server stop
  
'''1'''. Haga un backup. Si algo falla, se arrepentirá de no haberlo hecho.
+
* Actualización de la base de datos Open:
  
  mysqldump -u root -p pandora > backup_pandora_X.Y.sql
+
  mysql -u username -p -D databasename
  
'''2'''. Pare su sistema Pandora FMS y pare el proceso Apache (Servidor WEB)
+
Ejemplo:
  
  /etc/init.d/pandora_server stop
 
  /etc/init.d/apache stop
 
 
'''3'''. Aplique el script de actualización para actualizar su base de datos. Lo encontrará una vez que haya instalado los paquetes de la nueva versión. Este script le preguntará por la password y el usuario de su Base de datos de Pandora. Puede obtenerla mirando el contenido del fichero ''/etc/pandora/pandora_server.conf''. Asumimos en esta documentación que su BD se llama "pandora" y está corriendo en la misma máquina donde ejecuta el script. Para actualizar ejecute este comando:
 
 
cd /srv/www/htdocs/pandora_console
 
 
  mysql -u pandora -p -D pandora  
 
  mysql -u pandora -p -D pandora  
 
   
 
   
Entrará en el cli de MySQL, ejecute el siguiente comando:
+
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;
 +
 
 +
{{Tip|Al ejecutar el migrate de la versión Open, se actualizará también la versión Enterprise.}}
  
source extras/pandoradb_migrate_vX.Y_to_vX.Z.sql;
+
Para salir del cliente de MySQL ejecute el comando "quit". Ya estará actualizada la base de datos a la versión correspondiente.
  
Para salir del cli de MySQL ejecute el comando "quit"
+
En caso de necesitar una vuelta atrás, podemos restaurar el backup de la base de datos mediante este procedimiento:
  
Después de unos minutos, la base de datos está lista para trabajar con la última versión. Puede que vea advertencias (WARNING) pero no deberia ver ningun error. Aun en el caso de que los hubiere, el sistema se habrá actualizado, si ha fallado algo, deberá reportarlo a soporte, indicando la linea y el errror, puede verlo en el histórico de comandos del cli de mysql.
+
mysql -u username -p databasename
 +
> drop database databasename;
 +
> create database newdatabasename;
 +
> use newdatabasename;
 +
> source backup_pandora_X.Y.sql
  
En caso de cualquier problema, el backup puede ser restaurado para operar con la versión anterior con el siguiente comando:
+
Ejemplo:
  
  mysql -u root -p
+
  mysql -u root -p pandora
 
  > drop database pandora;
 
  > drop database pandora;
 
  > create database pandora;
 
  > create database pandora;
 
  > use pandora;
 
  > use pandora;
  > source backup_pandora_X.Y.sql
+
  > source backup_pandora_X.Y.sql;
 +
 
 +
= Actualización automática con Update Manager =
 +
 
 +
== Actualizaciones openSource ==
  
=== Esquema de la base de datos Enterprise DB ===
+
Desde la versión 4.0.2, Pandora FMS permite realizar -desde la versión OpenSource- actualizaciones semanales semiautomáticas. Para ello, se basa en una mejora del sistema Update Manager, antes solo 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.
  
<br><br>
+
Esta actualización tiene las siguientes características:
{{warning|Es muy importante que se '''ejecute antes el script de migración "Open"''' contenido en la carpeta extras, como se indica en el apartado anterior}}
 
  
El proceso es idéntico al anterior. En el directorio ''/enterprise'' existe un fichero llamado  ''pandoradb_migrate_v3.2_to_v4.0.sql'' (si, igual que el de la version Open). Usaremos este fichero para hacer la migración del esquema de la BD igual que hicimos en el paso anterior:
+
* 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 (de agentes).
cd  cd /srv/www/htdocs/pandora_console
+
* Se descargará la actualización desde Sourceforge, del directorio de actualizaciones semanales.
cat enterprise/pandoradb_migrate_v3.2_to_v4.0.sql | mysql -u pandora -p -D pandora
+
* 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 debería 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.
  
=== Notas de actualización desde la versión 5.0 a la 5.1  ===
+
=== Proceso a seguir para actualizar su consola ===
  
==== Consola web de Pandora ====
+
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.
* Es necesario eliminar el antiguo "update manager", y son el fichero <pandora_console>/extensions/update_manager.php y el directorio <pandora_console>/extensions/update_manager/.
 
  
==== Scripts y tareas de reconocimiento ====
+
<center>
 +
[[file:um_online_open_actualizar_es.png|center|500px]]
 +
</center>
 +
 
 +
Después del proceso de descarga del paquete, aparecerá un diálogo en el que se le dará la opción de aceptar la actualización de la consola o rechazar.
  
Los campos de las tareas recon tenían cuatro campos estáticos hasta la versión 5.0. Estos campos han sido cambiados en Pandora FMS 5.1 a un sistema dinámico de campos definidos en la creación de los scripts de reconocimiento (similar a las macros de los plugins). Esto implica algunos cambios en la estructura y almacenamiento de base de datos.
+
<center>
 +
[[file:dialog_um_principal_es.png|center|500px]]
 +
</center>
  
Debido a estos cambios, necesitamos ejecutar el siguiente script tras la actualización:
+
Pulse el botón de confirmación para comenzar el proceso de actualización.
  
/usr/share/pandora_server/util/pandora_migrate_recon_scripts.pl <dbname> <dbhost> <dbuser> <dbpass>
+
Algunas de las actualizaciones llevan consigo modificaciones en base de datos. El propio proceso de actualización le lanzará un diálogo avisando de que existen estos cambios, como se muestra en la siguiente captura.
  
Esto creará en la tabla de los scripts de reconocimiento los 4 campos antiguos como campos dinamicos y adaptará los campos usados en las tareas de reconocimeinto al nuevo formato manteniendo compatibilidad con las tareas recon previamente creadas.
+
<center>
 +
[[file:dialog_hay_mr_es.jpg|center|500px]]
 +
</center>
  
Es posible que al intentar arrancar el servicio pandora_server encontremos este error en el log:
+
Llegados a este punto tenemos dos opciones, o bien aplicar el cambio en base de datos, tras el cual se actualizará la consola, o bien podemos rechazar esta actualización en la base de datos, y 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.
  
DBI connect('pandora:localhost:3306','pandora',...) failed: Can't
+
{{tip|Para utilizar Update Manager necesita que su consola tenga salida a Internet. Por defecto, utilizará WGET para bajarse los paquetes (más rápido); puede utilizar el método CURL (esto se cambia en la configuración de Pandora FMS) pero este es algo más lento.}}
connect to local MySQL server through socket '/tmp/mysql.sock' (2) at
 
/</usr/local/bin/pandora_server>PandoraFMS/DB.pm line 108.
 
  
Pruebe a modificar en el fichero ''/etc/pandora/pandora_server.conf'' el servidor el parametro dbhost con la ip 127.0.0.1 en vez de localhost. Esto se debe a una combinacion específica de factores de version de MySQL y Perl.
+
Después de este proceso, se mostrará la página principal del actualizador con la versión de la consola actualizada. ¡Enhorabuena, ya hemos actualizado la versión!
  
=== Notas de actualización desde la versión 4.x a la 5.0  ===
+
<center>
 +
[[file:um_online_open_finalizado.png|center|500px]]
 +
</center>
  
<br><br>
+
== Actualizaciones Enterprise ==
  
{{warning|En la versión 5.0 hay funciones del API web que han sufrido cambios y son las siguientes: '''set create_event'''}}
+
A diferencia de las actualizaciones Open, estas tienen algunas características adicionales:
  
==== Alertas compuestas ====
+
* 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).
  
En la versión 5.0 las alertas compuestas se han eliminado completamente. Si existen serán eliminadas en el proceso de migración.
+
* Actualizaciones específicas (incrementales) que permiten actualizar solo lo que está desactualizado, sin descargar paquetes pesados de Internet.
  
==== Plugins ====
+
* 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).
  
El sistema de Plugins ha cambiado en Pandora FMS 5.0. Los datos de estos módulos ahora son diferentes, por lo que será necesario adaptarlos.
+
=== Configuración ===
  
Si la instalación actual dispone de plugins y módulos de tipo plugin, tras la actualización deberemos ejecutar el script:
+
Para poder usar Update Manager en la versión Enterprise, primero ha debido configurar correctamente el actualizador, el cual tiene su propia sección en el menú:
  
/usr/share/pandora_server/util/pandora_migrate_plugins.pl <dbname> <dbhost> <dbuser> <dbpass>
+
<center>
 +
[[image:opciones_um_es.png|center]]
 +
</center>
  
Los ficheros PSPZ para importar plugins de versiones anteriores a la 5.0 '''son compatibles''' con el nuevo sistema.
+
=== Actualizaciones "online" ===
  
=== Notas de actualización desde la versión 3.2.1 a la 4.0  ===
+
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; si no, aparecerá la de la versión Open.
  
Es necesario en la actualización a través de una instalación limpia, por lo cual debes hacer un backup del fichero /var/www/pandora_console/include/config.php y después realizar una desinstalación del paquete.
+
<center>
 +
[[image:um_online_pag_principal_es.png|center|750px]]
 +
</center>
  
Después de actualizar la consola ya sea desde Tarballs, DEB o RPM y acceder a la consola web pueden aparecer el siguientes errores:
+
Desde esta página se muestra el número de versión en el que está en Pandora FMS y se notificará la existencia de nuevas actualizaciones.
  
Notice: Undefined index: dbtype in /var/www/pandora_console/include/functions_db.php on line 32
+
Para actualizar a la última versión pulse en el enlace que muestra la imagen en su consola de Pandora FMS.
Notice: Undefined index: dbtype in /var/www/pandora_console /include/functions_db.php on line 48
 
Notice: Undefined index: dbtype in /var/www/pandora_console/include/functions_db.php on line 625
 
  
Para solucionar dicho error simplemente hay añadir la siguiente línea al archivo <pandora_console_path>/include/config.php:
+
Este proceso lanzará un diálogo que nos permitirá elegir si proseguir con la actualización o rechazarla.  
  
$config["dbtype"]="mysql";
+
<center>
 +
[[image:dialog_um_principal_es.png|center|500px]]
 +
</center>
  
Si tiene la antigua extension SSH instalada, por favor, bórrela, no está soportada en la version 4.0 y hará que la consola no funcione:
+
Si decidimos continuar con ella, pueden pasar dos cosas. La primera es que se actualice directamente la consola y terminemos el proceso. 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.
  
rm -Rf <path a la consola de pandora>/extensions/ssh_console*
+
<center>
 +
[[image:dialog_hay_mr_es.jpg|center|500px]]
 +
</center>
  
Algunas configuraciones, al migrar dan problemas en el autoincremental del una tabla. Si es su caso, inserte esta secuencia SQL en su base de datos (usando mysql por linea de comando o la extension SQL de pandora):
+
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.
  
ALTER TABLE tsesion AUTO_INCREMENT = 1;
+
Después del proceso, el actualizador aparecerá con la versión actual instalada en Pandora FMS.
  
Después de actualizar el servidor, tendrá dos tipos de servidores nuevos disponibles para la monitorización a alta  velocidad con ICMP y SNMP, pero estos tienen requisitos especiales. Por favor, lea con detalle estas nuevas características y desactívelos por defecto la configuración de las siguientes líneas en su pandora_sever.conf:
+
=== Actualizaciones "offline" ===
  
  snmpserver 0
+
Puede descargarse las actualizaciones "offline" de Pandora FMS, que son unos ficheros con extensión .OUM. Para ello, vaya a la página de soporte oficial de Pandora FMS y descargue los ficheros .OUM.
  icmpserver 0
 
  
== Problemas al actualizar desde una versión anterior (Librerías PERL) ==
+
Súbalo a la consola usando este control:
  
Algunas veces al actualizar, las librerías de Pandora se desplazan a lugares diferentes donde está instalada la versión antigua, así que después de una actualización tendrá dos versiones diferentes de las librerías de Pandora FMS y no podrá saber exactamente que versión se utilizará, si la versión antigua o la nueva. La mejor solución es ubicar las librerías, borrarlas todas y reinstalar/actualizar. Para ello deberá ejecutar:
+
<center>
 +
[[image:um_offline_pag_principal_es.png|center]]
 +
</center>
  
find /usr -name "Core.pm"
+
Al subirlo, aparecerá el fichero cargado, dándonos la posibilidad de pinchar en él y comenzar el proceso de actualización.
  
Esto le mostrará algunas lineas como estas:
+
<center>
 +
[[image:um_offline_pag_principal_cargado_es.png|center]]
 +
</center>
  
/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/Core.pm
+
La actualización se aplicará siguiendo el mismo flujo de operaciones que en el caso online, mostrando los diálogos correspondientes a la actualización de la consola y de la base de datos, en el caso de que hubiera cambios en esta.
  
Las librerías de Pandora FMS se encuentran en ''/usr/lib/perl5/site_perl/5.10.0/PandoraFMS/''. Bórrela de manera segura y reinstálela de nuevo (desde los paquetes o las fuentes tarball).
+
{{tip|También desde el mismo modo con los OUM, puede actualizar la consola de Pandora FMS por medio de archivos zip generados por nuestros técnicos.}}
  
rm -Rf /usr/lib/perl5/site_perl/5.10.0/PandoraFMS/
+
{{Warning|En caso de actualizar una instalación con Alta Disponibilidad (HA), será necesario tener en cuenta lo indicado en [[https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:HA#Actualizaci.C3.B3n esta sección]].}}
  
La versión Perl y la localización exacta puede variar en cada distribución Linux, así que necesitará ubicar en primer lugar el directorio escrito allí.
+
== Configuración adicional del motor PHP para la operación de Update Manager ==
  
== Problemas al actualizar desde una versión anterior (Database) ==
+
Para que Open Update Manager se ejecute correctamente, este 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.
  
Si encuentra algún problema, es probablemente porque este actualizando a una versión 3.x que procede de una versión 2.x. o porque ha hecho cambios en el esquema de la BD. Si obtiene un mensaje como este:
+
La línea es:  
  
  ERROR 1005 (HY000) at line 101: Can't create table './pandora/talert_template_modules.frm' (errno: 150)
+
  memory_limit = 256M ; Maximum amount of memory a script may consume (16MB)
  
Esto se debe a un problema en MySQL porque algunos campos no tienen el tipo deseado. Por ejemplo, en algunas versiones el campo id_agente_modulo tiene el tipo bigint(10). Si ha migrado desde la 1.x seguramente haya tenido antes este problema. Antes de poner en marcha la herramienta de migración para la 3.0, meta este comando en la consola mysql:
+
Generalmente, en sistemas Debian/Ubuntu, este fichero está en el directorio /etc/php5/apache2.
  
ALTER TABLE tagente_modulo MODIFY id_agente_modulo bigint(10) unsigned NOT NULL auto_increment;
+
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
  
E intente correr otra vez la herramienta de actualización. Por favor, recuerde que necesita soporte InnoDB para el servidor de su base de datos MySQL.
+
[[Category: Pandora FMS]]
  
 
= Migración a otro sistema =
 
= 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.
+
Nos podemos ver ante la circunstancia de que queramos usar una nueva versión de Pandora FMS 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.
 
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:
+
1. Una vez esté 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
 
  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.
+
2. Después 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.
+
3. Cerramos todos los procesos que estén corriendo excepto mysql.
  
 
  /etc/init.d/pandora_server stop  
 
  /etc/init.d/pandora_server stop  
 
  /etc/init.d/pandora_agent_daemon stop  
 
  /etc/init.d/pandora_agent_daemon stop  
 
  /etc/init.d/tentacle_serverd 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)
+
  /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.
+
4. Entramos en mysql con usuario root. Accedemos a la base de datos de Pandora FMS en el sistema nuevo, por defecto "pandora" e importaremos la base de datos.
  
 
  #mysql -u root -p
 
  #mysql -u root -p
 
  mysql>use pandora
 
  mysql>use pandora
 
  Database changed
 
  Database changed
  mysql>source /home/artica/backup_pandora_X.Y.sql ( esta ruta variará dependiendo el directorio donde tengamos el backup )
+
  mysql>source /home/artica/backup_pandora_X.Y.sql (esta ruta variará dependiendo del 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 esctructura 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 actualizacion mayor de versión.
+
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.
+
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 -u root -p
Line 362: Line 363:
 
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:
 
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 estan en los nuevos.
+
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:
+
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 -u root -p
Line 370: Line 371:
 
  mysql>flush privileges;
 
  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.  
+
Después de esto, podemos volver a arrancar todos los demonios de nuevo y ya podremos acceder a la Consola de Pandora FMS, con todos los agentes, módulos, alertas, etc., que teníamos configurados y si cambiamos la IP del nuevo Host por la del anterior, todos los agentes locales reportarán a este nuevo sistema.  
  
 
En el caso de que se trate de una versión Enterprise, se seguirá el mismo proceso.
 
En el caso de que se trate de una versión Enterprise, se seguirá el mismo proceso.
  
= Actualizaciones de seguridad / Parches =
+
= Actualización del cliente Windows desde el instalador =
  
Una actualización de seguridad o parche de seguridad es un pequeño parche generalmente para la Consola, pero usted también puede tener un parche de seguridad para el servidor. Salvo instrucciones en sentido contrario (más específicas), debe seguir los mismos pasos que los descritos para una actualización menor.
+
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.  
  
= Actualizaciones de la consola con Update Manager =
+
Inicie el instalador (.exe) como si fuera a realizar una instalación limpia y seleccione el idioma:
  
== Actualizaciones openSource ==
+
<center>
 +
[[image:Pandora_agent_3.0_RC3_install_windows_01_es.png]]
 +
</center>
  
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.
+
Siga los pasos del instalador:
  
Esta actualización tiene las siguientes características:
+
<center>
 +
[[image:Pandora_server_install_windows_01.png]]
 +
</center>
  
* Necesitará estar conectado a internet desde su consola de Pandora FMS (hacia fuera).
+
Acepte los términos de la licencia:
* 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.
 
  
=== Proceso a seguir para actualizar su consola ===
+
<center>
 +
[[image:Pandora_server_install_windows_02_es.png]]
 +
</center>
  
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 lista de las actualizaciones anteriores instaladas (en esta captura de pantalla, ninguna aún). Pulse instalar.
+
En el apartado Selección de componentes, escoja '''únicamente''' la opción de actualizar la versión instalada.
  
 
<center>
 
<center>
<br><br>
+
[[image:Pandora_server_update_windows_01_es.png]]
[[file:Update_manager_open.png|center|760px]]
 
<br><br>
 
 
</center>
 
</center>
  
Pulse el botón de instalar.
+
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.
 
 
{{tip|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.}}
 
  
 
<center>
 
<center>
<br><br>
+
[[image:Pandora_server_install_windows_05_es.png]]
[[file:Update_manager_open2.png|center|760px]]
+
</center>
<br><br>
+
 +
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.
 +
 
 +
<center>
 +
[[image:Pandora_server_install_windows_06_2.png]]
 
</center>
 
</center>
  
Una vez descargado e instalado el paquete, volveremos a la pantalla principal que tendrá este aspecto. Muestra las actualizaciones instaladas y un mensaje de que no hay más actualiazciones disponibles. Enhorabuena, ya ha actualizado la versión!.
+
Cuando haga clic en Terminar, la instalación continuará hasta su finalización.
 
+
 
<center>
 
<center>
<br><br>
+
[[image:Pandora_server_install_windows_08.png]]
[[file:Update_manager_open3.png|center|760px]]
 
<br><br>
 
 
</center>
 
</center>
  
== Actualizaciones Enterprise ==
+
Pandora FMS está actualizado y listo para su uso.
 
 
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 su nº de serie y tener instalado el "keygen", y configurado éste adecuadamente, en la pantalla de setup, tal y como se muestra aquí:
 
  
<center><br><br>
+
{{Tip|Con estos pasos, el código de Pandora FMS 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.}}
[[image:Update_manager4.png|center]]
 
</center><br><br>
 
  
Desde Operation>Extensions>Open Update Manager, 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.
+
= Actualización a una versión anterior =
  
<center><br><br>
+
Para poder realizar una actualización a una versión menor, bastará con bajar de versión la consola de Pandora FMS. Se recomienda como precaución realizar una copia de seguridad de la base de datos y de los ficheros de configuración de Pandora FMS, como se puede observar anteriormente. Siempre tendremos que realizar la instalación del paquete Open y posteriormente de la versión Enterprise.
[[image:Update_manager5.png|center|750px]]
 
</center><br><br>
 
  
Desde esta página se muestra el número de versión en el que esta e Pandora FMS y se notificara la existencia de nuevas actualizaciones.
+
==Desde paquetes RPM==
  
Para actualizar a una versión posterior se pulsa en “Update”.
+
* Actualización de la consola Open:
 +
rpm -i --force pandorafms_console_package.rpm
 +
* Actualización de la consola Enterprise:
 +
rpm -i --force pandorafms_console__enterprise_package.rpm
  
Es posible marcar la casilla “Overwrite local changes” para sobre escribir los cambios locales lo que implica que si tenemos alguna modificación local, esta será sobreescrita por las actualizaciones.
+
==Desde paquetes DEB==
  
=== Actualizaciones "offline" ===
+
* Actualización de la consola Open:
 +
dpkg –i  --force pandorafms_console_package.rpm
 +
* Actualización de la consola Enterprise:
 +
dpkg -i --force pandorafms_console__enterprise_package.rpm
  
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, que tendran un aspecto similar a este:
+
==Desde Tarball/Fuentes==
  
<center><br><br>
+
* Actualización de la consola Open:
[[image:Update_manager7.png|center|750px]]
+
tar -xvzf pandorafms_console_package.tar.gz
</center><br><br>
+
mv –f ./pandora_console/* /yourconsolepath
  
Súbalo a la consola usando este control:
+
* Actualización de la consola Enterprise:
 
+
tar -xvzf pandorafms_console_package.tar.gz
<center><br><br>
+
mv -f ./enterprise /yourconsolepath
[[image:Update_manager6.png|center]]
 
</center><br><br>
 
 
 
Y aplicará automáticamente la actualización.
 
 
 
{{tip|También desde el mismo modo con los OUM, puede actualizar el Pandora Console por medio de archivos zip generados por nuestros técnicos.}}
 
 
 
== 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.
 
 
 
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
 
 
 
[[Category: Pandora FMS]]
 

Latest revision as of 09:20, 2 March 2020

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 entre 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, resuélvalos 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 (un error poco frecuente que no debería ocurrir en condiciones normales), 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 FMS 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 FMS aparecerá el MR0. Hemos instalado la versión 704 de forma manual y tendríamos 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, deberemos actualizar el valor del MR dentro de la tabla de MySQL tconfig para cambiar el valor del footer al actual. Se debe realizar con el siguiente mandato dentro del mysql:

mysql> use pandora;
mysql> update tconfig set value= XX where token='MR';

Una vez realizado, desaparecerá el mensaje de warning de la consola de Pandora FMS y en el footer de la consola podremos ver el MR1 aplicado. El siguiente paso será mover el sql dentro de la carpeta updated. Para conocer que MRs se deben aplicar, por favor vaya al siguiente enlace.

[[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 y 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

Ejemplo:

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;

Info.png

Al ejecutar el migrate de la versión Open, se actualizará también la versión Enterprise.

 


Para salir del cliente 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 realizar -desde la versión OpenSource- actualizaciones semanales semiautomáticas. Para ello, se basa en una mejora del sistema Update Manager, antes solo 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 debería 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 diálogo 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 le lanzará un diálogo 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 cual se actualizará la consola, o bien podemos rechazar esta actualización en la base de datos, y 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 rápido); puede utilizar el método CURL (esto se cambia en la configuración de Pandora FMS) 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 hemos 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).

2.2.1 Configuración

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

Opciones um es.png

2.2.2 Actualizaciones "online"

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; si no, 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 está 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 FMS.

Este proceso lanzará un diálogo 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. 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 FMS.

2.2.3 Actualizaciones "offline"

Puede descargarse las actualizaciones "offline" de Pandora FMS, que son unos ficheros con extensión .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 diálogos correspondientes a la actualización de la consola y de la base de datos, en el caso de que hubiera cambios en esta.

Info.png

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

 


Template warning.png

En caso de actualizar una instalación con Alta Disponibilidad (HA), será necesario tener en cuenta lo indicado en [esta sección].

 


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

Para que Open Update Manager se ejecute correctamente, este 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 línea 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 queramos usar una nueva versión de Pandora FMS 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 esté 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. Después 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 estén 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 FMS 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 del 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 FMS, con todos los agentes, módulos, alertas, etc., que teníamos configurados y si cambiamos la IP del nuevo Host por la del anterior, todos los agentes locales reportarán 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 es.png

Siga los pasos del instalador:

Pandora server install windows 01.png

Acepte los términos de la licencia:

Pandora server install windows 02 es.png

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

Pandora server update windows 01 es.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 es.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 FMS está actualizado y listo para su uso.

Info.png

Con estos pasos, el código de Pandora FMS 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.

 


5 Actualización a una versión anterior

Para poder realizar una actualización a una versión menor, bastará con bajar de versión la consola de Pandora FMS. Se recomienda como precaución realizar una copia de seguridad de la base de datos y de los ficheros de configuración de Pandora FMS, como se puede observar anteriormente. Siempre tendremos que realizar la instalación del paquete Open y posteriormente de la versión Enterprise.

5.1 Desde paquetes RPM

  • Actualización de la consola Open:
rpm -i --force pandorafms_console_package.rpm
  • Actualización de la consola Enterprise:
rpm -i --force pandorafms_console__enterprise_package.rpm

5.2 Desde paquetes DEB

  • Actualización de la consola Open:
dpkg –i  --force pandorafms_console_package.rpm
  • Actualización de la consola Enterprise:
dpkg -i --force pandorafms_console__enterprise_package.rpm

5.3 Desde Tarball/Fuentes

  • Actualización de la consola Open:
tar -xvzf pandorafms_console_package.tar.gz
mv –f ./pandora_console/* /yourconsolepath
  • Actualización de la consola Enterprise:
tar -xvzf pandorafms_console_package.tar.gz
mv -f ./enterprise /yourconsolepath