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.

You must run the installation procedure as a privileged user.

Prerequisites​

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

dnf update

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

If you are installing Centreon on AlmaLinux/RHEL/OracleLinux 8, and you intend to use Centreon in French, Spanish or Portuguese, install the corresponding packages:

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

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

locale -a

Step 1: Pre-installation​

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 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​

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.0 using the following commands:

dnf module reset php
dnf module install php:remi-8.0

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

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​

dnf install -y centreon
systemctl daemon-reload
systemctl restart mariadb

You can now move to Step 3.

With a remote database​

If installing the database on a dedicated server, this server should also have the prerequired repositories.

Run the following command on the Central server:

dnf install -y centreon-central

Then run the following commands on the dedicated server for your database:

dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb

Secure your MariaDB root access by executing the following command:

mysql_secure_installation

It is mandatory to set a password for the root user of the database.

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>'@'<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, example:

$ cat /etc/my.cnf.d/centreon.cnf
[server]
innodb_file_per_table=1
open_files_limit=32000

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 = 128M

Optionally, 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. Run the following command as root:

echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini

Replace Europe/Paris by your time zone. You can find the list of supported time zones here.

After saving the file, restart the PHP-FPM service:

systemctl restart php-fpm

Services startup during system bootup​

To make services start automatically during system bootup, run these commands on the central server:

systemctl enable php-fpm httpd centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd

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

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​

  1. Start the Apache server with the following command:
systemctl start httpd
  1. To complete the installation, follow the web installation steps procedure.