Centreon MAP requires a valid license key. To purchase one and retrieve the necessary repositories, contact Centreon.
This chapter describes how to install Centreon MAP. The server must be installed on a dedicated machine to allow Centreon MAP to operate with its own database and avoid any potential conflict with the Centreon central server.
Before installation, be sure to review the Prerequisites chapter for system requirements (CPU and memory). Remember to choose the best type of architecture to suit your needs.
Centreon MAP consists of three components:
- Centreon MAP Server, developed in Java, using SpringBoot, Hibernate and CXF
- Centreon MAP Desktop Client, developed in Java, based on Eclipse RCP 4.
The diagram below summarizes the architecture:
Table of network flow
|Map Server||Map server||Centreon central broker||5758||TCP||Get real-time status updates|
|Map Server||Map server||Centreon MariaDB database||3306||TCP||Retrieve configuration and other data from Centreon|
|Map Server||Map server||Map server database||3306||TCP||Store all views and data related to Centreon MAP|
|Web + Desktop||Map server||Centreon central||80/443||HTTP/HTTPS||Authentication & data retrieval|
|Web interface||User||Map server||8080/8443||HTTP/HTTPS||Retrieve views & content|
|Web interface||User||Internet* (Mapbox)||443||HTTPS||Retrieve Mapbox data|
|Desktop client||User||Map server||8080/8443||HTTP/HTTPS||Retrieve and create views & content|
|Desktop client||User||Internet* (Mapbox)||443||HTTPS||Retrieve Mapbox data|
|Desktop client||User||Internet* (p2 repo)||80||HTTP||Retrieve automatic desktop client update|
* With or without a proxy
The required version of Centreon software for compatibility with Centreon MAP is Centreon 20.10
Centreon must be installed using the RPM packages.
Centreon MAP Server
The server requires the license to be available and valid on Centreon's central server. To do this, you must contact the support Centreon support team to get & install your license key.
Hardware requirements for your dedicated Centreon MAP server are as follows:
|Monitored services||< 10 000||< 20 000||< 40 000||> 40 000|
|CPU||2 vCPU ( 3Ghz ) minimum||4 CPU (3GHz) Minimum||4 CPU (3GHz) Minimum||Ask Centreon Support|
|Dedicated Memory||2GB||4GB||8GB||Ask Centreon Support|
|MariaDB data partition||2GB||5GB||10GB||Ask Centreon Support|
To correctly implement the dedicated memory, you have to edit the JAVA_OPTS
parameter in the Centreon Map configurations file
restart the service:
NB: The Xmx value depends on the amount of memory indicated in the above table.
and restart the service:
systemctl restart centreon-map
The space used by Centreon MAP server is directly determined by the number of elements you add into your views. An element is any graphical object in Centreon MAP. Most elements (like hosts, groups, etc.) have children which must be included in the count.
These values are applied after optimization of Centreon MAP tables.
- OS: CentOS 7 / Redhat 7
- DBMS: MariaDB 10.3
- Firewall: Disabled
- SELinux: Disabled
Information required during configuration
- Centreon Web login with admin rights.
Even with a correctly sized server, you should have in mind the best practices & recommandations when creating views so you don't face performance issues.
Centreon MAP Web interface
The web interface requires the license to be available and valid on Centreon's central server. To do this, you must contact the support Centreon support team to get & install your license key.
The Centreon MAP Web interface is compatible with the following web browsers:
- Firefox (latest version)
- Chrome (latest version)
- Safari (latest version).
- Microsoft Edge Chromium
Resolution must be at least 1280 x 768.
Centreon MAP Desktop Client
- 4 GB of RAM minimum, 8 GB advised (mandatory for 10,000 or more services)
- Java 64 bits version 8
- Resolution must be at least 1280 x 768.
- Debian 7,8 or 9
Desktop Client is not compatible with Microsoft Windows Server. * If a version of Java other than 8 is installed, consider installing Java 8 and modifying Centreon-Map4.ini to add the following line
To optimize the desktop client, you have to "give" it more memory than the default value. To do so, modify the Centreon-Map4.ini* file and add the following parameters:
Note: The Xmx value is the maximum memory used by the application (i.e, if your computer has 4 Go RAM, set this value to 3GB maximum (or 75% of the maximum).
Depending on your OS, the file is located in one of this directories:
- WINDOWS: C:[USER][AppdatalocaleCentreon-map4unstableCentreon-Map4.ini
- LINUX: /opt/centreon-map4-desktop-client/Centreon-Map4.ini
Centreon MAP Server machine must access:
- Centreon Central broker, usually on Centreon Central machine, using TCP port 5758
- Centreon Database, usually on Centreon Central machine, using TCP port 3306
- Centreon MAP database, usually on localhost, using TCP port 3306.
All the ports above are default values and can be changed if needed.
- Centreon Web Central, using HTTP port 80 or HTTPS port 443
Centreon MAP Desktop Client machines must access:
- Centreon MAP Server, using HTTP port 8080 or 8443 when HTTPS/TLS is enabled
- Internet with or without proxy.
Ports 8080 and 8443 are recommanded default values, but other configurations are possible.
Centreon Web interface
The Centreon MAP server requires a dedicated user who has access to all resources. Since the password will be stored in human-readable form in a configuration file, you should not use a Centreon admin user account.
Provide this user with access to the Centreon Web real-time API:
Centreon Central server
Create a user in the mysql instance hosting 'centreon' and 'centreon_storage' databases:
mysql CREATE USER 'centreon_map'@'<IP_SERVER_MAP>' IDENTIFIED BY 'centreon_map'; GRANT SELECT ON centreon_storage.* TO 'centreon_map'@'<IP_SERVER_MAP>'; GRANT SELECT, INSERT ON centreon.* TO 'centreon_map'@'<IP_SERVER_MAP>';
The INSERT privilege will only be used during the installation process in order to create new Centreon Broker output. It will be revoked later.
Centreon MAP server
Install Centreon MAP from the Centreon MAP yum repository. It will automatically install java (OpenJDK 11) if needed. You need to have a MySQL/MariaDB database to store Centreon Map data, wether it's on localhost or somewhere else.
If you installed your Centreon Map server from a "fresh CentOS installation" you need to install the Centreon-Release package : :
yum install http://yum.centreon.com/standard/20.10/el7/stable/noarch/RPMS/centreon-release-20.10-2.el7.centos.noarch.rpm
If the URL doesn't work, you can manualy find this package in the folder
Then install Centreon Map server using the following command:
yum install centreon-map-server
Make sure the database that stores Centreon MAP data is optimized (automatically added by the RPM in /etc/my.cnf.d/map.cnf):
max_allowed_packet=20M innodb_log_file_size = 200M
Then, restart MariaDB:
systemctl restart mysql
Execute the Centreon MAP server configuration script. Two modes are available: interactive or automatic.
- interactive (no option/default mode): Several questions will be asked to interactively fill in the installation variables.
- automatic (--automatic or -a): The installation will be done automatically from the values set in
If it's your first installation, we advice you to use the standard mode (interactive) and choose "No" when asked for advanced installation mode:
Before restarting Broker you must export the configuration from the Centreon Web interface.
Restart Centreon Broker on the Central server:
systemctl restart cbd
Remove the INSERT privilege from user centreon_map:
REVOKE INSERT ON centreon.* FROM 'centreon_map'@'<IP_SERVER_MAP>';
Centreon MAP server
Check your configuration:
If configuration is correct, the centreon-map service can be started from the Centreon Map server:
systemctl restart centreon-map
Enable the service to start up automatically on server boot:
systemctl enable centreon-map
Install the Software Collections repository using this command:
yum install -y centos-release-scl
To register your Centreon Map server to the Centreon Central server or a Remote server, execute the following command:
/opt/rh/rh-php72/root/bin/php /usr/share/centreon/bin/registerServerTopology.php -u <API_ACCOUNT> \ -t map -h <IP_TARGET_NODE> -n <SERVER_NAME>
/opt/rh/rh-php72/root/bin/php /usr/share/centreon/bin/registerServerTopology.php -u admin -t map -h 192.168.0.1 -n centreon-map-server
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
- Define if you use a proxy to connect to Centreon central or the Remote Server:
Are you using a proxy ? (y/n)n
If you use a proxy, please define credentials:
Are you using a proxy ? (y/n)y proxy host: myproxy.example.com proxy port: 3128 proxy username (press enter if no username/password are required): myuser please enter the proxy password:
- Select the IP adress:
Found IP on CURRENT NODE: : 192.168.0.2 Which IP do you want to use as CURRENT NODE IP ?1
- 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: centreon-map-server type: map address: 192.168.0.2 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 'map': 'firstname.lastname@example.org' linked to TARGET NODE: '192.168.0.1' has been added
Centreon Map server is now started and enabled, let's install the interface part of the extension.
Web Interface installation
yum install centreon-map-web-client
Centreon > Administration > Extensions and click on the install button:
- License Manager (if not yet installed)
- Map Web Client
You can see a red stripe asking for a license.
Upload the license map.license given by the support team. Refresh the page and the banner must be green with the valid license date.
Click on Back to return to the Extensions page. Now that the module is installed, we will configure it.
Administration > Extensions > Options, and in the Centreon MAP menu
update the Centreon MAP server address field:
Use the real IP address/hostname of your Centreon MAP server.
Using the client
The Centreon MAP Web interface is now available in
Monitoring > MAP.
If the content doesn't display, you may empty your browser cache
You can see to which IP the client is connected.
Centreon MAP Widget
By installing the Web interface, you automatically add the Centreon MAP Widget,
but you need to perform one last task. Go to
Administration > Extensions
and click on the "Install" button on the widget. The result after installed:
The desktop client is currently available only for 64-bit Windows, Mac and Linux platforms (Debian and Ubuntu).
You can find the installers in
Monitoring > Map > Desktop Client or
For performance considerations, we highly recommand to have less than 5, 10 users maximum connected at the same time manipulating views.
On user's computer
The desktop client requires Java 8. You can download and install the latest version of Java from here.
Be sure to download the 64-bit version. Browsers are usually 32-bit and the Oracle website generally proposes 32-bit Java instead of the 64-bit version. If you already have Java installed, use the java -version command to check the architecture. If 64-bit does not appear, the version is 32-bit.
On a Mac platform, note that you must install Oracle JDK instead of the usually-required JRE.
To check the Java version run the command:
You do not need to be the administrator of your computer to perform the installation. All the files are will be installed in your personnal folders.
The default installation folder is
You can install the software at this location without administrator rights but can change the destination to Program files if you have the sufficient rights.
Use the installer to install the software properly and integrate it into the Windows environment. The installer can also be used to uninstall it from the Windows dedicated configuration page.
Download the provided DEB file and run the command from the root directory:
sudo dpkg -i centreon-map4-desktop-client*.deb
Alternatively, you can open the DEB file using the Ubuntu software Center.
You should now be able to run Centreon-Map4.
You will also find it in the list of installed applications.
Once installed, the Desktop Client is automatically kept up to date through an online update system. When it connects to a Centreon MAP server it automatically downloads and installs the latest version compatible with the server. Auto-update requires your computer to have internet access.
Centreon MAP NG
The server is in experimental phase and is subject to evolution.
It is currently only used for visualizing maps. Maps creation and edition still use the server as we know it.
The Centreon MAP NG Server is available on the same repository as the usual server.
To begin, install the server using the following command:
yum install centreon-map-server-ng
And proceed to the configuration with the following command:
The configuration is exactly the same as the usual server, but is stored in the /etc/centreon-map/ folder.
The default listening port is 8081.
If the configuration is correct, the server can be started:
systemctl restart centreon-map-ng
Enable the service to be started automatically at server startup:
systemctl enable centreon-map-ng
The client does not require any other installation than the actual Centreon MAP Web Client.
However, new options are available in the
Administration > Extensions > Options page:
- An input field for the IP address and port of the NG server,
- A "yes/no" toggle to choose whether the new server should be used to display maps.
Monitoring > Map page, new actions allow to launch
synchronizations: - Resources from the production server to the NG
server - Standard maps - Geoviews - ACLs - Images
Synchronization progression can then be followed from this same page.
At each synchronizations, all resources are deleted and imported again.