MAP Legacy end of life
MAP Legacy is no longer available. Starting from version 24.10, you have to use MAP.
This topic describes what to do:
- if you were still using MAP Legacy and want to upgrade to Centreon 24.10 without losing any data.
- if you were still using MAP Legacy and have already upgraded to Centreon 24.10, and want to switch to MAP without losing any data.
- if you had already migrated from MAP Legacy to MAP in an earlier version (then MAP Legacy files need to be removed).
If you were still using MAP Legacy, it is likely that you have never installed MAP before. To know whether MAP is installed on your platform, run the following command:
rpm -q centreon-map-engine
If you have installed MAP at some point in the past, then switched back to MAP Legacy, be aware that switching from MAP Legacy to MAP will delete all contents you may have created in MAP when you first installed it.
I was still using MAP Legacy and I haven't upgraded to Centreon 24.10 yet
If you have not upgraded to Centreon 24.10 yet, follow these steps:
- Make a backup of your MAP legacy data: backup all files in /etc/centreon-studio and make a dump of the MAP database.
- Upgrade your Centreon platform to version 24.10.
- If you have never done it in the past, install MAP. If you have installed MAP in the past, upgrade it to version 24.10.
- Upgrade MAP legacy to version 24.10.
- Switch from MAP Legacy to MAP in your current version. This includes activating the new MAP module and importing your legacy maps into MAP.
- Uninstall MAP Legacy from your Centreon platform.
I was still using MAP Legacy and I have already upgraded my platform and MAP legacy and MAP to Centreon 24.10
- Make a backup of your MAP legacy data: backup all files in /etc/centreon-studio and make a dump of the MAP database.
- Switch from MAP Legacy to MAP. This includes activating the new MAP module and importing your legacy maps into MAP.
- Uninstall MAP Legacy from your Centreon platform.
I wasn't using MAP Legacy anymore but it was still installed on my platform
If you had already migrated to MAP in an earlier version and weren't using MAP Legacy anymore, uninstall MAP Legacy from your Centreon 24.10 platform. This is because some legacy files are still present and need to be removed to avoid all problems when upgrading later.
How to fully uninstall MAP Legacy
It is mandatory to unistall MAP Legacy from your Centreon 24.10 platform, otherwise you may encounter issues when upgrading to later versions.
Remove the legacy package
Remove the centreon-map-server package from the server where MAP Legacy was installed:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 12
dnf remove centreon-map-server
dnf remove centreon-map-server
apt remove centreon-map-server
Optional procedures
These cleaning procedures will allow you to work in an optimal environment. Make sure you have made a backup of your data.
-
Remove the legacy log files. (If you do not know where to find the log files, look in
/etc/centreon-studio/map-log.xml
. By default, the path is/var/log/centreon-map/centreon-map.log
.)rm /var/log/centreon-map/centreon-map.log
-
Remove the legacy configuration files from the server where MAP Legacy was installed:
rm -rf /etc/centreon-studio
-
Remove the database that was used by MAP Legacy:
-
Retrieve the credentials to connect to the database from this file
/etc/centreon-studio/studio-database.properties
. -
Enter this command to remove the database:
mysql --host=$DB_HOST --port=$DB_PORT --user=$DB_USER --password $DB_NAME "DROP DATABASE centreon_studio;"
-
-
If you have reused your MAP legacy server to install MAP, remove the images that were stored on the server during the migration process:
rm -fr /usr/share/centreon/www/img/media/