Skip to main content
Version: ⭐ 22.04

Using packages

Centreon provides RPM packages for its products through the Centreon Open Source version available free of charge in our repository.

These packages can be installed on CentOS 7 and on Alma/RHEL/Oracle Linux 8.

Pre-installation steps​

Disable SELinux​

During installation, SELinux should be disabled. To do this, edit the file /etc/selinux/config and replace enforcing by disabled. You can also run the following command:

sed -i s/^SELINUX=.*$/SELINUX=disabled/ /etc/selinux/config

Reboot your operating system to apply the change.

reboot

After system startup, perform a quick check of the SELinux status:

getenforce

You should have this result:

Disabled

Configure or disable firewall​

Add firewall rules or disable the firewall by running the following commands:

systemctl stop firewalld
systemctl disable firewalld

You can find instructions here to configure firewalld.

Server name​

If you want, you can change the server's name using the following command:

hostnamectl set-hostname new-server-name

Replace new-server-name by the name you want. Example:

hostnamectl set-hostname poller1

Install the repositories​

Redhat PowerTools repository​

To install Centreon you will need to enable the official PowerTools repository supported by Redhat.

Enable the PowerTools repository using these commands:

dnf -y install dnf-plugins-core epel-release
dnf config-manager --set-enabled powertools

Centreon repository​

To install Centreon software from the repository, you should first install the centreon-release package, which will provide the repository file.

Install the Centreon repository using this command:

dnf install -y https://yum.centreon.com/standard/22.04/el8/stable/noarch/RPMS/centreon-release-22.04-3.el8.noarch.rpm

Installation​

To install the monitoring engine, run the command:

dnf install -y centreon-poller

To make services start automatically during system bootup, run the following command:

systemctl enable centreon centengine centreontrapd snmptrapd

Passive monitoring services can be started:

systemctl start centreontrapd snmptrapd

Restart Centreon Engine:

systemctl restart centengine

Register the server​

To turn the server into a poller and to register it to the Central server or to a Remote server, execute the following command on the future poller:

/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t poller -h <IP_TARGET_NODE> -n <POLLER_NAME>

Example:

/usr/share/centreon/bin/registerServerTopology.sh -u admin -t poller -h 192.168.0.1 -n poller-1

Replace <IP_TARGET_NODE> by the IP of the central server or remote server that you want to link the poller to (IP as seen by the poller)

The <API_ACCOUNT> must have access to the configuration API. You can use the default admin account.

If you need to change the HTTP method or the port, you can use the following format for the -h option: HTTPS://<IP_TARGET_NODE>:PORT

Then follow instructions by

  1. Entering your password:

    please enter the password of 192.168.0.1:
  2. Select the IP adress if multiple network interfaces exist:

    Which IP do you want to use as CURRENT NODE IP ?
    1) 192.168.0.2
    2) 192.168.0.3
    1
  3. Then validate the information:

    Summary of the informations that will be send:

    Api Connection:
    username: admin
    password: ******
    target server: 192.168.0.1

    Pending Registration Server:
    name: poller-1
    type: poller
    address: 192.168.0.2

    Do you want to register this server with those information ? (y/n)y

You will receive the validation of the Centreon central or the Remote Server server:

2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'poller': 'poller-1@192.168.0.2' linked to TARGET NODE: '192.168.0.1' has been added

Main errors messages​

2020-10-20T10:23:15+02:00 [ERROR]: Invalid credentials

Your credentials are incorrect for the <API_ACCOUNT>.

2020-10-20T10:24:59+02:00 [ERROR]: Access Denied.

The <API_ACCOUNT> doesn't have access to configuration API.

Failed connect to 192.168.0.1:444; Connection refused

Unable to access to the API. Please check <IP_TARGET_NODE>, scheme and port.

2020-10-20T10:39:30+02:00 [ERROR]: Can’t connect to the API using: https://192.168.0.1:443/centreon/api/latest/login

The access url is not complete or invalide. Use the --root option to define the API URL Path. For example: --root monitoring.

2020-10-20T10:42:23+02:00 [ERROR]: No route found for β€œPOST /centreon/api/latest/platform/topology”

Your Centreon target version is invalid. It should be greater or equal to 22.04.

Add the Poller to configuration​

Go to the Add a Poller to configuration.

Secure your platform​

Don't forget to secure your Centreon platform following our recommendations