Skip to main content
Version: 24.04

Using packages

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

These packages can be installed on Alma/RHEL/Oracle Linux 8 and 9 and on Debian 11.

You must run the installation procedure as a privileged user.

When you run a command, check its output. If you get an error message, stop the procedure and fix the issue.

Prerequisites

After installing your server, update your operating system using the following command:

dnf update

Additional configuration

If you intend to use Centreon in French, Spanish, Portuguese or German, install the corresponding packages:

dnf install glibc-langpack-fr
dnf install glibc-langpack-es
dnf install glibc-langpack-pt
dnf install glibc-langpack-de

Use the following command to check which languages are installed on your system:

locale -a

Accept all GPG keys and reboot your server if a kernel update is proposed.

Step 1: Pre-installation

Disable SELinux

During installation, SELinux should be disabled. To do this, edit the file /etc/selinux/config and replace enforcing with 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

Note that this deactivation should be temporary. SELinux should be reenabled after installation for security reasons.

Configure or disable the firewall

If your firewall is active, add firewall rules. You can also disable the firewall during installation by running the following commands:

systemctl stop firewalld
systemctl disable firewalld

Server name

If you want to change the server's name, use the following command:

hostnamectl set-hostname new-server-name

Replace new-server-name with the name of your choice. 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, you should first install the Centreon repository.

Install the Centreon repository using this command:

dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/24.04/el8/centreon-24.04.repo
dnf clean all --enablerepo=*
dnf update

Step 2: 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 gorgoned

Passive monitoring services can be started:

systemctl start centreontrapd snmptrapd gorgoned

Restart Centreon Engine:

systemctl restart centengine

Step 3: Register the server

To turn the server into a poller and to register it to the Central server or 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> with 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 for 192.168.0.1:
  2. Select the IP address 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 information that will be sent:

    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 the previous 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 error messages

2023-05-20T10:23:15+02:00 [ERROR]: Invalid credentials

Your credentials are incorrect for the <API_ACCOUNT>.

2023-05-20T10:24:59+02:00 [ERROR]: Access Denied.

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

Couldn't connect to 192.168.0.1:444; Connection refused

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

2023-05-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 incomplete or invalid. Use the --root option to define the API URL Path. For example: --root monitoring.

2023-05-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 than or equal to 24.04.

Step 4: Add the Poller to the configuration

Go to Attach a poller to a central or a remote server.

Step 5: Secure your platform

Remember to secure your Centreon platform following our recommendations.