# Configuración en PandoraFMS

Para configurar el plugin en PandoraFMS, se deben seguir los siguientes pasos:

**1. Subir el plugin a PandoraFMS, por ejemplo en la siguiente ruta:**

```
/usr/share/pandora_server/util/plugin
```

**2. Subir el JAR de Oculix y los scripts .ocx necesarios al servidor, en una ruta accesible por el plugin.**

**3. Crear el archivo de configuración .conf con los parámetros de Pandora:**

```ini
[CONF]
agent_name=Oculix Login Test
agents_group_name=Oculix
module_prefix=
interval=300
agent_plugin=1
temporal=/tmp
transfer_mode=tentacle
tentacle_client=tentacle_client
tentacle_ip=127.0.0.1
tentacle_port=41121
tentacle_opts=
data_dir=/var/spool/pandora/data_in/
```

**4. Dirigirse al apartado plugins y crear uno nuevo:**

Se le añade nombre, descripción y timeout.

**5. Se añade la ruta del plugin en el comando y los parámetros necesarios para la ejecución de este.**

<p class="callout info">Para cada parámetro se debe configurar una macro, siendo la sintaxis de esta macro la siguiente: `_fieldx_`, siendo x el numero posicional del parámetro.</p>

Ejemplo de comando para el plugin:

```
/usr/share/pandora_server/util/plugin/pandora_oculix.py --script _field1_ --jar _field2_ --conf _field3_
```

**6. Se configuran las macros anteriores, añadiendo en cada una el valor del parámetro:**

Ejemplo de macros:

- \_field1\_ = /opt/oculix/scripts/login.py
- \_field2\_ = /opt/oculix/oculix.jar
- \_field3\_ = /opt/oculix/oculix.conf

**7. Una vez configurado se debe crear un módulo en un agente que ejecute el plugin. En el menú de módulos de un agente creamos un módulo de tipo plugin nuevo:**

**8. En el menú de configuración del módulo, le ponemos un nombre, seleccionamos el plugin antes configurado y se le debe dar a "crear".**

**9. Se creará el agente con los módulos en la siguiente ejecución del plugin.**