Using Centreon ISO
Installing a Remote Server is similar to installing a Centreon Central Server.
If you want to install Centreon on CentOS / Oracle Linux / RHEL distribution in version 8, you must use RPM packages
Download the ISO from Centreon's download site.
Step 1: Startup the server
To install Centreon, start up your server from the Centreon ISO image in version el7. Start up with Install CentOS 7:
Step 2: Choose a language
Choose the language for the installation process and click on Continue:
Step 3: Select the component
Click on the Installation Type menu:
You have different options to choose from:
- Central with database: Install Centreon (web interface and database), monitoring engine and Broker.
- Central without database: Install Centreon (web interface only), monitoring engine and Broker.
- Poller: Install poller (monitoring engine and Broker only).
- Database: Install database server (if you have already installed a Central server without a database option).
After selecting your installation type, click Done.
Step 4: System configuration
Configure disk Partitioning
Click on the Installation Destination menu:
Select the hard disk drive and the I will configure partitioning option. Then click on Done:
Using the + button, create your own partitioning file system following the instructions in prerequisites chapter. Then click on Done:
It is recommended to use LVM as the default partitioning scheme.
A confirmation window appears. Click on Accept Changes to validate the partitioning:
Configure the timezone
Click on the Date & Time menu:
Select the time zone and then click the gear button to configure the NTP server:
Type in the name of the NTP server you wish to use and click the plus button. Or, select one from the list of predefined NTP servers then click OK and then Done:
It is okay that you can't enable the “network time” option in this screen. It will become enabled automatically when you configure the network and hostname.
Configure the network
Click on the Network & Hostname menu:
Enable all network interfaces by clicking the button in the top right from off to on. Then click on Done:
Begin the installation
Once configuration is complete, click on Begin Installation:
Click on Root Password:
Define and confirm the root user password. Click on Done:
Wait for the installation process to finish. You can also use this time to add additional users to the system if you desire.
When the installation is complete, click on Reboot:
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 remote1
Update the system
Connect to your server using a terminal, and execute the command:
Accept all GPG keys if you are prompted
Then restart your server with the following command:
Services startup during system bootup
To make services start automatically during system bootup, run these commands on the central server:
systemctl enable rh-php73-php-fpm httpd24-httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd
Secure the database
Since MariaDB 10.5, it is mandatory to secure the database's root access before installing Centreon. Run the following command:
- 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.
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 transform the server into a Remote Server and register it to the Centreon Central server, execute the following command:
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t remote -h <IP_TARGET_NODE> -n <POLLER_NAME>
/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 Remote Server.
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 ?
Then validate the information:
Summary of the informations that will be send:
target server: 192.168.0.1
Pending Registration Server:
Do you want to register this server with those informations ? (y/n)y
Add 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:
<CURRENT_NODE_ADDRESS> : Please enter your password:
<CURRENT_NODE_ADDRESS> : Protocol [http]:
<CURRENT_NODE_ADDRESS> : Port :
<CURRENT_NODE_ADDRESS> : centreon root folder [centreon]:
If you use a proxy, please define credentials:
Are you using a proxy ? (y/n)
enter your proxy Host:
enter your proxy Port :
Are you using a username/password ? (y/n)
enter your 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: 'firstname.lastname@example.org' 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 is invalid. 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 21.04.
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