On the 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:
On the Centreon Central server¶
Create a user in the mysql instance hosting ‘centreon’ and ‘centreon_storage’ databases:
> 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.
On the Centreon MAP server¶
Install Centreon MAP from the Centreon MAP yum repository. It will automatically install java and Tomcat if needed. You need to have a MySQL/MariadDB 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/19.04/el7/stable/noarch/RPMS/centreon-release-19.04-1.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 MySQL:
systemctl restart mysql
Install the license file received from Centreon (see prerequisites):
# mv map.license /etc/centreon/license.d/ # chmod 644 /etc/centreon/license.d/map.license # chown root:root /etc/centreon/license.d/map.license
- New license in use (map.license)
Create the /etc/centreon/license.d/ directory and copy the license file you retrieve previously in the folder
# mkdir -p /etc/centreon/license.d/ # chmod 775 /etc/centreon/license.d/ # mv map.license /etc/centreon/license.d/map.license
Execute the Centreon MAP server configuration script:
# cd /etc/centreon-studio/ # ./configure.sh
On the Centreon Central machine¶
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>';
On the Centreon MAP server¶
Check your configuration:
# cd /etc/centreon-studio/ # ./diagnostic.sh
If the configuration is correct, then start Tomcat from the Centreon MAP server:
# systemctl start tomcat
Verifying your installation¶
Once your server is started, you can check if all its APIs are up and running by entering the following URL in your favorite web browser:
If your server is running in http mode: http://<IP_SERVER_MAP>:8080/centreon-studio/docs.
If your server is running in HTTPS mode: https://<IP_SERVER_MAP>:8443/centreon-studio/docs.
You should see the following page:
Installation of the Centreon MAP server is complete. If you want to configure the SSL, go to this page: Advanced Centreon MAP Configuration.
To improve your daily experience as a product user, Centreon urges you to send your Centreon MAP usage statistics to our servers. This information will help us to target our software development more effectively, increase the stability of our products, and anticipate your requirements.
The statistics we collect includes:
The version number of your Centreon MAP server.
The name of your company (written in your license file).
The name of your Centreon MAP platform (also written in your license file).
The number of resources monitored by your Centreon server.
- The number of connections and disconnections on your Centreon MAP platform along with:
- The number of connected users.
- The IP address of the connected users.
By default, this information is sent once an hour to our servers.
You can, at any time, stop sending us your statistics, or change how frequently you send them, by editing the file “/etc/centreon-studio/studio-config.properties”: