Skip to main content
Version: 24.04

Switching from MAP (Legacy) to MAP

This topic describes how to move from Centreon MAP (Legacy) to Centreon MAP by importing your legacy maps into your MAP module.

From Centreon 24.10, MAP Legacy will no longer be available. If you are still using MAP Legacy, you will need to migrate to MAP. See MAP Legacy end of life.

Requirements​

  • Centreon MAP must be installed in your environment. See the MAP installation procedure if needed.

  • Before you start the procedure to import legacy maps into MAP, you need to switch from MAP (Legacy) to MAP by activating the MAP module.

  • In case you want to install MAP on the same server as MAP (Legacy), you need to make sure that free disk space is at least equal to used space. This is because after migration, the new database will coexist with the legacy one.

Importing legacy maps into MAP​

Migration from MAP Legacy to MAP is final: importing your maps from MAP Legacy to MAP must be done only once, from a blank MAP installation. Do not use MAP Legacy again once you have migrated your legacy maps to MAP. If you migrate your maps from MAP Legacy to MAP more than once, any content created in MAP in the meantime will be deleted and there will be no way of retrieving it.

Step 1: Install MAP​

You need first to install Centreon MAP. Go to this page to perform the installation and switch to the MAP Engine server.

Step 2: Update MAP (Legacy)​

For the icons to be displayed properly after you migrate your maps, you need to update your MAP (legacy) by running the following commands:

systemctl stop centreon-map
yum update centreon-map-server
systemctl daemon-reload
systemctl start centreon-map

Step 3: Migrate maps​

  1. If you have custom images on your legacy maps, you need to create a dedicated directory (/usr/share/centreon/www/img/media/) on the MAP Legacy server:

    mkdir -p /usr/share/centreon/www/img/media/
    chown -R centreon-map:centreon-map /usr/share/centreon/
    chmod -R 775 /usr/share/centreon/*

  2. To import your legacy maps into MAP, go to the Monitoring > Map page, then click the Migrate button. The following window appears:

  3. Click Migrate.

  4. When the migration has succeeded, you can close the window.

  5. If you have created a dedicated directory as indicated previously, you need now to copy it to /usr/share/centreon/www/img/media/ on the central server. Assuming you have access rights to the servers involved, enter the following command:

    scp -r /usr/share/centreon/www/img/media/* root@<IP_CENTREON_CENTRAL>:/usr/share/centreon/www/img/media/

Your legacy maps are now displayed on the Map page.

About images​

The migration process has migrated images from MAP Legacy to Centreon MAP. The following example explains how the name of the image file is set after the migration:

  • In MAP Legacy, your image was located in the Medias panel as follows:

    countries > france > hardware > hardware_green.png

  • After the migration, this image will be located in Centreon in Administration > Parameters > Images, as follows:

    countries_france_hardware > hardware_green.png