Upgrade from Centreon 21.04
This chapter describes how to upgrade your Centreon platform from version 21.04 to version 22.04.
When you upgrade your central server, make sure you also upgrade all your remote servers and your pollers. All servers in your architecture must have the same version of Centreon. In addition, all servers must use the same version of the BBDO protocol.
If you want to migrate your Centreon server to Oracle Linux / RHEL 8 you need to follow the migration procedure
Prerequisitesβ
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β
Update the Centreon repositoryβ
Run the following commands:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
dnf install -y https://yum.centreon.com/standard/22.04/el8/stable/noarch/RPMS/centreon-release-22.04-3.el8.noarch.rpm
yum install -y https://yum.centreon.com/standard/22.04/el7/stable/noarch/RPMS/centreon-release-22.04-3.el7.centos.noarch.rpm
If you are using a Business edition, install the correct Business repository too. You can find it on the support portal.
Install the MariaDB repositoryβ
- Alma / RHEL / Oracle Linux 8
- CentOS 7
cd /tmp
curl -JO https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
bash ./mariadb_repo_setup
sed -ri 's/10\.[0-9]+/10.5/' /etc/yum.repos.d/mariadb.repo
rm -f ./mariadb_repo_setup
cd /tmp
curl -JO https://downloads.mariadb.com/MariaDB/mariadb_repo_setup
bash ./mariadb_repo_setup
sed -ri 's/10\.[0-9]+/10.5/' /etc/yum.repos.d/mariadb.repo
rm -f ./mariadb_repo_setup
Upgrade PHPβ
Centreon 22.04 uses PHP in version 8.0.
- RHEL 8
- Oracle Linux 8
- CentOS 7
First, you need to install the remi repository:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
sudo subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms
Then, you need to change the PHP stream from version 7.3 to 8.0 by executing the following commands and answering y to confirm:
dnf module reset php
dnf module install php:remi-8.0
First, you need to install the remi repository:
dnf install -y dnf-plugins-core
dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf install -y https://rpms.remirepo.net/enterprise/remi-release-8.rpm
Then, you need to change the PHP stream from version 7.3 to 8.0 by executing the following commands and answering y to confirm:
dnf module reset php
dnf module install php:remi-8.0
First, you need to install the remi repository:
yum install -y yum-utils
yum install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
Then, you need to enable the php 8.0 repository
yum-config-manager --enable remi-php80
Upgrade the Centreon solutionβ
Make sure all users are logged out from the Centreon web interface before starting the upgrade procedure.
If you have installed Business extensions, update the Business repository to version 22.04. Visit the support portal to get its address.
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:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
yum update centreon\* php-pecl-gnupg
yum update centreon\* php-pecl-gnupg
Accept new GPG keys from the repositories as needed.
- Alma / RHEL / 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/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-php73-php-fpm
systemctl disable rh-php73-php-fpm
systemctl enable php-fpm
systemctl start php-fpm
Or, if you have PHP 7.4:
systemctl stop rh-php74-php-fpm
systemctl disable rh-php74-php-fpm
systemctl enable php-fpm
systemctl start php-fpm
Update your customized Apache configurationβ
This section only applies if you customized your Apache configuration. When upgrading your platform, the Apache configuration file is not upgraded automatically: the new configuration file brought by the rpm does not replace tha old file. You must copy the changes manually to your customized configuration file.
Run a diff between the old and the new Apache configuration files:
diff -u /opt/rh/httpd24/root/etc/httpd/conf.d/10-centreon.conf /opt/rh/httpd24/root/etc/httpd/conf.d/10-centreon.conf.rpmnew
- 10-centreon.conf (post upgrade): this file contains the custom configuration. It does not contain anthing new brought by the upgrade, e.g. the authentication string in the LocationMatch directive
- 10-centreon.conf.rpmnew (post upgrade): this file is provided by the rpm; it contains the authentication string, but does not contain any custom configuration.
For each difference between the files, assess whether you should copy it from 10-centreon.conf.rpmnew to 10-centreon.conf.
In particular, make sure your customized Apache configuration contains the following directive (with authentication).
<LocationMatch ^\${base_uri}/?(authentication|api/(latest|beta|v[0-9]+|v[0-9]+\.[0-9]+))/.*$>
ProxyPassMatch "fcgi://127.0.0.1:9042${install_dir}/api/index.php/$1"
</LocationMatch>
If you were using OpenID or the Web SSO authentication, some extra configuration steps are required. Refer to the release note.
Finalizing the upgradeβ
Before starting the web upgrade process, reload the Apache server with the following command:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
systemctl reload php-fpm httpd
systemctl reload php-fpm 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β
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.Set the following rights on Broker and Engine files:
chown apache:apache /etc/centreon-engine/*
chown apache:apache /etc/centreon-broker/*
su - apache -s /bin/bash -c umaskRestart the processes:
systemctl restart cbd centengine centreontrapd gorgoned
Upgrade the Remote Serversβ
This procedure is the same as for upgrading a Centreon Central server.
At the end of the update, configuration should be deployed from the Central server.
Upgrade the Pollersβ
Update the Centreon repositoryβ
Run the following command:
- Alma / RHEL / Oracle Linux 8
- CentOS 7
dnf install -y https://yum.centreon.com/standard/22.04/el8/stable/noarch/RPMS/centreon-release-22.04-3.el8.noarch.rpm
yum install -y https://yum.centreon.com/standard/22.04/el7/stable/noarch/RPMS/centreon-release-22.04-3.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