Instalación

Pandora FMS necesita GNU/Linux para el servidor y la Consola. No está oficialmente soportado en MS Windows® ni en otro sistema operativo.

Los requisitos expuestos en esta tabla son las recomendaciones mínimas para las distintas instalaciones. Estas recomendaciones están calculadas suponiendo que el 80 % de los Módulos tienen histórico de datos y el muestreo medio es de cinco minutos. Estas recomendaciones están especificadas para un entorno donde se instalan en el mismo servidor base de datos, Pandora FMS Server y Consola web.

Estos valores son aproximados y tomando como referencia un entorno con monitorización mixta (agente software y remota) con el intervalo por defecto de 5 minutos y el almacenamiento de datos por defecto. Si se alteran estos valores los requerimientos pueden variar.

* * Para entornos que superen las 80 mil métricas se debe optar por un sistema de monitorización distribuida utilizando múltiples nodos.

(*) En el caso de requerir un mayor rendimiento por nodo, existe la posibilidad de desplegar la base de datos en otra instancia o incluso configurar al nodo para conectar con un clúster de base de datos xtradb.

Todas las pruebas y validaciones se realizan con Percona Server for MySQL® 8 (opción recomendada). Debido a las similitudes entre Percona Server for MySQL® 8 y MySQL® 8 la compatibilidad entre ambas soluciones es completa.

Pandora FMS depende en gran parte del sistema operativo GNU/Linux®, pero además necesita paquetes adicionales que muchas veces no vienen instalados de forma predeterminada.

Se necesita de un servidor MySQL operativo antes de instalar Pandora FMS. Si se está instalando PFMS a la vez que el servidor MySQL se tiene que arrancar y configurar el acceso al usuario root de MySQL:

1. Arrancar con systemd: systemctl start mysql (de manera alternativa se puede usar /etc/init.d/mysql start).
2. Configurar la contraseña del usuario administrador root: mysqladmin password < password >. Esta password será solicitado durante todo el proceso de instalación.

1. Instalar la Consola web.
2. Instalar el PFMS server.

La razón es que la base de datos MySQL que usa el servidor se crea en el proceso de configuración inicial de la consola y por ello, para asegurar el correcto funcionamiento del servidor, es recomendable realizar primero el proceso de instalación completo de la consola.

Es innecesario que la consola y el servidor se encuentren alojados en la misma máquina. Es posible indicar a ambos dónde se encuentra la base de datos MySQL mediante los correspondientes ficheros de configuración, aunque en entornos Enterprise a la hora de realizar una instalación distribuida, hay que tener en cuenta más factores para la instalación.

La instalación del Agente Software en el servidor se realiza sin ningún problema antes o después de instalar el servidor y la consola ya que es independiente de estos.

El orden adecuado para realizar una instalación Enterprise es el siguiente:

• Instale la Consola Open Source.
• Instale la Consola de la versión Enterprise.
• Instale el servidor de la versión Enterprise.
• Al acceder a la Consola, aparecerán cuadros requiriendo que introduzca su código de licencia Enterprise.

Si tiene acceso a Internet se recomienda que realice la instalación en línea (online) por medio de esta útil herramienta.

Este método de instalación es especialmente útil cuando el entorno está alojado en proveedores en la nube aunque no es exclusivo para este tipo de entornos.

El término “proveedor en la Nube” (o simplemente “Nube”) es utilizado para describir el alojamiento de máquinas virtuales, ya sea de manera exclusiva o compartida, en proveedores especializados con hardware, hipervisores y sistemas web de atención al cliente para su configuración y administración.

Se recomienda Red Hat (RHEL) como sistema operativo aunque también tiene compatibilidad oficial con Rocky Linux, AlmaLinux y Ubuntu (véase la tabla de versiones).

Para dimensionar adecuadamente el entorno de monitorización se recomienda ir a la sección de requisitos mínimos de hardware.

