Upgrade from Centreon 20.10
This chapter describes how to upgrade your Centreon platform from version 20.10 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
Warning, following the correction of a problem relating to the database schema, it will be necessary to stop the insertion of the data collected into the database during the update. These will be stored in temporary files and then installed at the end of the update process.
Perform a backupβ
Be sure that you have fully backed up your environment for the following servers:
- Central server
- Database server
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.
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 https://yum.centreon.com/standard/21.04/el7/stable/noarch/RPMS/centreon-release-21.04-6.el7.centos.noarch.rpm
Upgrade PHPβ
Centreon 21.04 use PHP in version 7.3.
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
You need to change the PHP stream from version 7.2 to 7.3 by executing the following commands and answering y to confirm:
dnf module reset php
dnf module install php:7.3
PHP will be updated with Centreon automatically.
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.
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
Execute the following commands:
systemctl enable php-fpm
systemctl restart php-fpm
The PHP timezone should be set. Run the command:
echo "date.timezone = Europe/Paris" >> /etc/opt/rh/rh-php73/php.d/50-centreon.ini
Replace Europe/Paris by your time zone. You can find the list of supported time zones here.
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β
- RHEL / CentOS / Oracle Linux 8
- CentOS 7
Before starting the web upgrade process, reload the Apache server with the following command:
systemctl reload httpd
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:
Click on Next:
The release notes describe the main changes. Click on Next:
This process performs the various upgrades. Click on Next:
Your Centreon server is now up to date. Click on Finish to access the login page:
If the Centreon BAM module is installed, refer to the upgrade procedure.
Post-upgrade actionsβ
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 the MariaDB serverβ
The MariaDB components can now be upgraded.
Refer to the official MariaDB documentation to know more about this process:
https://mariadb.com/kb/en/upgrading-between-major-mariadb-versions/
Update the Centreon repositoryβ
This step is required ONLY when your environment features an architecture with a dedicated remote DBMS. If your environment features Centreon Central and MariaDB together on the same server, you SHOULD simply skip this step.
Run the following command on the dedicated DBMS server:
yum install -y https://yum.centreon.com/standard/21.04/el7/stable/noarch/RPMS/centreon-release-21.04-6.el7.centos.noarch.rpm
Upgrading MariaDBβ
You have to uninstall then reinstall MariaDB to upgrade between major versions (i.e. to switch from version 10.3 to version 10.5).
Stop the mariadb service:
systemctl stop mariadb
Uninstall the current version:
rpm --erase --nodeps --verbose MariaDB-server MariaDB-client MariaDB-shared MariaDB-compat MariaDB-common
Install version 10.5:
yum install MariaDB-server-10.5\* MariaDB-client-10.5\* MariaDB-shared-10.5\* MariaDB-compat-10.5\* MariaDB-common-10.5\*
Start the mariadb service:
systemctl start mariadb
Launch the MariaDB upgrade process:
mysql_upgrade
If your database is password-protected, enter:
mysql_upgrade -u <database_admin_user> -p
Example: if your database_admin_user is
root
, enter:mysql_upgrade -u root -p
Refer to the official documentation for more information or 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 https://yum.centreon.com/standard/21.04/el7/stable/noarch/RPMS/centreon-release-21.04-6.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.
Start and enable gorgoned:
systemctl start gorgoned
systemctl enable gorgoned
Restart centengine:
systemctl restart centengine