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 12.
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:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 12
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
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
apt update && apt upgrade
Accept all GPG keys and reboot your server if a kernel update is proposed.
Step 1: Pre-installation
Disable SELinux
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 12
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.
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.
SELinux is not installed on Debian 12, continue.
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
- Alma 8
- RHEL 8
- Oracle Linux 8
- Alma 9
- RHEL 9
- Oracle Linux 9
- Debian 12
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
Redhat CodeReady Builder repository
To install Centreon, you will need to enable the official CodeReady Builder supported by Redhat.
Enable the CodeReady Builder repository using these commands:
dnf -y install dnf-plugins-core https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
If your server is a Cloud RHEL instance, you will have to execute the following command:
dnf config-manager --set-enabled codeready-builder-for-rhel-8-rhui-rpms
Oracle CodeReady Builder repository
To install Centreon, you will need to enable the official Oracle CodeReady Builder repository supported by Oracle.
Enable the repository using these commands:
dnf install dnf-plugins-core
dnf install -y http://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
dnf config-manager --set-enabled ol9_codeready_builder
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install dnf-plugins-core
dnf install epel-release
dnf config-manager --set-enabled crb
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y http://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms
If your server is a Cloud RHEL instance, you will have to execute the following command:
dnf config-manager --set-enabled codeready-builder-for-rhel-9-rhui-rpms
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
dnf config-manager --set-enabled ol9_codeready_builder
dnf install -y epel-release
Install the following dependencies:
apt update && apt install lsb-release ca-certificates apt-transport-https software-properties-common wget gnupg2 curl
Centreon repository
To install Centreon software, you should first install the Centreon repository.
Install the Centreon repository using this command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 12
dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/24.10/el8/centreon-24.10.repo
dnf clean all --enablerepo=*
dnf update
dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/24.10/el9/centreon-24.10.repo
dnf clean all --enablerepo=*
dnf update
To install the Centreon repository, execute the following command line:
echo "deb https://packages.centreon.com/apt-standard-24.10-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon.list
echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list
Then import the repository key:
wget -O- https://apt-key.centreon.com | gpg --dearmor | tee /etc/apt/trusted.gpg.d/centreon.gpg > /dev/null 2>&1
apt update
Step 2: Installation
To install the monitoring engine, run the command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 12
dnf install -y centreon-poller
dnf install -y centreon-poller
apt install -y --no-install-recommends 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
Entering your password:
please enter the password for 192.168.0.1:
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
1Then 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.10.
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.