Aller au contenu principal
Version: ⭐ 22.04

Upgrade the extension

This chapter describes how to upgrade your Centreon MAP extension. This is done by upgrading the four main components:

  • Centreon MAP server
  • Centreon MAP web interface & its widget
  • Desktop client (automatically updated)
  • MariaDB database.

Prerequisites

Before upgrading Centreon MAP server, we highly recommend performing a MariaDB dump (backup) of your centreon_studio database. This will allow you easily to roll back to the previous state if necessary.

Be sure to read the release notes for an explanation of features, fixes & custom procedures.

When you're upgrading to a new major or minor version (i.e:A.B.x with A or B that changes) you need to contact our Support service to retrieve the new repository.

Update the RPM signing key

For security reasons, the keys used to sign Centreon RPMs are rotated regularly. The last change occurred on October 14, 2021. When upgrading from an older version, you need to go through the key rotation procedure, to remove the old key and install the new one.

Step 1: Centreon MAP server

If you are still running version 4.0.X, you must first install and run the server in version 4.1.X before upgrading to the latest version.

Run the following commands to upgrade your Centreon MAP server:

  1. Update Centreon & Centreon MAP repositories:
dnf install -y https://yum.centreon.com/standard/22.04/el8/stable/noarch/RPMS/centreon-release-22.04-3.el8.noarch.rpm
> Install Centreon MAP repository, you can find it on the
> [support portal](https://support.centreon.com/s/repositories).
  1. Update Centreon MAP server:

    yum update centreon-map-server
  2. Enable and start centreon-map service:

    systemctl enable centreon-map
    systemctl start centreon-map
  3. This point only applies if you customized your centreon-map.conf configuration file. When upgrading your MAP module, the /etc/centreon-studio/centreon-map.conf file is not upgraded automatically: the new configuration file brought by the rpm does not replace the old file. You must copy the changes manually to your customized configuration file.

  • The old configuration file is renamed centreon-map.conf.rpmsave

  • The upgrade installs a new centreon-map.conf file.

    Run a diff between the old and the new configuration files:

    diff -u /etc/centreon-studio/centreon-map.conf /etc/centreon-studio/centreon-map.conf.rpmsave

    For each difference between the files, assess whether you should copy it from centreon-map.conf.rpmsave to centreon-map.conf.

Step 2: Centreon MAP web interface

yum update centreon-map-web-client

Complete the upgrade:

  1. Go to Administration > Extensions > Manager.
  2. Search for Map web client.
  3. Click on the update button (module & widget parts).

Step 3: Centreon MAP desktop client

If the user's computer has an online connection, the desktop client is automatically upgraded to the latest version that corresponds to the server.

Alternatively, the client can be downloaded through the menu Monitoring > Map and Desktop client button.

Step 4 : MariaDB database

  1. Stop the centreon-map service:

    systemctl stop centreon-map
  2. See Upgrading MariaDB.

  3. Si vous avez mis à jour votre plateforme Centreon en version 22.04, le nouveau protocole BBDO v3 est activé. Vous devez éditer le fichier suivant pour que MAP fonctionne correctement : /etc/centreon-studio/studio-config.properties

    broker.pb.message.enabled=true
  4. Start the centreon-map service:

    systemctl start centreon-map