• Tener acceso a internet (URL necesarias). Además de estas URL es necesario tener acceso a los repositorios oficiales de la distribución utilizada (RHEL / Rocky Linux / Ubuntu Server).
• Tener instalado curl (viene por defecto en la mayoría de las distribuciones).
• Cumplir con los requisitos mínimos de hardware.
• Ser usuario administrador root.
• Contar con un SO compatible.
• En el caso de usar RHEL 8 será necesario que previamente esté activado con una licencia y subscrito a los repositorios estándar.

Aunque la ejecución anterior hace una instalación completa del entorno, es posible definir diferentes modificadores a través de variables de entorno para personalizar la instalación.

• TZ: Define el time zone (huso horario) de la máquina, por defecto es Europe/Madrid.
• DBHOST: El host (anfitrión) de la base de datos, por defecto DBHOST=127.0.0.1 .
• DBNAME: El nombre de la base de datos a crear, por defecto DBNAME=pandora.
• DBUSER: El usuario de la base de datos que se creará, por defecto DBUSER=pandora .
• DBPASS: La contraseña (password) para el usuario que se creará, por defecto DBPASS='Pandor4!' .
• DBPORT: Número de puerto de la base de datos a conectar, por defecto DBPORT=3306.
• DBROOTPASS: Contraseña del usuario root de la base de datos, por defecto DBROOTPASS='Pandor4!' .
• SKIP_PRECHECK: Saltarse el chequeo de sí ya existe una instalación previa de Pandora FMS, útil para crear una base de datos nueva y apuntar la instalación a esta; por defecto SKIP_PRECHECK=0.
• SKIP_DATABASE_INSTALL: Saltarse la instalación de la base de datos, útil para cuando se tenga ya una base de datos instalada, bien sea local o remota y se usen las credenciales de este para crear la base de datos de Pandora FMS; por defecto SKIP_DATABASE_INSTALL=0.
• SKIP_KERNEL_OPTIMIZATIONS: Saltarse la optimización de kernel recomendada, solo para usuarios avanzados. Por defecto SKIP_KERNEL_OPTIMIZATIONS=0.
• MYVER: Define la versión de MySQL a instalar, si se define 80 se instalará MySQL 8. Por defecto MYVER=80 (despliega MySQL 8.0).
• PHPVER: Define la versión de PHP a instalar, por defecto PHPVER=8 (despliega PHP 8).
• PANDORA_SERVER_PACKAGE: Define la URL del paquete RPM del servidor de Pandora FMS que se desee instalar. Por defecto está definida la última versión disponible.
• PANDORA_CONSOLE_PACKAGE: Define la URL del paquete RPM de la Consola web de Pandora FMS que se desee instalar. Por defecto está definida la última versión disponible.
• PANDORA_AGENT_PACKAGE: Define la URL del paquete RPM del Agente software de Pandora FMS que se desee instalar. Por defecto está definida la última versión disponible.
• PANDORA_BETA: Si se define a 1 se instalarán los paquetes de la última versión beta disponible (solo para entornos de prueba). Por defecto PANDORA_BETA=0 (si están definidos paquetes específicos se ignora esta opción).
• PANDORA_LTS: Instala la última versión Long Term Support (LTS), una versión de máxima estabilidad que incorpora gran corrección de fallos. Por defecto activa (PANDORA_LTS=1), si se establece a cero instala la última versión regular, Regular Rolling Release (RRR).

Para el uso de estas variables de entorno basta con definir cada una de ellas antes de ejecutar el script de instalación, por ejemplo, en una instalación en EL 9 con variables definidas ejecute el bloque:

env TZ='Europe/Madrid' \
 DBHOST='127.0.0.1' \
 DBNAME='pandora' \
 DBUSER='pandora' \
 DBPASS='Pandor4!' \
 DBPORT='3306' \
 DBROOTPASS='Pandor4!' \
 MYVER=80 \
 PHPVER=8 \
 SKIP_PRECHECK=0 \
 SKIP_DATABASE_INSTALL=0 \
 SKIP_KERNEL_OPTIMIZATIONS=0 \
 PANDORA_AGENT_PACKAGE="https://firefly.pandorafms.com/pandorafms/latest/pandorafms_one_agent_linux_bin-latest.el9.x86_64.rpm" \
 PANDORA_BETA=0 \
 PANDORA_LTS=1 \
 sh -c "$(curl -fsSL < your_link_for_trial >)"

