Instalación y configuración

Las instalaciones de las Instancias y el Command Center (Metaconsola) tienen como requisito estar alojadas en servidores que estén comunicados en ambos sentidos.

• Verificar que el Command Center puede contactar con las Instancias.
• Verificar que las Instancias puedan contactar con el Command Center.

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

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

Un Command Center es una instalación de Pandora FMS con una licencia especial para Command Center.

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

Tras activar la licencia de la Consola web de Pandora FMS, sea cual sea el método de instalación se deberá acceder a la consola de Pandora FMS:

http://<dir_IP_or_URL>/pandora_console/

Aparecerá una pantalla de bienvenida para aceptar la licencia.

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

Esta licencia se aplica en el Command Center 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.

• Las Instancias (nodos) deben contar con su propia clave generada y correctamente validada.
• Una vez se tengan los nodos generados y correctamente validados, estos se configuran en el Command Center.
• Todos los estados han de aparecer normales (en verde) y de ser necesario se utilizará el botón de sincronización, Synchronize all:

• Cumplidos todos estos pasos para cada uno de los nodos, se accede a la licencia de el Command Center y se pulsa el botón Validate para sincronizar la Metalicencia con todas las Instancias.

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

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
• 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
• Console URL:

http://<dir_IP_orURL>/pandora_console

Campos avanzados

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

• Metaconsole DB host: dirección 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 el Command Center.

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 clic sobre ellos.

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 Command Center. El nombre del servidor de la Instancia, por ejemplo, debe coincidir con el nombre que se le dé en su configuración en el Command Center.
• 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 el Command Center. 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 el Command Center a las Instancias.

Los tres primeros indicadores deben aparecer en color verde 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.

Es preciso instalar los paquetes del servidor en el sistema donde esté instalada el Command Center 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 enlace.).

Si se van a utilizar los informes bajo demanda (enviados por correo electrónico) se necesita programar la ejecución de la extensión cron al igual que se hace en una Consola web normal. Generalmente, esto se hace introduciendo en el cron la siguiente línea, ajustando las rutas o 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/log/console.log

/var/www/pandora_console/pandora_console.log

Por último, para configurar el SMTP de envío de correos electrónicos, hay que editar los parámetros correspondientes en la sección de configuración de correo.

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

• Usuario y contraseña: Se deberán conocer 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 direcciones IP que pueden acceder a la API. Se puede usar el asterisco como comodín para dar acceso a todas las direcciones IP o a una subred.

En algunas partes de el Command Center hay accesos a la Consola Web de la Instancia; por ejemplo, en el visor de eventos, al hacer clic en el agente asociado a un evento (si lo hay), llevará a la vista de ese agente en la consola de la Instancia a la que pertenece.

Para este tipo de acceso se utiliza autoautenticación. Esta autentificación se realiza activando el token Setup → General setup → Auto login in node.

Para configurar el Command Center vaya a Setup → Metasetup.

Al poseer una licencia válida de Command Center y tener acceso a internet podrá actualizar el Command Center de manera automática. Esta sección solo será visible si se encuentra activado Enable Warp Update en la Configuración General.

• Permite actualizar y/o parchar el Command Center sin necesidad de conectar a internet.
• Esta sección solamente será visible si se encuentra activado Enable Warp Update en la Configuración General.
• Solamente “suba” los ficheros en orden hasta la versión que necesite actualizar, dado que no son versiones acumulativas. Consulte el procedimiento completo en el artículo principal, Warp Update Offline

Haga clic en el icono Warp Update Journal para conocer las actualizaciones realizadas, versión, fecha y hora de aplicación, usuario quien la solicitó y aplicó, etc. Esta sección solo será visible si se encuentra activado Enable Warp Update en la Configuración General.

Con el paso del tiempo acumulará muchos registros los cuales podrá filtrar expandiendo el cuadro Filter y colocando la palabra clave a buscar.

Por defecto ya viene configurado para poder realizar la actualización en línea. Esta sección solo será visible si se encuentra activado Enable Warp Update en la Configuración General.

Para activar esta funcionalidad se debe habilitar el token Enable API agente en la configuración general.

Por medio del menú Setup → Metasetup → Relations rules es posible acceder a esta utilidad. Permite recuperar rápidamente información sobre ciertos dispositivos especiales mediante una API (distinta de la API principal).

En el cuadro de relaciones (Relations) se debe escoger un tipo (en Type, lista desplegable: Ip Gateway o IMEI) y asignar un valor de relación el cual será utilizado en la consulta API. Dicha consulta devolverá la dirección del nodo (Node address) que haya seleccionado, ya sea uno de los nodos del Command Center (Metaconsola) o un nodo personalizado mediante Custom. Una vez establecidos los tres campos descritos haga clic en el botón Insert relation para guardar la nueva relación.

Para cargar una lista de relaciones debe preparar un fichero en formato CSV con el siguiente orden:

imei,<rule>,<node> o gateway,<rule>,<node> .

Valores ilustrativos: gateway,4,192.168.80.37 .

