Using packages
Centreon provides RPM packages for its products through the Centreon Open Sources 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.
After installing your server, consider updating your operating system via the command:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf update
yum update
Accept all GPG keys and consider rebooting your server if a kernel update is proposed.
Pre-installation stepsβ
Disable SELinuxβ
SELinux should be disabled. To do this, you have to edit the file /etc/selinux/config and replace enforcing by disabled, or by running the following command:
sed -i s/^SELINUX=.*$/SELINUX=disabled/ /etc/selinux/config
Reboot your operating system to apply the change.
After system startup, perform a quick check of the SELinux status:
getenforce
You should have this result:
Disabled
Configure or disable firewallβ
Add firewall rules or disable the firewall by running the following commands:
systemctl stop firewalld
systemctl disable firewalld
You can find instructions here to configure firewalld.
Install the repositoriesβ
- RHEL 8
- CentOS 8
- Oracle Linux 8
- CentOS 7
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
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
For CentOS 8.2 use:
dnf -y install dnf-plugins-core epel-release
dnf config-manager --set-enabled PowerTools
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 -y install dnf-plugins-core oracle-epel-release-el8
dnf config-manager --set-enabled ol8_codeready_builder
Redhat Software Collections repositoryβ
To install Centreon you will need to set up the official Software Collections repository supported by Redhat.
Software collections are required for installing PHP 7 and associated libraries.
Install the Software Collections repository using this command:
yum install -y centos-release-scl
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:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y https://yum.centreon.com/standard/20.10/el8/stable/noarch/RPMS/centreon-release-20.10-4.el8.noarch.rpm
yum install -y https://yum.centreon.com/standard/20.10/el7/stable/noarch/RPMS/centreon-release-20.10-4.el7.centos.noarch.rpm
Installationβ
This section describes how to install a Centreon Central server.
It's possible to install this server with a local database on the server, or a remote database on a dedicated server.
With a local databaseβ
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb
yum install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb
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:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon-base-config-centreon-engine centreon-widget\*
yum install -y centreon-base-config-centreon-engine centreon-widget\*
Then run the following commands on the dedicated server:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
yum install -y centreon-database
systemctl daemon-reload
systemctl restart mariadb
Then create a distant user with root privileges needed for Centreon installation:
CREATE USER 'centreon'@'<IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO 'centreon'@'<IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;
Replace <IP> with the Centreon Central IP address that will connect to the database server.
Use the correct <PASSWORD> for user 'centreon'.
Once the installation is complete you can delete this user using:
DROP USER 'centreon'@'<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=32000Same 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 = 128MOptionnaly, 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.
Configurationβ
Set the PHP time zoneβ
You are required to set the PHP time zone. Run the command:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
echo "date.timezone = Europe/Paris" >> /etc/php.d/50-centreon.ini
echo "date.timezone = Europe/Paris" >> /etc/opt/rh/rh-php72/php.d/50-centreon.ini
Change Europe/Paris to your time zone. You can find the supported list of time zone here.
After saving the file, please do not forget to restart the PHP-FPM service:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
systemctl restart php-fpm
systemctl restart rh-php72-php-fpm
Services startup during system bootupβ
To make services start automatically during system bootup, run these commands on the central server:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
systemctl enable php-fpm httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
systemctl enable rh-php72-php-fpm httpd24-httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
If the database is on a dedicated server, remember to enable mariadb service on it.
Web installationβ
Before starting the web installation process, start the Apache server with the following command:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
systemctl start httpd
systemctl start httpd24-httpd
Conclude installation by performing web installation steps.