• TZ: Define el time zone de la máquina, por defecto es Europe/Madrid.
• PHPVER: Define la versión de PHP a instalar. Por defecto PHPVER=8 (despliega PHP 8).
• DBHOST: El host (anfitrión) de la base de datos, por defecto DBHOST=127.0.0.1 .
• DBNAME: El nombre de la base de datos a crear, por defecto DBNAME=pandora.
• DBUSER: El usuario de la base de datos que se creará, por defecto DBUSER=pandora .
• DBPASS: La contraseña (password) para el usuario que se creará, por defecto DBPASS='Pandor4!' .
• DBPORT: Número de puerto de la base de datos a conectar, por defecto DBPORT=3306.
• DBROOTPASS: Contraseña del usuario root de la base de datos, por defecto DBROOTPASS='Pandor4!' .
• SKIP_PRECHECK: Saltarse el chequeo si ya existe una instalación previa de Pandora fMS, útil para crear una base de datos nueva y apuntar la instalación a esta; por defecto SKIP_PRECHECK=0.
• SKIP_DATABASE_INSTALL: Saltarse la instalación de la base de datos, útil para cuando se tenga ya una base de datos instalada, bien sea local o remota y se usen las credenciales de este para crear la base de datos de Pandora FMS; por defecto SKIP_DATABASE_INSTALL=0.
• SKIP_KERNEL_OPTIMIZATIONS: Saltarse la optimización de kernel recomendada, solo para usuarios avanzados. Por defecto SKIP_KERNEL_OPTIMIZATIONS=0.
• POOL_SIZE: Especifica un valor de memoria a utilizar, por defecto lo realiza de manera automática.
• PANDORA_BETA: Si se define a 1 se instalarán los paquetes de la última versión beta disponible (solo para entornos de prueba). Por defecto PANDORA_BETA=0 .
• PANDORA_LTS: Instala la última versión Long Term Support (LTS), una versión de máxima estabilidad que incorpora gran corrección de fallos. Por defecto activa (PANDORA_LTS=1), si se establece a cero instala la última versión regular, Regular Rolling Release (RRR).

Para el uso de estas variables de entorno basta con definir sus valores correspondientes antes de ejecutar el script de instalación, por ejemplo, en una instalación en Ubuntu Server con variables definidas ejecute el bloque:

env TZ='Europe/Madrid' \
 DBHOST='127.0.0.1' \
 DBNAME='pandora' \
 DBUSER='pandora' \
 DBPASS='Pandor4!' \
 DBPORT='3306' \
 DBROOTPASS='Pandor4!' \
 PHPVER='8.0' \
 SKIP_PRECHECK=0 \
 SKIP_DATABASE_INSTALL=0 \
 SKIP_KERNEL_OPTIMIZATIONS=0 \
 PANDORA_BETA=0 \
 PANDORA_LTS=1 \
 bash -c "$(curl -SsL < your_link_for_trial >)"

Los siguiente cambios son hechos por el parámetro SKIP_KERNEL_OPTIMIZATIONS=1:

# default=5
net.ipv4.tcp_syn_retries = 3

Esta configuración especifica el número de reintentos que el núcleo del sistema operativo realizará al enviar un paquete de solicitud de conexión TCP antes de que se considere que la conexión ha fallado. El valor por defecto es 5, pero con la configuración especificada, se establecerá en 3.

# default=5
net.ipv4.tcp_synack_retries = 3

Similar a la configuración anterior, esta opción establece el número de reintentos que el núcleo realizará al recibir un paquete de respuesta de acuse de recibo de una conexión TCP. El valor por defecto es 5, pero con la configuración especificada, se establecerá en 3.

# default=1024
net.ipv4.tcp_max_syn_backlog = 65536

