Server

Installation

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:

../_images/reach-api.png

On the 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.

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/18.10/el7/stable/noarch/RPMS/centreon-release-18.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

Configuration

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

Warning

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:

# mysql
> 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:

../_images/server-api-rest1.png

Installation of the Centreon MAP server is complete. If you want to configure the SSL, go to this page: Advanced Centreon MAP Configuration.

Statistics

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

statistics.enabled=true

We collect our data through a service called Mixpanel, specialized in retrieving statistics. You can visit the company website for more details. For information about terms of use, please read this page