Migrate your Centreon Central server
If the module centreon-poller-display-central-1.6.x is installed:
Go to the Administration > Extensions > Modules menu and uninstall the centreon-poller-display-central.
Remove the associated package:
yum remove centreon-poller-display-central
If you use the Centreon EMS modules, you must update these repositories. Be sure to contact Centreon support and request new licenses.
Migrate a Poller from Poller Display module to Remote Server
Go to the Administration > Extensions > Modules menu and uninstall the Centreon Poller Display module.
If you installed the module using an RPM package, remove it with the following command:
yum remove centreon-poller-display
> If you use Centreon EMS modules, you must update the repositories. Be sure to
> contact your Centreon support and request new licenses.
Go to Administration > Extensions > Modules menu and install the centreon-license-manager module.
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 <REMOTE_SERVER_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, Kindly fill in the required information to convert your platform into Remote :
<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: 'email@example.com' 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.
Add rights to centreon database user to use LOAD DATA INFILE command:
GRANT FILE on *.* to 'centreon'@'localhost';
On the Centreon Central server, edit all pollers and attach them to the Remote Server using the selection list.
Remember to generate the configuration for your Remote Server.
A Centreon Remote Server is self-administered.
Thus, the configuration of the LDAP directory, users and ACLs are specific to this server and must be configured through the Administration menu.