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.
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.
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:
Stop and disable legacy tomcat service coming from precedent version:
systemctl stop tomcat
systemctl disable tomcat
Update Centreon & Centreon MAP repositories:
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
dnf install https://yum.centreon.com/standard/21.10/el8/stable/noarch/RPMS/centreon-release-21.10-2.el8.noarch.rpm
yum install https://yum.centreon.com/standard/21.10/el7/stable/noarch/RPMS/centreon-release-21.10-2.el7.centos.noarch.rpm
Install Centreon MAP repository, you can find it on the support portal.
Update Centreon MAP server:
yum update centreon-map-server
Enable and start
systemctl enable centreon-map
systemctl start centreon-map
If you want totally clean up legacy Tomcat service, you can just remove Tomcat and move old log file to new log folder:
yum remove tomcat
cp /var/log/centreon-studio/* /var/log/centreon-map/
rm -rf /var/log/centreon-studio
- 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 by going to
Administration > Extensions > Manager
(module & widget parts):
An error message concerning the license is displayed while you don't have a license on the Central server, don't worry Centreon Map still works, you can ask for a new license to the support Team to remove this error message.
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
Map and Desktop client button.
Step 4: MariaDB database
See Upgrading MariaDB.