Update a Centreon 24.04 platform
This chapter describes how to update your Centreon 24.04 platform (i.e. switch from version 24.04.x to version 24.04.y).
Perform a backup
Make sure that you have fully backed up your environment for the following servers:
- central server,
- database server.
Update the Centreon central server
Update the Centreon solution
Make sure all users are logged out from the Centreon web interface before starting the update procedure.
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11 & 12
Clean the cache:
dnf clean all --enablerepo=*
Then upgrade all the components with the following command:
dnf update centreon\*
Clean the cache:
dnf clean all --enablerepo=*
Then upgrade all the components with the following command:
dnf update centreon\*
Clean the cache:
apt clean
apt update
Then upgrade all the components with the following command:
apt install --only-upgrade centreon*
Now you need to finalize the update:
- Using the wizard
- Using a dedicated API endpoint
Log on to the Centreon web interface to continue the update process. Click Next:
Click Next:
The release notes describe the main changes. Click Next:
This process performs the various upgrades. Click Next:
Your Centreon server is now up to date. Click Finish to access the login page:
If the Centreon BAM module is installed, refer to the update procedure.
Deploy the central's configuration from the Centreon web UI by following this procedure.
Log on to the central server through your terminal to continue the update process.
You need an authentication token to reach the API endpoint. Perform the following procedure to get a token.
In our case, we have the configuration described below (you need to adapt the procedure to your configuration).
- address: 10.25.XX.XX
- port: 80
- version: 24.04
- login: Admin
- password: xxxxx
Enter the following request:
curl --location --request POST '10.25.XX.XX:80/centreon/api/v24.04/login' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"security": {
"credentials": {
"login": "Admin",
"password": "xxxxx"
}
}
}'This is how the result should look:
{"contact":{"id":1,"name":"Admin Centreon","alias":"admin","email":"admin@localhost","is_admin":true},"security":{"token":"hwwE7w/ukiiMce2lwhNi2mcFxLNYPhB9bYSKVP3xeTRUeN8FuGQms3RhpLreDX/S"}}
Retrieve the token number to use it in the next request.
Then enter this request:
curl --location --request PATCH 'http://10.25.XX.XX:80/centreon/api/latest/platform/updates' \
--header 'X-AUTH-TOKEN: hwwE7w/ukiiMce2lwhNi2mcFxLNYPhB9bYSKVP3xeTRUeN8FuGQms3RhpLreDX/S' \
--header 'Content-Type: application/json' \
--data '{
"components": [
{
"name": "centreon-web"
}
]
}'This request does not return any result. To check if the update has been successfully applied, read the version number displayed on the Centreon web interface login page.
Finally, restart Broker, Engine and Gorgone on the central server by running this command:
systemctl restart cbd centengine gorgoned
Update extensions
From Administration > Extensions > Manager, update all extensions, starting with the following:
- License Manager,
- Monitoring Connector Manager,
- Auto Discovery.
Then you can update all other commercial extensions.
Update the Remote Servers
This procedure is the same as to update a Centreon central server.
At the end of the update, the configuration should be deployed from the central server.
Update the Pollers
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11 & 12
Clean the cache:
dnf clean all --enablerepo=*
Then upgrade all the components with the following command:
dnf update centreon\* --exclude=centreon-plugin*
Clean the cache:
dnf clean all --enablerepo=*
Then upgrade all the components with the following command:
dnf update centreon\* --exclude=centreon-plugin*
Clean the cache:
apt clean
apt updateThen upgrade all the components with the following command:
apt-get update && apt-mark hold centreon-pack* && apt-mark hold centreon-plugin* && apt-get install --only-upgrade 'centreon*'
Accept the new GPG keys from the repositories as needed.
Deploy the Poller's configuration from the Centreon web UI by following this procedure, and choose the Restart method for the Engine process.
Finally, restart the Gorgone service if it is used on the Poller:
systemctl restart centengine gorgoned
Run the following command:
- Alma / RHEL / Oracle Linux 8
- Alma / RHEL / Oracle Linux 9
- Debian 11 & 12
Nothing to do for this OS.
Nothing to do for this OS.
apt-mark unhold centreon-pack* && apt-mark unhold centreon-plugin*
Unattended update
You can perform an unattended update of your platform using the unattended.sh script.
- Download the script using the following command:
curl -L https://download.centreon.com/24.04/unattended.sh -O /tmp/unattended
- Run the script:
- For a central server:
bash unattended.sh update -t central -v 24.04 -r stable -s -p<my_admin_password> -l DEBUG 2>&1 |tee -a /tmp/unattended-$(date +"%m-%d-%Y-%H%M%S").log
- For a remote server:
bash unattended.sh update -t central -v 24.04 -r stable -s -p<my_admin_password> -l DEBUG 2>&1 |tee -a /tmp/unattended-$(date +"%m-%d-%Y-%H%M%S").log
- For a poller:
bash unattended.sh update -t poller -v 24.04 -r stable -l DEBUG 2>&1 |tee -a /tmp/unattended-$(date +"%m-%d-%Y-%H%M%S").log