Configuración

El fichero de configuración del plugin “​ovm-plugin​” se divide en bloques (todos los parámetros de configuración se indicarán sin comillas aunque tengan espacios en blanco):

Configuraciones de acceso a la API REST

################################
## OVM Manager access parameters
################################
## OVM Manager REST API URL
ovmm_api_url=https://192.168.70.70:7002/ovm/core/wsapi/rest/
## OVM Manager user
user=admin
## OVM Manager password
password=P4nd0r4OVM

ovmm_api_url
URL de acceso a la API REST del Oracle VM Manager a monitorizar
user
Usuario de acceso a la API REST
password
Contraseña del usuario de acceso especificado

Configuraciones de los agentes generados

####################
## Agents parameters
####################
## Agents group (if Pandora server autocreate_group is not set)
group=Servers
## Agents interval
interval=300

group
Grupo al que se asignarán los agentes generados. Este grupo se tendrá en cuenta
solo si el parámetro “​autocreate_group​” del servidor de Pandora no se ha definido
correctamente.
interval
Intervalo de monitorización en segundos de los agentes generados. Permitirá
definir cuándo pasarán los módulos a estado desconocido (por defecto, 2 veces el intervalo
definido sin recibir datos)

Configuraciones de transferencia de los ficheros XML

######################
## Transfer parameters
######################
## Temporal folder
tmp=/tmp
## Transfer mode used to send XML files (tentacle or local)
transfer_mode=tentacle
## Local folder to copy XML files (used only if transfer_mode is not tentacle)
local_folder=/var/spool/pandora/data_in/
## Tentacle server IP
tentacle_ip=127.0.0.1
## Tentacle server port
tentacle_port=41121
## Tentacle extra options (if needed)
#tentacle_opts=

tmp
Directorio temporal en el que se generarán los ficheros XML de los agentes
generados antes de su transferencia al servidor de Pandora FMS.
transfer_mode
Método de transferencia de ficheros que se utilizará. Si no se establece como “​tentacle​” se considerará que el método de transferencia es “​local​” (copiando los ficheros XML del directorio temporal a uno definido).
local_folder
Directorio al que se copiarán los ficheros XML si el método de transferencia no se establece como “​tentacle​”.
tentacle_ip
Dirección IP al que se enviarán los ficheros XML si el método de transferencia se establece como “​tentacle​”.
tentacle_port
Puerto al que conectarse al servidor de Tentacle indicado en el parámetro “​tentacle_ip​”.
tentacle_opts
Opciones adicionales para la transferencia de ficheros al servidor de Tentacle indicado.

Configuraciones de renombrado de agentes

#################
## Rename section
#################
## Change the default agent name to the desired agent name
## (By default, the agent name is the ID provided by the API except for OVM servers,
where it is the ID's MD5 hash)
#default_agent_name1=new_agent_name1
#default_agent_name2=new_agent_name2

De forma opcional, se pueden configurar tantos parámetros de renombrado de agentes como se quiera. Estos parámetros permitirán que el nombre de agente (​agent_name​) utilizado se sustituya por el indicado. Por ejemplo:

0004fb000009000059ae00c7b0568784=Oracle VM Server 1

Cambiará el nombre del agente “​0004fb000009000059ae00c7b0568784​” por “​Oracle VM Server 1​” en los ficheros XML generados, y por tanto sus módulos se verán reflejados en un nuevo agente en la consola.

Por defecto los nombres de agente utilizados son los IDs devueltos por la API REST de Oracle VM para cada uno de sus elementos.

Esto es así para todos los elementos excepto para los servidores (OVM servers), donde el nombre de agente es el hash MD5 del ID del servidor, debido a que el formato utilizado para estos IDs es distinto y no es aceptado por Pandora como “​agent_name​”.

Por ejemplo, para el servidor con ID “​ff:67:51:6d:00:a8:ca:ae:5e:52:b5:cd:58:a0:11:70​” el nombre de agente utilizado sería el hash MD5 de esa cadena:
“​a62454d287e230c773f56d618b78500f​”

Los nombres de los agentes no se utilizarán como alias de los agentes (​agent_alias​) a no ser que se configure la opción “​alias_as_name​” (se explica en el siguiente bloque).

Configuraciones adicionales

###################
## Extra parameters
###################
## Set to 1 to use the agent_name as the agent_alias in the XML file (By default = 0).
alias_as_name=0
## Set to 1 to get the IP addresses from VMs (requires OVM guest additions installed)
- By default = 1
scan_vm_ip=1
## Set to 1 to get detailed execution information
debug=0

alias_as_name
Si se establece a “1” se utilizará el nombre del agente (​agent_name​) como alias del agente (​agent_alias​). Esto solo tendrá efecto si el agente se crea en Pandora a partir del XML generado. Por defecto se usará el nombre del elemento del Oracle VM como su alias. Su valor por defecto si no se especifica es “0” (deshabilitado).
scan_vm_ip
Si se establece a “1” se intentarán obtener las direcciones IP de las VMs detectadas. Para poder obtener las direcciones IP es necesario que las VMs tengan instaladas las “OVM guest additions”. Su valor por defecto si no se especifica es “1” (habilitado).
debug
Si se establece a “1” se mostrará información detallada de las acciones que se realicen durante la ejecución del plugin. Su valor por defecto si no se especifica es “0” (deshabilitado).