Skip to main content

Using packages

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

These packages have been successfully tested in CentOS 7 and 8 environments.

Due to Red Hat's stance on CentOS 8, we suggest not to use said version for your production environment. Nevertheless, these packages for CentOS 8 are compatible with RHEL 8 and Oracle Linux 8 versions.

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.

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​

Redhat CodeReady Builder repository​

To install Centreon you will need to enable the official CodeReady Builder repository 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

Enable PHP 7.3 using the following command:

dnf module enable php:7.3 -y

Check that PHP 7.3 is activated:

dnf module list php

You should have this result:

Red Hat Enterprise Linux 8 for x86_64 - AppStream (RPMs)
Name Stream Profiles Summary
php 7.2 [d] common [d], devel, minimal PHP scripting language
php 7.3 [e] common [d], devel, minimal PHP scripting language
php 7.4 common [d], devel, minimal PHP scripting language

Hint: [d]efault, [e]nabled, [x]disabled, [i]nstalled

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/21.04/el8/stable/noarch/RPMS/centreon-release-21.04-6.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 centreon-database
systemctl daemon-reload
systemctl restart mariadb

You can now move to Step 3.

With a remote database​

If installing 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-base-config-centreon-engine centreon-widget\*

Then run the following commands on the dedicated server:

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

Secure your MariaDB installation by executing the following command:

mysql_secure_installation

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

Then create a distant user with root privileges needed for Centreon installation:

CREATE USER '<USER>'@'<IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO '<USER>'@'<IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;

Replace <IP> with the Centreon Central IP address that will connect to the database server.

Replace <USER> and <PASSWORD> by user's credentials.

Once the installation is complete you can delete this user using:

DROP USER '<USER>'@'<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 mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd

If the database is on a dedicated server, remember to enable mariadb service on it.

Secure the database​

Since MariaDB 10.5, it is mandatory to secure the database's root access before installing Centreon. Run the following command:

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.