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

From Pandora FMS Wiki
Jump to: navigation, search
(Configuraciones personalizadas (por agente))
(Cajas de credenciales)
 
(130 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[Pandora:Documentation|Volver a Indice de Documentacion Pandora FMS]]
+
[[Pandora:Documentation|Volver al Índice de Documentación Pandora FMS]]<br><br><br>
  
 
= Satellite Server =
 
= Satellite Server =
Line 5: Line 5:
 
== Introducción ==
 
== Introducción ==
  
El satellite server se emplea para descubrir y monitorizar redes y equipos remotos,  bien elementos de red (routers, switches, etc) via SNMP o ICMP, o bien servidores Windows (via WMI) o linux (via SNMP). Este no es un servidor "ordinario" sino que más bien se podría considerar como un Agente en modo broker con funcionalidades extendidas. Es un componente exclusivamente de la version Enterprise. El satellite server es especialmente útil para monitorizar redes remotas innaccesibles desde el servidor de Pandora, y donde tampoco podemos instalar agentes.
+
[[Image:icono-modulo-enterprise.png|left|Versión Enterprise.]]
  
<br>
+
El '''Satellite Server''' se emplea para descubrir y monitorizar redes y equipos remotos,  bien elementos de red (''routers'', ''switches'', etc.) vía SNMP o ICMP, o bien servidores MS Windows® (vía WMI) o Linux® (vía SNMP). Este no es un servidor "ordinario", sino que más bien se podría considerar como un Agente Software en [https://pandorafms.com/docs/index.php?title=Pandora:Documentation_es:Operacion#Modo_Broker modo ''broker''] pero con funcionalidades extendidas. Es especialmente útil para monitorizar redes remotas inaccesibles desde el servidor de Pandora FMS, y donde tampoco podemos instalar Agentes Software.
[[File:Esquema-satellite.png|700px|center]]
 
<br>
 
  
El satellite server no requiere una conexión a la base de datos de Pandora, y envía la información recolectada a través de ficheros de datos XML mediante tentacle, como si fuera un agente.  
+
[[Image:Esquema-satellite.png|center|750px]]
  
El satellite server funciona tanto en Windows como en Linux, aunque su instalación difiere en uno u otro caso.
+
El Satellite Server funciona tanto en Windows® como en GNU/Linux® (sistema operativo recomendado) y tiene algunas características que lo hacen especial, más que recomendable en determinados entornos.
  
Este servidor tiene algunas características que lo hacen especial, y más que recomendable en determinados entornos.
+
* Puede ejecutar pruebas de red (ICMP, Latencia y SNMP v1 y v2) a una tasa extremadamente alta (500 chequeos por segundo). Para SNMP v3 debe [[Pandora:Documentation_es:SatelliteServer#SNMPv3|configurar las credenciales de acceso]] y debido al cifrado de datos hará un chequeo menos rápido.
  
* Puede ejecutar pruebas de red (ICMP, Latencia y SNMP v1 y v2) a una tasa extremadamente alta (500 chequeos por segundo).
+
* Solo envía datos al servidor cada X segundos (por defecto 300), pero puede ejecutar las pruebas de latencia, ICMP y SNMP con un intervalo menor (por ejemplo 30 segundos) de forma que, cuando detecta cambios de estado, notifica inmediatamente al servidor. Estos cambios de estado se han de definir previamente si el tipo de Módulo no es un <code>*_proc</code> (por ejemplo interfaces de red o conectividad general de red).
  
* Sólo envía datos al servidor cada X segundos (por defecto 300), pero puede ejecutar las pruebas de latencia, ICMP y SNMP con un intervalo menor, p.e: 30 segundos, de forma que cuando detecta cambios de estado, notifica inmediatamente al servidor. Estos cambios de estado se han de definir previamente si el tipo de modulo no es un _proc (interfaces de red o conectividad general de red, p.e).
+
* '''Es un servidor autónomo,''' no requiere conexión a la base de datos de Pandora FMS. Envía todos los datos como XML de forma que funciona como un servidor independiente, similar a como lo hace un Agente Software en modo ''broker'' o a un Export Server.
  
* Es un servidor autónomo, no requiere conexión a la BBDD. Envía todos los datos como XML de forma que funciona como un servidor independiente, similar a como lo hace un agente en modo broker o a un export server.
+
* Tiene un mecanismo de autodiscovery para SNMP y WMI, de forma que crea los Agentes detectados (por dirección IP), detecta los elementos dinámicos (interfaces de red, almacenamiento) y los monitoriza de forma automática.  
  
* Tiene un mecanismo de autodiscovery para SNMP y WMI, de forma que crea los agentes detectados (por IP) y detecta los elementos dinámicos (interfaces de red, almacenamiento) y los monitoriza de forma automática.  
+
* En sistemas Windows® detecta discos, CPU y memoria.
  
* En sistemas Windows detecta discos, CPU, y memoria.
+
* En sistemas de red con SNMP detecta estado de las interfaces, tráfico de entrada y salida por cada interfaz, y el nombre del sistema.
  
* En sistemas de red con SNMP, estado de las interfaces, tráfico de entrada y salida por cada interfaz, y el nombre del sistema.
+
* Los Módulos autogenerados se pueden modificar, como otro módulo más, gestionando el Agente desde la consola, como si fuera un Agente ordinario (en la sección de '''Operaciones masivas''' -> '''Satélite''').
 
 
* Los módulos autogenerados se pueden modificar, como otro módulo más, gestionando el agente desde la consola. Como si fuera un agente ordinario (en la seccion de operaciones masivas -> Satélite).
 
 
 
* Podemos crear “agentes” directamente, creando un fichero de configuración de agente en el directorio de configuraciones del satellite server (ver uno de ejemplo para más pistas sobre su formato).
 
  
 +
* '''Puede crear Agentes manualmente''' generando un fichero de configuración de Agente en el directorio de configuraciones del Satellite Server (explicado más adelante).
  
 
=== Capacidad ===
 
=== Capacidad ===
  
Es difícil precisar la capacidad máxima del satélite, ya que depende totalmente del servidor donde se ejecuta, y el tipo de chequeos que se quiere realizar. En el mejor de los casos, hemos logrado realizar 500 chequeos ICMP y SNMP por segundo, pero eso depende muchisimo de los tiempos de respuesta del dispositivo remoto (no es lo mismo uno que contesta en 0.5ms que uno que tarda 2sec en responder). En condiciones ideales teóricas podemos hablar de que se pueden monitorizar unos 150,000 monitores con un solo satellite server. En condiciones reales, hemos probado en entornos más o menos controlados (redes locales) unos 50,000 modulos con un satellite server en un ordenador de hardware muy discreto (Intel i5, 2GHz, 4GB RAM).
+
La capacidad máxima del '''Satellite Server''' depende totalmente del hardware del servidor donde se ejecuta, y el tipo de chequeos que se necesitan realizar. En entorno de pruebas se ha logrado realizar 500 chequeos ICMP y SNMP por segundo, pero eso depende mucho de los tiempos de respuesta del dispositivo remoto (no es lo mismo uno que responde en 10 milisegundos que uno que tarda 2 segundos en responder). En condiciones ideales teóricas se puede hablar de que se pueden monitorizar unos 150&nbsp;000 monitores con un solo '''Satellite Server'''. En condiciones reales se ha probado en entornos más o menos controlados (redes locales) unos 50&nbsp;000 Módulos con un Satellite Server en un ordenador de hardware muy discreto (procesador Intel i5®, 2 GHz, 4 GB RAM).
 
 
{{Warning|SI EXISTEN MULTITUD DE MONITORES CRÍTICOS EL RENDIMIENTO SE VE MUY AFECTADO. También hay que tener en cuenta el timeout configurado, ya que solo se realiza una comprobación crítica por timeout.}}
 
  
{{Tip|Si tenemos 1000 módulos críticos y el timeout configurado a 4 segundos, se tardarían 4000 segundos en ejecutar todos estos chequeos con un único hilo.}}
+
{{Warning|'''Si existen muchos Módulos críticos, el rendimiento puede verse muy afectado'''. También hay que tener en cuenta el '''timeout''' configurado, ya que solo se realiza una comprobación crítica por '''timeout'''. Si tiene 1000 Módulos críticos y el '''timeout''' configurado en 4 segundos, se tardará 4000 segundos en ejecutar todos estos chequeos con un único hilo.}}
  
 
== Instalación ==
 
== Instalación ==
  
El Satellite Server se distribuye en forma de tarball o .exe para windows, de forma que no hace falta instalar Perl o ninguna librería adicional. El funcionamiento en las versiones Windows o Linux es idéntica. En caso de Windows se instala como servicio, y en el caso de Linux se instala como demonio del sistema. El fichero de configuración y las especificaciones de ambos son idénticas.
+
El Satellite Server se distribuye en forma de '''tarball''' (GNU/Linux®) o <code>.exe</code> (Windows®), de forma que no hace falta instalar Perl ni ninguna librería adicional. El funcionamiento en las versiones Windows® o Linux® es idéntico. En caso de Windows® se instala como servicio, y en el caso de Linux® se instala como demonio del sistema. El fichero de configuración y las especificaciones de ambos son idénticas.
  
La versión de Linux del Satellite Server depende de paquetes externos que se especifican en la sección correspondiente de esta documentación.
+
La versión de Linux® del '''Satellite Server''' depende de paquetes externos que se especifican en la sección correspondiente de esta documentación.
  
 
== Instalación de Satellite Server en Linux ==
 
== Instalación de Satellite Server en Linux ==
  
 +
'''El sistema operativo GNU/Linux recomendado es CentOS'''. Una vez descargado el paquete que contiene el Satellite Server es necesario ir a la carpeta de descarga con privilegios de '''root''' y descomprimir el binario:
  
Una vez descargado el paquete que contiene el Satellite Server seria necesario situarnos dentro de la carpeta de descarga con privilegios de root y desarchivar el binario:
+
tar -xvzf pandorafms_satellite_server_X.XNG.XXX_x86_64.tar.gz
 
 
 
 
 
 
<center>
 
<br>
 
[[File:Desarchivar_nuevo.png]]
 
</center>
 
 
 
{{Tip|tar -xvzf pandorafms_satellite_server_X.XNG.XXX_x86_64.tar.gz.}}
 
 
 
  
A continuación se generará una carpeta denominada satellite_server. Tenemos que situarnos dentro tecleando:
+
[[Image:Desarchivar_nuevo.png|center|711px]]
  
'''cd satellite_server/'''
+
A continuación se generará una carpeta denominada <code>satellite_server</code>. Vaya a dicha carpeta tecleando:
  
Antes de proceder con la instalación es necesario dejar claro cuales son las dependencias fundamentales del Satellite Server:
+
cd satellite_server/
fping, nmap, wmic y braa.
 
  
Tambien sera necesario para la ejecucion del servidor tener instalado Perl en el dispositivo.
+
Antes de proceder con la instalación es necesario dejar claro cuáles son las dependencias fundamentales del Satellite Server:
 +
'''Perl''', '''Braa''', '''Wmic''', '''Fping''' y '''Nmap'''.  
  
{{Tip|Para instalar Perl se debe utilizar el siguiente comando: yum install perl.}}
+
Instale Perl con el siguiente comando:
  
En el instalador se adjuntan las dependencias de Braa y Wmic. Es necesario instalar Fping y Nmap de forma independiente.
+
yum install perl
  
{{Tip|Para instalar Fping se debe utilizar el siguiente comando: yum install fping.}}
+
En el instalador se adjuntan las dependencias de Braa y Wmic. Es necesario instalar Fping y Nmap de forma independiente:
{{Tip|Para instalar Nmap se debe utilizar el siguiente comando: yum install nmap.}}
 
  
A continuación para instalar el Satellite Server solamente tendriamos que seguir las instrucciones de la siguiente imagen:
+
yum install fping nmap
  
 +
Para instalar el Satellite Server en sí, debe ejecutar el comando de instalación:
  
 +
./satellite_server_installer --install
  
<center>
+
[[Image:Instalacion linux_nuevo.png|center|751px]]
<br>
 
[[File:Instalacion linux_nuevo.png]]
 
</center>
 
  
{{Tip|./satellite_server_installer --install}}
+
Una vez terminado el proceso, será necesario editar el fichero de configuración del satélite localizado en:
  
 +
/etc/pandora/satellite_server.conf
  
Una vez terminado sera necesario editar el fichero satellite_server.conf localizado en /etc/pandora/satellite_server.conf
+
El [https://www.youtube.com/watch?v=MEdvLdH_DoE editor de texto por defecto] en CentOS es '''VIM'''. Busque el ''token'' <code>pandora_license</code>, proceda a descomentarlo e '''introduzca la licencia''' del servidor Pandora FMS Enterprise. Tras ello puede guardar el archivo y levantar el servicio, ejecutando lo siguiente:
buscar el token pandora_license, descomentarlo e introducir la licencia.
 
Guardar el archivo y levantar el sercivio
 
  
Para ejecutar el servidor tiene que teclear lo siguiente:
+
sudo /etc/init.d/satellite_serverd start
  
'''sudo /etc/init.d/satellite_serverd start'''
+
En caso de algún error o mal funcionamiento, puede revisar el fichero  de registro en:
  
En caso de algun error o malfuncionamiento puede revisar el fichero satellite_server.log, localizado en la ruta /var/log/satellite_server.log
+
  /var/log/satellite_server.log
  
 
== Instalación en Windows ==
 
== Instalación en Windows ==
  
 +
Elija el idioma de instalación:
  
El proceso de instalación en windows se puede realizar siguiendo las siguientes imagenes:
+
[[Image:Instalacion windows1.png|center|288px]]
 
 
Empezamos por elegir el idioma de instalación:
 
 
 
 
 
<center>
 
<br>
 
[[File:Instalacion windows1.png|300px]]
 
</center>
 
 
 
  
A continuación pinchamos en siguiente:
+
Haga clic en Siguiente:
  
 +
[[Image:Instalacion windows2_nuevo.png|center|516px]]
  
 +
Elija el lugar para instalar el programa:
  
<center>
+
[[Image:Instalacion windows3_nuevo.png|center|516px]]
<br>
 
[[File:Instalacion windows2_nuevo.png]]
 
</center>
 
  
 +
Será necesario instalar tambien '''WinPCap'''. La ventana de instalación aparecerá en este paso de la instalación.
  
 +
[[Image:Instalación wincap1.png|center|498px]]
  
 +
Configure el encendido de WinPCap al iniciar la máquina:
  
A continuación podemos elegir el lugar donde queremos instalar el programa y pinchar sobre instalar:
+
[[Image:Instalación wincap2.png|center|499px]]
  
 +
Una vez terminada la instalación de WinCap verá la siguiente pantalla:
  
 +
[[Image:Instalación wincap3.png|center|499px]]
  
<center>
+
Introduzca la clave de licencia de Pandora FMS Enterprise para continuar con la instalación:
<br>
 
[[File:Instalacion windows3_nuevo.png]]
 
</center>
 
  
 +
[[Image:Instalacion windows4_nuevo.png|center|512px]]
  
 +
En el siguiente apartado debe configurar la dirección del servidor Pandora FMS para el envío de los datos; puede definir las reglas exploración de red para el Satellite Server.
  
 +
[[Image:Instalacion windows5_new.png|center|503px]]
  
Será necesario instalar tambien WinPCap. la ventana de instalación de WinPCap nos aparecerá en este paso de la instalación.
+
Será necesario reiniciar la máquina para que se apliquen todos los cambios.
  
 +
[[Image:Instalacion windows6_nuevo.png|center|507px]]
  
 +
Una vez terminado el proceso, puede arrancar y detener el servicio Satellite Server PFMS desde el menú Inicio de Windows®.
  
<center>
+
=== Funcionamiento de Módulos WMI en algunas versiones de Windows ===
<br>
 
[[File:Instalación wincap1.png|500px]]
 
</center>
 
  
 +
Por motivos de seguridad de Windows®, algunas versiones tienen limitados los usuarios con los que realizar consultas WMI remotas. En el caso de que estas consultas no se lleven a cabo, la solución es ejecutar el servicio del Satellite Server como usuario '''Administrador'''.
  
 +
El proceso a seguir es el siguiente:
  
A continuación configuramos el encendido de WinPCap al iniciar la maquina:
+
Abra los servicios:
  
 +
[[Image:Instalacion windows7_nuevo.png|center|344px]]
  
 +
Haga clic sobre el servicio y entre en '''Propiedades''':
  
<center>
+
[[Image:Instalacion windows8_nuevo.png|center|806px]]
<br>
 
[[File:Instalación wincap2.png|500px]]
 
</center>
 
  
 +
Sobre la ventana de '''Iniciar sesión''' seleccione una cuenta con permisos de Administrador y aplique los cambios:
  
 +
[[Image:Instalacion windows9_nuevo.png|center|405px]]
  
 +
Debe reiniciar el servicio para aplicar los cambios.
  
Una vez terminada la instalación de WinCap podra ver la siguiente pantalla:
+
== Configuración ==
  
 +
Todos los parámetros que requieren un ''timeout'' o tiempo de expiración se deben especificar en segundos ( por defecto 300 segundos que es igual a 5 minutos).
  
 +
Es importante destacar que los intervalos de latency y SNMP son específicos al cambio de estado. En el caso de los chequeos ''booleanos'' (estado de un puerto, estado de la máquina), el umbral que define el cambio de estado es automático. En el caso de valores numéricos (latencia, tráfico de red en una interfaz, espacio de disco, CPU, etc.), se basa en el umbral. Por defecto no se definen umbrales; esto tiene que hacerse en la definición del Módulo.
  
<center>
+
=== agent_interval ===
<br>
 
[[File:Instalación wincap3.png|500px]]
 
</center>
 
  
 +
agent_interval xxx
  
 +
Por defecto, 300 segundos (5 minutos). Será el tiempo tras el que enviará datos al servidor, ''independientemente de que los chequeos que haga el Satellite Server sean con un intervalo más corto''. De ser necesario, y por defecto, crea Agentes en el servidor Pandora FMS correspondiente según el tiempo aquí especificado.
  
Será necesario introducir la clave de licencia para poder seguir con la instalación:
+
=== agent_threads ===
  
 +
agent_threads xxx
 +
 +
Número de hilos que se utilizan para mandar ficheros XML de datos.
  
 +
=== xxxxxx_interval ===
  
<center>
+
xxxxxx_interval xxx
<br>
 
[[File:Instalacion windows4_nuevo.png]]
 
</center>
 
  
 +
Ejecuta todos los chequeos (latencia, SNMP, etc) cada <code>xxx</code> segundos. Si el dato recopilado cambia respecto al anterior lo envía en ese momento. Si es igual, lo enviará cuando el intervalo de ese Agente así lo ordene. Es útil para realizar pruebas muy intensivas y notificar '''solo en el caso de cambio de estado'''.
  
 +
=== xxxxx_retries ===
  
En el siguiente apartado tenemos que configurar las opciones de exploración de red para el Satellite Server.
+
xxxxx_retries xxx
  
 +
Número de reintentos <code>xxx</code> en los chequeos (latencia, SNMP, ping, etcétera).
  
 +
=== xxxxx_timeout ===
  
<center>
+
xxxxx_timeout xxx
<br>
 
[[File:Instalacion windows5_new.png]]
 
</center>
 
  
 +
''Timeout'' en segundos para las pruebas de tipo SNMP, latencia y ping.
  
 +
=== xxxxx_block ===
  
Por último será necesario reinciar la maquina para que se puedan aplicar satisfactoriamente todos los cambios.
+
xxxxx_block xxx
  
 +
Fuerza al servidor a ejecutar las consultas (latencia, ping y SNMP) en bloques de <code>XXX</code> consultas. Cuanto mayor sea el número (máximo 500) más capacidad de proceso tendrá, pero a costa de incrementar la latencia. En algunos casos puede ser conveniente disminuir ese número.
  
 +
=== xxxxx_threads ===
  
<center>
+
xxxxx_threads n
<br>
 
[[File:Instalacion windows6_nuevo.png]]
 
</center>
 
  
 +
Número de hilos <code>n</code> asignados a cada tipo de chequeo para que trabajen de manera concurrente. Dependerá de la potencia (CPU y RAM) de la máquina. Cuantos más hilos, más se cargará el sistema, pero más capacidad de proceso tendrá. Al superar los 20 hilos, dependiendo del sistema, puede empeorar el rendimiento.
  
 +
=== log_file ===
  
Una vez terminado desde el menu inicio puede arrancar y parar el servicio de satellite server.
+
log_file <path_file>
  
=== Funcionamiento módulos WMI en algunas versiones de Windows ===
+
Indica el fichero en el que se escribe el ''log'' del Satellite Server, por defecto en <code>/var/log/satellite_server.log</code>.
  
Por motivos de seguridad de Windows, algunas versiones tienen limitados los usuarios con los que puedes realizar consultas WMI remotas. En el caso de que estas consultas no se lleven a cabo, la solución es ejecutar el servicio del Satellite Server como usuario Administrador.
+
=== recon_task ===
  
El proceso a seguir es el siguiente:
+
recon_task xxxxx[,yyyy]
  
Abrimos los servicios:
+
Direcciones/Redes IP empleadas para el Autodiscovery, separadas por comas. Ejemplo:
  
<center>
+
192.168.50.0/24,10.0.1.0/22,192.168.70.64/26
<br>
 
[[File:Instalacion windows7_nuevo.png]]
 
</center>
 
<br>
 
 
 
Pinchamos botón derecho sobre el servicio y entramos en Propiedades
 
 
 
 
 
<center>
 
<br>
 
[[File:Instalacion windows8_nuevo.png]]
 
</center>
 
<br>
 
 
 
Sobre la ventana de Iniciar sesión seleccionamos una cuenta con permisos de Administrador y Aplicamos cambios:
 
  
<center>
+
=== server_ip ===
<br>
 
[[File:Instalacion windows9_nuevo.png]]
 
</center>
 
<br>
 
  
Tras estos cambios, reiniciamos el servicio.
+
server_ip <IP>
  
== Configuración ==
+
Dirección IP o nombre DNS del servidor de Pandora FMS al cual enviar la información. Los datos se envían por [[Pandora:Documentation_es:Tentacle|Tentacle]], de forma que la comunicación hacia el servidor debe estar permitida y garantizada por el puerto <code>41121/tcp</code>.
  
Todos los parámetros que requieren un timeout o tiempo se especifican en segundos, p.e: 300 = 5 minutos.
+
=== recon_mode ===
  
Es importante destacar que los intervalos de latency y snmp son específicos al cambio de estado. En el caso de chequeos booleanos (estado de un puerto, estado de la máquina) el umbral que define el cambio de estado es automático, en el caso de valores numéricos (latencia, tráfico de red en una interfaz, espacio de disco, CPU, etc), se basa en el umbral. Por defecto no se definen umbrales, esto tiene que hacerse en la definición del módulo.
+
recon_mode <mode_discovery>
  
=== agent_interval xxx ===
+
<!-- ¿separados por comas -->
  
Por defecto 300 segundos (5 minutos), crea agentes con un intervalo de 5 minutos. Será el tiempo tras el cual enviará datos al servidor. Independientemente de que los chequeos que haga el Satellite Server sean con un intervalo mucho más corto.
+
Modo de autodescubrimiento ( <code><mode_discovery></code> ) a utilizar. El sistema empleará los siguientes protocolos para descubrir los sistemas:
  
=== agent_theads xxx ===
+
* <code>icmp</code>: Realiza verificación para determinar si el ''host'' está en línea ('''ping''') y mide el tiempo de latencia.
 +
* <code>snmp</code>: Si es capaz de comunicar por SNMP (v1 y v2 únicamente) buscará todas las interfaces de red y sacará el tráfico de todas ellas, así como su estado operativo, además del nombre del dispositivo y ubicación. Probará con las [[Pandora:Documentation_es:SatelliteServer#recon_community|diferentes comunidades suministradas en el fichero de configuración]] para conectar. ''Para utilizar SNMP v3 cuyo reconocimiento es innecesario'', consulte en [[Pandora:Documentation_es:SatelliteServer#SNMPv3|este enlace]] cómo configurar las credenciales de acceso conocidas.
 +
* <code>wmi</code>: Similar al caso anterior, en este caso mostrando Carga de CPU, Memoria y Discos (todos los disponibles).
  
Número de hilos que se utilizan para mandar ficheros XML de datos.
+
=== recon_community ===
  
=== xxxxxx_interval xxx ===
+
recon_community <aaa>,<bbb>,<ccc>...
  
Ejecuta todos los chequeos (latencia, snmp, etc) cada xxx segundos. Si cambia el dato respecto al anterior lo envía en ese momento. Si es igual, lo enviará cuando el intervalo de ese agente así lo ordene. Es útil para realizar pruebas muy intensivas, y notificar sólo en el caso de cambio de estado.
+
Especifica una lista de comunidades SNMP <code><xxx></code> para usar en el discovery de SNMP, separadas por comas. Utilizará esta lista en la exploración SNMP: por cada dirección IP encontrada, intentará ver si responde a alguna de estas comunidades.
  
=== xxxxx_retries xxx ===
+
=== wmi_auth ===
  
Número de reintentos en los chequeos (latencia, snmp, ping...)
+
wmi_auth Administrator%password[,user%pass]
  
=== xxxxx_timeout xxx ===
+
Especifica una lista de parejas de credenciales de usuario, cada una de ellas en el formato '''<nombre de usuario>%<contraseña>''' y separadas por comas.
  
Timeout en segundos para las pruebas de tipo SNMP, Latency y Ping.
+
Por ejemplo: <code>admin%1234,super%qwerty</code>. Utilizará esta lista en la exploración WMI. Por cada dirección IP encontrada, intentará ver si responde a alguna de estas combinaciones.
  
=== xxxxx_block xxx ===
+
=== agent_conf_dir ===
  
Fuerza al servidor a ejecutar las consultas en bloques de XXX consultas. Cuanto mayor sea el numero (Hasta 500) mas capacidad de proceso tendrá, pero con una latencia ligeramente superior. En algunos casos puede ser conveniente disminuir ese número (Valido para latency, ping y snmp).
+
agent_conf_dir <path>
  
=== xxxxx_threads n ===
+
Vía ( <code><path></code>) al directorio que crea y almacena automáticamente los ficheros de configuración de cada Agente creado por el Satellite Server. Por defecto <code>/etc/pandora/conf</code>. Dichos Agentes también pueden ser [[Pandora:Documentation_es:SatelliteServer#Creaci.C3.B3n_de_agentes_de_manera_manual|creados manualmente]].
  
Número de hilos asignados a cada tipo de chequeo para que trabajen concurrentemente. Dependerá de la potencia (CPU y Memoria) de la máquina. Cuantos más hilos mas se cargará el sistema, pero más capacidad de proceso tendrá. Al superar los 20 hilos, dependiendo del sistema, puede empeorar el rendimiento.
+
=== group ===
  
=== log_file /var/log/satellite_server.log ===
+
group <group_name>
  
Indica el fichero en el que se escribe el log del Satellite server, por defecto está en /var/log/satellite_server.log
+
Define el nombre del grupo <code><group_name></code> por defecto de los Agentes creados por el Satellite Server. Por ejemplo, "Servers".
  
=== recon_task xxxxx[,yyyy] ===
+
=== daemon ===
  
Direcciones/Redes IP empleadas para el autodiscovery, p.e:
+
daemon [1|0]
  
192.168.50.0/24,10.0.1.0/22,192.168.70.64/26
+
Si su valor es 1 ejecuta el ''demonio'' (servicio) en segundo plano (valor por defecto).
  
=== server_ip <ip> ===
+
=== hostfile ===
  
Dirección del servidor de Pandora FMS al que queremos enviar la información. La información se envía por Tentacle, de forma que la comunicación hacia el servidor debe ser posible por el puerto de tentacle (41121/tcp).
+
hostfile <file>
  
=== recon_mode [icmp,snmp,wmi] ===
+
Es un método alternativo o complementario al de explorar una red para encontrar ''hosts''. En este fichero <code><file></code>, en cada línea hay una dirección. Alternativamente, se le puede pasar en la misma línea el hostname seguido de la IP, de esa forma el Agente será creado con ese nombre y además use esa dirección IP para los Módulos (por ejemplo: <code>192.168.0.2 <hostname></code>). Es necesario que al realizar una consulta con Fping a esas direcciones su resultado sea en línea para que dichas direcciones sean válidas.
  
Modo de autodescubrimiento. El sistema empleará esos protocolos para descubrir los sistemas:
+
=== pandora_license ===
  
* ICMP: Se limitará a hacer verificación de si el host está vivo (ping) y medir el tiempo de latencia.
+
pandora_license xxxxxxx
* SNMP: Si es capaz de comunicar por SNMP (v1 y v2 únicamente), buscará todas las interfaces de red, y sacará el tráfico de todas ellas, así como su estado operativo, además del nombre del dispositivo y ubicación. Probará con las diferentes comunidades suministradas en el fichero de configuración para conectar.
 
* WMI: Similar al caso anterior, en este caso mostrando Carga de CPU, Memoria y Discos (todos los disponibles).
 
  
=== recon_community aaa,bbb,ccc... ===
+
Escriba y almacena la licencia del servidor Pandora FMS Enterprise, tal como se muestra en la seccion '''Setup''' -> '''License''' de la Consola Pandora FMS.  
  
Especifica una lista de comunidades SNMP para usar en el discovery de SNMP. Separadas por comas. Utilizará esta lista en la exploración SNMP. Por cada IP encontrada, intentará ver si responde a alguna de estas comunidades.
+
[[Image:PFMS-setup-license.png|center|500px]]
  
=== wmi_auth Administrator%password[,user%pass] ===
+
Puede usar la misma licencia en tantos Satellite Servers como se necesite, ya que el total de Agentes que usan la licencia se verifica en el servidor de Pandora FMS, no en el Satellite Server.
  
Especifica una lista de parejas de Usuario%Password, p.e: admin%1234,super%qwerty. Utilizará esta lista en la exploración WMI. Por cada IP encontrada, intentará ver si responde a alguna de estas combinaciones.
+
=== remote_config ===
  
=== agent_conf_dir <path to agente conf dir> ===
+
remote_config [1|0]
  
En este directorio se crean automáticamente los ficheros de configuración de cada agente creado por el Satellite Server. Puede crearlos a mano. su sintaxis es muy parecida a los de un agente software estandard.
+
Activa por defecto la [[Pandora:Documentation_es:Operacion#Configuraci.C3.B3n_remota|configuración remota]] en los Agentes detectados, necesario si quiere gestionarlos desde la Consola después de detectarlos. También activa la configuración remota del propio Satellite Server.
  
=== group <grupo> ===
+
=== temporal_min_size ===
  
Define el grupo por defecto de los agentes creados por el satélite. Por ejemplo "servers".
+
temporal_min_size xxx
  
=== daemon 1|0 ===
+
Si el espacio libre (en megabytes) de la partición en la que se encuentra el directorio temporal es menor que este valor, no se siguen generando paquetes de datos. De este modo se evita que se llene el disco si por alguna razón se pierde la conexión con el servidor durante un intervalo de tiempo prolongado.
  
Si su valor es 1, levanta en demonio en background (por defecto).
+
=== xml_buffer ===
  
=== hostfile <file> ===
+
xml_buffer [0|1]
  
Es un método alternativo/complementario al de escanear una red para encontrar hosts. Se le pasa un fichero donde en cada línea hay una direccion. Alternativamente se le puede pasar en la misma línea el hostname seguido de la IP de forma que cree que el agente con ese nombre y use esa IP para los módulos (192.168.0.2 hostname). Se debe de poder realizar un fping a esas direcciones para que sean válidas.
+
Valor por defecto 0. Estando configurado con valor a 1 el Agente guardará los XML de datos que no haya podido enviar para intentarlo de nuevo más adelante.
  
=== pandora_license xxxxxxx ===
+
{{Warning|En Unix, si está en un entorno seguro considere cambiar el directorio temporal, ya que <code>/tmp</code> tiene permisos de escritura para todos los usuarios.}}
  
Ahi debe escribir la licencia de su servidor Pandora FMS, tal como se muestra en la seccion Setup-> Licencia de su consola Pandora FMS. Puede usar la misma licencia en tantos servidores satélite como necesite, ya que el total de agentes que usan la licencia se verifica en el servidor de Pandora FMS, no en el satélite.
+
=== snmp_version ===
  
=== remote_config 1|0 ===
+
snmp_version xx
  
Activa por defecto la configuración remota en los agentes detectados. Necesario si quiere gestionarlos desde la consola después de detectarlos. También activa la configuración remota del propio Satellite Server. Para más información sobre configuración remota ver: [[Pandora:Documentation_es:Operacion#Configuraci.C3.B3n_remota|Configuración remota]].
+
Versión de SNMP que se utilizará por defecto ( 1 ). Para utilizar SNMP v3 consulte en [[Pandora:Documentation_es:SatelliteServer#SNMPv3|este enlace]] cómo configurar las credenciales de acceso conocidas.
  
===temporal_min_size===
+
{{Warning|Algunos Módulos podrían dejar de funcionar si se cambia este valor.}}
  
Si el espacio libre (en mega bytes) de la partición en la que se encuentra el directorio temporal es menor que este valor, no se siguen generando paquetes de datos. De este modo se evita que se llene el disco si por alguna razón se pierde la conexión con el servidor durante un intervalo de tiempo prolongado.
+
=== braa ===
  
===xml_buffer===
+
braa <path>
 +
Vía <code><path></code> al binario de Braa. Valor por defecto <code>/usr/bin/braa</code>.
  
Por defecto 0. Estando a 1 el agente guardará los XML de datos que no haya podido enviar para intentarlo de nuevo más adelante.
+
=== fping ===
  
En Unix, si está en un entorno seguro debería considerar cambiar el directorio temporal, ya que /tmp tiene permisos de escritura para todos los usuarios.
+
fping <path>
 +
Vía <code><path></code> al binario de Fping. Valor por defecto <code>/usr/sbin/fping</code>.
  
 +
=== fsnmp ===
  
=== snmp_version ===
+
fsnmp <path>
 +
Vía <code><path></code> al binario de Fsnmp. Valor por defecto <code>/usr/bin/pandorafsnmp</code>.
  
Versión de SNMP que se utilizará por defecto (sólo 1 y 2c están soportadas). 1 por defecto.
+
=== latency_packets ===
  
{{warning|Algunos módulos podrían dejar de funcionar si se cambia este valor.}}
+
latency_packets xxx
  
=== braa <path a braa> ===
+
Número de paquetes <code>xxx</code> ICMP que se envían por petición de latencia.
  
Path al binario de braa (/usr/bin/braa por defecto).
+
=== nmap ===
  
=== fping <path a fping> ===
+
nmap <path>  
  
Path al binario de fping (/usr/sbin/fping por defecto).
+
Vía <code><path></code> al binario de Nmap. Valor por defecto <code>/usr/bin/nmap</code>.
  
=== fsnmp <path a fsnmp> ===
+
=== nmap_timing_template ===
  
 +
nmap_timing_template x
  
Path al binario de SNMP(/usr/bin/pandorafsnmp por defecto).
+
Un valor <code>xxx</code> que especifica nivel de agresividad de Nmap, de 1 a 5. Uno significa más lento pero más fiable, cinco significa más rápido pero menos fiable. Valor por defecto: 2.
  
=== latency_packets xxx ===
+
=== ping_packets ===
  
Número de paquetes ICMP que se envían por petición de latencia.
+
ping_packets xxx
  
=== nmap <path a nmap> ===
+
Número de paquetes ICMP que se envían por cada ping.
  
Path al binario de nmap (/usr/bin/nmap por defecto).
+
=== recon_enabled ===
  
=== nmap_timing_template xxx ===
+
recon_enabled [0|1]
  
Un valor que especifica cómo de agresivo debe ser nmap de 1 a 5. 1 significa más lento pero más fiable, 5 significa más rápido pero menos fiable. 2 por defecto.
+
Habilita (1) o deshabilita (0) el autodescubrimiento de equipos.
  
=== ping_packets xxx ===
+
=== recon_timing_template ===
  
Number of ICMP packets to send per ping request.
+
recon_timing_template xxx
  
=== recon_enabled 0|1 ===
+
Tal como [[Pandora:Documentation_es:SatelliteServer#nmap_timing_template|nmap_timing_template]] pero aplicado a los escaneos de red.
  
Habilita (1) o deshabilita (0) el autodescubrimiento de equipos.
+
=== server_port ===
  
=== recon_timing_template xxx ===
+
server_port xxxxx
  
Como nmap_timing_template, pero aplicado a los escaneos de red.
+
Puerto del servidor Tentacle.
  
=== server_port xxxxx ===
+
=== server_name ===
  
Puerto del servidor de Tentacle.
+
server_name xxxxx
  
=== server_name xxxxx ===
+
Nombre del servidor Satellite (por defecto toma el ''hostname'' de la máquina).
  
Nombre que se quiere dar al servidor Satellite (por defecto localhost.localdomain).
+
=== server_path ===
  
=== server_path xxxxx ===
+
server_path <path>
  
Ruta donde los ficheros XML son copiados si el transfer_mode esta en local (por defecto /var/spool/pandora/data_in).
+
Ruta <code><path></code> donde los ficheros XML son copiados si el [[Pandora:Documentation_es:SatelliteServer#transfer_mode|transfer_mode]] está en local (por defecto <code>/var/spool/pandora/data_in</code>).
  
 
=== server_opts ===
 
=== server_opts ===
  
Parametros del servidor que son pasados a Tentacle.
+
Parámetros del servidor que son pasados a Tentacle.
 +
 
 +
=== transfer_mode ===
  
=== transfer_mode XXX ===
+
transfer_mode [tentacle|local]
  
Modo de tranferencia de ficheros. Puede ser únicamente Tentacle o local (por defecto Tentacle).
+
Modo de transferencia de ficheros. Puede ser únicamente Tentacle o local (por defecto Tentacle).
  
 
=== Servidor Secundario ===
 
=== Servidor Secundario ===
 +
 +
secondary_mode [on_error|always]
  
 
Un tipo especial de parámetro de configuración general es la definición de un servidor secundario. Esto permite definir un servidor al que se le envían los datos, de forma complementaria al servidor definido de forma estándar. El modo de servidor secundario funciona de dos formas:
 
Un tipo especial de parámetro de configuración general es la definición de un servidor secundario. Esto permite definir un servidor al que se le envían los datos, de forma complementaria al servidor definido de forma estándar. El modo de servidor secundario funciona de dos formas:
  
 
* '''on_error''': Envía datos al servidor secundario solo si no puede enviarlas al primario.
 
* '''on_error''': Envía datos al servidor secundario solo si no puede enviarlas al primario.
* '''always''': Siempre envía datos al servidor secundario, independientemente si puede contactar o no con el servidor principal.
+
* '''always''': Siempre envía datos al servidor secundario, independientemente de si puede contactar o no con el servidor principal.
  
 
Ejemplo de configuración:
 
Ejemplo de configuración:
Line 418: Line 394:
 
  secondary_server_port  41121
 
  secondary_server_port  41121
  
=== snmp_verify 0|1 ===
+
=== snmp_verify ===
 +
 
 +
snmp_verify [0|1]
 +
 
 +
Habilita (1) o deshabilita (0) la comprobación de módulos SNMP v1 que hacen fallar Braa en tiempo real. Estos Módulos serán descartados y dejarán de ejecutarse. Véase también tanto [[Pandora:Documentation_es:SatelliteServer#snmp2_verify|snmp2_verify]] como [[Pandora:Documentation_es:SatelliteServer#snmp3_verify|snmp3_verify]].<br><br><br>
 +
 
 +
=== snmp2_verify ===
 +
 
 +
snmp2_verify [0|1]
 +
 
 +
Habilita (1) o deshabilita (0) la comprobación de módulos SNMP v2 que hacen fallar Braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse. Véase también tanto [[Pandora:Documentation_es:SatelliteServer#snmp_verify|snmp_verify]] como [[Pandora:Documentation_es:SatelliteServer#snmp3_verify|snmp3_verify]].
  
Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv1 que rompen braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.
 
  
=== snmp2_verify 0|1 ===
+
{{warning|¡Comprobar módulos SNMP versión 2 puede ser muy lento!}}
  
Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv2 que rompen braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.
+
=== snmp3_verify ===
  
{{warning|Comprobar módulos SNMP versión 2 puede ser muy lento!}}
+
snmp3_verify [0|1]
  
=== snmp3_verify 0|1 ===
+
Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv3 que hacen fallar Braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse. Véase también tanto [[Pandora:Documentation_es:SatelliteServer#snmp_verify|snmp_verify]] como [[Pandora:Documentation_es:SatelliteServer#snmp2_verify|snmp2_verify]].<br><br><br>
  
Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv3 que rompen braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse.
+
=== startup_delay ===
  
=== startup_delay xxx ===
+
startup_delay xxx  
  
 
Espera xxx segundos antes de enviar ficheros de datos por primera vez.
 
Espera xxx segundos antes de enviar ficheros de datos por primera vez.
  
=== temporal /tmp ===
+
=== temporal ===
 +
 
 +
temporal <directory>
 +
 
 +
Directorio temporal donde se crean los ficheros XML, por defecto <code>/tmp</code>.
 +
 
 +
=== tentacle_client ===
 +
 
 +
tentacle_client <path>
  
Directorio temporal donde se crean los ficheros XML.
+
Vía <code><path></code> del cliente de Tentacle. Valor por defecto <code>/usr/bin/tentacle_client</code>.
  
=== tentacle_client <path a tentacle_client> ===
+
=== wmi_client ===
  
Path al binario del cliente de Tentacle (/usr/bin/tentacle_client por defecto).
+
wmi_client <path>
 +
Vía <code><path></code> al binario de wmi_client. Valor por defecto <code>/usr/bin/wmic</code>.
  
=== wmi_client <path a wmic> ===
+
=== snmp_blacklist ===
  
Path al binario de wmic (/usr/bin/wmic por defecto).
+
snmp_blacklist <path>
  
=== snmp_blacklist <path to the blacklist> ===
+
Vía <code><path></code> a la lista de exclusión de Módulos SNMP. Valor por defecto <code>/etc/pandora/satellite_server.blacklist</code>.
  
Path a la lista negra de módulos SNMP (/etc/pandora/satellite_server.blacklist por defecto).
+
=== add_host ===
  
=== add_host <dirección IP> [nombre del agente] ===
+
add_host <dir_IP> [agent_name]  
  
Añade el host dado a la lista de agentes monitorizados. Se puede especificar el nombre del agente después de la dirección IP. Se pueden añadir múltiples hosts, uno por línea. Por ejemplo:
+
Añade el ''host'' dado a la lista de agentes monitorizados. Se puede especificar el nombre del Agente después de la dirección IP. Se pueden añadir múltiples ''hosts'', uno en cada línea por separado. Por ejemplo:
  
 
  add host 192.168.0.1
 
  add host 192.168.0.1
 
  add host 192.168.0.2 localhost.localdomain
 
  add host 192.168.0.2 localhost.localdomain
  
=== ignore_host <nombre del agente> ===
+
=== ignore_host ===
 +
 
 +
ignore_host <agent_name>
 +
 
 +
Elimina el ''host'' dado de la lista de Agentes monitorizados, incluso si es encontrado en un escaneo de red por una tarea de reconocimiento (Recon Task). El ''host'' debe identificarse por el nombre del Agente. Se pueden ignorar múltiples ''hosts'', uno por cada línea. Por ejemplo:
 +
 
 +
ignore_host 192.168.0.1
 +
ignore_host localhost.localdomain
 +
 
 +
=== keepalive ===
 +
 
 +
keepalive xxx
 +
 
 +
El Satellite Server informa de su estado y comprueba cambios en la configuración remota (de los Agentes y de sí mismo) cada <code>xxx</code> segundos. Valor por defecto: 30 segundos.
 +
 
 +
=== credential_pass ===
 +
 
 +
credential_pass xxx
 +
 
 +
Contraseña utilizada para ''cifrar las contraseñas de las cajas de credenciales''. Debe ser la misma que se defina en la Consola de Pandora FMS. Por defecto se utiliza el nombre de ''host''.
 +
 
 +
=== timeout_bin ===
 +
 
 +
timeout_bin <path>
 +
 
 +
Si está definido, el programa '''timeout''' (normalmente <code>/usr/bin/timeout</code>) se utilizará al llamar al cliente de Tentacle.
 +
 
 +
=== timeout_seconds ===
 +
 
 +
timeout_seconds xxx
 +
 
 +
Tiempo de expiración, en segundos, para el programa '''timeout'''. El parámetro [[Pandora:Documentation_es:SatelliteServer#timeout_bin|timeout_bin]] debe estar configurado.
 +
 
 +
=== proxy_traps_to ===
 +
 
 +
proxy_traps_to <dir_IP[:port]>
  
Elimina el host dado de la lista de agentes monitorizados, incluso si es encontrado en un escaneo de red por una tarea recon. El host debe identificarse por el nombre del agente. Se pueden ignorar múltiples hosts, uno por línea. Por ejemplo:
+
Redirige los traps SNMP recibidos por el Satellite Server a la dirección (y puerto, opcionalmente) especificados. Por defecto se utiliza el puerto 162.
  
ignore host 192.168.0.1
+
=== proxy_tentacle_from ===
ignore host localhost.localdomain
 
  
=== keepalive xxx ===
+
proxy_tentacle_from <dir_IP[:port]>
  
El Satellite Server informa de su estado y comprueba cambios en la configuración remota (de los agentes y de él mismo) cada '''keepalive''' segundos. Por defecto es igual a 30 segundos.
+
Redirige los datos recibidos por Tentacle Server desde la dirección (y puerto, de manera opcional) especificados. Por defecto se utiliza el puerto 41121.
  
=== credential_pass xxx ===
+
=== proxy_tentacle_to ===
  
Contraseña utilizada para cifrar las contraseñas de las cajas de credenciales. Debe ser la misma que se defina en la Consola de Pandora FMS. Por defecto se utiliza el nombre de host.
+
proxy_tentacle_to <dir_IP[:port]>
  
=== timeout_bin <path a timeout> ===
+
Redirige las peticiones de clientes de Tentacle recibidas por el Satellite Server a la dirección (y puerto, de manera opcional) especificados. Por defecto se utiliza el puerto 41121.
Si está definido, el programa timeout (normalmente /usr/bin/timeout) se utilizará para llamar al cliente de Tentacle.
 
  
=== timeout_seconds xxx ===
+
{{Warning|Esta opción puede entrar en conflicto con la configuración remota de agentes.<br>Esto ocurre si se pretende usar el Satellite Server como ''proxy'' de algunos Agentes Software y monitorizarlos a su vez desde el mismo Satellite Server de forma remota (ICMP, SNMP, etc.) estando la configuración remota habilitada en ambos casos.<br>En esta situación se deberá, o bien usar Agentes distintos para los chequeos hechos (es decir, con <code>agent_name</code> diferente), o bien dejar la configuración remota habilitada solamente en uno de los dos (Satellite Server o Agentes Software).}}
Timeout en segundos para el programa timeout. timeout_bin debe estar configurado.
 
  
=== proxy_traps_to <dirección[:puerto]> ===
+
=== dynamic_inc ===
  
Redirige los traps SNMP recibidos por el Satellite Server a la dirección (y puerto) especificados. Por defecto se utiliza el puerto 162.
+
dynamic_inc [0|1]
  
=== proxy_tentacle_from <dirección[:puerto]> ===
+
Con valor de 1 mueve los módulos dinámicos descubiertos de forma automática (SNMP, WMI...) a ficheros separados para que no interfieran con la configuración remota de Agentes.
  
Da permiso el Tentacle server a la dirección (y puerto) especificados. Por defecto se utiliza el puerto 41121.
+
=== vlan_cache_enabled ===
  
=== proxy_tentacle_to <dirección[:puerto]> ===
+
vlan_cache_enabled [0|1]  
  
Redirige las peticiones de clientes de Tentacle recibidas por el Satellite Server a la dirección (y puerto) especificados. Por defecto se utiliza el puerto 41121.
+
Habilita (1) o deshabilita (0) la ''cache'' VLAN de los ''hosts'' autodescubiertos.
  
{{Warning|Esta opción puede entrar en conflicto con la configuración remota de agentes.
+
=== verbosity ===
  
Esto ocurre si se pretende usar el Satellite Server como proxy de algunos agentes software y monitorizarlos a su vez desde el mismo Satellite Server de forma remota (ICMP, SNMP, etc.) y la configuración remota está habilitada en ambos casos.
+
verbosity <0-10>
  
En esta situación se deberá o bien usar agentes distintos para los chequeos hechos (es decir, con "agent_name" diferente), o bien dejar la configuración remota habilitada solo en uno de los dos sitios (Satellite Server o agentes software).}}
+
Nivel de detalle en el registro del ''log'', donde 10 es el nivel de información más detallado.
  
=== dynamic_inc 0|1 ===
+
=== agents_blacklist_icmp ===
  
Poner a 1 para mover los módulos dinámicos descubiertos de forma automática (SNMP, WMI...) a ficheros separados para que no interfieran con la configuración remota de agentes.
+
{{Tip|Versión NG  713 o superior.}}
  
=== vlan_cache_enabled 0|1 ===
+
agents_blacklist_icmp 10.0.0.0/24[,8.8.8.8/30]
  
Habilita (1) o deshabilita (0) la cache VLAN de los host autodescubiertos.
+
Lista de exclusión de chequeos ICMP. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo ICMP. Es posible especificar varias subredes separándolas por comas.
  
=== verbosity <0-10> (Version > 7.0OUM204) ===
+
=== agents_blacklist_snmp  ===
  
Nivel de verbosidad del log desde 0 se escribe en el log menos informacion hasta 10 informacion mas detallada.
+
  {{Tip|Versión NG  713 o superior.}}
 +
  agents_blacklist_snmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713)
  
=== agents_blacklist_icmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713)  ===
+
Lista de exclusión de chequeos SNMP. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo SNMP. Es posible especificar varias subredes separándolas por comas.
  
Lista negra de chequeos ICMP. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo ICMP. Es posible especificar varias subredes separándolas por comas.
+
=== agents_blacklist_wmi ===
  
=== agents_blacklist_snmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713) ===
+
{{Tip|Versión NG  713 o superior.}}
  
Lista negra de chequeos SNMP. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo SNMP. Es posible especificar varias subredes separándolas por comas.
+
agents_blacklist_wmi 10.0.0.0/24[,8.8.8.8/30]
  
=== agents_blacklist_wmi 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713) ===
+
Lista de exclusión de chequeos WMI. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo WMI. Es posible especificar varias subredes separándolas por comas.
  
Lista negra de chequeos WMI. Este campo se puede configurar con una lista de IPs usando la notación CIDR para evitar que se ejecuten módulos de tipo WMI. Es posible especificar varias subredes separándolas por comas.
+
=== general_gis_exec ===
  
=== general_gis_exec (Version > 7.0OUM734) ===
+
{{Tip|Versión NG  734 o superior.}}
  
Script de posicionamiento de todos los agentes detectados por el Satellite Server. El script debe de ser executable y debe imprimir por pantalla las coordenadas con el formato ''<longitud>,<latitud>[,<altitud>]''. El tercer parámetro, la latitud, es opcional.
+
general_gis_exec xxx
 +
 +
Activando esta opción, se usará un ''script'' para proveer posicionamiento GIS a todos los Agentes detectados por el Satellite Server. El ''script'' debe tener permisos de ejecución e imprimir por pantalla las coordenadas con el formato  
 +
'''<longitud>,<latitud>[,<altitud>]'''
 +
El tercer parámetro, la altitud, es opcional.
  
== Creación de agentes en Satellite Server ==
+
== Creación de Agentes en Satellite Server ==
  
Existen tres modos de crear los agentes en el Satelllite server: '''Recon Task''', fichero de '''Satellite_hosts.txt''' o de manera '''manual''' creando los .conf de los agentes a crear.
+
Existen tres modos de crear los Agentes en el Satellite Server: '''Recon Task''', fichero de '''satellite_hosts.txt''' o de manera '''manual''' creando los .conf de los Agentes a monitorizar.
  
=== Creación de agentes mediante Recon Task ===
+
=== Creación de Agentes mediante Recon Task ===
  
La creación de agentes mediante Recon Task es la más utilizada por los usuarios de PandoraFMS. Para poder realizar, debemos irnos al fichero de configuración del Satellite server y configurar los siguientes parámetros:
+
La creación de Agentes mediante una tarea de reconocimiento (Recon Task) es la más utilizada por los usuarios de Pandora FMS. Para llevarla a cabo, debemos acceder al fichero de configuración del Satellite Server y configurar los siguientes parámetros:
  
* '''recon_community''': Se debe de especificar una lista de comunidades SNMP para usar en el discovery de SNMP separados por comas(en el caso de realizar una recon de tipo snmp.
+
* '''recon_community''': Se debe especificar una lista de comunidades SNMP para usar en el discovery de SNMP separadas por comas (en el caso de realizar una Recon Task de tipo SNMP).
* '''recon_enabled''': Se debe de poner a 1 para habilitar el recon task del Satellite Server.
+
* '''recon_enabled''': Se debe poner a 1 para habilitar el Recon Task del Satellite Server.
* '''recon_interval''': Intervalo de tiempo donde se escanea la red que queramos, en segundos (por defecto 604800 segundos).
+
* '''recon_interval''': Intervalo de tiempo donde se escanea la red, en segundos (por defecto 604800 segundos, 7 días).
* '''recon_mode''': Modo de realizar la recon task (snmp,icmp,wmi) separados por comas.
+
* '''recon_mode''': Modo de realizar la Recon Task (SNMP,ICMP,WMI), separados por comas.
* '''recon_task''': Lista de redes a las cuales les queremos hacer el reconocimiento, separadas por comas.
+
* '''recon_task''': Lista de redes a las cuales hacer el reconocimiento, separadas por comas.
* '''recon_timing_template''': Un valor que especifica cómo de agresivo debe ser nmap de 1 a 5. 1 significa más lento pero más fiable, 5 significa más rápido pero menos fiable (por defecto 3).
+
* '''recon_timing_template''': Un valor que especifica cómo de agresivo debe ser '''nmap''', de 1 a 5. Uno significa más lento pero más fiable; cinco significa más rápido pero menos fiable (por defecto 3).
  
 
Un ejemplo de realización de Recon Task es:
 
Un ejemplo de realización de Recon Task es:
Line 550: Line 581:
 
  recon_timing_template 3
 
  recon_timing_template 3
  
Una vez configurados los datos, ejecutamos el satellite server mediante el comando:
+
Una vez configurados los datos, ejecute el Satellite Server mediante el comando:
 +
 
 
  /etc/init.d/satellite_serverd start
 
  /etc/init.d/satellite_serverd start
  
=== Creación de agentes mediante fichero Satellite_hosts.txt ===
+
{{Warning|Los Agentes cuyos ficheros de configuración no contengan ningún Módulo serán ignorados por el Satellite Server.}}
 +
 
 +
=== Creación de agentes mediante fichero ===
  
En primer lugar, para poder crear un agente mediante el fichero satellite_hosts.txt, debemos ir al archivo de configuración del satellite server y descomentar la línea:
+
En primer lugar, para poder crear un Agente mediante el fichero satellite_hosts.txt, debe ir al archivo de configuración del Satellite Server y quitar de comentario la línea:
  
 
  host_file /etc/pandora/satellite_hosts.txt
 
  host_file /etc/pandora/satellite_hosts.txt
  
En segundo lugar crearemos el fichero satellite_hosts.txt con las IP de los host que queremos crear poniendo IP y nombre del agente a crear:
+
En segundo lugar debe crear el fichero en la ruta señalada anteriormente con las direcciones IP de los ''hosts'' que queremos crear colocando la dirección IP y nombre del Agente a crear:
 +
 
 +
192.168.10.5 Server5
 +
192.168.10.6 Server6
 +
192.168.10.7 Server7
  
192.168.10.5 Server.5
+
{{Warning|Para que los Agentes con estas direcciones IP puedan ser creados, es necesario que respondan a la llamada '''fping''', pues en caso contrario no se crearán.}}
192.168.10.6 Server.6
 
192.168.10.7 Server.7
 
  
{{Warning|Para que estas IPs puedan ser creadas, es necesario poder realizar la llamada Fping a cada una de las IPs de la lista, en caso contrario, no se creará.}}
+
Una vez configurados los datos, iniciamos el Satellite Server mediante el comando:
  
Una vez configurados los datos, ejecutamos el satellite server mediante el comando:
 
 
  /etc/init.d/satellite_serverd start
 
  /etc/init.d/satellite_serverd start
 +
 +
La lectura del fichero indicado se realiza cada [[Pandora:Documentation_es:SatelliteServer#Creaci.C3.B3n_de_Agentes_mediante_Recon_Task|recon_interval]] segundos.
  
 
=== Creación de agentes de manera manual ===
 
=== Creación de agentes de manera manual ===
  
En primer lugar nos fijamos en el fichero de configuración del satellite server en el parametro agent_conf_dir, que es donde se crear los ficheros de configuración de los nuevos agentes.
+
En el directorio <code>/etc/pandora/conf</code> (por defecto) van alojados los ficheros de configuración de los nuevos Agentes. Abra una venta terminal y vaya a esa carpeta:
 +
 
 +
cd /etc/pandora/conf
  
Una vez localizado dicha ruta, solo tendremos que crear un archivo.conf de los agentes que queramos crear, cogiendo por ejemplo el agente del servidor como ejemplo, y rellenando manualmente los siguientes campos:
+
Proceda a crear un fichero con una extensión <code>.conf</code>, por ejemplo "archivo.conf". Rellene manualmente los siguientes campos:
  
* '''agent_name''': Pondremos el nombre que queremos dar al agente.
+
* '''agent_name''': Nombre que se asignará al Agente.
* '''agent_alias''': Ponemos el alias que queremos dar al agente
+
* '''agent_alias''': Alias que se asignará al Agente.
* '''address''': Poner la IP del elemento que queremos monitorizar.
+
* '''address''': Dirección IP del elemento a monitorizar.
* '''group''': Grupo al que queremos asignar al agente.
+
* '''group''': Grupo al cual asignar el Agente.
* '''gis_exec''': Sctipt de posicionamiento. Sobreescribe el comportamiendo de ''general_gis_exec''.
+
* '''gis_exec''': ''Script'' de posicionamiento (opcional). Si se utiliza, sobreescribe la localización provista por el parámetro [[Pandora:Documentation_es:SatelliteServer#general_gis_exec|general_gis_exec'']] del Satellite Server.
* '''Modulos''': Y la creación de los módulos que creemos que se creen al realizar la recon.
+
* Agregue los Módulos a crear en el Agente.
  
 
Un ejemplo sería:
 
Un ejemplo sería:
  
  agent_name Ejemplo1
+
  agent_name Example
  agent_alias Es un ejemplo
+
  agent_alias This is an example
  address X.X.X.X
+
  address 127.0.0.1
 
  group Servers
 
  group Servers
 +
 
  module_begin
 
  module_begin
 
  module_name Ping
 
  module_name Ping
 
  module_ping
 
  module_ping
 
  module_end
 
  module_end
 +
 
  module_begin
 
  module_begin
 
  module_name Latency
 
  module_name Latency
Line 598: Line 639:
 
  module_end
 
  module_end
  
Una vez configurados los datos, ejecutamos el satellite server mediante el comando:
+
Una vez configurados los datos, inicie el Satellite Server mediante el comando:
 +
 
 
  /etc/init.d/satellite_serverd start
 
  /etc/init.d/satellite_serverd start
  
 
== Eliminación de agentes en Satellite Server ==
 
== Eliminación de agentes en Satellite Server ==
  
Existen varios casos en relación a la eliminación de agentes de Satellite server: eliminación total de agentes o eliminación parcial de agentes.
+
Puede realizar una eliminación total de Agentes o una eliminación parcial de Agentes.
 +
 
 +
{{Warning|Haga primero un respaldo de todas las carpetas y sus archivos antes de proceder.}}
  
Para la '''eliminación total''' de agentes debemos tener en cuenta el método utilizado en la realización de creación de agentes.
+
Para la '''eliminación total''' de Agentes debemos tener en cuenta el método utilizado en la creación de Agentes:
  
* '''Manual''': Habrá que eliminar en primer lugar los ficheros .conf de los agentes creados en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
+
* '''Manual''': Habrá que eliminar, en primer lugar, los ficheros <code>.conf</code> de los Agentes creados en la carpeta <code>/etc/pandora/conf</code> y posteriormente eliminar los Agentes en la consola.
  
* '''Fichero Satellite_hosts.txt''': Habrá que eliminar el fichero.txt, así como las conf que se han creado en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
+
* '''Fichero satellite_hosts.txt''': Habrá que eliminar el fichero, así como los <code>.conf</code> que se hayan creado en la carpeta <code>/etc/pandora/conf</code>, y posteriormente eliminar los Agentes en la Consola.
  
* '''Recon_task''': Habrá que desconfigurar la recon_task en el fichero conf del satellite server, posteriormente eliminar las conf que se han creado en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
+
* '''Recon_task''': Habrá que desconfigurar la <code>recon_task</code> en el fichero <code>.conf</code> del Satellite Server, eliminar los <code>.conf</code> que se hayan creado en la carpeta <code>/etc/pandora/conf</code> y posteriormente eliminar los Agentes en la Consola.
  
Para la '''eliminación parcial''' también debemos de tener en cuenta el método utilizado en la creación de agentes.
+
Para la '''eliminación parcial''' también debemos de tener en cuenta el método utilizado en la creación de Agentes.
  
* '''Manual''': Habrá que eliminar en primer lugar los ficheros .conf de los agentes que creamos borrar en la carpeta /etc/pandora/conf y posteriormente eliminar los agentes en la consola.
+
* '''Manual''': Habrá que eliminar, en primer lugar, los ficheros <code>.conf</code> de los Agentes a borrar en la carpeta <code>/etc/pandora/conf</code> y posteriormente eliminar los Agentes en la consola.
  
* '''Fichero Satellite_hosts.txt''': Habrá que eliminar del fichero.txt las líneas de las IPs a eliminar, así como las conf que se han creado en la carpeta /etc/pandora/conf con esas IPs y posteriormente eliminar los agentes en la consola.
+
* '''Fichero satellite_hosts.txt''': Habrá que eliminar del fichero las líneas de las direcciones IP a eliminar, así como los <code>.conf</code> que se hayan creado en la carpeta <code>/etc/pandora/conf</code> con esas direcciones IP, y posteriormente eliminar los Agentes en la consola.
  
* '''Recon_task''': Habrá que configurar la blacklist de la recon_task en el fichero conf del satellite server, posteriormente eliminar las conf que se han creado en la carpeta /etc/pandora/conf con esas IPs y posteriormente eliminar los agentes en la consola.
+
* '''Recon_task''': Habrá que configurar la lista de excluidos de la <code>recon_task</code> en el fichero <code>.conf</code> del Satellite Server, después borrar los <code>.conf</code> que se hayan creado en la carpeta <code>/etc/pandora/conf</code> con esas direcciones IP y eliminar los Agentes en la consola.
  
== Configuraciones personalizadas (por agente) ==
+
== Configuraciones personalizadas por Agente ==
  
Adicionalmente a los módulos "automonitorizados", se podrán agregar a la monitorización cualquier chequeo TCP, SNMP o WMI remoto que esté disponible, usando una sintaxis similar a los módulos locales para dicho propósito en los agentes. A continuación vemos algunos ejemplos de modulos válidos para el satellite server, tal como se autogeneran después de detectar el sistema.
+
Adicionalmente a los Módulos "automáticos", se podrá agregar a la monitorización cualquier chequeo TCP, SNMP, WMI o SSH que esté disponible, usando una sintaxis similar a que se usa para los Módulos locales en los [[Pandora:Documentation_es:Operacion#Monitorizaci.C3.B3n_con_Agente_Software|Agentes Software]]. Se exponen algunos ejemplos de Módulos válidos para el Satellite Server, tal como se autogeneran después de detectar el sistema.
  
{{warning |¡Asegúrese de que los OID empiezan con un punto o los módulos SNMP no funcionarán!}}
+
{{warning |¡Asegúrese de que los OID '''empiezan con un punto''' o los módulos SNMP no funcionarán!}}
  
Estado de la interfaz via SNMP. El Satellite Server detecta automáticamente cada interfaz:
+
Estado de la interfaz vía SNMP. El Satellite Server detecta automáticamente cada interfaz:
  
 
  module_begin
 
  module_begin
Line 658: Line 702:
 
  module_end
 
  module_end
  
Conectividad a una máquina (via PING)
+
Conectividad a una máquina (vía PING):
  
 
  module_begin
 
  module_begin
Line 666: Line 710:
 
  module_end
 
  module_end
  
Consulta de un puerto (via TCP)
+
Comprobación de un puerto (vía TCP):
  
 
  module_begin
 
  module_begin
 
  module_name Port 80
 
  module_name Port 80
  module_type generic_data
+
  module_type generic_proc
  module_tcp 192.168.70.225
+
  module_tcp
 
  module_port 80
 
  module_port 80
 
  module_end
 
  module_end
  
Consulta genérica SNMP. en este caso el Satellite Server, saca automáticamente el tráfico de cada interfaz, con su nombre "real" descriptivo.
+
Consulta genérica SNMP. En este caso el Satellite Server saca automáticamente el tráfico de cada interfaz, con su nombre "real" descriptivo:
  
 
  module_begin
 
  module_begin
Line 683: Line 727:
 
  module_snmp 192.168.70.225
 
  module_snmp 192.168.70.225
 
  module_oid .1.3.6.1.2.1.2.2.1.16.2
 
  module_oid .1.3.6.1.2.1.2.2.1.16.2
  module_community artica06
+
  module_community public
 
  module_end
 
  module_end
  
Consulta WMI para uso de CPU (porcentaje).
+
Consulta WMI para uso de CPU (porcentaje):
  
 
  module_begin
 
  module_begin
Line 695: Line 739:
 
  module_end
 
  module_end
  
Consulta WMI para memoria libre (porcentaje).
+
Consulta WMI para memoria libre (porcentaje):
  
 
  module_begin
 
  module_begin
Line 704: Line 748:
 
  module_end
 
  module_end
  
Consulta genérica WMI
+
Consulta genérica WMI:
  
 
  module_begin
 
  module_begin
Line 714: Line 758:
 
  module_end
 
  module_end
  
 
+
Comando genérico SSH:
Comando genérico SSH  
 
  
 
  module_begin
 
  module_begin
Line 724: Line 767:
 
  module_end
 
  module_end
  
Para introducir un umbral hay que hacerlo tanto en la definición de texto del modulo (module_min_warning, module_min_critical) como en la definición de umbrales mediante la interfaz web. Por ejemplo:
+
Para introducir un umbral hay que hacerlo tanto en la definición de texto del Módulo (<code>module_min_warning</code>, <code>module_min_critical</code>) como en la definición de umbrales mediante la interfaz web. Por ejemplo:
  
 
  module_begin
 
  module_begin
  module_name latency
+
  module_name Latency
 
  module_type generic_data
 
  module_type generic_data
 
  module_latency 192.168.70.225
 
  module_latency 192.168.70.225
Line 734: Line 777:
 
  module_end
 
  module_end
  
Manualmente podemos crear módulos de ejecución. Los scripts o comandos que ejecute el Satellite Server, deben estar previamente desplegados y accesibles por el mismo. En este sentido funciona igual que un module_exec de un agente. El uso de module_exec hace que el rendimiento del Satellite Server disminuya.
+
Manualmente puede crear Módulos de ejecución. Los ''scripts'' o comandos que ejecute el Satellite Server deben estar previamente desplegados y accesibles por el mismo. En este sentido, funciona igual que un <code>module_exec</code> de un Agente. Tenga en cuenta que el uso de <code>module_exec</code> puede hacer que el rendimiento del Satellite Server disminuya.
  
 
  module_begin
 
  module_begin
Line 744: Line 787:
 
  module_end
 
  module_end
  
A partir de la versión 7, de la misma forma que el module_exec, se pueden añadir plugins. Al igual que estos, hay que tener en cuenta que los plugins se ejecutarán en la máquina donde está corriendo el Satellite Server. Por lo tanto, habrá que implementar en estos plugins algún método para conectarse al equipo remoto que se quiere monitorizar. La ventaja respecto a los anteriores es su gran flexibilidad. De esta forma, se pueden implementar precondiciones y otros mecanismos para los que un module_exec se queda corto. La sintaxis es la misma que la de los agentes. Un ejemplo de uso de un plugin podría ser el siguiente:
+
A partir de la versión 7 de Pandora FMS también pueden añadirse ''plugins''. Al igual que estos, hay que tener en cuenta que los ''plugins'' se ejecutarán en la máquina donde está corriendo el Satellite Server. '''Por lo tanto, habrá que implementar en estos ''plugins'' algún método para conectarse al equipo remoto que se necesita monitorizar.''' La ventaja respecto a los anteriores es su gran flexibilidad. De esta forma, se pueden implementar condiciones y otros mecanismos para los que un <code>module_exec</code> se queda corto. La sintaxis es la misma que la de los Agentes. Un ejemplo de uso de un ''plugin'' podría ser el siguiente:
  
 
  module_plugin /usr/share/pandora/remote_advanced_checks.sh 192.168.0.1
 
  module_plugin /usr/share/pandora/remote_advanced_checks.sh 192.168.0.1
Line 750: Line 793:
 
=== SNMPv3 ===
 
=== SNMPv3 ===
  
Para configurar un módulo SNMPv3 module, ponga ''module_version'' a 3 y especifique el nivel de seguridad (''noauth'', ''authnopriv'' or ''authpriv''), nombre de seguridad, protocolo de autenticación (''md5'' or ''sha''), clave de autenticación, protocolo de privacidad (''aes'' or ''des'') y clave de privacidad según sea necesario. Por ejemplo:
+
Para configurar un módulo SNMPv3, defina [[Pandora:Documentation_es:SatelliteServer#Configuraciones_personalizadas_por_Agente|module_version]] a 3 y especifique:
 +
 
 +
* <code>module_seclevel</code>: Nivel de seguridad ( <code>noauth</code>, <code>authnopriv</code> o <code>authpriv</code> ).
 +
* <code>module_secname</code>: Nombre de seguridad.
 +
* <code>module_authproto</code>: Protocolo de autenticación ( <code>md5</code> o <code>sha</code> ).
 +
* <code>module_authpass</code>: Clave de autenticación.
 +
* <code>module_privproto</code>: Protocolo de privacidad ( <code>aes</code> o <code>des</code> ).
 +
* <code>module_privpass</code>: Clave de privacidad, según sea necesario.
 +
 
 +
Por ejemplo:
  
 
  module_begin
 
  module_begin
Line 788: Line 840:
 
  module_end
 
  module_end
  
La configuración específica de SNMPv3 se puede compartir entre módulos sacándola fuera de la declaración del módulo (también se puede compartir entre agentes moviéndola al fichero de configuración del satélite):
+
La configuración específica de SNMPv3 se puede compartir entre Módulos sacándola fuera de la declaración del Módulo, en caso de que sea la misma para todos (también se puede compartir entre Agentes moviéndola al fichero de configuración del Satellite Server):
  
 
  agent_name snmp
 
  agent_name snmp
Line 818: Line 870:
 
== Cajas de credenciales ==
 
== Cajas de credenciales ==
  
Salvo que la autenticación basada en claves esté configurada, los módulos SSH necesitan un nombre de usuario y una contraseña para funcionar. Éstos se configuran en el fichero de configuración principal, satellite_server.conf, utilizando cajas de credenciales con el siguiente formato:
+
Salvo que la autenticación esté configurada con clave privada y clave pública, los Módulos SSH necesitan un nombre de usuario ( <code><user></code> ) y una contraseña ( <code><pass></code> ) para funcionar. Ambos se registran en el fichero de configuración principal, <code>satellite_server.conf</code>, utilizando cajas de credenciales (<code>credential_box</code> ) con los siguientes formatos:
 
 
credential_box red/máscara,usuario,contraseña
 
credential_box red/máscara,usuario,<nowiki>[[contraseña cifrada]]</nowiki>
 
 
 
Por ejemplo:
 
 
 
credential_box 192.168.1.1/32,user,pass1
 
credential_box 192.168.1.0/24,user,pass2
 
 
 
Las búsquedas en las cajas de credenciales se hacen de máscaras más restrictivas a menos.
 
 
 
Las contraseñas se pueden cifrar utilizando Blowfish en modo ECB. Asegúrese de que credential_pass está definido, de otro modo el nombre del host se utilizará como contraseña de cifrado por defecto. La representación hexadecimal del texto cifrado se debe rodear de corchetes dobles:
 
 
 
credential_box 192.168.1.0/24,user,<nowiki>[[80b51b60786b3de2]]</nowiki>
 
 
 
== Vista en la consola de todos los agentes ==
 
 
 
 
 
 
 
Si la configuración del Satellite Serverha sido correcta deberiamos obtener una vista de agentes parecida a esta:
 
 
 
  
 +
<center>
 +
'''red/máscara,usuario,contraseña'''
  
<center>
+
'''red/máscara,usuario,<nowiki>[[contraseña cifrada]]</nowiki>'''
<br>
 
[[File:Selección 146.png|700px]]
 
 
</center>
 
</center>
  
 +
Por ejemplo:
  
 +
credential_box 192.168.1.1/32,<user>,<pass1>
 +
credential_box 192.168.1.0/24,<user>,<pass2>
  
Generalmente en todas las maquinas se crearan modulos de tipo ICMP (Ping y Latencia) pero en algunas maquinas tambien se pueden generar modulos de tipo SNMP y WMI.
+
Las búsquedas en las cajas de credenciales se hacen de máscaras más a menos restrictivas.
 
 
En las maquinas que tienen habilitado wmi se pueden generar los siguientes modulos:
 
 
 
 
 
  
<center>
+
Las contraseñas se pueden cifrar utilizando Blowfish en modo ECB. Asegúrese de que [[Pandora:Documentation_es:SatelliteServer#credential_pass|credential_pass]] está definido, de otro modo el nombre del ''host'' se utilizará como contraseña de cifrado por defecto. La representación hexadecimal del texto cifrado se debe rodear con corchetes dobles:
<br>
 
[[File:Modulos.png|700px]]
 
</center>
 
  
 +
credential_box 192.168.1.0/24,<user>,<nowiki>[[80b51b60786b3de2]]</nowiki>
  
 +
== Vista en la consola de todos los Agentes ==
  
En las maquinas con SNMP habilitado se pueden generar los siguientes modulos:
+
Si la configuración del Satellite Server ha sido correcta, debería obtener una vista de Agentes parecida a esta:
  
 +
[[Image:Selección 146.png|center|700px]]
  
<center>
+
Generalmente en todas las máquinas se crearán Módulos de tipo ICMP (Ping y Latencia) pero en algunas también se pueden generar Módulos de tipo SNMP y WMI. En las que tengan WMI habilitado se generarán los siguientes Módulos, de estar disponibles:
<br>
 
[[File:Modulos1.png|700px]]
 
</center>
 
  
 +
[[Image:Modulos.png|center|800px]]
  
En el apartado de operaciones masivas de la consola de pandora hay una sección especial dedicada al Satellite Serverdonde se pueden realizar diversas acciones de edición y borrado de agentes y modulos de forma massiva:
+
En las máquinas con SNMP habilitado se generarán los siguientes módulos, de estar disponibles:
  
 +
[[Image:Modulos1.png|center|800px]]
  
 +
En el apartado de operaciones masivas de la Consola de Pandora FMS hay una sección especial dedicada al Satellite Server, donde se pueden realizar diversas acciones de edición y borrado de Agentes y Módulos de forma masiva:
  
<center>
+
[[Image:Operación massivas.png|center|800px]]
<br>
 
[[File:Operación massivas.png|700px]]
 
</center>
 
  
== Lista negra de SNMP ==
+
== Lista de exclusión de SNMP ==
  
Al monitorizar redes grandes los módulos SNMP que devuelven datos inválidos pueden afectar al rendimiento del Satellite Server y muchos módulos pueden ponerse en desconocido. El Satellite Server, en lugar de definir una subred con el token #agents_blacklist_snm, puede leer una lista negra de módulos SNMP que serán descartados en el arranque antes de la ejecución.
+
Al monitorizar redes grandes los Módulos SNMP que devuelven datos inválidos pueden afectar al rendimiento del Satellite Server, y llevar a otros Módulos a estado Desconocido. Para evitar esto, el Satellite Server puede leer una ''lista de excluidos'' de Módulos SNMP que serán descartados en el arranque antes de la ejecución.
  
Para crear una lista negra nueva edite el fichero de configuración '''/etc/pandora/satellite_server.conf''' y asegúrese de que '''snmp_blacklist''' está configurado. A continuación ejecute:
+
Para crear una lista de excluidos, edite el fichero de configuración <code>/etc/pandora/satellite_server.conf</code> y asegúrese de que <code>snmp_blacklist</code> está ''descomentado'' y configurado con la ruta al fichero en el que se guardarán los Módulos de la lista de excluidos. A continuación ejecute:
  
 
  satellite_server -v /etc/pandora/satellite_server.conf
 
  satellite_server -v /etc/pandora/satellite_server.conf
  
Reinicie el Satellite Server. La lista negra se puede regenerar tantas veces como sea necesario.
+
Reinicie el Satellite Server. La lista de excluidos se puede regenerar tantas veces como sea necesario.
  
El formato de la lista negra es:
+
El formato de la lista de excluidos es:
  
 
  agent:OID
 
  agent:OID
Line 898: Line 925:
 
Por ejemplo:
 
Por ejemplo:
  
  192.168.0.1:1.3.6.1.4.1.9.9.27  
+
  192.168.0.1:.1.3.6.1.4.1.9.9.27  
  192.168.0.2:1.3.6.1.4.1.9.9.27  
+
  192.168.0.2:.1.3.6.1.4.1.9.9.27  
 +
 
 +
[[Pandora:Documentation|Volver al Índice de Documentación Pandora FMS]]<br><br><br>
  
 
[[Category:Pandora FMS]]
 
[[Category:Pandora FMS]]

Latest revision as of 15:26, 20 April 2021

Volver al Índice de Documentación Pandora FMS


Contents

1 Satellite Server

1.1 Introducción

Versión Enterprise.

El Satellite Server se emplea para descubrir y monitorizar redes y equipos remotos, bien elementos de red (routers, switches, etc.) vía SNMP o ICMP, o bien servidores MS Windows® (vía WMI) o Linux® (vía SNMP). Este no es un servidor "ordinario", sino que más bien se podría considerar como un Agente Software en modo broker pero con funcionalidades extendidas. Es especialmente útil para monitorizar redes remotas inaccesibles desde el servidor de Pandora FMS, y donde tampoco podemos instalar Agentes Software.

Esquema-satellite.png

El Satellite Server funciona tanto en Windows® como en GNU/Linux® (sistema operativo recomendado) y tiene algunas características que lo hacen especial, más que recomendable en determinados entornos.

  • Puede ejecutar pruebas de red (ICMP, Latencia y SNMP v1 y v2) a una tasa extremadamente alta (500 chequeos por segundo). Para SNMP v3 debe configurar las credenciales de acceso y debido al cifrado de datos hará un chequeo menos rápido.
  • Solo envía datos al servidor cada X segundos (por defecto 300), pero puede ejecutar las pruebas de latencia, ICMP y SNMP con un intervalo menor (por ejemplo 30 segundos) de forma que, cuando detecta cambios de estado, notifica inmediatamente al servidor. Estos cambios de estado se han de definir previamente si el tipo de Módulo no es un *_proc (por ejemplo interfaces de red o conectividad general de red).
  • Es un servidor autónomo, no requiere conexión a la base de datos de Pandora FMS. Envía todos los datos como XML de forma que funciona como un servidor independiente, similar a como lo hace un Agente Software en modo broker o a un Export Server.
  • Tiene un mecanismo de autodiscovery para SNMP y WMI, de forma que crea los Agentes detectados (por dirección IP), detecta los elementos dinámicos (interfaces de red, almacenamiento) y los monitoriza de forma automática.
  • En sistemas Windows® detecta discos, CPU y memoria.
  • En sistemas de red con SNMP detecta estado de las interfaces, tráfico de entrada y salida por cada interfaz, y el nombre del sistema.
  • Los Módulos autogenerados se pueden modificar, como otro módulo más, gestionando el Agente desde la consola, como si fuera un Agente ordinario (en la sección de Operaciones masivas -> Satélite).
  • Puede crear Agentes manualmente generando un fichero de configuración de Agente en el directorio de configuraciones del Satellite Server (explicado más adelante).

1.1.1 Capacidad

La capacidad máxima del Satellite Server depende totalmente del hardware del servidor donde se ejecuta, y el tipo de chequeos que se necesitan realizar. En entorno de pruebas se ha logrado realizar 500 chequeos ICMP y SNMP por segundo, pero eso depende mucho de los tiempos de respuesta del dispositivo remoto (no es lo mismo uno que responde en 10 milisegundos que uno que tarda 2 segundos en responder). En condiciones ideales teóricas se puede hablar de que se pueden monitorizar unos 150 000 monitores con un solo Satellite Server. En condiciones reales se ha probado en entornos más o menos controlados (redes locales) unos 50 000 Módulos con un Satellite Server en un ordenador de hardware muy discreto (procesador Intel i5®, 2 GHz, 4 GB RAM).

Template warning.png

Si existen muchos Módulos críticos, el rendimiento puede verse muy afectado. También hay que tener en cuenta el timeout configurado, ya que solo se realiza una comprobación crítica por timeout. Si tiene 1000 Módulos críticos y el timeout configurado en 4 segundos, se tardará 4000 segundos en ejecutar todos estos chequeos con un único hilo.

 


1.2 Instalación

El Satellite Server se distribuye en forma de tarball (GNU/Linux®) o .exe (Windows®), de forma que no hace falta instalar Perl ni ninguna librería adicional. El funcionamiento en las versiones Windows® o Linux® es idéntico. En caso de Windows® se instala como servicio, y en el caso de Linux® se instala como demonio del sistema. El fichero de configuración y las especificaciones de ambos son idénticas.

La versión de Linux® del Satellite Server depende de paquetes externos que se especifican en la sección correspondiente de esta documentación.

1.3 Instalación de Satellite Server en Linux

El sistema operativo GNU/Linux recomendado es CentOS. Una vez descargado el paquete que contiene el Satellite Server es necesario ir a la carpeta de descarga con privilegios de root y descomprimir el binario:

tar -xvzf pandorafms_satellite_server_X.XNG.XXX_x86_64.tar.gz
Desarchivar nuevo.png

A continuación se generará una carpeta denominada satellite_server. Vaya a dicha carpeta tecleando:

cd satellite_server/

Antes de proceder con la instalación es necesario dejar claro cuáles son las dependencias fundamentales del Satellite Server: Perl, Braa, Wmic, Fping y Nmap.

Instale Perl con el siguiente comando:

yum install perl

En el instalador se adjuntan las dependencias de Braa y Wmic. Es necesario instalar Fping y Nmap de forma independiente:

yum install fping nmap

Para instalar el Satellite Server en sí, debe ejecutar el comando de instalación:

./satellite_server_installer --install
Instalacion linux nuevo.png

Una vez terminado el proceso, será necesario editar el fichero de configuración del satélite localizado en:

/etc/pandora/satellite_server.conf

El editor de texto por defecto en CentOS es VIM. Busque el token pandora_license, proceda a descomentarlo e introduzca la licencia del servidor Pandora FMS Enterprise. Tras ello puede guardar el archivo y levantar el servicio, ejecutando lo siguiente:

sudo /etc/init.d/satellite_serverd start

En caso de algún error o mal funcionamiento, puede revisar el fichero de registro en:

/var/log/satellite_server.log

1.4 Instalación en Windows

Elija el idioma de instalación:

Instalacion windows1.png

Haga clic en Siguiente:

Instalacion windows2 nuevo.png

Elija el lugar para instalar el programa:

Instalacion windows3 nuevo.png

Será necesario instalar tambien WinPCap. La ventana de instalación aparecerá en este paso de la instalación.

Instalación wincap1.png

Configure el encendido de WinPCap al iniciar la máquina:

Instalación wincap2.png

Una vez terminada la instalación de WinCap verá la siguiente pantalla:

Instalación wincap3.png

Introduzca la clave de licencia de Pandora FMS Enterprise para continuar con la instalación:

Instalacion windows4 nuevo.png

En el siguiente apartado debe configurar la dirección del servidor Pandora FMS para el envío de los datos; puede definir las reglas exploración de red para el Satellite Server.

Instalacion windows5 new.png

Será necesario reiniciar la máquina para que se apliquen todos los cambios.

Instalacion windows6 nuevo.png

Una vez terminado el proceso, puede arrancar y detener el servicio Satellite Server PFMS desde el menú Inicio de Windows®.

1.4.1 Funcionamiento de Módulos WMI en algunas versiones de Windows

Por motivos de seguridad de Windows®, algunas versiones tienen limitados los usuarios con los que realizar consultas WMI remotas. En el caso de que estas consultas no se lleven a cabo, la solución es ejecutar el servicio del Satellite Server como usuario Administrador.

El proceso a seguir es el siguiente:

Abra los servicios:

Instalacion windows7 nuevo.png

Haga clic sobre el servicio y entre en Propiedades:

Instalacion windows8 nuevo.png

Sobre la ventana de Iniciar sesión seleccione una cuenta con permisos de Administrador y aplique los cambios:

Instalacion windows9 nuevo.png

Debe reiniciar el servicio para aplicar los cambios.

1.5 Configuración

Todos los parámetros que requieren un timeout o tiempo de expiración se deben especificar en segundos ( por defecto 300 segundos que es igual a 5 minutos).

Es importante destacar que los intervalos de latency y SNMP son específicos al cambio de estado. En el caso de los chequeos booleanos (estado de un puerto, estado de la máquina), el umbral que define el cambio de estado es automático. En el caso de valores numéricos (latencia, tráfico de red en una interfaz, espacio de disco, CPU, etc.), se basa en el umbral. Por defecto no se definen umbrales; esto tiene que hacerse en la definición del Módulo.

1.5.1 agent_interval

agent_interval xxx 

Por defecto, 300 segundos (5 minutos). Será el tiempo tras el que enviará datos al servidor, independientemente de que los chequeos que haga el Satellite Server sean con un intervalo más corto. De ser necesario, y por defecto, crea Agentes en el servidor Pandora FMS correspondiente según el tiempo aquí especificado.

1.5.2 agent_threads

agent_threads xxx

Número de hilos que se utilizan para mandar ficheros XML de datos.

1.5.3 xxxxxx_interval

xxxxxx_interval xxx 

Ejecuta todos los chequeos (latencia, SNMP, etc) cada xxx segundos. Si el dato recopilado cambia respecto al anterior lo envía en ese momento. Si es igual, lo enviará cuando el intervalo de ese Agente así lo ordene. Es útil para realizar pruebas muy intensivas y notificar solo en el caso de cambio de estado.

1.5.4 xxxxx_retries

xxxxx_retries xxx 

Número de reintentos xxx en los chequeos (latencia, SNMP, ping, etcétera).

1.5.5 xxxxx_timeout

xxxxx_timeout xxx 

Timeout en segundos para las pruebas de tipo SNMP, latencia y ping.

1.5.6 xxxxx_block

xxxxx_block xxx 

Fuerza al servidor a ejecutar las consultas (latencia, ping y SNMP) en bloques de XXX consultas. Cuanto mayor sea el número (máximo 500) más capacidad de proceso tendrá, pero a costa de incrementar la latencia. En algunos casos puede ser conveniente disminuir ese número.

1.5.7 xxxxx_threads

xxxxx_threads n 

Número de hilos n asignados a cada tipo de chequeo para que trabajen de manera concurrente. Dependerá de la potencia (CPU y RAM) de la máquina. Cuantos más hilos, más se cargará el sistema, pero más capacidad de proceso tendrá. Al superar los 20 hilos, dependiendo del sistema, puede empeorar el rendimiento.

1.5.8 log_file

log_file <path_file> 

Indica el fichero en el que se escribe el log del Satellite Server, por defecto en /var/log/satellite_server.log.

1.5.9 recon_task

recon_task xxxxx[,yyyy] 

Direcciones/Redes IP empleadas para el Autodiscovery, separadas por comas. Ejemplo:

192.168.50.0/24,10.0.1.0/22,192.168.70.64/26

1.5.10 server_ip

server_ip <IP> 

Dirección IP o nombre DNS del servidor de Pandora FMS al cual enviar la información. Los datos se envían por Tentacle, de forma que la comunicación hacia el servidor debe estar permitida y garantizada por el puerto 41121/tcp.

1.5.11 recon_mode

recon_mode <mode_discovery>


Modo de autodescubrimiento ( <mode_discovery> ) a utilizar. El sistema empleará los siguientes protocolos para descubrir los sistemas:

  • icmp: Realiza verificación para determinar si el host está en línea (ping) y mide el tiempo de latencia.
  • snmp: Si es capaz de comunicar por SNMP (v1 y v2 únicamente) buscará todas las interfaces de red y sacará el tráfico de todas ellas, así como su estado operativo, además del nombre del dispositivo y ubicación. Probará con las diferentes comunidades suministradas en el fichero de configuración para conectar. Para utilizar SNMP v3 cuyo reconocimiento es innecesario, consulte en este enlace cómo configurar las credenciales de acceso conocidas.
  • wmi: Similar al caso anterior, en este caso mostrando Carga de CPU, Memoria y Discos (todos los disponibles).

1.5.12 recon_community

recon_community <aaa>,<bbb>,<ccc>... 

Especifica una lista de comunidades SNMP <xxx> para usar en el discovery de SNMP, separadas por comas. Utilizará esta lista en la exploración SNMP: por cada dirección IP encontrada, intentará ver si responde a alguna de estas comunidades.

1.5.13 wmi_auth

wmi_auth Administrator%password[,user%pass] 

Especifica una lista de parejas de credenciales de usuario, cada una de ellas en el formato <nombre de usuario>%<contraseña> y separadas por comas.

Por ejemplo: admin%1234,super%qwerty. Utilizará esta lista en la exploración WMI. Por cada dirección IP encontrada, intentará ver si responde a alguna de estas combinaciones.

1.5.14 agent_conf_dir

agent_conf_dir <path> 

Vía ( <path>) al directorio que crea y almacena automáticamente los ficheros de configuración de cada Agente creado por el Satellite Server. Por defecto /etc/pandora/conf. Dichos Agentes también pueden ser creados manualmente.

1.5.15 group

group <group_name> 

Define el nombre del grupo <group_name> por defecto de los Agentes creados por el Satellite Server. Por ejemplo, "Servers".

1.5.16 daemon

daemon [1|0]

Si su valor es 1 ejecuta el demonio (servicio) en segundo plano (valor por defecto).

1.5.17 hostfile

hostfile <file>

Es un método alternativo o complementario al de explorar una red para encontrar hosts. En este fichero <file>, en cada línea hay una dirección. Alternativamente, se le puede pasar en la misma línea el hostname seguido de la IP, de esa forma el Agente será creado con ese nombre y además use esa dirección IP para los Módulos (por ejemplo: 192.168.0.2 <hostname>). Es necesario que al realizar una consulta con Fping a esas direcciones su resultado sea en línea para que dichas direcciones sean válidas.

1.5.18 pandora_license

pandora_license xxxxxxx

Escriba y almacena la licencia del servidor Pandora FMS Enterprise, tal como se muestra en la seccion Setup -> License de la Consola Pandora FMS.

PFMS-setup-license.png

Puede usar la misma licencia en tantos Satellite Servers como se necesite, ya que el total de Agentes que usan la licencia se verifica en el servidor de Pandora FMS, no en el Satellite Server.

1.5.19 remote_config

remote_config [1|0] 

Activa por defecto la configuración remota en los Agentes detectados, necesario si quiere gestionarlos desde la Consola después de detectarlos. También activa la configuración remota del propio Satellite Server.

1.5.20 temporal_min_size

temporal_min_size xxx 

Si el espacio libre (en megabytes) de la partición en la que se encuentra el directorio temporal es menor que este valor, no se siguen generando paquetes de datos. De este modo se evita que se llene el disco si por alguna razón se pierde la conexión con el servidor durante un intervalo de tiempo prolongado.

1.5.21 xml_buffer

xml_buffer [0|1]

Valor por defecto 0. Estando configurado con valor a 1 el Agente guardará los XML de datos que no haya podido enviar para intentarlo de nuevo más adelante.

Template warning.png

En Unix, si está en un entorno seguro considere cambiar el directorio temporal, ya que /tmp tiene permisos de escritura para todos los usuarios.

 


1.5.22 snmp_version

snmp_version xx

Versión de SNMP que se utilizará por defecto ( 1 ). Para utilizar SNMP v3 consulte en este enlace cómo configurar las credenciales de acceso conocidas.

Template warning.png

Algunos Módulos podrían dejar de funcionar si se cambia este valor.

 


1.5.23 braa

braa <path> 

Vía <path> al binario de Braa. Valor por defecto /usr/bin/braa.

1.5.24 fping

fping <path> 

Vía <path> al binario de Fping. Valor por defecto /usr/sbin/fping.

1.5.25 fsnmp

fsnmp <path> 

Vía <path> al binario de Fsnmp. Valor por defecto /usr/bin/pandorafsnmp.

1.5.26 latency_packets

latency_packets xxx

Número de paquetes xxx ICMP que se envían por petición de latencia.

1.5.27 nmap

nmap <path> 

Vía <path> al binario de Nmap. Valor por defecto /usr/bin/nmap.

1.5.28 nmap_timing_template

nmap_timing_template x

Un valor xxx que especifica nivel de agresividad de Nmap, de 1 a 5. Uno significa más lento pero más fiable, cinco significa más rápido pero menos fiable. Valor por defecto: 2.

1.5.29 ping_packets

ping_packets xxx

Número de paquetes ICMP que se envían por cada ping.

1.5.30 recon_enabled

recon_enabled [0|1]

Habilita (1) o deshabilita (0) el autodescubrimiento de equipos.

1.5.31 recon_timing_template

recon_timing_template xxx

Tal como nmap_timing_template pero aplicado a los escaneos de red.

1.5.32 server_port

server_port xxxxx

Puerto del servidor Tentacle.

1.5.33 server_name

server_name xxxxx

Nombre del servidor Satellite (por defecto toma el hostname de la máquina).

1.5.34 server_path

server_path <path>

Ruta <path> donde los ficheros XML son copiados si el transfer_mode está en local (por defecto /var/spool/pandora/data_in).

1.5.35 server_opts

Parámetros del servidor que son pasados a Tentacle.

1.5.36 transfer_mode

transfer_mode [tentacle|local] 

Modo de transferencia de ficheros. Puede ser únicamente Tentacle o local (por defecto Tentacle).

1.5.37 Servidor Secundario

secondary_mode [on_error|always]

Un tipo especial de parámetro de configuración general es la definición de un servidor secundario. Esto permite definir un servidor al que se le envían los datos, de forma complementaria al servidor definido de forma estándar. El modo de servidor secundario funciona de dos formas:

  • on_error: Envía datos al servidor secundario solo si no puede enviarlas al primario.
  • always: Siempre envía datos al servidor secundario, independientemente de si puede contactar o no con el servidor principal.

Ejemplo de configuración:

secondary_server_ip     192.168.1.123
secondary_server_path   /var/spool/pandora/data_in
secondary_mode          on_error
secondary_transfer_mode tentacle
secondary_server_port   41121

1.5.38 snmp_verify

snmp_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMP v1 que hacen fallar Braa en tiempo real. Estos Módulos serán descartados y dejarán de ejecutarse. Véase también tanto snmp2_verify como snmp3_verify.


1.5.39 snmp2_verify

snmp2_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMP v2 que hacen fallar Braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse. Véase también tanto snmp_verify como snmp3_verify.


Template warning.png

¡Comprobar módulos SNMP versión 2 puede ser muy lento!

 


1.5.40 snmp3_verify

snmp3_verify [0|1]

Habilita (1) o deshabilita (0) la comprobación de módulos SNMPv3 que hacen fallar Braa en tiempo real. Estos módulos serán descartados y dejarán de ejecutarse. Véase también tanto snmp_verify como snmp2_verify.


1.5.41 startup_delay

startup_delay xxx 

Espera xxx segundos antes de enviar ficheros de datos por primera vez.

1.5.42 temporal

temporal <directory>

Directorio temporal donde se crean los ficheros XML, por defecto /tmp.

1.5.43 tentacle_client

tentacle_client <path> 

Vía <path> del cliente de Tentacle. Valor por defecto /usr/bin/tentacle_client.

1.5.44 wmi_client

wmi_client <path> 

Vía <path> al binario de wmi_client. Valor por defecto /usr/bin/wmic.

1.5.45 snmp_blacklist

snmp_blacklist <path> 

Vía <path> a la lista de exclusión de Módulos SNMP. Valor por defecto /etc/pandora/satellite_server.blacklist.

1.5.46 add_host

add_host <dir_IP> [agent_name] 

Añade el host dado a la lista de agentes monitorizados. Se puede especificar el nombre del Agente después de la dirección IP. Se pueden añadir múltiples hosts, uno en cada línea por separado. Por ejemplo:

add host 192.168.0.1
add host 192.168.0.2 localhost.localdomain

1.5.47 ignore_host

ignore_host <agent_name> 

Elimina el host dado de la lista de Agentes monitorizados, incluso si es encontrado en un escaneo de red por una tarea de reconocimiento (Recon Task). El host debe identificarse por el nombre del Agente. Se pueden ignorar múltiples hosts, uno por cada línea. Por ejemplo:

ignore_host 192.168.0.1
ignore_host localhost.localdomain

1.5.48 keepalive

keepalive xxx 

El Satellite Server informa de su estado y comprueba cambios en la configuración remota (de los Agentes y de sí mismo) cada xxx segundos. Valor por defecto: 30 segundos.

1.5.49 credential_pass

credential_pass xxx

Contraseña utilizada para cifrar las contraseñas de las cajas de credenciales. Debe ser la misma que se defina en la Consola de Pandora FMS. Por defecto se utiliza el nombre de host.

1.5.50 timeout_bin

timeout_bin <path> 

Si está definido, el programa timeout (normalmente /usr/bin/timeout) se utilizará al llamar al cliente de Tentacle.

1.5.51 timeout_seconds

timeout_seconds xxx 

Tiempo de expiración, en segundos, para el programa timeout. El parámetro timeout_bin debe estar configurado.

1.5.52 proxy_traps_to

proxy_traps_to <dir_IP[:port]> 

Redirige los traps SNMP recibidos por el Satellite Server a la dirección (y puerto, opcionalmente) especificados. Por defecto se utiliza el puerto 162.

1.5.53 proxy_tentacle_from

proxy_tentacle_from <dir_IP[:port]>

Redirige los datos recibidos por Tentacle Server desde la dirección (y puerto, de manera opcional) especificados. Por defecto se utiliza el puerto 41121.

1.5.54 proxy_tentacle_to

proxy_tentacle_to <dir_IP[:port]> 

Redirige las peticiones de clientes de Tentacle recibidas por el Satellite Server a la dirección (y puerto, de manera opcional) especificados. Por defecto se utiliza el puerto 41121.

Template warning.png

Esta opción puede entrar en conflicto con la configuración remota de agentes.
Esto ocurre si se pretende usar el Satellite Server como proxy de algunos Agentes Software y monitorizarlos a su vez desde el mismo Satellite Server de forma remota (ICMP, SNMP, etc.) estando la configuración remota habilitada en ambos casos.
En esta situación se deberá, o bien usar Agentes distintos para los chequeos hechos (es decir, con agent_name diferente), o bien dejar la configuración remota habilitada solamente en uno de los dos (Satellite Server o Agentes Software).

 


1.5.55 dynamic_inc

dynamic_inc [0|1]

Con valor de 1 mueve los módulos dinámicos descubiertos de forma automática (SNMP, WMI...) a ficheros separados para que no interfieran con la configuración remota de Agentes.

1.5.56 vlan_cache_enabled

vlan_cache_enabled [0|1] 

Habilita (1) o deshabilita (0) la cache VLAN de los hosts autodescubiertos.

1.5.57 verbosity

verbosity <0-10> 

Nivel de detalle en el registro del log, donde 10 es el nivel de información más detallado.

1.5.58 agents_blacklist_icmp

Info.png

Versión NG 713 o superior.

 


agents_blacklist_icmp 10.0.0.0/24[,8.8.8.8/30]

Lista de exclusión de chequeos ICMP. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo ICMP. Es posible especificar varias subredes separándolas por comas.

1.5.59 agents_blacklist_snmp

Info.png

Versión NG 713 o superior.

 


agents_blacklist_snmp 10.0.0.0/24[,8.8.8.8/30] (Version > 7.0OUM713) 

Lista de exclusión de chequeos SNMP. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo SNMP. Es posible especificar varias subredes separándolas por comas.

1.5.60 agents_blacklist_wmi

Info.png

Versión NG 713 o superior.

 


agents_blacklist_wmi 10.0.0.0/24[,8.8.8.8/30]

Lista de exclusión de chequeos WMI. Este campo se puede configurar con una lista de direcciones IP usando la notación CIDR para evitar que se ejecuten módulos de tipo WMI. Es posible especificar varias subredes separándolas por comas.

1.5.61 general_gis_exec

Info.png

Versión NG 734 o superior.

 


general_gis_exec xxx

Activando esta opción, se usará un script para proveer posicionamiento GIS a todos los Agentes detectados por el Satellite Server. El script debe tener permisos de ejecución e imprimir por pantalla las coordenadas con el formato <longitud>,<latitud>[,<altitud>] El tercer parámetro, la altitud, es opcional.

1.6 Creación de Agentes en Satellite Server

Existen tres modos de crear los Agentes en el Satellite Server: Recon Task, fichero de satellite_hosts.txt o de manera manual creando los .conf de los Agentes a monitorizar.

1.6.1 Creación de Agentes mediante Recon Task

La creación de Agentes mediante una tarea de reconocimiento (Recon Task) es la más utilizada por los usuarios de Pandora FMS. Para llevarla a cabo, debemos acceder al fichero de configuración del Satellite Server y configurar los siguientes parámetros:

  • recon_community: Se debe especificar una lista de comunidades SNMP para usar en el discovery de SNMP separadas por comas (en el caso de realizar una Recon Task de tipo SNMP).
  • recon_enabled: Se debe poner a 1 para habilitar el Recon Task del Satellite Server.
  • recon_interval: Intervalo de tiempo donde se escanea la red, en segundos (por defecto 604800 segundos, 7 días).
  • recon_mode: Modo de realizar la Recon Task (SNMP,ICMP,WMI), separados por comas.
  • recon_task: Lista de redes a las cuales hacer el reconocimiento, separadas por comas.
  • recon_timing_template: Un valor que especifica cómo de agresivo debe ser nmap, de 1 a 5. Uno significa más lento pero más fiable; cinco significa más rápido pero menos fiable (por defecto 3).

Un ejemplo de realización de Recon Task es:

recon_community public
recon_enabled 1
recon_interval 604800
recon_mode icmp,snmp,wmi
recon_task 192.168.0.0/24,192.168.1.0/24
recon_timing_template 3

Una vez configurados los datos, ejecute el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

Template warning.png

Los Agentes cuyos ficheros de configuración no contengan ningún Módulo serán ignorados por el Satellite Server.

 


1.6.2 Creación de agentes mediante fichero

En primer lugar, para poder crear un Agente mediante el fichero satellite_hosts.txt, debe ir al archivo de configuración del Satellite Server y quitar de comentario la línea:

host_file /etc/pandora/satellite_hosts.txt

En segundo lugar debe crear el fichero en la ruta señalada anteriormente con las direcciones IP de los hosts que queremos crear colocando la dirección IP y nombre del Agente a crear:

192.168.10.5 Server5
192.168.10.6 Server6
192.168.10.7 Server7

Template warning.png

Para que los Agentes con estas direcciones IP puedan ser creados, es necesario que respondan a la llamada fping, pues en caso contrario no se crearán.

 


Una vez configurados los datos, iniciamos el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

La lectura del fichero indicado se realiza cada recon_interval segundos.

1.6.3 Creación de agentes de manera manual

En el directorio /etc/pandora/conf (por defecto) van alojados los ficheros de configuración de los nuevos Agentes. Abra una venta terminal y vaya a esa carpeta:

cd /etc/pandora/conf

Proceda a crear un fichero con una extensión .conf, por ejemplo "archivo.conf". Rellene manualmente los siguientes campos:

  • agent_name: Nombre que se asignará al Agente.
  • agent_alias: Alias que se asignará al Agente.
  • address: Dirección IP del elemento a monitorizar.
  • group: Grupo al cual asignar el Agente.
  • gis_exec: Script de posicionamiento (opcional). Si se utiliza, sobreescribe la localización provista por el parámetro general_gis_exec del Satellite Server.
  • Agregue los Módulos a crear en el Agente.

Un ejemplo sería:

agent_name Example
agent_alias This is an example
address 127.0.0.1
group Servers

module_begin
module_name Ping
module_ping
module_end

module_begin
module_name Latency
module_latency
module_end

Una vez configurados los datos, inicie el Satellite Server mediante el comando:

/etc/init.d/satellite_serverd start

1.7 Eliminación de agentes en Satellite Server

Puede realizar una eliminación total de Agentes o una eliminación parcial de Agentes.

Template warning.png

Haga primero un respaldo de todas las carpetas y sus archivos antes de proceder.

 


Para la eliminación total de Agentes debemos tener en cuenta el método utilizado en la creación de Agentes:

  • Manual: Habrá que eliminar, en primer lugar, los ficheros .conf de los Agentes creados en la carpeta /etc/pandora/conf y posteriormente eliminar los Agentes en la consola.
  • Fichero satellite_hosts.txt: Habrá que eliminar el fichero, así como los .conf que se hayan creado en la carpeta /etc/pandora/conf, y posteriormente eliminar los Agentes en la Consola.
  • Recon_task: Habrá que desconfigurar la recon_task en el fichero .conf del Satellite Server, eliminar los .conf que se hayan creado en la carpeta /etc/pandora/conf y posteriormente eliminar los Agentes en la Consola.

Para la eliminación parcial también debemos de tener en cuenta el método utilizado en la creación de Agentes.

  • Manual: Habrá que eliminar, en primer lugar, los ficheros .conf de los Agentes a borrar en la carpeta /etc/pandora/conf y posteriormente eliminar los Agentes en la consola.
  • Fichero satellite_hosts.txt: Habrá que eliminar del fichero las líneas de las direcciones IP a eliminar, así como los .conf que se hayan creado en la carpeta /etc/pandora/conf con esas direcciones IP, y posteriormente eliminar los Agentes en la consola.
  • Recon_task: Habrá que configurar la lista de excluidos de la recon_task en el fichero .conf del Satellite Server, después borrar los .conf que se hayan creado en la carpeta /etc/pandora/conf con esas direcciones IP y eliminar los Agentes en la consola.

1.8 Configuraciones personalizadas por Agente

Adicionalmente a los Módulos "automáticos", se podrá agregar a la monitorización cualquier chequeo TCP, SNMP, WMI o SSH que esté disponible, usando una sintaxis similar a que se usa para los Módulos locales en los Agentes Software. Se exponen algunos ejemplos de Módulos válidos para el Satellite Server, tal como se autogeneran después de detectar el sistema.

Template warning.png

¡Asegúrese de que los OID empiezan con un punto o los módulos SNMP no funcionarán!

 


Estado de la interfaz vía SNMP. El Satellite Server detecta automáticamente cada interfaz:

module_begin
module_name if eth1 OperStatus
module_description IP address N/A. Description: The current operational state of the interface. The testing(3) state indicates that no operational packets can be passed.
module_type generic_data_string
module_snmp 192.168.70.225
module_oid .1.3.6.1.2.1.2.2.1.8.3
module_community artica06
module_end

Para obligar al módulo a utilizar SNMP versión 2c añada la línea:

module_version 2c

Para obligar al módulo a utilizar SNMP versión 1 añada la línea:

module_version 1

Por ejemplo:

module_begin
module_name if eth1 OperStatus
module_description IP address N/A. Description: The current operational state of the interface. The testing(3) state indicates that no operational packets can be passed.
module_type generic_data_string
module_snmp 192.168.70.225
module_version 2c
module_oid .1.3.6.1.2.1.2.2.1.8.3
module_community artica06
module_end

Conectividad a una máquina (vía PING):

module_begin
module_name ping
module_type generic_data
module_ping 192.168.70.225
module_end

Comprobación de un puerto (vía TCP):

module_begin
module_name Port 80
module_type generic_proc
module_tcp
module_port 80
module_end

Consulta genérica SNMP. En este caso el Satellite Server saca automáticamente el tráfico de cada interfaz, con su nombre "real" descriptivo:

module_begin
module_name if eth0 OutOctets
module_description The total number of octets transmitted out of the interface, including framing characters.
module_type generic_data_inc
module_snmp 192.168.70.225
module_oid .1.3.6.1.2.1.2.2.1.16.2
module_community public
module_end

Consulta WMI para uso de CPU (porcentaje):

module_begin
module_name CPU
module_type generic_data
module_wmicpu 192.168.30.3
module_wmiauth admin%none
module_end

Consulta WMI para memoria libre (porcentaje):

module_begin
module_name FreeMemory
module_type generic_data
module_wmimem 192.168.30.3
module_wmiauth admin%none
module_end

Consulta genérica WMI:

module_begin
module_name GenericWMI
module_type generic_data_string
module_wmi 192.168.30.3
module_wmiquery SELECT Name FROM Win32_ComputerSystem
module_wmiauth admin%none
module_end

Comando genérico SSH:

module_begin
module_name GenericSSH
module_type generic_data
module_ssh 192.168.30.3
module_command ls /tmp | wc -l
module_end

Para introducir un umbral hay que hacerlo tanto en la definición de texto del Módulo (module_min_warning, module_min_critical) como en la definición de umbrales mediante la interfaz web. Por ejemplo:

module_begin
module_name Latency
module_type generic_data
module_latency 192.168.70.225
module_min_warning 80
module_min_critical 120
module_end

Manualmente puede crear Módulos de ejecución. Los scripts o comandos que ejecute el Satellite Server deben estar previamente desplegados y accesibles por el mismo. En este sentido, funciona igual que un module_exec de un Agente. Tenga en cuenta que el uso de module_exec puede hacer que el rendimiento del Satellite Server disminuya.

module_begin
module_name Sample_Remote_Exec
module_type generic_data
module_exec /usr/share/test/test.sh 192.168.50.20
module_min_warning 90
module_min_critical 95
module_end

A partir de la versión 7 de Pandora FMS también pueden añadirse plugins. Al igual que estos, hay que tener en cuenta que los plugins se ejecutarán en la máquina donde está corriendo el Satellite Server. Por lo tanto, habrá que implementar en estos plugins algún método para conectarse al equipo remoto que se necesita monitorizar. La ventaja respecto a los anteriores es su gran flexibilidad. De esta forma, se pueden implementar condiciones y otros mecanismos para los que un module_exec se queda corto. La sintaxis es la misma que la de los Agentes. Un ejemplo de uso de un plugin podría ser el siguiente:

module_plugin /usr/share/pandora/remote_advanced_checks.sh 192.168.0.1

1.8.1 SNMPv3

Para configurar un módulo SNMPv3, defina module_version a 3 y especifique:

  • module_seclevel: Nivel de seguridad ( noauth, authnopriv o authpriv ).
  • module_secname: Nombre de seguridad.
  • module_authproto: Protocolo de autenticación ( md5 o sha ).
  • module_authpass: Clave de autenticación.
  • module_privproto: Protocolo de privacidad ( aes o des ).
  • module_privpass: Clave de privacidad, según sea necesario.

Por ejemplo:

module_begin
module_name snmp_noauth
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.1.0
module_seclevel noauth
module_secname snmpuser
module_end
module_begin
module_name snmp_authnopriv
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_seclevel authnopriv
module_secname snmpuser
module_authproto md5
module_authpass 12345678
module_end
module_begin
module_name snmp_authpriv
module_type generic_data_string
module_snmp 127.0.0.1
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_seclevel authpriv
module_secname snmpuser
module_authproto sha
module_authpass 12345678
module_privproto aes
module_privpass 12345678
module_end

La configuración específica de SNMPv3 se puede compartir entre Módulos sacándola fuera de la declaración del Módulo, en caso de que sea la misma para todos (también se puede compartir entre Agentes moviéndola al fichero de configuración del Satellite Server):

agent_name snmp
address 127.0.0.1

seclevel authpriv
secname snmpuser
authproto md5
authpass 12345678
privproto des
privpass 12345678

module_begin
module_name snmp_authpriv_1
module_type generic_data_string
module_snmp
module_version 3
module_oid .1.3.6.1.2.1.1.1.0
module_end

module_begin
module_name snmp_authpriv_2
module_type generic_data_string
module_snmp
module_version 3
module_oid .1.3.6.1.2.1.1.2.0
module_end

1.9 Cajas de credenciales

Salvo que la autenticación esté configurada con clave privada y clave pública, los Módulos SSH necesitan un nombre de usuario ( <user> ) y una contraseña ( <pass> ) para funcionar. Ambos se registran en el fichero de configuración principal, satellite_server.conf, utilizando cajas de credenciales (credential_box ) con los siguientes formatos:

red/máscara,usuario,contraseña

red/máscara,usuario,[[contraseña cifrada]]

Por ejemplo:

credential_box 192.168.1.1/32,<user>,<pass1>
credential_box 192.168.1.0/24,<user>,<pass2>

Las búsquedas en las cajas de credenciales se hacen de máscaras más a menos restrictivas.

Las contraseñas se pueden cifrar utilizando Blowfish en modo ECB. Asegúrese de que credential_pass está definido, de otro modo el nombre del host se utilizará como contraseña de cifrado por defecto. La representación hexadecimal del texto cifrado se debe rodear con corchetes dobles:

credential_box 192.168.1.0/24,<user>,[[80b51b60786b3de2]]

1.10 Vista en la consola de todos los Agentes

Si la configuración del Satellite Server ha sido correcta, debería obtener una vista de Agentes parecida a esta:

Selección 146.png

Generalmente en todas las máquinas se crearán Módulos de tipo ICMP (Ping y Latencia) pero en algunas también se pueden generar Módulos de tipo SNMP y WMI. En las que tengan WMI habilitado se generarán los siguientes Módulos, de estar disponibles:

Modulos.png

En las máquinas con SNMP habilitado se generarán los siguientes módulos, de estar disponibles:

Modulos1.png

En el apartado de operaciones masivas de la Consola de Pandora FMS hay una sección especial dedicada al Satellite Server, donde se pueden realizar diversas acciones de edición y borrado de Agentes y Módulos de forma masiva:

Operación massivas.png

1.11 Lista de exclusión de SNMP

Al monitorizar redes grandes los Módulos SNMP que devuelven datos inválidos pueden afectar al rendimiento del Satellite Server, y llevar a otros Módulos a estado Desconocido. Para evitar esto, el Satellite Server puede leer una lista de excluidos de Módulos SNMP que serán descartados en el arranque antes de la ejecución.

Para crear una lista de excluidos, edite el fichero de configuración /etc/pandora/satellite_server.conf y asegúrese de que snmp_blacklist está descomentado y configurado con la ruta al fichero en el que se guardarán los Módulos de la lista de excluidos. A continuación ejecute:

satellite_server -v /etc/pandora/satellite_server.conf

Reinicie el Satellite Server. La lista de excluidos se puede regenerar tantas veces como sea necesario.

El formato de la lista de excluidos es:

agent:OID
agent:OID
...

Por ejemplo:

192.168.0.1:.1.3.6.1.4.1.9.9.27 
192.168.0.2:.1.3.6.1.4.1.9.9.27 

Volver al Índice de Documentación Pandora FMS