Las relaciones guardadas serán visualizadas en la parte inferior y podrán ser filtradas por tipo, valor o dirección de nodo. También se podrán borrar relaciones una a una o seleccionar varias o todas con la correspondiente casilla de verificación y luego pulsando el botón Delete para borrar de manera masiva.

Las consultas de relaciones serán devueltas en formato JSON. En navegador web Mozilla Firefox para gateway=1:

En navegador web Mozilla Firefox para imei=2:

Por medio del botón Node Address Default puede configurar para devolver una respuesta preestablecida cuando no haya norma de relación alguna establecida o cuando no sea hallada ninguna norma de relación que coincida con la solicitud hecha. Dicha respuesta bien puede ser la dirección IP de alguno de los nodos de la Metaconsola o bien un mensaje personalizado al seleccionar la opción Custom:

En Pandora FMS existe un sistema de supervisión del estado de la consola y en general del sistema.

• Haciendo clic en el icono de notificaciones (Notifications) podrá añadir o suscribir a cada categoría de notificaciones aquellos usuarios o grupos que recibirán la notificación.
• Para el estado del sistema (System status) puede, además, especificar cada aspecto técnico para cada uno de los usuarios o grupos registrados.

En esta configuración se deben de establecer una serie de valores tales como:

• La dirección de salida (From dir).
• Nombre de dirección de salida (From name).
• La dirección IP o FQND del servidor SMTP (Server SMTP).
• Número de puerto SMTP (Port SMTP).
• Tipo de cifrado para la privacidad (Encryption): SSL, SSLv2, SSLv3, STARTTLS.
• Si es necesario, el usuario y contraseña del usuario del correo electrónico (E-mail user y E-mail password).

Podrá hacer sus traducciones personalizadas (icono String translation) incluso con variables macro; esta extensión está descrita por completo en la sección Translate string.

Gestor de ficheros donde se pueden subir y eliminar en los ficheros de la carpeta imágenes de la instalación de el Command Center.

• Max. days before events are deleted: Campo donde se definen el número máximo de días antes de borrar los eventos.
• Use real-time statistics: Habilitar o deshabilitar el uso de estadísticas en tiempo real.
• Max. days before audited events are deleted: Número de días a mantener de auditoría de eventos.
• Default hours for event view: Campo donde se define el campo horas del filtro por defecto en la vista de eventos. Si por defecto es 8, la vista de eventos mostrará únicamente los eventos sucedidos en las últimas 8 horas. Este campo también afecta al visualizado, conteo y gráficas de los eventos en la vista táctica.
• Migration block size: Tamaño del bloque de migración. Se utiliza para migrar (mover) agentes entre nodos en entornos de Command Center, sobre todo para transferir el histórico de datos entre un nodo y otro.
• Events response max. execution: Número de eventos que llevarán a cabo la acción deseada a la vez.
• Max. number of events per node: Máximo número de eventos a ser visualizados por cada nodo.
• Row limit in CSV log: Límite de filas para el registro en formato CSV.
• Max. macro data fields: Campo donde se define el número de macros que se pueden utilizar para las alertas.
• Limit of events per query: Límite establecido para el máximo número de eventos en una consulta, por defecto cinco mil items.
• Max. days before purge: Campo donde se definen el número máximo de días antes de borrar datos. Esto también especifica el número máximo de días a mantener datos de histórico de inventario.

Toda la configuración relativa a la representación de los datos. Colores y resolución de las gráficas, número de elementos en la paginación de las vistas, etc. Existe más información acerca de la configuración visual en este enlace.

Para conocer más sobre la autentificación visite la sección Autentificación.

Permite activar el uso de la base de datos histórica en el Command Center (Enable historical database). Para conocer más sobre la configuración de la base de datos histórica visite la Configuración de consola.

A partir de la versión 774 de Pandora FMS se incorpora la configuración de acceso al OpenSearch.

Se puede establecer una política de contraseñas con limitaciones en el número de caracteres de las contraseñas, expiración, bloqueo temporal de un usuario. Para conocer más sobre la política de contraseñas visitar la sección Política de contraseñas.

En esta sección se encuentran datos generales de el Command Center tales como el idioma, la configuración de fecha/hora o la personalización de ciertas secciones, entre otras.

Se pueden personalizar si queremos que estén activadas o desactivadas las secciones de NetFlow, la vista de árbol clasificada por tags, la consola visual o la posibilidad de creación de chequeos web desde el Wizard.

Campos notables:

• Force use Public URL: Fuerza el uso de URL públicas. Si este campo está activo, sin importar el sistema que esté implementado, los enlaces y las referencias se construirán siempre en base a public_url.
• Public URL host exclusions: Los hosts añadidos en este campo ignorarán el campo anterior.
• Enable update manager: Esta opción permite activar el Warp Update para actualizar el Command Center .
• Enable log viewer: Esta opción permite activar la pestaña del visor de logs para editar la configuración del servidor de Elasticsearch.
• Auto login in node: Disponible desde la versión 777 permite ir desde Command Center (Metaconsole) hacia cada uno de las Consolas web de los nodos centralizados e iniciar sesiónde manera automática.

Volver al Índice de Documentación Pandora FMS