Este ajuste establece el tamaño máximo de la cola de conexiones TCP pendientes de aceptación. En otras palabras, determina el número máximo de peticiones de conexión que el sistema operativo puede atender simultáneamente. El valor por defecto es 1024, pero con la configuración especificada, se establecerá en 65536.

# default=124928
net.core.wmem_max = 8388608

Esta opción establece el tamaño máximo del buffer de memoria para el envío de datos a través de conexiones de red. Controla la cantidad máxima de memoria que se puede asignar para almacenar datos antes de enviarlos. El valor por defecto es 124928, pero con la configuración especificada, se establecerá en 8388608.

# default=131071
net.core.rmem_max = 8388608

Al igual que el ajuste anterior, pero para recibir datos en lugar de enviarlos, esta opción establece el tamaño máximo del buffer de memoria para recibir datos a través de conexiones de red. Controla la cantidad máxima de memoria que se puede asignar para almacenar los datos recibidos. El valor por defecto es 131071, pero con la configuración especificada, se establecerá en 8388608.

# default = 128
net.core.somaxconn = 1024

Esta opción especifica el número máximo de conexiones pendientes en la cola de escucha de sockets del sistema operativo. Controla el número máximo de conexiones entrantes que pueden estar en estado de espera antes de ser aceptadas. El valor por defecto es 128, pero con la configuración especificada, se establecerá en 1024.

# default = 20480
net.core.optmem_max = 81920

Este ajuste establece el tamaño máximo del buffer de memoria para las opciones de socket. Controla la cantidad máxima de memoria que se puede asignar para almacenar opciones de socket antes de que se utilicen. El valor por defecto es 20480, pero con la configuración especificada, se establecerá en 81920.

Dado el caso se cuente con un poderoso servidor exclusivo para alojar la base de datos (DB) para Pandora FMS, existe otra personalización para la instalación en línea.

Primero debe tener en cuenta, a grandes rasgos, cómo debe planificar la instalación para que tanto el servidor PFMS como su Consola web (PANDORA FMS SERVER+CONSOLE) conecten a una base de datos remota (DB):

• Conéctese al servidor que aloja el motor de la base de datos, tome nota exacta de su URL o su dirección IP (DBHOST).
• El número de puerto (DBPORT) por defecto es 3306, tome nota si utiliza uno distinto.
• Debe crear la base de datos, anote exactamente el nombre utilizado (se recomienda usar pandora como DBNAME).
• Debe crear el usuario a utilizar para conectar a la base de datos (se recomienda usar pandora como DBUSER).
• Asigne una contraseña para el usuario creado en el paso anterior (DBPASS).

• Asigne todos los permisos sobre la base de datos creada al usuario creado.

• Ya con todo esto establecido, realice una conexión de prueba por línea de comandos desde el futuro servidor PFMS a la base de datos creada, esto garantizará que existe comunicación verificada y lista para trabajar.
• El parámetro de instalación que permite conectar a una base de datos remota durante la instalación en línea es SKIP_DATABASE_INSTALL y su valor debe ser establecido a 1.
• Proceda a realizar la instalación propiamente dicha con la herramienta de instalación en línea. Se muestra a continuación un ejemplo simplificado y con los valores por defecto (recuerde siempre utilizar contraseña de usuario distinta a la establecida por defecto).

env \
 DBHOST='192.168.1.107' \
 DBNAME='pandora' \
 DBUSER='pandora' \
 DBPASS='pandora' \
 DBPORT='3306' \
 SKIP_DATABASE_INSTALL=1 \
 sh -c "$(curl -fsSL < your_link_for_trial >)"

Para instalar solamente el Agente Software existe también una herramienta de instalación en línea por medio de comando BASH.

• Es compatible con los sistemas operativos GNU/Linux® de base RedHat (Fedora, Rocky Linux, etcétera) y Debian (Ubuntu Server, Devuan, Lubuntu, etcétera).
• Disponible en MS Windows® por medio de la tecnología PowerShell®.

Requisitos para el uso de la herramienta de instalación en línea (online):

