Edit

Upgrade from Centreon 20.04

This chapter describes how to upgrade your Centreon platform from version 20.04 to version 21.04.

If you want to migrate your Centreon server to CentOS / Oracle Linux / RHEL 8 you need to follow the migration procedure

To perform this procedure, your MariaDB version must be >= 10.3.22. If not, please follow before the MariaDB update chapter

Perform a backup

Be sure that you have fully backed up your environment for the following servers:

  • Central server
  • Database server

Upgrade the Centreon Central server

Since 21.04, Centreon uses MariaDB 10.5.

This upgrade process will only upgrade Centreon components first.

MariaDB will be upgraded afterwards.

Update the Centreon repository

Run the following commands:

yum install -y http://yum.centreon.com/standard/21.04/el7/stable/noarch/RPMS/centreon-release-21.04-4.el7.centos.noarch.rpm

Upgrade the Centreon solution

Stop the Centreon Broker process:

systemctl stop cbd

Delete existing retention files:

rm /var/lib/centreon-broker/* -f

Clean yum cache:

yum clean all --enablerepo=*

Then upgrade all the components with the following command:

yum update centreon\*

Accept new GPG keys from the repositories as needed.

The PHP timezone should be set. Run the command:

echo "date.timezone = Europe/Paris" >> /etc/opt/rh/rh-php73/php.d/50-centreon.ini

Execute the following commands:

systemctl stop rh-php72-php-fpm
systemctl disable rh-php72-php-fpm
systemctl enable rh-php73-php-fpm
systemctl start rh-php73-php-fpm

Finalizing the upgrade

Before starting the web upgrade process, reload the Apache server with the following command:

systemctl reload httpd24-httpd

Then log on to the Centreon web interface to continue the upgrade process:

Click on Next:

image

Click on Next:

image

The release notes describe the main changes. Click on Next:

image

This process performs the various upgrades. Click on Next:

image

Your Centreon server is now up to date. Click on Finish to access the login page:

image

If the Centreon BAM module is installed, refer to the upgrade procedure.

Post-upgrade actions

Restart Centreon processes

Restart the processes:

systemctl restart cbd centengine centreontrapd gorgoned

Upgrade extensions

From Administration > Extensions > Manager, upgrade all extensions, starting with the following:

  • License Manager,
  • Plugin Packs Manager,
  • Auto Discovery.

Then you can upgrade all other commercial extensions.

Upgrade MariaDB server

The MariaDB components can now be upgraded.

Be aware that MariaDB strongly recommends to upgrade the server through each major release. Please refer to the official MariaDB documentation for further information.

You then need to upgrade from 10.3 to 10.4 and from 10.4 to 10.5.

That is why Centreon provides both 10.4 and 10.5 versions on its stable repositories.

Refer to the official MariaDB documentation to know more about this process:

Upgrade from 10.3 to 10.4

Follow those summarized steps to perform the upgrade in the way recommended by MariaDB:

  1. Stop the mariadb service:

    systemctl stop mariadb

  2. Uninstall current 10.3 version:

    rpm --erase --nodeps --verbose MariaDB-server MariaDB-client MariaDB-shared MariaDB-compat MariaDB-common

  3. Install 10.4 version:

    yum install MariaDB-server-10.4\* MariaDB-client-10.4\* MariaDB-shared-10.4\* MariaDB-compat-10.4\* MariaDB-common-10.4\*

  4. Start the mariadb service:

    systemctl start mariadb

  5. Launch the MariaDB upgrade process:

    mysql_upgrade

Refer to the official documentation if errors occur during this last step.

Upgrade from 10.4 to 10.5

Follow those summarized steps to perform the upgrade in the way recommended by MariaDB:

  1. Stop the mariadb service:

    systemctl stop mariadb

  2. Uninstall current 10.4 version:

    rpm --erase --nodeps --verbose MariaDB-server MariaDB-client MariaDB-shared MariaDB-compat MariaDB-common

  3. Install 10.5 version:

    yum install MariaDB-server-10.5\* MariaDB-client-10.5\* MariaDB-shared-10.5\* MariaDB-compat-10.5\* MariaDB-common-10.5\*

  4. Start the mariadb service:

    systemctl start mariadb

  5. Launch the MariaDB upgrade process:

    mysql_upgrade

Refer to the official documentation if errors occur during this last step.

Enable MariaDB on startup

Execute the following command:

systemctl enable mariadb

Upgrade the Remote Servers

This procedure is the same than to upgrade a Centreon Central server.

Upgrade the Pollers

Update the Centreon repository

Run the following command:

yum install -y http://yum.centreon.com/standard/21.04/el7/stable/noarch/RPMS/centreon-release-21.04-4.el7.centos.noarch.rpm

Upgrade the Centreon solution

Clean yum cache:

yum clean all --enablerepo=*

Upgrade all the components with the following command:

yum update centreon\*

Accept new GPG keys from the repositories as needed.

Secure your platform

Don't forget to secure your Centreon platform following our recommendations

← Upgrade from Centreon 20.10Upgrade from Centreon 19.10 →