Skip to main content
Version: ⭐ 22.04

Deploying a configuration

When you create, delete or edit objects in the Configuration menu, changes are not applied automatically (neither on the central server on which you have made the change, nor on any remote server or poller linked to it). For the changes to be taken into account, you have to export the configuration.

Any change in configuration must be done and exported from the central server's interface or API, regardless of which poller is affected by the change (central server, remote server, poller).

Exporting the configuration​

  1. Go to the Configuration > Pollers > Pollers page. The page shows the state of your central server and of all pollers and remote servers linked to it: changes are shown in the Conf changed column.

  2. Select the central server, the remote server or the poller whose configuration has changed.

    image

  3. Click on Export configuration.

  4. Check the following boxes (see section Export options) :

    • Generate Configuration Files
    • Run monitoring engine debug (-v)
    • Move Export Files
    • Restart Monitoring Engine. Use the most appropriate method:
      • Reload : when you have created, deleted or edited monitored objects
      • Restart : when you have made changes to the way a poller and the central server communicate together, or to the configuration of the engine. Restarting takes more time than reloading.
  5. Click Export. A log of the export is displayed.

    image

  6. Read the log to check that the export has worked normally and that no errors were returned.

Export options​

The options work in the following ways:

  • Generate Configuration Files: Generates the monitoring engine's configuration files in a temporary directory. This configuration is generated from objects configured via the web interface
  • Run monitoring engine debug (-v): Performs a sanity check of the monitoring engine's configuration files
  • Move Export Files: Moves the configuration files from the temporary directory to the monitoring engine's configuration directory
  • Restart Monitoring Engine: Restarts the monitoring engine to apply the new configuration
  • Post generation command: Executes the post-generation command set in the poller's configuration

Quick export​

Administrators can activate a quick export button that allows them to export the configurations of ALL pollers at once (i.e. the configuration of the central server, remote servers and pollers). This feature is still in beta mode.

When to use this feature​

Do NOT use this feature if you have a large number of pollers. This feature is not appropriate either if you are an MSP and each poller belongs to a different customer.

Activating the feature​

In beta mode, only administrator users can use this feature.

To activate the feature:

  1. Go to Administration > Parameters > My Account, or click on the profile icon in the top right corner of the screen and then click on Edit profile.
  2. In section Preferences, select Enable the one-click export button for poller configuration [BETA].
  3. Click Save.

Exporting all configurations​

To quickly export the configuration for all pollers:

  1. Click the Pollers menu at the top left of the screen, then click Export configuration.

    image

  2. Confirm the export in the pop-up that appears.