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
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 Remote 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=32000Remember 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.
During web installation, it is not necessary to install Autodiscovery module.
In the step Initialization of the monitoring, only the actions from 6 to 8 must be done.
Register the serverβ
To register it to the Centreon Central server or a Remote server, execute the following command:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <REMOTE_SERVER_NAME>
Example:
/usr/share/centreon/bin/registerServerTopology.sh -u admin -t remote -h 192.168.0.1 -n remote-1
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <REMOTE_SERVER_NAME>
Example:
/usr/share/centreon/bin/registerServerTopology.sh -u admin -t remote -h 192.168.0.1 -n remote-1
Replace <IP_TARGET_NODE> by the IP of the Centreon server seen by the poller or by the Remote Server if you want to link your server to it.
The <API_ACCOUNT> must have access to configuration API. You can use 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:
192.168.0.1: please enter your password:
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 informations that will be send:
Api Connection:
username: admin
password: ******
target server: 192.168.0.1
Pending Registration Server:
name: remote-1
type: remote
address: 192.168.0.2
Do you want to register this server with those informations ? (y/n)yAdd additional information to enable future communication between your Remote Server and its Central, fill in the required information to convert your platform into a Remote server:
<CURRENT_NODE_ADDRESS> : Please enter your username:
admin
<CURRENT_NODE_ADDRESS> : Please enter your password:
<CURRENT_NODE_ADDRESS> : Protocol [http]:
<CURRENT_NODE_ADDRESS> : Port [80]:
<CURRENT_NODE_ADDRESS> : centreon root folder [centreon]:If you use a proxy, please define credentials:
Are you using a proxy ? (y/n)
y
enter your proxy Host:
myproxy.example.com
enter your proxy Port [3128]:
Are you using a username/password ? (y/n)
y
enter your username:
my_proxy_username
enter your password:
You will receive the validation of the Centreon central server:
2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'remote: 'remote-1@192.168.0.2' has been converted and registered successfully.
Main errors messagesβ
2020-10-20T10:23:15+02:00 [ERROR]: Invalid credentials
Your credentials are incorrect for the <API_ACCOUNT>.
2020-10-20T10:24:59+02:00 [ERROR]: Access Denied.
The <API_ACCOUNT> doesn't have access to configuration API.
Failed connect to 192.168.0.1:444; Connection refused
Unable to access to the API. Please check <IP_TARGET_NODE>, scheme and port.
2020-10-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 not complete or invalide. Use the --root option to define the API URL Path. For example: --root monitoring.
2020-10-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 or equal to 20.10.
Extend local DBMS rightsβ
Finally, add rights to centreon database user to use LOAD DATA INFILE command:
GRANT FILE on *.* to 'centreon'@'localhost';
Add the Remote Server to configurationβ
Go to the Add a Remote Server to configuration.
Secure your platformβ
Don't forget to secure your Centreon platform following our recommendations