Using packages
This is an older version of Centreon. We recommend you install the latest version.
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:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
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 11
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
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 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
Note that this deactivation should be temporary. SELinux should be reenabled after installation for security reasons.
SELinux is not installed on Debian 11, 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
Install the repositories
- Alma 8
- RHEL 8
- Oracle Linux 8
- Alma 9
- RHEL 9
- Oracle Linux 9
- Debian 11
Remi repository
To install Centreon you will need to install the remi repository.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf config-manager --set-enabled 'powertools'
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:remi-8.1
Remi and CodeReady Builder repository
To install Centreon you will need to install the remi and CodeReady Builder repositories.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.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
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:remi-8.1
Remi and CodeReady Builder repositories
To install Centreon you will need to install the remi and CodeReady Builder repositories.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf config-manager --set-enabled ol8_codeready_builder
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:remi-8.1
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
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:8.1
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
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:8.1
To install Centreon you will need to install the CodeReady Builder repository.
Run the following 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
Enable PHP 8.1 using the following commands:
dnf module reset php
dnf module install php:8.1
Install dependencies
Install the following dependencies:
apt update && apt install lsb-release ca-certificates apt-transport-https software-properties-common wget gnupg2
Add Sury APT repository for PHP 8.1
To install the Sury repository, execute the following command:
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/sury-php.list
Then import the repository key:
wget -O- https://packages.sury.org/php/apt.gpg | gpg --dearmor | tee /etc/apt/trusted.gpg.d/php.gpg > /dev/null 2>&1
apt update
MariaDB repository
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --os-type=rhel --os-version=8 --mariadb-server-version="mariadb-10.5"
curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | sudo bash -s -- --os-type=rhel --os-version=9 --mariadb-server-version="mariadb-10.5"
curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup | bash -s -- --os-type=debian --os-version=11 --mariadb-server-version="mariadb-10.5"
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 11
dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/23.04/el8/centreon-23.04.repo
dnf clean all --enablerepo=*
dnf update
dnf install -y dnf-plugins-core
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/23.04/el9/centreon-23.04.repo
dnf clean all --enablerepo=*
dnf update
To install the Centreon repository, execute the following command:
echo "deb https://packages.centreon.com/apt-standard-23.04-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
This section describes how to install a Centreon central server.
You can install this server with a local database on the server, or a remote database on a dedicated server.
- With a local database
- With a remote database
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf install -y centreon-database centreon-central
systemctl daemon-reload
systemctl restart mariadb
dnf install -y centreon-database centreon-central
systemctl daemon-reload
systemctl restart mariadb
apt install -y --no-install-recommends centreon
systemctl daemon-reload
systemctl restart mariadb
If installing the database on a dedicated server, this server should also have the prerequired repositories.
Run the following command on the Central server:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf install -y centreon-central
dnf install -y centreon-central
apt install -y --no-install-recommends centreon-central
Then run the following commands on the dedicated server for your database:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
apt update
apt install -y --no-install-recommends centreon-database
systemctl daemon-reload
systemctl restart mariadb
It is mandatory to set a password for the root user of the database.
Secure your MariaDB root access by executing the following command:
mysql_secure_installation
Then, in the remote dabatase, create a user with root privileges. You will have to enter this user during the web installation process (at step 6, in the Root user and Root password fields).
CREATE USER '<USER>'@'<CENTRAL_SERVER_IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO '<USER>'@'<CENTRAL_SERVER_IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;
Example:
CREATE USER 'dbadmin'@'<CENTRAL_SERVER_IP>' IDENTIFIED BY '<DBADMIN_PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO 'dbadmin'@'<CENTRAL_SERVER_IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;
Replace <CENTRAL_SERVER_IP> with the Centreon Central IP address that will connect to the database server.
Replace <USER> and <PASSWORD> by the user's credentials.
This user will only be used for the installation process: once the web installation is complete you can delete this user using:
DROP USER '<USER>'@'<CENTRAL_SERVER_IP>';
Example:
DROP USER 'dbadmin'@'<CENTRAL_SERVER_IP>';
- The package centreon-database installs an optimized MariaDB configuration to be used with Centreon.
If this package is not installed, system limitation LimitNOFILE should be at least set to 32000 using a dedicated configuration file, example:
$ cat /etc/systemd/system/mariadb.service.d/centreon.conf
[Service]
LimitNOFILE=32000
- Same for the MariaDB open_files_limit directive:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
$ cat /etc/my.cnf.d/centreon.cnf
[server]
innodb_file_per_table=1
open_files_limit=32000
$ cat /etc/my.cnf.d/centreon.cnf
[server]
innodb_file_per_table=1
open_files_limit=32000
$ cat /etc/mysql/mariadb.conf.d/80-centreon.cnf
[server]
innodb_file_per_table=1
open_files_limit=32000MariaDB has to listen to all interfaces instead of localhost/127.0.0.1, which is the default value. Edit the following file:
/etc/mysql/mariadb.conf.d/50-server.cnf
Set the bind-address parameter to 0.0.0.0 and restart mariadb.
systemctl restart mariadb
In addition to the directives above, it's strongly recommended to tune the database configuration with the following parameters:
[server]
key_buffer_size = 256M
sort_buffer_size = 32M
join_buffer_size = 4M
thread_cache_size = 64
read_buffer_size = 512K
read_rnd_buffer_size = 256K
max_allowed_packet = 128MOptionally, tune the memory and buffer utilization of the InnoDB engine powered tables. The example below applies to a database server with 8Gb RAM
innodb_buffer_pool_size=1G
Remember to restart MariaDB after a change to configuration.
Step 3: Configuration
Server name
If you want, you can change the server's hostname using the following command:
hostnamectl set-hostname new-server-name
Replace new-server-name by the name you want. Example:
hostnamectl set-hostname central
Set the PHP time zone
You are required to set the PHP time zone.
Replace Europe/Paris by your time zone. You can find the list of supported time zones here.
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
Run the following command as root
:
echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini
After saving the file, restart the PHP-FPM service:
systemctl restart php-fpm
Run the following command as root
:
echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini
After saving the file, restart the PHP-FPM service:
systemctl restart php-fpm
echo "date.timezone = Europe/Paris" >> /etc/php/8.1/mods-available/centreon.ini
The PHP timezone was defined during the installation process by retrieving the timezone configured on the operating system.
After saving the file, restart the PHP8.1-FPM service:
systemctl restart php8.1-fpm
Services startup during system bootup
To make services start automatically during system bootup, run these commands on the central server:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
systemctl enable php-fpm httpd centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
systemctl enable crond
systemctl start crond
systemctl enable php-fpm httpd centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
systemctl enable crond
systemctl start crond
systemctl enable php8.1-fpm apache2 centreon cbd centengine gorgoned centreontrapd snmpd snmptrapd
Then execute the following command (on the central server if you are using a local database, or on your remote database server):
systemctl enable mariadb
systemctl restart mariadb
Secure the database
Since MariaDB 10.5, it is mandatory to secure the database's root access before installing Centreon. If you are using a local database, run the following command on the central server:
mysql_secure_installation
- Answer yes to all questions except "Disallow root login remotely?".
- It is mandatory to set a password for the root user of the database. You will need this password during the web installation.
For more information, please see the official MariaDB documentation.
Step 4: Web installation
- Start the Apache server with the following command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
systemctl start httpd
systemctl start httpd
systemctl start apache2
- To complete the installation, follow the web installation procedure.