Using packages
After installating your server, consider updating your operating system via the command:
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
Install the repositoriesβ
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:
yum install -y https://yum.centreon.com/standard/20.04/el7/stable/noarch/RPMS/centreon-release-20.04-1.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
- With a remote database
Run the commands:
yum install -y centreon centreon-database
systemctl daemon-reload
systemctl restart mariadb
If installing database on a dedicated server, this server should also have the prerequired repositories.
Run the following command on the Centreon Remote Server:
yum install -y centreon-base-config-centreon-engine centreon-widget\*
Then run the following commands on the dedicated server:
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 '<USER>'@'<IP>' IDENTIFIED BY '<PASSWORD>';
GRANT ALL PRIVILEGES ON *.* TO '<USER>'@'<IP>' WITH GRANT OPTION;
FLUSH PRIVILEGES;
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=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:
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:
systemctl restart rh-php72-php-fpm
Services startup during system bootupβ
To make services start automatically during system bootup, run these commands on the remote server:
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:
systemctl start httpd24-httpd
Conclude installation by performing web installation steps.
In the step Initialization of the monitoring, only the actions from 6 to 8 must be done.
Enable the Remote Server optionβ
To transform the server into a Remote Server, connect to the server and execute following command:
/usr/share/centreon/bin/centreon -u admin -p centreon -a enableRemote -o CentreonRemoteServer \
-v '<IP_CENTREON_CENTRAL>;<don't check SSL CA on Central>;<HTTP method>;<TCP port>;<don't check SSL CA on Remote>;<no proxy to call Central>'
Replace <IP_CENTREON_CENTRAL> by the IP of the Centreon server as seen by the poller. You can define multiple IP address using a comma as separator.
To use HTTPS, replace <IP_CENTREON_CENTRAL> by https://<IP_CENTREON_CENTRAL>.
To use non default port, replace <IP_CENTREON_CENTRAL> by <IP_CENTREON_CENTRAL>:<PORT>
For the <don't check SSL CA on Central> option, you should put 1 if you intend not to check the SSL CA on the Centreon Central Server whenever HTTPS is enabled, or put 0.
The <HTTP method> option defines how the Centreon Central server can contact the Remote server: HTTP or HTTPS.
The <TCP port> option defines on which TCP port the Centreon Central server can contact the Remote server.
For the <don't check SSL CA on Remote> option, you should put 1 if you intend not to check the SSL CA on the Remote server whenever HTTPS is enabled, or put 0.
For the <no proxy to call Central> option, you should put 1 if you intend not to use an HTTP(S) proxy to contact the Centreon Central server.
For instance:
/usr/share/centreon/bin/centreon -u admin -p centreon -a enableRemote -o CentreonRemoteServer -v '10.1.2.3;1;HTTP;80;1;1'
This command will enable Remote Server mode:
- by limiting menu access,
- by limiting possible actions,
- by allowing the Central to connect to it,
- by pre-registering the server to the Central.
Starting Centreon Remote enable process:
Limiting Menu Access... Success
Limiting Actions... Done
Authorizing Master... Done
Set 'remote' instance type... Done
Notifying Master...
Trying host '10.1.2.3'... Success
Centreon Remote enabling finished.
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