• Tener acceso a internet.
• Tener instalado curl (viene por defecto en la mayoría de las instalaciones).
• Ser usuario administrador root.
• Contar con un SO compatible.

El script soporta una serie de variables de entorno para personalizar la instalación. Solamente una de ellas es obligatoria: $PANDORA_SERVER_IP, por lo que para realizar una instalación estándar en una sola línea basta con ejecutar:

export PANDORA_SERVER_IP=< PandoraServer IP or FQDN > && curl -Ls https://pfms.me/agent-deploy | bash

Opcionalmente es posible utilizar otras variables env para personalizar la instalación:

• $PANDORA_REMOTE_CONFIG: Configurar la configuración remota en la versión Enterprise. Cero ( 0 ) por defecto, desactivado.
• $PANDORA_AGENT_NAME: Configura el nombre del agente. Autogenerado por defecto.
• $PANDORA_AGENT_ALIAS: Configura el alias del Agente Software. Por defecto el nombre de host.
• $PANDORA_GROUP: Configura el grupo del Agente Software. Por defecto Servers.
• $PANDORA_SECONDARY_GROUPS: Configura los grupos secundarios del Agente Software. Vacío por defecto
• $PANDORA_DEBUG: Configurar el ajuste de depuración. Cero ( 0 ) por defecto, desactivado.
• $TIMEZONE : Configura la zona horaria del sistema.
• $PANDORA_AGENT_SSL: Permite configurar las comunicaciones cifradas entre el Agente Software y el servidor PFMS correspondiente. Por defecto no habilitado (no), para habilitarlo utilice yes (esto también instalará las dependencias de software para cifrar dichas comunicaciones). Utilice comillas simples para delimitar el valor:

env \
 PANDORA_SERVER_IP='192.168.10.245' \
 PANDORA_REMOTE_CONFIG=1 \
 PANDORA_AGENT_NAME='pandora_agent_name' \
 PANDORA_AGENT_ALIAS='pandora_AGENT_ALIAS' \
 PANDORA_GROUP='Servers' \
 PANDORA_SECONDARY_GROUPS='VMware,Web' \
 PANDORA_AGENT_SSL='yes' \
 bash -c "$(curl -Ls https://pfms.me/agent-deploy)"

Requisitos para el uso de la herramienta de instalación en línea (online):

• Tener acceso a internet.
• Tener instalado PowerShell®.

Ejecutar los comandos siguientes en una ventana terminal con PowerShell y con permisos de administrador (administrator):

Invoke-WebRequest -Uri https://firefly.pandorafms.com/pandorafms/LTS/PandoraFMS_One_Agent_Windows-lts.x86_64.exe -OutFile ${env:tmp}\pandora-agent-windows.exe; & ${env:tmp}\pandora-agent-windows.exe /S --ip [PANDORASERVER IP or NAME] --group [GROUPNAME] --remote_config 1

Luego:

NET START PandoraFMSAgent

• Guía de instalación Pandora FMS Enterprise en Ubuntu server.
• Guía de instalación Pandora FMS Enterprise en Rocky Linux.
• Instalación Pandora FMS Open en Ubuntu server.
• Instalación Pandora FMS Open en Rocky Linux.

Se ejecutan con la orden:

dnf remove pandorafms_console pandorafms_server

Si se desinstala la versión 761 o posterior:

dnf remove pandorawmic

Si ha instalado MySQL y solamente albergaba la base de datos PFMS:

dnf remove Percona-Server*

Será necesario tener todas las dependencias necesarias instaladas según el sistema operativo, descargar los ficheros en formato tarball (.tar.gz, .tgz o .tar.bz2) y descomprimirlo. Para ello, localice la última versión de Pandora FMS:

Una vez que dispone del fichero comprimido en la Consola, por medio de una ventana terminal:

1. Eleve privilegios a usuario root. Usted es el único responsable de dicha clave.

su -

2. Copie a un directorio donde pueda descomprimir el fichero (en este ejemplo se utiliza /tmp) y dentro de ese directorio ejecute:

