Skip to main content

Configuration in PandoraFMS

The plugin is delivered as a .disco Discovery package. To configure the plugin in PandoraFMS, follow these steps:it:

1. UploadInstall the plugin.disco package, if not already installed: go to PandoraFMS,Discovery e.g.→ inExtension manager and upload the followingpackage path:(or confirm it is already listed).

/usr/share/pandora_server/util/plugin

2. UploadCreate thea Oculixnew JARDiscovery andtask: the required .ocx scriptsgo to theDiscovery server,→ inApplications a→ path accessible by the plugin.Playwright.

3. CreateFill in the .confwizard configurationsteps file(see withParameters Pandora parameters:above):

    

  • 
Basic setup: worker mode and browser.
    • 

  • 
Worker setup: only shown when worker mode is [CONF]remote agent_name=Oculix— LoginSSH connection details.
    • 

  • 
Test agents_group_name=Oculixsetup: module_prefix=Docker interval=300image, agent_plugin=1browser temporal=/tmpsize, transfer_mode=tentacletimeout, tentacle_client=tentacle_clientSend tentacle_ip=127.0.0.1full tentacle_port=41121report, tentacle_opts=Generate data_dir=/var/spool/pandora/data_in/error history module
, and the Playwright test .ts content itself.

4. Go toSave the pluginstask. sectionOn each execution, the plugin runs the test in Docker and createreports aone newagent one:

per

AddPlaywright atest(...) name,found description,in andthe timeout.file.

5. AddOpen the pluginresulting pathagent(s) in the commandconsole. The WUX transactional view renders the phases derived from test.step(...); standard module views show status, time, error screenshot, metrics, and the(if necessary parameters for its execution.

For each parameter, a macro must be configured. The macro syntax is: _fieldx_, where x isenabled) the positionalerror-history number of the parameter.modules.

Example plugin command:

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

6. Configure the macros above, adding the parameter value in each one:

Example macros:

  • _field1_ = /opt/oculix/scripts/login.py
  • _field2_ = /opt/oculix/oculix.jar
  • _field3_ = /opt/oculix/oculix.conf

7. Once configured, a module must be created in an agent to run the plugin. In an agent's module menu, create a new plugin-type module:

8. In the module configuration menu, give it a name, select the previously configured plugin, and click "create".

9. The agent with the modules will be created on the next execution of the plugin.

Back to top