Attach a remote server to a central server
Prerequisitesβ
Install the remote server using packages.
Step 1: Configure a new Remote Serverβ
As of Centreon version 18.10, a new wizard has been added for defining a new Remote Server on the Centreon platform.
Go to the Configuration > Pollers > Pollers menu and click Add to configure a new Remote Server.
Select Add a Centreon Remote Server and click Next:
Select the option you want:
If you enabled the Remote Server option when installing your server, select the option Select a Remote Server, then select your server and fill in the form:
Otherwise, select the Create new Remote Server option and fill in the form:
The Database username and Database password are the credentials defined during the installation of the Remote Server.
The Server IP address field has the following form: [(http|https)://]@IP[:(port)]. If your Remote Server is only available on HTTPS, it is mandatory to define the HTTP method and the TCP port if it is not the default one.
The Do not check SSL certificate validation option allows you to connect to the Remote Server using a self-signed SSL certificate.
The Do not use configured proxy to connect to this server allows you to connect to the Remote Server without using the proxy configuration of the Centreon Central server.
Click Next.
Select the poller(s) to be linked to this Remote Server, then click Apply:
The wizard will configure your new server:
The Remote Server is now configured:
If you have customized the names of the databases at step 6 of the web installation wizard, carry out the following steps:
Go to Configuration > Pollers > Broker configuration.
Select the broker service for the remote server you want.
On the Output tab, in section Output 1 - Unified SQL, update the name of the database in the DB name field (the default name is centreon_storage), then click Save.
Export the configuration of the remote server.
Restart cbd:
systemctl restart cbd
If needed, check /var/log/centreon-broker/<remote-server-name>.log for issues/errors. (In the example above, the file would be /var/log/centreon-broker/remote-server.log.)
Step 2: Enable communicationβ
The communication between the Central server and a Remote Server is ensured by Gorgone and can be done using ZMQ (with a Gorgone running on the Remote Server, recommended) or using SSH protocol.
- Using ZMQ
- Using SSH (Deprecated)
Select the communication type:
Edit the newly created Remote Server configuration, and select ZMQ as Gorgone connection protocol. Define the suitable port (port 5556 is recommended).
Click Save.
Note that the SSH Legacy port is no longer used, and will be removed.
If you were using it in custom scripts, consider changing to the Gorgone communication system.
Copy the Gorgone configuration:
From the poller list, click the Display Gorgone configuration action icon on the line corresponding to your Remote Server
A popin will show the configuration to copy into the Remote Server terminal. Click Copy to clipboard.
Paste the content of the clipboard directly into the Remote Server terminal as it contains the following content, and will fill the right file:
cat <<EOF > /etc/centreon-gorgone/config.d/40-gorgoned.yaml
name: gorgoned-My Remote Server
description: Configuration for remote server My Remote Server
gorgone:
gorgonecore:
id: 3
external_com_type: tcp
external_com_path: "*:5556"
authorized_clients:
- key: Np1wWwpbFD2I0MdeHWRlFx51FmlYkDRZy9JTFxkrDPI
privkey: "/var/lib/centreon-gorgone/.keys/rsakey.priv.pem"
pubkey: "/var/lib/centreon-gorgone/.keys/rsakey.pub.pem"
modules:
- name: action
package: gorgone::modules::core::action::hooks
enable: true
- name: cron
package: "gorgone::modules::core::cron::hooks"
enable: true
cron: !include cron.d/*.yaml
- name: nodes
package: gorgone::modules::centreon::nodes::hooks
enable: true
- name: proxy
package: gorgone::modules::core::proxy::hooks
enable: true
- name: legacycmd
package: gorgone::modules::centreon::legacycmd::hooks
enable: true
cmd_file: "/var/lib/centreon/centcore.cmd"
cache_dir: "/var/cache/centreon/"
cache_dir_trap: "/etc/snmp/centreon_traps/"
remote_dir: "/var/cache/centreon/config/remote-data/"
- name: engine
package: gorgone::modules::centreon::engine::hooks
enable: true
command_file: "/var/lib/centreon-engine/rw/centengine.cmd"
- name: statistics
package: "gorgone::modules::centreon::statistics::hooks"
enable: true
broker_cache_dir: "/var/cache/centreon/broker-stats/"
cron:
- id: broker_stats
timespec: "*/5 * * * *"
action: BROKERSTATS
parameters:
timeout: 10
- id: engine_stats
timespec: "*/5 * * * *"
action: ENGINESTATS
parameters:
timeout: 10
EOFHit the Enter key for the command to be applied.
You can copy the configuration in a custom file by copying the content from the popin.
Restart the Gorgone daemon:
From the Remote Server, run the following command to restart the Gorgone service:
systemctl restart gorgoned
Make sure it is started by running the following command:
systemctl status gorgoned
It should result as follows:
β gorgoned.service - Centreon Gorgone
Loaded: loaded (/etc/systemd/system/gorgoned.service; enabled; vendor preset: disabled)
Active: active (running) since Wed 2020-03-24 19:45:00 CET; 6s ago
Main PID: 30902 (perl)
CGroup: /system.slice/gorgoned.service
ββ30902 /usr/bin/perl /usr/bin/gorgoned --config=/etc/centreon-gorgone/config.yaml --logfile=/var/log/centreon-gorgone/gorgoned.log --severity=info
ββ30916 gorgone-nodes
ββ30917 gorgone-dbcleaner
ββ30924 gorgone-proxy
ββ30925 gorgone-proxy
ββ30938 gorgone-proxy
ββ30944 gorgone-proxy
ββ30946 gorgone-proxy
ββ30959 gorgone-engine
ββ30966 gorgone-action
ββ30967 gorgone-legacycmd
Mar 24 19:45:00 localhost.localdomain systemd[1]: Started Centreon Gorgone.To force the Central's Gorgone daemon to connect to the Remote Server, restart it with the following command from the Central server:
systemctl restart gorgoned
Deprecated
This mode should no longer be used because it does not allow data synchronization between the central and the remote server UI.
Step 3: Export the configurationβ
From the poller list, select the remote server and click Export configuration.
Then check the first three boxes and click Export:
Finally, from the Remote Server, start/restart the collect processes:
systemctl restart cbd centengine
The Remote Server's Broker and Engine will then start and connect to the Central Broker.
Getting startedβ
Go to the Getting Started chapter to configure your first monitoring.