View source for Pandora: Metaconsole: Documentation es: InstallAndConfigure

[[Pandora:Documentation#Parte_6._Metaconsola|Volver a Indice de Documentacion Pandora FMS]]

= Instalar y Configurar =

En este apartado figurarán todos los aspectos necesarios para instalar y configurar una Metaconsola y sus Instancias (nodos).

== Instalación ==

Las instalaciones de las Instancias y la Metaconsola tienen como requisito estar '''alojadas en servidores que estén comunicados''' en ambos sentidos.

Por lo que nos tendremos que asegurar de que:
* La Metaconsola puede contactar con las Instancias
* Las Instancias puedan contactar con la Metaconsola

{{Tip|Las Instancias no necesitan estar comunicadas entre ellas en ningún momento.}}

Para entender mejor este requisito puede echar un vistazo a la [[Pandora:Metaconsole:Documentation_es:Arquitecture#Arquitectura|Arquitectura de la Metaconsola]].

La '''configuración horaria''' debe ser la misma. Cuanto más sincronizados estén los relojes de Instancias y Metaconsola más exactos serán los datos visualizados.

Por ejemplo, si una Instancia tiene 5 minutos de diferencia respecto a la Metaconsola, la visualización del tiempo transcurrido desde que se generaron sus eventos, cuando se muestren esos datos en la Metaconsola, será falsa.

=== Instancias ===

Una Instancia o nodo es una instalación típica de Pandora FMS Enterprise, compuesta por un '''servidor''' y una '''consola web'''

Para saber con detalle cómo instalar una instancia podemos visitar el siguiente [[Pandora:Documentation_es:Instalacion|enlace.]]

=== Metaconsola ===

Una Metaconsola es una instalación de Pandora FMS Enterprise con una licencia de Metaconsola.

{{Tip|No se puede utilizar a la vez la consola de Pandora FMS y la Metaconsola.}}

Es necesario tener activo un servidor para poder realizar distintas operaciones referentes a la Metaconsola, como la “migración”, “autoprovisionamiento”, ejecución de servicios, etc.

=== Activación de la licencia ===

Tras instalar la versión Enterprise de la consola de Pandora FMS, sea cual sea el método de instalación se deberá acceder a la consola de Pandora (http://IP/pandora_console/) y le aparecerá una pantalla de bienvenida para aceptar la licencia. 

Para saber más acerca de cómo se activa la licencia puede visitar el siguiente [[Pandora:QuickGuides_ES:Guia_Rapida_General#Activaci.C3.B3n_de_la_licencia_Enterprise|enlace.]]

{{Tip|Para poder activar la Metaconsola necesita una licencia de Metaconsola. Si activa la licencia de nodo le aparecerá la consola normal.}}

== Metalicencia ==

A partir de la versión 7.0NG de PandoraFMS disponemos de una licencia única para un entorno con Metaconsola. Se podrán crear tantas Instancias como se quiera, siempre y cuando no se sobrepase el número de agentes total dentro de la Metaconsola. 

Esta licencia se aplica en la Metaconsola y se puede sincronizar en tantas Instancias como se quiera, permitiendo así la gestión centralizada de los distintos agentes que se desplegarán en dichas Instancias. 

Con esta licencia, si empezamos una instalación desde cero, primero deberemos instalar la Metaconsola validando su metalicencia. Una vez validada, registraremos cada una de las Instancias deseadas (se explica en los siguientes apartados), sincronizando posteriormente la metalicencia para que podamos trabajar sobre todas ellas.

Al margen de fallos puntuales de red, los nodos de Pandora FMS deberán poder contactar con la Metaconsola de Pandora FMS en todo momento. Si necesita soportar nodos que puedan permanecer desconectados por periodos de tiempo arbitrariamente largos, contacte con Ártica en [mailto:info@artica.es info@artica.es].

== Configuración ==

Para que las Instancias se comuniquen con la Metaconsola y viceversa, hay que configurar ambos lados apropiadamente.

=== Metaconsola ===

==== Alta y Configuración de las Instancias ====

En el apartado de Metasetup, se podrán dar de alta y configurar las Instancias con las que se enlazará la Metaconsola.

Para dar de alta una nueva Instancia debemos conocer una serie de parámetros referentes a la Instancia que queremos manejar. Si se trata del alta de una Instancia que todavía no ha sido registrada con una licencia, los datos por defecto son: 

* '''Server name''': localhost.localdomain
* '''Auth token''': vacía
* '''Console URL''': http://IP/pandora_console
* '''API password''': vacía
* '''DB host''': IP de la base de datos
* '''DB name''': pandora
* '''DB user''': pandora
* '''DB password''': pandora
* '''DB port''': 3306
* '''Control user''': admin
* '''Console password''': pandora

<b>Campos avanzados</b>

Para garantizar la conectividad entre nodo y Metaconsola, podemos configurar manualmente los datos de conexión.

* '''Metaconsole DB host''': IP de la base de datos
* '''Metaconsole DB name''': pandora
* '''Metaconsole DB user''': pandora
* '''Metaconsole DB password''': pandora
* '''Metaconsole DB port''': 3306


Estos campos indican la configuración de la conexión que establecerá el ''nodo'' contra la ''Metaconsola''.

[[File:Configure_Instances_editor3.png]]

En caso de ser una instalación de Pandora FMS donde ya hemos incluido una licencia válida en la Instancia, tendremos que obtener dichos datos del setup de la Instancia y la base de datos de la misma.

En la vista de las Instancias configuradas veremos que las Instancias pueden ser modificadas, desactivadas y eliminadas.
Existen unos indicadores que chequean cierta información de la configuración de cada Instancia. Esos chequeos se realizan al cargar esta vista, pero también se pueden hacer individualmente haciendo click sobre ellos.

[[File:Configure Instances list new4.png]]

Los indicadores son los siguientes:

* '''Base de datos''': Si hemos configurado mal la base de datos de la Instancia o no tenemos los permisos necesarios, el indicador estará en rojo y nos dará información del problema.
* '''API''': Este indicador hará una prueba a la API de la Instancia. Si falla nos dará información del fallo.
* '''Compatibilidad''': Este indicador hace un chequeo de algunos requisitos que tiene que haber entre Instancia y Metaconsola. El nombre del servidor de la Instancia, por ejemplo, debe coincidir con el nombre que se le dé en su configuración en la Metaconsola.
* '''Replicación de eventos''': Este indicador muestra si la Instancia tiene activada la replicación de eventos, y si ya se han recibido eventos de la Instancia hace cuánto tiempo fue la última replicación. 
* '''Caché del agente''': Este indicador muestra que los últimos estados de los agentes y módulos del nodo se han guardado correctamente en la base de datos de la Metaconsola. Cuando un cambio se genera, solo ese cambio será modificado en la base de datos.
* '''Sincronización''': Este indicador hace referencia a la posibilidad de poder realizar la sincronización de los distintos elementos desde la Metaconsola a las Instancias.

Los tres primeros indicadores deben estar verdes para que la Instancia esté debidamente enlazada y comencemos a ver sus datos. En cambio, el indicador de Replicación de eventos solamente nos da información de esta característica. 

{{Tip|Una Instancia puede estar bien configurada, pero sin replicar sus eventos.}}

{{Tip|Una vez se haya escogido replicar los eventos, toda la gestión de los mismos se realizará desde la Metaconsola, dejando a los eventos de la Instancia como meramente informativos.}}

==== Escalado de índices ====

La mayor parte de la sincronización entre la Metaconsola y las Instancias se realiza por nombre, independientemente del ID interno de los elementos, teniendo como excepción los grupos, tags, alertas, sistemas operativos y grupos de módulos, cuyos IDs es importante que estén sincronizados.

Para '''asegurar que los IDs de los grupos, tags, alertas, sistemas operativos y grupos de módulos que se sincronizan desde la Metaconsola no existan en las instancias''', aumentaremos el valor AUTO_INCREMENT de las tablas tgrupo, ttag, talert_templates, talert_actions, talert_commands, tconfig_os y tmodule_group sensiblemente. De este modo, daremos un margen amplio por si se crean elementos en las Instancias por causas ajenas a la Metaconsola. 

Para ello ejecutaremos en la base de datos de la Metaconsola la siguiente consulta: 

 ALTER TABLE tgrupo AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE ttag AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE talert_templates AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE talert_actions AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE talert_commands AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE tconfig_os AUTO_INCREMENT <nowiki>=</nowiki> 3000;
 ALTER TABLE tmodule_group AUTO_INCREMENT <nowiki>=</nowiki> 3000;

{{Tip|Si se sospecha que el número de elementos de una instancia creados de forma ajena a la Metaconsola puede superar los 3000, se puede configurar un valor superior.}}

==== Programación de informes ====

Es preciso instalar los paquetes (Open y Enterprise) del servidor en el sistema donde esté instalada la Metaconsola a fin de poder lanzar el script de mantenimiento de Base de datos ('''pandora_db'''). Debe asegurarse de que queda correctamente programado para su ejecución en el cron cada hora (tal y como se detalla en el siguiente [[Pandora:Documentation_es:Gestion_y_Administracion#Cron_Job |enlace.]]).

Si va a utilizar los informes bajo demanda (enviados por email), necesita programar la ejecución de la extensión cron al igual que se hace en una consola Enterprise normal. Generalmente, esto se hace metiendo en el cron la siguiente línea, ajustando los paths locales que correspondan:

  */5 * * * * <user> wget -q -O - http://x.x.x.x/pandora_console/enterprise/extensions/cron/cron.php >> /var/www/pandora_console/pandora_console.log

Por último, para configurar el SMTP de envío de emails, hay que editar los parámetros correspondientes en la sección de configuración de mail, que por defecto tienen los siguientes valores:

[[File:Mail metaconsola1.png]]

=== Instancias ===

En las Instancias hay una serie de parámetros para garantizar el acceso de sus datos con la Metaconsola.

==== Dar acceso a la Metaconsola ====

La Metaconsola accede de dos maneras a una Instancia:

* Acceso remoto a la '''Base de Datos''' para ver y editar los datos almacenados en las Instancias.
* Acceso a la '''API''' para algunas acciones como la edición de ficheros de configuración o la monitorización NetFlow.

La Instancia deberá configurarse para '''garantizar ambos accesos''' a la Metaconsola. 

===== Base de datos =====

Como hemos dicho anteriormente se deberán saber las '''credenciales''' de la base de datos para configurar la instancia en la Metaconsola. (Host, Base de datos, Usuario y Contraseña).

Además de ello, otro punto importante es '''dar permisos''' al usuario para que acceda remotamente a la base de datos.
Se hace con el comando GRANT de MySQL:

 GRANT ALL PRIVILEGES on <InstanceDatabaseName>.* to <UserName>@<HostAddress> IDENTIFIED BY <UserPass>;

Por ejemplo:

 GRANT ALL PRIVILEGES on PandoraMetaBase.* to adminmeta@localhost IDENTIFIED BY pandora;

===== API =====

El acceso a la API de la Instancia se garantizará con los siguientes parámetros:

* '''Usuario y contraseña''': Se deberá saber un usuario y contraseña válidos en la Instancia.
* '''Contraseña API''': Se deberá conocer la contraseña de acceso a la API configurada en la Instancia.
* '''Lista de IPs con acceso a la API''': En la configuración de la Instancia hay una lista de IPs que pueden acceder a la API. Se puede usar <nowiki>'*'</nowiki> como comodín para dar acceso a todas las IPs o a una subred.

[[File:Imagen setup2.png]]

==== Auto-autenticación ====

En algunas partes de la Metaconsola hay accesos a la Consola Web de la Instancia; por ejemplo, en el visor de eventos, al pinchar en el agente asociado a un evento (si lo hay), nos llevará a la vista de ese agente en la consola de la Instancia a la que pertenece. Para este acceso se utiliza Auto-autenticación. Esta autenticación se realiza con un ''hash'' para el que se necesita una cadena configurada en la Instancia: ''la contraseña de auto identificación''. Dicha contraseña la ponemos en el campo de “Auth token” de la configuración de la instancia en la Metaconsola.

[[File:Autologin hash2.png]]

{{Tip|Esta configuración no es necesaria para configurar la instancia en la Metaconsola, pero sin ella, al pinchar en uno de los enlaces que nos llevan a la Instancia, tendremos que autenticarnos.}}

==== Replicación de eventos ====

Para que en la Metaconsola se vean los eventos de las Instancias, estas tienen que tener acceso a la base de datos de la Metaconsola.

Las Instancias replicarán cada cierto tiempo sus eventos almacenando la fecha y hora del último replicado para continuar desde ahí la próxima vez.

Además de replicar los eventos, harán efectiva la autovalidación en la Metaconsola. Esto es, para los eventos que están asociados a un módulo, cuando repliquen el evento a la Metaconsola, validarán todos los eventos anteriores asignados al mismo módulo.

Para configurar la replicación de eventos, en el apartado de Configuración Enterprise de las Instancias, activaremos la ''Replicación de Eventos''.

Se configurará:

* '''Intervalo''': Cada cuántos segundos el servidor replicará los eventos generados desde la última replicación a la base de datos de la Metaconsola. 
{{Tip|Si se tiene configurado, por ejemplo, 60 segundos, la primera replicación sucederá a los 60 segundos de haber iniciado el servidor.}}
* '''Modo de replicación''': Si se replicarán todos los eventos o solo los validados.
* '''Mostrar lista de eventos en consola local (solo lectura)''': Cuando la replicación de eventos está activada, la gestión de los eventos se lleva a cabo en la Metaconsola y en la instancia no se tiene acceso a ellos. Con esta opción se tendrá acceso a una vista de los eventos en modo solo lectura.
* '''Credenciales de la base de datos de la Metaconsola''': Host, Base de datos, Usuario, Contraseña y Puerto (si el puerto no se indica se utilizará el puerto por defecto).

[[File:Replication events setup2.png]]

La replicación de eventos la hace el servidor. En el fichero de configuración debe haber un token habilitado: ''event_replication 1''

[[File:Replication events conf token2.png]]

{{Warning|Para hacer efectivo cualquier cambio de configuración en la replicación de eventos será necesario reiniciar el servidor.}}

{{Warning|Si añade un nodo que ya contiene muchos eventos a una Metaconsola, le llevará mucho tiempo copiar todos los eventos que tiene a la Metaconsola.}}

Si quiere modificar manualmente la fecha a partir de la cual el nodo va a sincronizar eventos con la Metaconsola (por ejemplo, para forzar a que replique eventos a partir de la fecha actual) tendrá que lanzar la siguiente query contra la BBDD del nodo para versiones de Pandora FMS anteriores a la 5.1SP3:

 UPDATE tconfig SET `value` = UNIX_TIMESTAMP() WHERE `token` = "replication_copy_last_utimestamp"

Para versiones posteriores a la 5.1SP3 ejecute la siguiente consulta:

 UPDATE tconfig SET `value` = (SELECT MAX(id_evento) FROM tevento) WHERE `token` = "replication_copy_last_id";

{{Warning|Si tiene activada en los nodos hijos la seguridad SELinux puede que la replicación no funcione; por favor, desactívela.}}

==== Autoprovisión desde la metaconsola ====

A partir de Pandora 7 puede encontrar en el setup de configuración de la Metaconsola la opción de dar de alta el nodo en la Metaconsola. 

Además, se puede chequear si se está llegando vía API a la Metaconsola y si el nodo está dado de alta en la misma.

Es necesario indicar las credenciales adecuadas para la conexión con el nodo, la base de datos y la API.


{{Tip|La primera vez que se realice esta configuración, se podrá indicar una contraseña para la API. En caso de actualización, se mantendrá la contraseña que tuviese el nodo.}}

La configuración que se encuentra en "opciones avanzadas" será la que se envíe al nodo para su conexión con la base de datos. 

[[File:MetaAutoprovisionamiento2.png]]

=== Configuración adicional de la metaconsola ===

La Metaconsola, si se ha activado la replicación de eventos de los nodos, alberga datos de eventos en su propia base de datos. Para su mantenimiento estos datos se pueden borrar y/o mover a la bbdd de histórico de eventos de la Metaconsola. Esto se hace, como en una Instancia de Pandora FMS, a través de la ejecución del script de mantenimiento de bbdd que se encuentra en ''/usr/share/pandora_server/util/pandora_db.pl''. Generalmente, para lanzarlo se utiliza el fichero del servidor, solo que al ser una Metaconsola no tiene porqué haber servidor. Para ello, coja una copia del fichero /etc/pandora/pandora_server.conf de uno de los nodos, edítelo, y modifique los datos relativos a la BBDD (hostname, nombre de la BBDD, usuario y password) y guarde el fichero, por ejemplo, como :

 /etc/pandora/pandora_meta.conf

Cree un script en /etc/cron.daily/pandora_meta_db con el siguiente contenido:

 /usr/share/pandora_server/util/pandora_db.pl /etc/pandora/pandora_meta.conf

Y modifique los permisos de este mediante chmod:

 chmod 755 /etc/cron.daily/pandora_meta_db

Para poder ejecutarlo, es necesario que tenga instalados los paquetes necesarios para ejecutar (aunque no lo haga) el servidor de Pandora FMS y su parte Enterprise.

Ejecútelo a mano para comprobar que funciona y no da errores:

 /etc/cron.daily/pandora_meta_db

== Sincronización de Metalicencia ==

A continuación vamos a ver un ejemplo de cómo sincronizar la metalicencia entre una Metaconsola y una Instancia.

En primer lugar, tenemos una Instancia con su propia clave generada y correctamente validada.

<center>
[[image:metalicencia1.JPG]]
</center>

Una vez tenemos el nodo generado y correctamente validado, a continuación lo configuraremos en la Metaconsola para posteriormente poder sincronizar la licencia:

[[File:Configure Instances list new4.png]]

Cuando ya tenemos estos pasos, nos iremos a la licencia de la Metaconsola y daremos a "Validate" para sincronizar la metalicencia con la Instancia.

<center>
[[image:metalicencia1.JPG]]
</center>

El resultado será que tendremos la metalicencia en la Instancia.


[[Category:Pandora FMS Metaconsole]]