Using packages
Centreon provides RPM and DEB packages for its products through the Centreon Open Source version available free of charge in our repository.
These packages can be installed on Alma/RHEL/Oracle Linux 8 and 9 and on Debian 11.
You must run the installation procedure as a privileged user.
When you run a command, check its output. If you get an error message, stop the procedure and fix the issue.
Prerequisitesβ
After installing your server, update your operating system using the following command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf update
Additional configurationβ
If you intend to use Centreon in French, Spanish, Portuguese or German, install the corresponding packages:
dnf install glibc-langpack-fr
dnf install glibc-langpack-es
dnf install glibc-langpack-pt
dnf install glibc-langpack-de
Use the following command to check which languages are installed on your system:
locale -a
dnf update
Additional configurationβ
If you intend to use Centreon in French, Spanish, Portuguese or German, install the corresponding packages:
dnf install glibc-langpack-fr
dnf install glibc-langpack-es
dnf install glibc-langpack-pt
dnf install glibc-langpack-de
Use the following command to check which languages are installed on your system:
locale -a
apt update && apt upgrade
Accept all GPG keys and reboot your server if a kernel update is proposed.
Step 1: Pre-installationβ
Disable SELinuxβ
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
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
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
SELinux is not installed on Debian 11, continue.
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
Server nameβ
If you want, you can change the server's name using the following command:
hostnamectl set-hostname new-server-name
Replace new-server-name by the name you want. Example:
hostnamectl set-hostname poller1
Install the repositoriesβ
- Alma 8
- RHEL 8
- Oracle Linux 8
- Alma 9
- RHEL 9
- Oracle Linux 9
- Debian 11
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
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
dnf config-manager --set-enabled codeready-builder-for-rhel-8-rhui-rpms
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 install dnf-plugins-core
dnf install -y http://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
dnf config-manager --set-enabled ol9_codeready_builder
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install dnf-plugins-core
dnf install epel-release
dnf config-manager --set-enabled crb
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y http://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms
dnf config-manager --set-enabled codeready-builder-for-rhel-9-rhui-rpms
To install Centreon you will need to install the CodeReady Builder repository.
Run the following commands:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm
dnf config-manager --set-enabled ol9_codeready_builder
dnf install -y epel-release
Install the following dependencies:
apt update && apt install lsb-release ca-certificates apt-transport-https software-properties-common wget gnupg2 curl
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:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/23.04/el8/centreon-23.04.repo
dnf clean all --enablerepo=*
dnf update
dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/23.04/el9/centreon-23.04.repo
dnf clean all --enablerepo=*
dnf update
To install the Centreon repository, execute following command line:
echo "deb https://packages.centreon.com/apt-standard-23.04-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon.list
echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list
Then import the repository key:
wget -O- https://apt-key.centreon.com | gpg --dearmor | tee /etc/apt/trusted.gpg.d/centreon.gpg > /dev/null 2>&1
apt update
Step 2: Installationβ
To install the monitoring engine, run the command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11
dnf install -y centreon-poller
dnf install -y centreon-poller
apt install -y --no-install-recommends centreon-poller
To make services start automatically during system bootup, run the following command:
systemctl enable centreon centengine centreontrapd snmptrapd gorgoned
Passive monitoring services can be started:
systemctl start centreontrapd snmptrapd gorgoned
Restart Centreon Engine:
systemctl restart centengine
Step 3: Register the serverβ
To turn the server into a poller and to register it to the Central server or to a Remote server, execute the following command on the future poller:
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t poller -h <IP_TARGET_NODE> -n <POLLER_NAME>
Example:
/usr/share/centreon/bin/registerServerTopology.sh -u admin -t poller -h 192.168.0.1 -n poller-1
Replace <IP_TARGET_NODE> by the IP of the central server or remote server that you want to link the poller to (IP as seen by the poller)
The <API_ACCOUNT> must have access to the configuration API. You can use the 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:
please enter the password of 192.168.0.1:
Select the IP adress 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: poller-1
type: poller
address: 192.168.0.2
Do you want to register this server with those information ? (y/n)y
You will receive the validation of the Centreon central or the Remote Server server:
2020-10-16T17:19:37+02:00 [INFO]: The CURRENT NODE 'poller': 'poller-1@192.168.0.2' linked to TARGET NODE: '192.168.0.1' has been added
Main error messagesβ
2023-05-20T10:23:15+02:00 [ERROR]: Invalid credentials
Your credentials are incorrect for the <API_ACCOUNT>.
2023-05-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.
2023-05-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.
2023-05-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 23.04.
Step 4: Add the Poller to the configurationβ
Go to Attach a poller to a central or a remote server.
Step 5: Secure your platformβ
Do not forget to secure your Centreon platform following our recommendations.