# Plugin HA histórico

# Introducción

El plugin **pandora\_history\_ha** permite gestionar la conectividad a bases de datos de histórico configuradas en HA en instalaciones de Pandora FMS.

# Instalación

Para instalar el servicio se debe descargar el paquete de instalación desde [Marketplace](https://marketplace.pandorafms.com//entries/pandorafms.pandora_history_ha).

Se debe transferir el paquete al host desde el que se gestionará el servicio (normalmente el servidor de Pandora FMS), descomprimirlo y ejecutar el script de instalación de su interior:

```bash
./pandora_history_ha_installer --install
```


La instalación se realizará por defecto en **/opt/pandorafms/pandora\_history\_ha**, pero se puede indicar un directorio personalizado con el parámetro **--destdir**:

```bash
./pandora_history_ha_installer --install --destdir /opt/cutom_pandora_history_ha/
```

# Configuración

Para gestionar el HA de la base de datos de histórico es necesario indicar las siguientes opciones de configuración en el fichero **/opt/pandorafms/pandora\_history\_ha/pandora\_history\_ha.conf**

<table border="1" id="bkmrk-par%C3%A1metro-descripci%C3%B3" style="border-collapse: collapse; width: 100%; height: 713.516px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td class="align-center" style="height: 29.7969px;">**Parámetro**</td><td class="align-center" style="height: 29.7969px;">**Descripción**</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**dbname**</td><td style="height: 29.7969px;">Nombre de la base de datos de histórico a la que conectar.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**dbport**</td><td style="height: 29.7969px;">Puerto de conexión a la base de datos de histórico.</td></tr><tr style="height: 63.3906px;"><td style="height: 63.3906px;">**dbuser**</td><td style="height: 63.3906px;">Usuario de conexión de la base de datos de histórico. Necesita los permisos "REPLICATION CLIENT" y "SUPER" (o "REPLICATION\_SLAVE\_ADMIN").</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**dbpass**</td><td style="height: 29.7969px;">Contraseña del usuario anterior.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**repl\_dbuser**</td><td style="height: 46.5938px;">Usuario de replicación de la base de datos de histórico. Necesita el permiso "REPLICATION SLAVE".</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**repl\_dbpass**</td><td style="height: 29.7969px;">Contraseña del usuario anterior.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**ha\_hosts**</td><td style="height: 46.5938px;">Lista de IPs o FQDNs de cada equipo que forma parte del HA de la base de datos de histórico (separados por comas).</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**ha\_interval**</td><td style="height: 46.5938px;">Intervalo en segundos para comprobar el estado del HA de la base de datos de histórico.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**ha\_connect\_retries**</td><td style="height: 46.5938px;">Numero de reintentos para conectar al HA de la base de datos de histórico.</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**ha\_connect\_delay**</td><td style="height: 46.5938px;">Retraso en segundos entre reintentos de conexión al HA de la base de datos de histórico.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**splitbrain\_autofix**</td><td style="height: 29.7969px;">Habilita (1) o deshabilita (0) la corrección automática del HA en caso de producirse un "splitbrain".</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**verbose**</td><td style="height: 29.7969px;">Habilita (1) o deshabilita (0) el mayor nivel de detalle del log.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**log\_file**</td><td style="height: 29.7969px;">Ruta al fichero de log del servicio.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**pid\_file**</td><td style="height: 29.7969px;">Ruta al fichero PID del servicio.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**main\_dbhost**</td><td style="height: 29.7969px;">IP o FQDN a la base de datos principal de Pandora FMS.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**main\_dbport**</td><td style="height: 29.7969px;">Puerto de conexión a la base de datos principal de Pandora FMS.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**main\_dbname**</td><td style="height: 29.7969px;">Nombre de la base de datos principal de Pandora FMS.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**main\_dbuser**</td><td style="height: 29.7969px;">Usuario de conexión a la base de datos principal de Pandora FMS.</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**main\_dbpass**</td><td style="height: 29.7969px;">Contraseña del usuario anterior.</td></tr></tbody></table>

# Servicio

El plugin **pandora\_history\_ha** instala un servicio de SystemD que se encarga de ponerlo en funcionamiento.

Este servicio, usando la configuración indicada en su fichero, se encargará de conectar a los equipos del HA de la base de datos de histórico y a la base de datos principal para actualizar la configuración de Pandora FMS y que utilice para la conexión de histórico el equipo principal del HA.

El servicio se puede gestionar con los comandos:

```bash
systemctl <action> pandora_history_ha
```