Using Centreon ISO
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 a Centreon Poller, 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).
Select Poller and 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 poller1
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:
After the machine has been rebooted, enable the services to allow centengine to be running on startup.
systemctl enable centreon centengine centreontrapd snmptrapd
Passive monitoring services can be started:
systemctl start centreontrapd snmptrapd
Restart Centreon Engine:
systemctl restart centengine
Register the server
To register it to the Centreon Central server or a Remote server, execute the following command:
/usr/share/centreon/bin/registerServerTopology.sh -u <API_ACCOUNT> \
-t poller -h <IP_TARGET_NODE> -n <POLLER_NAME>
/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 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 adress 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
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': 'email@example.com' linked to TARGET NODE: '192.168.0.1' has been added
Main error 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 21.04.
Add the Poller to configuration
Go to the Add a Poller to configuration.
Secure your platform
Don't forget to secure your Centreon platform following our recommendations