Skip to main content
Version: 20.10

Using Centreon ISO

Installing a Remote Server is similar to installing a Centreon Central Server.

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:

image

Step 2: Choose a language

Choose the language for the installation process and click on Continue:

image

Step 3: Select the component

Click on the Installation Type menu:

image

You have different options to choose from:

image

  • 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:

image

Select the hard disk drive and the I will configure partitioning option. Then click on Done:

image

Using the + button, create your own partitioning file system following the instructions in prerequisites chapter. Then click on Done:

image

It is recommended to use LVM as the default partitioning scheme.

A confirmation window appears. Click on Accept Changes to validate the partitioning:

image

Configure the timezone

Click on the Date & Time menu:

image

Select the time zone and then click the gear button to configure the NTP server:

image

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:

image

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:

image

Enable all network interfaces by clicking the button in the top right from off to on. Then click on Done:

image

Begin the installation

Once configuration is complete, click on Begin Installation:

image

Click on Root Password:

image

Define and confirm the root user password. Click on Done:

image

Wait for the installation process to finish. You can also use this time to add additional users to the system if you desire.

image

When the installation is complete, click on Reboot:

image

Update the system

Connect to your server using a terminal, and execute the command:

yum update

Accept all GPG keys if you are prompted

Then restart your server with the following command:

reboot

Services startup during system bootup

To make services start automatically during system bootup, run these commands on the central server:

systemctl enable rh-php72-php-fpm httpd24-httpd mariadb centreon cbd centengine gorgoned snmptrapd centreontrapd snmpd

Web installation

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>

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 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

  1. Entering your password:

    192.168.0.1: please enter your password:
  2. 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
    1
  3. Then 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)y
  4. 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:
    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]:
  5. 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 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 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