tar xvzf pandorafms_console-X.Y.tar.gz
cd pandora_console
./pandora_console_install --install

Una vez que se disponga del fichero comprimido el servidor, el cual tendrá un nombre similar a:

pandorafms_server-7.0NG.7xx.tar.gz

1. Eleve privilegios a usuario root. Usted es el único responsable de dicha clave.

su -

2. Copie a un directorio donde se pueda descomprimir el fichero (en este ejemplo se vuelve a utilizar /tmp) y dentro de ese directorio se ejecuta:

tar xvzf pandorafms_server-7.0NG.7xx.tar.gz
cd pandora_server
./pandora_server_installer --install

Si existen problemas de dependencias, se deben resolverlas antes de intentar la instalación. Puede forzar la instalación ignorando el problema de dependencias, pero es muy posible que Pandora FMS funcione de manera incorrecta.

Para la instalación de la versión Enterprise de Pandora FMS, se deben instalar los paquetes Open de la Consola y el servidor, y después añadir los paquetes Enterprise de cada uno. En el caso de la Consola web se usarán unos paquetes u otros dependiendo de la distribución que se tenga instalada.

Si desea instalar la Consola Enterprise a través del código fuente:

Una vez que tenemos el fichero comprimido con la consola, que se tendrá como nombre pandorafms_console_enterprise-X.X.tar.gz (o similar).

1. Eleve privilegios a usuario root. Usted es el único responsable de dicha clave.

su -

2. Copie a un directorio donde pueda descomprimir el fichero (para este ejemplo se usa /tmp) y ejecute:

tar xvzf pandorafms_console-X.Xtar.gz

3. Copie al directorio donde esté instalada la Consola de Pandora FMS Open Source (suponiendo que PFMS esté instalado en el directorio pandora_console):

cp -R enterprise /var/www/html/pandora_console

4. Cambie los permisos para que los ficheros sean propiedad del usuario del servidor web (suponiendo que PFMS esté instalado en el directorio pandora_console):

chown -R apache /var/www/html/pandora_console/enterprise

Para realizar la instalación del servidor Enterprise, primero hay que asegurarse de que la versión Open del servidor está instalada y después proceder a instalar la versión Enterprise.

Una vez que tenga el fichero comprimido en el servidor, que se llamará pandorafms_server_enterprise-X.X.tar.gz o similar:

1. Eleve privilegios a usuario root. Usted es el único responsable de dicha clave:

su -

2. Copie al directorio para descomprimir los ficheros (/tmp en el siguiente ejemplo) y dentro de ese directorio ejecute:

tar xvzf pandorafms_server_enterprise-X.X.tar.gz
cd pandora_server/
# ./pandora_server_installer --install

En el caso de que el binario del servidor de Pandora FMS 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

Tras realizar la instalación reinicie el servidor:

/etc/init.d/pandora_server restart

Deben aparecer habilitados los servidores Enterprise.

Para instalar el servidor de Pandora FMS en una ruta diferente, utilice la opción:

./pandora_server_installer --install --destdir < path >

Después de la instalación, deberá configurar el servidor de Pandora FMS para que se inicie de forma automática durante el arranque y configurar el script de mantenimiento de la base de datos, pandora_db, para que se ejecute de forma periódica. Por ejemplo, en GNU/Linux (sustituya < destdir > por la ruta que le pasó a la opción destdir):

ln -s < destdir >/etc/init.d/pandora_server /etc/init.d/
echo "\"< destdir >/usr/share/pandora_server/util/pandora_db\" \
 \"< destdir >/etc/pandora/pandora_server.conf\">/dev/null 2>&1"> /etc/cron.hourly/pandora_db

Para instalar el servidor de Pandora FMS con un usuario no privilegiado, lance el siguiente comando con el usuario con el que se desea realizar la instalación:

./pandora_server_installer --install --no-root --destdir /opt/pandora

Este usuario debe tener permisos de escritura sobre la ruta que se le pase a destdir.

• Instalación de Agentes Software PFMS.

Volver al índice de documentación de Pandora FMS