From def4ce7cbd0d77326bdefbde826163abead4098b Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 11:09:28 +0200 Subject: [PATCH 01/18] update mbi files for 26.10 --- versioned_docs/version-26.10/reporting/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index a5bd3b1e6a57..043e852d3fe8 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -6,7 +6,7 @@ description: "Install and configure the Centreon MBI reporting server and interf import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import DatabaseRepository from '../installation/_database-repository.mdx'; - + > This page is intended for administrators who will install and configure Centreon MBI. This page presents the software architecture of the **Centreon MBI** extension, then explains how to install it. To do so, five main steps are required: From 763784b7ada09c7141ca9db3d305fd52740ef785 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 11:28:27 +0200 Subject: [PATCH 02/18] update mbi files for 26.10 --- .../version-26.10/reporting/installation.md | 102 +++++++++--------- .../version-26.10/reporting/update.md | 18 ++-- .../version-26.10/reporting/upgrade.md | 14 +-- 3 files changed, 67 insertions(+), 67 deletions(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 043e852d3fe8..882f193f86a7 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -6,7 +6,7 @@ description: "Install and configure the Centreon MBI reporting server and interf import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import DatabaseRepository from '../installation/_database-repository.mdx'; - + > This page is intended for administrators who will install and configure Centreon MBI. This page presents the software architecture of the **Centreon MBI** extension, then explains how to install it. To do so, five main steps are required: @@ -80,9 +80,9 @@ considerations. - + -- Centreon Web 25.10 +- Centreon Web 25ZZ.10 - Check that `date.timezone` is correctly configured in the `/etc/php.d/50-centreon.ini` or `/etc/php.d/20-timezone.ini` file (same as the one returned by the `timedatectl status` command). - Avoid using the following variables in the configuration file `/etc/my.cnf`. They interrupt the @@ -98,9 +98,9 @@ considerations. | apache (existing) | centreonBI | - + -- Centreon Web 25.10 +- Centreon Web 26.10 - Check that `date.timezone` is correctly configured in the `/etc/php.d/50-centreon.ini` or `/etc/php.d/20-timezone.ini` file (same as the one returned by the `timedatectl status` command). - Avoid using the following variables in the configuration file `/etc/my.cnf`. They interrupt the @@ -116,10 +116,10 @@ considerations. | apache (existing) | centreonBI | - + -- Centreon Web 25.10 -- Check that `date.timezone` is correctly configured in the `/etc/php/8.2/mods-available/centreon.ini` or `/etc/php/8.2/mods-available/timezone.ini` file +- Centreon Web 26.10 +- Check that `date.timezone` is correctly configured in the `/etc/php/8.4/mods-available/centreon.ini` or `/etc/php/8.4/mods-available/timezone.ini` file (same as the one returned by the `timedatectl status` command). - Avoid using the following variables in the configuration file `/etc/mysql/mariadb.cnf`. They interrupt the execution of long queries and can stop ETL or report generation jobs: @@ -310,7 +310,7 @@ If you are using MySQL: 1. Perform the following action: - + In the `/etc/my.cnf.d/mysql-server.cnf` file, add: @@ -319,7 +319,7 @@ log_bin_trust_function_creators=1 ``` - + In the `/etc/my.cnf.d/mysql-server.cnf` file, add: @@ -328,7 +328,7 @@ log_bin_trust_function_creators=1 ``` - + In the `/etc/mysql/mysql.cnf` file, add: @@ -379,21 +379,21 @@ The actions listed in this chapter must be performed on the **Centreon Central S 2. Then run the following commands: - + ```shell dnf install centreon-bi-server ``` - + ```shell dnf install centreon-bi-server ``` - + Install **gpg**: @@ -528,7 +528,7 @@ GRANT ALL PRIVILEGES ON centreon_storage.* TO 'centreonbi'@'$BI_ENGINE_IP$'; If you use MariaDB replication for your **monitoring databases**, some views are created during the installation of Centreon MBI. You must exclude them from replication by adding the following line to the **my.cnf** -file of the slave server or mariadb.cnf on Debian 12. +file of the slave server or mariadb.cnf on Debian 13. ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 ``` @@ -538,7 +538,7 @@ Then, create the views manually on the slave server: ```bash mysql centreon < /tmp/view_creation.sql ``` -#### Debian 12 specific configuration +#### Debian 13 specific configuration MariaDB must listen on all interfaces instead of listening on localhost/127.0.0.1 (default value). Edit the following file: ```shell /etc/mysql/mariadb.conf.d/50-server.cnf @@ -554,7 +554,7 @@ systemctl restart mariadb If you use MySQL replication for your **monitoring databases**, some views are created during the installation of Centreon MBI. You must exclude them from replication by adding the following line to the **my.cnf** -file of the slave server or mysql.cnf on Debian 12. +file of the slave server or mysql.cnf on Debian 13. ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 @@ -570,7 +570,7 @@ Then, create the views manually on the slave server: mysql centreon < /tmp/view_creation.sql ``` -#### Debian 12 specific configuration +#### Debian 13 specific configuration MySQL must listen on all interfaces instead of listening on localhost/127.0.0.1 (default value). Edit the following file: @@ -640,27 +640,27 @@ During database installation, note the password for the database's **root** acco 1. Install the standard repository: - + ```shell dnf install -y dnf-plugins-core -dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/25.10/el8/centreon-25.10.repo +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el9/centreon-26.10.repo dnf clean all --enablerepo=* dnf update ``` - + ```shell dnf install -y dnf-plugins-core -dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/25.10/el9/centreon-25.10.repo +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el10/centreon-26.10.repo dnf clean all --enablerepo=* dnf update ``` - + Install the required packages: @@ -671,7 +671,7 @@ apt install lsb-release ca-certificates apt-transport-https software-properties- Install the Centreon repositories: ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-25.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-25.10-stable.list +echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list ``` @@ -694,7 +694,7 @@ apt update #### Install dependencies - + Install the **epel** repository: @@ -709,7 +709,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms ``` - + Install the **epel** repository: @@ -753,7 +753,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms ``` - + Install the **epel** repository: @@ -782,7 +782,7 @@ dnf config-manager --set-enabled 'crb' ``` - + No dependencies need to be installed. @@ -794,21 +794,21 @@ No dependencies need to be installed. - + ```shell dnf install MariaDB-server MariaDB-client ``` - + ```shell dnf install MariaDB-server MariaDB-client ``` - + ```shell apt update @@ -823,10 +823,10 @@ apt install mariadb-server mariadb-client - + ```shell -dnf install https://dev.mysql.com/get/mysql84-community-release-el8-1.noarch.rpm +dnf install https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm dnf config-manager --enable mysql-8.4-lts-community dnf module disable mysql dnf install mysql-community-server @@ -834,7 +834,7 @@ systemctl start mysqld ``` - + ```shell dnf install -y mysql-server mysql @@ -850,7 +850,7 @@ sudo systemctl status mysqld ``` - + ```shell apt update @@ -869,22 +869,22 @@ systemctl restart mysql #### Install the MBI module on the MBI server - + ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-25.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-25.10-stable.list +echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list dnf install centreon-bi-reporting-server ``` - + ```shell dnf install centreon-bi-reporting-server ``` - + ```shell apt update @@ -929,7 +929,7 @@ systemctl start gorgoned && systemctl enable gorgoned - + Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MariaDB service: @@ -964,7 +964,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MariaDB service: @@ -999,7 +999,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) provided in the requirements is present in `/etc/mysql/mariadb.conf.d/`. @@ -1052,7 +1052,7 @@ socket=$PATH_TO_SOCKET$ - + Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MySQL service: @@ -1083,7 +1083,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MySQL service: @@ -1115,7 +1115,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/mysql/mysql.conf.d/`. @@ -1335,7 +1335,7 @@ Avoid scheduled periods for statistical calculations with Centreon MBI ETL and r You can run this cron daily or weekly, depending on the batch execution time and the load generated on the server. - + Restart the cron service: @@ -1344,7 +1344,7 @@ systemctl restart crond ``` - + Restart the cron service: @@ -1381,14 +1381,14 @@ systemctl restart cron 2. Restart **crond**. - + ```shell systemctl restart crond ``` - + ```shell systemctl restart cron @@ -1448,14 +1448,14 @@ Once the data building process is complete, you can reenable the daily calculati 2. Restart the cron service on the reporting server: - + ```shell systemctl restart crond ``` - + ```shell systemctl restart cron diff --git a/versioned_docs/version-26.10/reporting/update.md b/versioned_docs/version-26.10/reporting/update.md index 22a67f32f65f..980c4b65554b 100644 --- a/versioned_docs/version-26.10/reporting/update.md +++ b/versioned_docs/version-26.10/reporting/update.md @@ -18,7 +18,7 @@ Centreon MBI is updated in two steps: 1. Update the package, run the following commands: - + ```shell dnf clean all @@ -26,7 +26,7 @@ dnf update centreon-bi-server ``` - + ```shell dnf clean all @@ -34,7 +34,7 @@ dnf update centreon-bi-server ``` - + ```shell apt clean @@ -65,7 +65,7 @@ systemctl stop gorgoned Then run the following commands: : - + ```shell dnf clean all @@ -73,7 +73,7 @@ dnf update centreon-bi\* ``` - + ```shell dnf clean all @@ -81,7 +81,7 @@ dnf update centreon-bi\* ``` - + ```shell apt clean @@ -94,21 +94,21 @@ apt --only-upgrade install centreon-bi\* You also need to update Centreon Gorgone: - + ```shell dnf update centreon-gorgone\* ``` - + ```shell dnf update centreon-gorgone\* ``` - + ```shell apt --only-upgrade install centreon-gorgone\* diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index d870968993b0..e1f8863e77e6 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -32,7 +32,7 @@ On EL8, for security reasons, the keys used to sign Centreon RPMs are rotated re ## Step 1: Update the repository -When you upgrade from a previous major version to 25.10.x, you first need to update the repository on your Central & Reporting servers. +When you upgrade from a previous major version to 26.10.x, you first need to update the repository on your Central & Reporting servers. You will find the new "Business" repository on the "Repositories" page in your [Centreon Support account](https://support.centreon.com/hc/en-us/categories/10341239833105-Repositories). @@ -41,7 +41,7 @@ You will find the new "Business" repository on the "Repositories" page in your [ 1. Update the package, run the following commands: - + ```shell dnf clean all @@ -49,7 +49,7 @@ dnf update centreon-bi-server ``` - + ```shell dnf clean all @@ -57,7 +57,7 @@ dnf update centreon-bi-server ``` - + ```shell apt clean @@ -111,7 +111,7 @@ Now you can start the upgrade process: 2. Then run the following commands: - + ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm @@ -120,7 +120,7 @@ dnf update centreon-bi\* ``` - + ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm @@ -129,7 +129,7 @@ dnf update centreon-bi\* ``` - + ```shell apt clean From 67276414120bafc3ec565f6e8b756f1bd2e45c4c Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 11:29:15 +0200 Subject: [PATCH 03/18] Update versioned_docs/version-26.10/reporting/installation.md --- versioned_docs/version-26.10/reporting/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 882f193f86a7..a6eb11df293c 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -82,7 +82,7 @@ considerations. -- Centreon Web 25ZZ.10 +- Centreon Web 26.10 - Check that `date.timezone` is correctly configured in the `/etc/php.d/50-centreon.ini` or `/etc/php.d/20-timezone.ini` file (same as the one returned by the `timedatectl status` command). - Avoid using the following variables in the configuration file `/etc/my.cnf`. They interrupt the From 51e8bbc1e9bb383659402f42f27b0d068c8575d4 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 11:47:35 +0200 Subject: [PATCH 04/18] update mbi files for 26.10 --- .../version-26.10/reporting/installation.md | 104 +++++++++--------- .../version-26.10/reporting/update.md | 6 +- .../version-26.10/reporting/upgrade.md | 6 +- 3 files changed, 58 insertions(+), 58 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index fff0fa2f76a7..06cde2f57644 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -79,9 +79,9 @@ performances & d'isolation. Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiques-des-serveurs). - + -- Centreon Web 25.10 +- Centreon Web 26.10 - Vérifiez que `date.timezone` est correctement configurée dans le fichier `/etc/php.d/50-centreon.ini` ou `/etc/php.d/20-timezone.ini` (même que celui retourné par la commande `timedatectl status`) @@ -96,9 +96,9 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu | apache (existant) | centreonBI | - + -- Centreon Web 25.10 +- Centreon Web 26.10 - Vérifiez que `date.timezone` est correctement configurée dans le fichier `/etc/php.d/50-centreon.ini` ou `/etc/php.d/20-timezone.ini` (même que celui retourné par la commande `timedatectl status`) @@ -113,9 +113,9 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu | apache (existant) | centreonBI | - + -- Centreon Web 25.10 +- Centreon Web 26.10 - Vérifiez que `date.timezone` est correctement configurée dans le fichier `/etc/php/8.2/mods-available/centreon.ini` ou `/etc/php/8.2/mods-available/timezone.ini` (même que celui retourné par la commande `timedatectl status`) @@ -310,7 +310,7 @@ Si vous utilisez MySQL : 1. Effectuez l'action suivante : - + Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : @@ -319,7 +319,7 @@ log_bin_trust_function_creators=1 ``` - + Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : @@ -328,7 +328,7 @@ log_bin_trust_function_creators=1 ``` - + Dans le fichier `/etc/mysql/mysql.cnf`, ajoutez: @@ -379,21 +379,21 @@ Les actions listées à cette étape doivent être exécutées **sur le serveur 2. Puis lancez la commande suivante : - + ```shell dnf install centreon-bi-server ``` - + ```shell dnf install centreon-bi-server ``` - + Installez **gpg** : @@ -523,7 +523,7 @@ GRANT ALL PRIVILEGES ON centreon_storage.* TO 'centreonbi'@'$BI_ENGINE_IP$'; -Si vous utilisez la réplication MariaDB pour vos **bases de données de supervision**, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier **my.cnf** du serveur esclave ou mariadb.cnf sur Debian 12. +Si vous utilisez la réplication MariaDB pour vos **bases de données de supervision**, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier **my.cnf** du serveur esclave ou mariadb.cnf sur Debian 13. ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 @@ -538,7 +538,7 @@ Ensuite, créez les vues manuellement sur le serveur esclave : mysql centreon < /tmp/view_creation.sql ``` -#### Configuration spécifique à Debian 12 +#### Configuration spécifique à Debian 13 MariaDB doit écouter sur toutes les interfaces au lieu d'écouter sur localhost/127.0.0.1 (valeur par défaut). Éditez le fichier suivant : @@ -555,7 +555,7 @@ systemctl restart mariadb -Si vous utilisez la réplication MySQL pour vos bases de données de supervision, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier my.cnf du serveur esclave ou mysql.cnf sur Debian 12. +Si vous utilisez la réplication MySQL pour vos bases de données de supervision, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier my.cnf du serveur esclave ou mysql.cnf sur Debian 13. ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 @@ -571,7 +571,7 @@ Ensuite, créez les vues manuellement sur le serveur esclave : mysql centreon < /tmp/view_creation.sql ``` -#### Configuration spécifique à Debian 12 +#### Configuration spécifique à Debian 13 MySQL doit écouter sur toutes les interfaces au lieu d'écouter sur localhost/127.0.0.1 (valeur par défaut). Éditez le fichier suivant :: @@ -639,32 +639,32 @@ Pendant l'installation de la base de données, notez le mot de passe du compte * 1. Installez le dépôt standard : - + ```shell dnf install -y dnf-plugins-core -dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/25.10/el8/centreon-25.10.repo +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el9/centreon-26.10.repo dnf clean all --enablerepo=* dnf update ``` - + ```shell dnf install -y dnf-plugins-core -dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/25.10/el9/centreon-25.10.repo +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el10/centreon-26.10.repo dnf clean all --enablerepo=* dnf update ``` - + Installez les paquets prérequis : ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-25.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-25.10-stable.list +echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list ``` @@ -687,7 +687,7 @@ apt update #### Installer les dépendances - + Installez le dépôt **epel** : @@ -702,7 +702,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms ``` - + Installez le dépôt **epel** : @@ -717,7 +717,7 @@ dnf config-manager --set-enabled ol8_codeready_builder ``` - + Installez le dépôt **epel** : @@ -731,7 +731,7 @@ Activez les dépôts powertools : dnf config-manager --set-enabled 'powertools' ``` - + Installez le dépôt **epel** : @@ -746,7 +746,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms ``` - + Installez le dépôt **epel** : @@ -760,7 +760,7 @@ Activez les dépôts **codeready-builder** : dnf config-manager --set-enabled ol9_codeready_builder ``` - + Installez le dépôt **epel** : @@ -775,7 +775,7 @@ dnf config-manager --set-enabled 'crb' ``` - + Pas de dépendances requises. @@ -787,21 +787,21 @@ Pas de dépendances requises. - + ```shell dnf install MariaDB-server MariaDB-client ``` - + ```shell dnf install MariaDB-server MariaDB-client ``` - + ```shell apt update @@ -815,10 +815,10 @@ apt install mariadb-server mariadb-client - + ```shell -dnf install https://dev.mysql.com/get/mysql84-community-release-el8-1.noarch.rpm +dnf install https://dev.mysql.com/get/mysql84-community-release-el9-1.noarch.rpm dnf config-manager --enable mysql-8.4-lts-community dnf module disable mysql dnf install mysql-community-server @@ -826,7 +826,7 @@ systemctl start mysqld ``` - + ```shell dnf install -y mysql-server mysql @@ -842,7 +842,7 @@ sudo systemctl status mysqld ``` - + ```shell apt update @@ -861,21 +861,21 @@ systemctl restart mysql #### Installer le module MBI sur le serveur MBI - + ```shell dnf install centreon-bi-reporting-server ``` - + ```shell dnf install centreon-bi-reporting-server ``` - + ```shell apt update @@ -920,7 +920,7 @@ systemctl start gorgoned && systemctl enable gorgoned - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : @@ -951,7 +951,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : @@ -962,7 +962,7 @@ systemctl restart mariadb Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/my.cnf` NE fonctionnera PAS. ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-25.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-25.10-stable.list +echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list ``` Si le service MariaDB échoue lors du démarrage, supprimer les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrer à nouveau MariaDB : @@ -978,7 +978,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : @@ -1027,7 +1027,7 @@ socket=$PATH_TO_SOCKET$ - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MySQL : @@ -1058,7 +1058,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MySQL : @@ -1089,7 +1089,7 @@ socket=$PATH_TO_SOCKET$ ``` - + Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/mysql/mysql.conf.d/`. @@ -1329,7 +1329,7 @@ Pour activer la purge automatique des anciennes données, modifiez le fichier cr Vous pouvez exécuter ce cron quotidiennement ou hebdomadairement, en fonction du temps d'exécution du batch et de la charge générée sur le serveur. - + Redémarrez le service cron : @@ -1338,7 +1338,7 @@ systemctl restart crond ``` - + Redémarrez le service cron : @@ -1378,14 +1378,14 @@ Veuillez passer à la section suivante pour continuer l'installation. 2. Redémarrez **crond**. - + ```shell systemctl restart crond ``` - + ```shell systemctl restart cron @@ -1443,7 +1443,7 @@ Sur le serveur de reporting, éditez le fichier **/etc/cron.d/centreon-bi-engine ``` - + Redémarrez le service cron sur le serveur de reporting : @@ -1452,7 +1452,7 @@ systemctl restart crond ``` - + Redémarrez le service cron sur le serveur de reporting : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md index 94c4f2dd862c..b4f19d2c2103 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md @@ -34,7 +34,7 @@ dnf update centreon-bi-server ``` - + ```shell apt clean @@ -80,7 +80,7 @@ dnf update centreon-bi\* ``` - + ```shell apt clean @@ -107,7 +107,7 @@ dnf update centreon-gorgone\* ``` - + ```shell apt --only-upgrade install centreon-gorgone\* diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 713905d795bf..6b303eb5fb1a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -32,7 +32,7 @@ Sous EL8, pour des raisons de sécurité, les clés utilisées pour signer les R ## Étape 1 : Montée de version du paquet -Lors d'une montée de version majeure (ex: 20.10.x à 25.10.x) il faut en premier lieu mettre à jour +Lors d'une montée de version majeure (ex: 20.10.x à 26.10.x) il faut en premier lieu mettre à jour le dépôt contenant les paquets. Vous trouverez ce dépôt depuis votre compte sur notre [platefome de support, à la page **Dépôts**](https://support.centreon.com/hc/fr/categories/10341239833105-D%C3%A9p%C3%B4ts). @@ -58,7 +58,7 @@ dnf update centreon-bi-server ``` - + ```shell apt clean @@ -129,7 +129,7 @@ dnf update centreon-bi\* ``` - + ```shell apt clean From 1e8e887c87e62d7594d747776bb77762ea412971 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 12:05:40 +0200 Subject: [PATCH 05/18] Apply batched suggestions from code review Co-authored-by: emgcentreon --- versioned_docs/version-26.10/reporting/installation.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index a6eb11df293c..1f74e34d9946 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -724,7 +724,7 @@ dnf config-manager --set-enabled ol8_codeready_builder ``` - + Install the **epel** repository: @@ -738,7 +738,7 @@ Enable the **powertools** repository: dnf config-manager --set-enabled 'powertools' ``` - + Install the **epel** repository: @@ -767,7 +767,7 @@ Enable the **codeready-builder** repositories: dnf config-manager --set-enabled ol9_codeready_builder ``` - + Install the **epel** repository: @@ -872,7 +872,6 @@ systemctl restart mysql ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list dnf install centreon-bi-reporting-server ``` @@ -980,7 +979,7 @@ option in `/etc/my.cnf` will NOT work. mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl restart mariadb +echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list ``` If the MariaDB service fails to start, remove the *ib_logfile* files From 319a385660a4e6207533fd47998f1104811ea57e Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 13:44:20 +0200 Subject: [PATCH 06/18] update mbi files for 26.10 --- .../version-26.10/reporting/installation.md | 6 +++--- .../version-26.10/reporting/update.md | 12 ++++++------ .../version-26.10/reporting/upgrade.md | 8 ++++---- .../version-26.10/reporting/installation.md | 12 ++++++------ 4 files changed, 19 insertions(+), 19 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 06cde2f57644..140b869e0f38 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -1329,7 +1329,7 @@ Pour activer la purge automatique des anciennes données, modifiez le fichier cr Vous pouvez exécuter ce cron quotidiennement ou hebdomadairement, en fonction du temps d'exécution du batch et de la charge générée sur le serveur. - + Redémarrez le service cron : @@ -1378,7 +1378,7 @@ Veuillez passer à la section suivante pour continuer l'installation. 2. Redémarrez **crond**. - + ```shell systemctl restart crond @@ -1443,7 +1443,7 @@ Sur le serveur de reporting, éditez le fichier **/etc/cron.d/centreon-bi-engine ``` - + Redémarrez le service cron sur le serveur de reporting : diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md index b4f19d2c2103..e75571aa676e 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md @@ -18,7 +18,7 @@ La mise à jour de Centreon MBI se fait en 2 étapes : 1. Mettre à jour le paquet: se connecter sur le serveur Centreon et exécuter la commande suivante : - + ```shell dnf clean all @@ -26,7 +26,7 @@ dnf update centreon-bi-server ``` - + ```shell dnf clean all @@ -64,7 +64,7 @@ systemctl stop gorgoned Puis mettre à jour les paquets, en exécutant la commande suivante: - + ```shell dnf clean all @@ -72,7 +72,7 @@ dnf update centreon-bi\* ``` - + ```shell dnf clean all @@ -93,14 +93,14 @@ apt --only-upgrade install centreon-bi\* Vous devez également mettre à jour Centreon Gorgone : - + ```shell dnf update centreon-gorgone\* ``` - + ```shell dnf update centreon-gorgone\* diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 6b303eb5fb1a..807f58ff9d5a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -42,7 +42,7 @@ Vous trouverez ce dépôt depuis votre compte sur notre [platefome de support, 1. Mettre à jour le paquet: se connecter sur le serveur Centreon et exécuter la commande suivante : - + ```shell dnf clean all @@ -50,7 +50,7 @@ dnf update centreon-bi-server ``` - + ```shell dnf clean all @@ -111,7 +111,7 @@ Vous pouvez maintenant procéder à la montée de version : 2. Puis mettez à jour les paquets, en exécutant la commande suivante : - + ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm @@ -120,7 +120,7 @@ dnf update centreon-bi\* ``` - + ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index a6eb11df293c..cd646460de90 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -694,7 +694,7 @@ apt update #### Install dependencies - + Install the **epel** repository: @@ -724,7 +724,7 @@ dnf config-manager --set-enabled ol8_codeready_builder ``` - + Install the **epel** repository: @@ -738,7 +738,7 @@ Enable the **powertools** repository: dnf config-manager --set-enabled 'powertools' ``` - + Install the **epel** repository: @@ -1335,7 +1335,7 @@ Avoid scheduled periods for statistical calculations with Centreon MBI ETL and r You can run this cron daily or weekly, depending on the batch execution time and the load generated on the server. - + Restart the cron service: @@ -1381,7 +1381,7 @@ systemctl restart cron 2. Restart **crond**. - + ```shell systemctl restart crond @@ -1448,7 +1448,7 @@ Once the data building process is complete, you can reenable the daily calculati 2. Restart the cron service on the reporting server: - + ```shell systemctl restart crond From 02f5e89badd7161f603c68ec1d9176b752585273 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 14:28:17 +0200 Subject: [PATCH 07/18] update mbi files for 26.10 --- versioned_docs/version-26.10/reporting/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index c47939ee15d4..568517e47551 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -694,7 +694,7 @@ apt update #### Install dependencies - + Install the **epel** repository: From 1461fe71bde5b1cf1ee42e49aed6c11e4ffc51d2 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 10 Sep 2026 16:46:43 +0200 Subject: [PATCH 08/18] Update installation.md --- .../version-26.10/reporting/installation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 140b869e0f38..df4c7a0d28d6 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -117,7 +117,7 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu - Centreon Web 26.10 - Vérifiez que `date.timezone` est correctement configurée dans le fichier - `/etc/php/8.2/mods-available/centreon.ini` ou `/etc/php/8.2/mods-available/timezone.ini` (même que celui retourné par la commande + `/etc/php/8.4/mods-available/centreon.ini` ou `/etc/php/8.4/mods-available/timezone.ini` (même que celui retourné par la commande `timedatectl status`) - Evitez l'utilisation des variables ci dessous dans le fichier de configuration MariaDB `/etc/mysql/mariadb.cnf`. Elles interrompent l'exécution de longues requêtes et peuvent arrêter les jobs d'ETL ou de génération de rapports : From 3c92de45773e5f373555d82871c86ccd94a46623 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Tue, 22 Sep 2026 16:31:24 +0200 Subject: [PATCH 09/18] update OS tabs for 26.10 --- .../version-26.10/reporting/upgrade.md | 21 ------------------- .../version-26.10/reporting/upgrade.md | 21 ------------------- 2 files changed, 42 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 807f58ff9d5a..c74f098bb5e5 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -26,10 +26,6 @@ La montée de version de Centreon MBI se fait en 4 étapes : Voir [Introduction à la montée de version](../upgrade/introduction.md). -### Mettre à jour la clé de signature RPM - -Sous EL8, pour des raisons de sécurité, les clés utilisées pour signer les RPMs Centreon sont changées régulièrement. Le dernier changement a eu lieu le 14 octobre 2021. Lorsque vous mettez Centreon à jour depuis une version plus ancienne, vous devez suivre la [procédure de changement de clé](../security/key-rotation.md#installation-existante), afin de supprimer l'ancienne clé et d'installer la nouvelle. - ## Étape 1 : Montée de version du paquet Lors d'une montée de version majeure (ex: 20.10.x à 26.10.x) il faut en premier lieu mettre à jour @@ -49,14 +45,6 @@ dnf clean all dnf update centreon-bi-server ``` - - - -```shell -dnf clean all -dnf update centreon-bi-server -``` - @@ -113,15 +101,6 @@ Vous pouvez maintenant procéder à la montée de version : -```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -dnf clean all -dnf update centreon-bi\* -``` - - - - ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index e1f8863e77e6..5391fe934ace 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -26,10 +26,6 @@ The upgrade of Centreon MBI consists of four steps: See [Introduction to upgrade](../upgrade/introduction.md). -### Update the RPM signing key - -On EL8, 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](../security/key-rotation.md#existing-installation) to remove the old key and install the new one. - ## Step 1: Update the repository When you upgrade from a previous major version to 26.10.x, you first need to update the repository on your Central & Reporting servers. @@ -48,14 +44,6 @@ dnf clean all dnf update centreon-bi-server ``` - - - -```shell -dnf clean all -dnf update centreon-bi-server -``` - @@ -113,15 +101,6 @@ Now you can start the upgrade process: -```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm -dnf clean all -dnf update centreon-bi\* -``` - - - - ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all From 6fa6e62f0bd5da44b5fd45ea417cc85f510458fc Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Tue, 29 Sep 2026 11:36:04 +0200 Subject: [PATCH 10/18] update mbi files for 26.10 --- .../version-26.10/reporting/installation.md | 6 +++--- .../version-26.10/reporting/migrate.md | 2 +- .../version-26.10/reporting/upgrade.md | 6 +++--- versioned_docs/version-26.10/reporting/installation.md | 6 +++--- versioned_docs/version-26.10/reporting/migrate.md | 2 +- versioned_docs/version-26.10/reporting/upgrade.md | 6 +++--- 6 files changed, 14 insertions(+), 14 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index df4c7a0d28d6..d9fd664a4fe4 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -885,7 +885,7 @@ apt install centreon-bi-reporting-server -Assurez-vous qu'une version de Java 17 (ou 18) est installée. +Assurez-vous qu'une version de Java 25 est installée. - Pour vérifier quelle version de Java est installée, entrez la commande suivante : @@ -893,9 +893,9 @@ Assurez-vous qu'une version de Java 17 (ou 18) est installée. java -version ``` - - Pour une mise à jour de Java en version 17 (ou 18), allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java17). + - Pour une mise à jour de Java en version 25, allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java25). - - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 17 (ou 18) : + - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 25 : ```shell sudo update-alternatives --config java diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/migrate.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/migrate.md index 94e4bc9541ba..d2f158cb2292 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/migrate.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/migrate.md @@ -39,7 +39,7 @@ mysql_upgrade - Si des erreurs sont visibles, notamment sur les tables mysql innodb\_index\_stats, innodb\_table\_stats, gtid\_slave\_pos, cela peut être dû à une incompatibilité entre MySQL/MariaDB 5.5 et - MariaDB 10.11. Dans ce cas, effectuer les actions suivantes: + MariaDB 11.8. Dans ce cas, effectuer les actions suivantes: ```shell service mysql stop diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index c74f098bb5e5..207de1e7e461 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -64,7 +64,7 @@ apt install --only-upgrade centreon-bi-server ### Prérequis de la version Java - > Assurez-vous qu'une version de Java 17 (ou 18) est installée avant de commencer la procédure. + > Assurez-vous qu'une version de Java 25 est installée avant de commencer la procédure. - Pour vérifier quelle version de Java est installée, entrez la commande suivante : @@ -72,9 +72,9 @@ apt install --only-upgrade centreon-bi-server java -version ``` - - Pour une mise à jour de Java en version 17 (ou 18), allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java17). + - Pour une mise à jour de Java en version 25, allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java25). - - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 17 (ou 18) : + - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 25 : ```shell sudo update-alternatives --config java diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 568517e47551..ff684f1a4047 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -893,7 +893,7 @@ apt install centreon-bi-reporting-server -Then, ensure a version of Java 17 (or 18) is installed before you start the procedure. +Then, ensure a version of Java 25 is installed before you start the procedure. - If you need to check the Java version, enter the following command: @@ -901,9 +901,9 @@ Then, ensure a version of Java 17 (or 18) is installed before you start the proc java -version ``` - - If you need to upgrade the Java installation to Java 17 (or 18), go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java17) page. + - If you need to upgrade the Java installation to Java 25, go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java25) page. - - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 17 (or 18) version: + - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 25 version: ```shell sudo update-alternatives --config java diff --git a/versioned_docs/version-26.10/reporting/migrate.md b/versioned_docs/version-26.10/reporting/migrate.md index ea8b43fe0ed0..8104c37509e7 100644 --- a/versioned_docs/version-26.10/reporting/migrate.md +++ b/versioned_docs/version-26.10/reporting/migrate.md @@ -39,7 +39,7 @@ mysql_upgrade - If you see errors, especially on the following tables mysql innodb_index_stats, innodb_table_stats, gtid_slave_pos, it might be caused by an incompatibility between MySQL/MariaDB 5.5 and - MariaDB 10.11. In that case, follow the procedure below: + MariaDB 11.8. In that case, follow the procedure below: ```shell service mysql stop diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index 5391fe934ace..ff4ebd5863f7 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -64,7 +64,7 @@ Update button to update the extension and the widgets. ### Java version requirement - > Ensure a version of Java 17 (or 18) is installed before you start the procedure. + > Ensure a version of Java 25 is installed before you start the procedure. - If you need to check the Java version, enter the following command: @@ -72,9 +72,9 @@ Update button to update the extension and the widgets. java -version ``` - - If you need to upgrade the Java installation to Java 17 (or 18), go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java17) page. + - If you need to upgrade the Java installation to Java 25, go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java25) page. - - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 17 (or 18) version: + - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 25 version: ```shell sudo update-alternatives --config java From 55fd72278a4aaaef8cb42b8b9bff1ac2679464f4 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Thu, 8 Oct 2026 16:19:43 +0200 Subject: [PATCH 11/18] partial implementation of QA feedback --- .../installation/_database-repository.mdx | 2 +- .../version-26.10/reporting/installation.md | 58 ++++++++++++------- .../version-26.10/api/api-tokens.md | 4 +- .../installation/_database-repository.mdx | 2 +- .../version-26.10/reporting/installation.md | 44 ++++++++------ 5 files changed, 65 insertions(+), 45 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/installation/_database-repository.mdx b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/installation/_database-repository.mdx index c62e849147c6..2c506ca8cf54 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/installation/_database-repository.mdx +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/installation/_database-repository.mdx @@ -64,7 +64,7 @@ dnf install -y --setopt=install_weak_deps=False mysql-server ```shell -mysql_apt_config="mysql-apt-config_0.8.34-1_all.deb" +mysql_apt_config="mysql-apt-config_0.8.36-1_all.deb" curl -fJLO "https://dev.mysql.com/get/$mysql_apt_config" echo "mysql-apt-config mysql-apt-config/select-server select mysql-8.4-lts" | debconf-set-selections export DEBIAN_FRONTEND="noninteractive" diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index d9fd664a4fe4..3fe9aa6c939c 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -330,7 +330,7 @@ log_bin_trust_function_creators=1 -Dans le fichier `/etc/mysql/mysql.cnf`, ajoutez: +Créez un fichier dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) et ajoutez : ```shell [mysqld] @@ -555,7 +555,7 @@ systemctl restart mariadb -Si vous utilisez la réplication MySQL pour vos bases de données de supervision, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier my.cnf du serveur esclave ou mysql.cnf sur Debian 13. +Si vous utilisez la réplication MySQL pour vos bases de données de supervision, certaines vues sont créées lors de l'installation de Centreon MBI. Vous devez les exclure de la réplication en ajoutant la ligne suivante dans le fichier my.cnf du serveur esclave. Sur Debian 13, ajoutez-la dans la section **[mysqld]** d'un fichier situé dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`). ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 @@ -573,13 +573,14 @@ mysql centreon < /tmp/view_creation.sql #### Configuration spécifique à Debian 13 -MySQL doit écouter sur toutes les interfaces au lieu d'écouter sur localhost/127.0.0.1 (valeur par défaut). Éditez le fichier suivant :: +MySQL doit écouter sur toutes les interfaces au lieu d'écouter sur localhost/127.0.0.1 (valeur par défaut). Ajoutez les lignes suivantes dans un fichier situé dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) : ```shell -/etc/mysql/mysql.conf.d/mysqld.cnf +[mysqld] +bind-address=0.0.0.0 ``` -Donnez au paramètre **bind-address** la valeur **0.0.0.0** et redémarrez **mysql**. +Puis redémarrez **mysql**. ```shell systemctl restart mysql @@ -664,8 +665,19 @@ dnf update Installez les paquets prérequis : ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list -echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list +apt update && apt install -y lsb-release ca-certificates apt-transport-https wget gnupg2 curl cron +systemctl enable --now cron +``` + +Installez les dépôts Centreon : + +```shell +install -d /etc/apt/keyrings +wget -O /etc/apt/keyrings/centreon.asc https://apt-key.centreon.com + +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee /etc/apt/sources.list.d/centreon-26.10-stable.list +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list +apt update ``` Ensuite, importez la clé du dépôt : @@ -847,7 +859,6 @@ sudo systemctl status mysqld ```shell apt update apt install -y centreon-mysql -# Sélectionner "Use Legacy Authentication Method" systemctl daemon-reload systemctl restart mysql ``` @@ -934,7 +945,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl restart mariadb +systemctl enable mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimer les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrer à nouveau MariaDB : @@ -962,7 +973,10 @@ systemctl restart mariadb Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/my.cnf` NE fonctionnera PAS. ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list +mkdir -p /etc/systemd/system/mariadb.service.d/ +echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf +systemctl daemon-reload +systemctl enable mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimer les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrer à nouveau MariaDB : @@ -1006,7 +1020,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl restart mariadb +systemctl enable mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrez à nouveau MariaDB : @@ -1041,7 +1055,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` Si le service MySQL échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MySQL doit absolument être stoppé) puis redémarrez à nouveau MySQL : @@ -1072,7 +1086,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` Si le service MySQL échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MySQL doit absolument être stoppé) puis redémarrez à nouveau MySQL : @@ -1092,7 +1106,7 @@ socket=$PATH_TO_SOCKET$ Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) -de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/mysql/mysql.conf.d/`. +de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/mysql/conf.d/`. Renommez le fichier en `80-centreon.cnf`: @@ -1100,25 +1114,26 @@ Renommez le fichier en `80-centreon.cnf`: mv centreon.cnf 80-centreon.cnf ``` -MySQL doit écouter toutes les interfaces au lieu de localhost/127.0.0.1, qui est la valeur par défaut. Éditez le fichier suivant : +MySQL doit écouter toutes les interfaces au lieu de localhost/127.0.0.1, qui est la valeur par défaut. Ajoutez les lignes suivantes dans un fichier situé dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) : ```shell -/etc/mysql/mysql.conf.d/mysqld.cnf +[mysqld] +bind-address=0.0.0.0 ``` -Définissez le paramètre **bind-address** à **0.0.0.0** et redémarrez mysql. +Puis redémarrez mysql. ```shell systemctl restart mysql ``` -Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/mysql/mysql.cnf` NE fonctionnera PAS. +Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/my.cnf` NE fonctionnera PAS. ```shell mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` Si le service MySQL échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MySQL doit absolument être stoppé) puis redémarrez à nouveau MySQL : @@ -1128,7 +1143,7 @@ rm -f /var/lib/mysql/ib_logfile* systemctl start mysql ``` -Si vous utilisez un fichier de socket spécifique pour MySQL, modifiez le fichier `/etc/mysql/mysql.cnf` et dans la section [client], ajoutez : +Si vous utilisez un fichier de socket spécifique pour MySQL, modifiez le fichier `/etc/my.cnf` et dans la section [client], ajoutez : ```shell socket=$PATH_TO_SOCKET$ @@ -1234,8 +1249,7 @@ Centreon MBI intègre un ETL qui permet de : données statistiques - Contrôler la rétention des données sur le serveur de reporting - +#### Configuration générale de l'ETL Dans le menu `Rapports > Monitoring Business Intelligence > Options générales > Options de l'ETL`, spécifiez les options suivantes : diff --git a/versioned_docs/version-26.10/api/api-tokens.md b/versioned_docs/version-26.10/api/api-tokens.md index ed97ea2f9580..9daa21ead9d5 100644 --- a/versioned_docs/version-26.10/api/api-tokens.md +++ b/versioned_docs/version-26.10/api/api-tokens.md @@ -4,9 +4,9 @@ title: API tokens description: "Generate and manage API tokens for third-party application access" --- -Using an API token, a third-party application can call the Centreon API to perform actions in Centreon (webhooks). +You need an API Token (a type of [authentication token](./authentication_tokens.md)) to authenticate with the Centreon APIs. To generate one, go to **Administration > Authentication tokens**. -A token is linked to one [Centreon user](../monitoring/basic-objects/contacts.md) and is valid only for a certain period of time. API calls will be executed according to the [rights assigned to this user](../administration/access-control-lists.md#granting-rights-to-a-user). A specific user can have several tokens. +An API token is linked to one [Centreon user](../users/users.md) and is valid only for a certain period of time. API calls will be executed according to the [rights assigned to this user](../users/users.md#user-roles). A specific user can have several tokens. ## Who can create API tokens? diff --git a/versioned_docs/version-26.10/installation/_database-repository.mdx b/versioned_docs/version-26.10/installation/_database-repository.mdx index 3ddc2e1ce6a4..a771c9328f1c 100644 --- a/versioned_docs/version-26.10/installation/_database-repository.mdx +++ b/versioned_docs/version-26.10/installation/_database-repository.mdx @@ -64,7 +64,7 @@ dnf install -y --setopt=install_weak_deps=False mysql-server ```shell -mysql_apt_config="mysql-apt-config_0.8.34-1_all.deb" +mysql_apt_config="mysql-apt-config_0.8.36-1_all.deb" curl -fJLO "https://dev.mysql.com/get/$mysql_apt_config" echo "mysql-apt-config mysql-apt-config/select-server select mysql-8.4-lts" | debconf-set-selections export DEBIAN_FRONTEND="noninteractive" diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index ff684f1a4047..f131a9e3bb8c 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -330,7 +330,7 @@ log_bin_trust_function_creators=1 -In the `/etc/mysql/mysql.cnf` file, add: +Create a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`) and add: ```shell [mysqld] @@ -554,7 +554,7 @@ systemctl restart mariadb If you use MySQL replication for your **monitoring databases**, some views are created during the installation of Centreon MBI. You must exclude them from replication by adding the following line to the **my.cnf** -file of the slave server or mysql.cnf on Debian 13. +file of the slave server. On Debian 13, add it to the **[mysqld]** section of a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`). ```shell replicate-wild-ignore-table=centreon.mod_bi_%v01,centreon.mod_bi_%V01 @@ -572,13 +572,14 @@ mysql centreon < /tmp/view_creation.sql #### Debian 13 specific configuration -MySQL must listen on all interfaces instead of listening on localhost/127.0.0.1 (default value). Edit the following file: +MySQL must listen on all interfaces instead of listening on localhost/127.0.0.1 (default value). Add the following lines to a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`): ```shell -/etc/mysql/mysql.conf.d/mysqld.cnf +[mysqld] +bind-address=0.0.0.0 ``` -Set **bind-address** to **0.0.0.0** and restart **mysql**. +Then restart **mysql**. ```shell systemctl restart mysql @@ -665,14 +666,19 @@ dnf update Install the required packages: ```shell -apt install lsb-release ca-certificates apt-transport-https software-properties-common wget gnupg2 +apt update && apt install -y lsb-release ca-certificates apt-transport-https wget gnupg2 curl cron +systemctl enable --now cron ``` Install the Centreon repositories: ```shell -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list -echo "deb https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list +install -d /etc/apt/keyrings +wget -O /etc/apt/keyrings/centreon.asc https://apt-key.centreon.com + +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee /etc/apt/sources.list.d/centreon-26.10-stable.list +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-plugins-stable/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/centreon-plugins.list +apt update ``` Then import the repository key: @@ -855,7 +861,6 @@ sudo systemctl status mysqld ```shell apt update apt install -y centreon-mysql -# Sélectionner "Use Legacy Authentication Method" systemctl daemon-reload systemctl restart mysql ``` @@ -944,7 +949,7 @@ option in `/etc/my.cnf` will NOT work. mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl restart mariadb +systemctl enable mariadb ``` If the MariaDB service fails to start, remove the *ib_logfile* files @@ -979,7 +984,7 @@ option in `/etc/my.cnf` will NOT work. mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -echo "deb https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee -a /etc/apt/sources.list.d/centreon-26.10-stable.list +systemctl enable mariadb ``` If the MariaDB service fails to start, remove the *ib_logfile* files @@ -1028,7 +1033,7 @@ It is necessary to change the **LimitNOFILE** limitation. Changing this option i mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl restart mariadb +systemctl enable mariadb ``` If the MariaDB service fails at the time of starting, remove the files *ib_logfile* @@ -1065,7 +1070,7 @@ You must modify the **LimitNOFILE** limitation. Changing this option in `/etc/my mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` If the MySQL service fails to start, delete the *ib_logfile* files (MySQL MUST be stopped) and then restart MySQL again: @@ -1097,7 +1102,7 @@ You must modify the **LimitNOFILE** limitation. Changing this option in `/etc/my mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` If the MySQL service fails to start, delete the *ib_logfile* files (MySQL MUST be stopped) and then restart MySQL again: @@ -1116,7 +1121,7 @@ socket=$PATH_TO_SOCKET$ -Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/mysql/mysql.conf.d/`. +Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/mysql/conf.d/`. Rename the file as `80-centreon.cnf`: @@ -1124,13 +1129,14 @@ Rename the file as `80-centreon.cnf`: mv centreon.cnf 80-centreon.cnf ``` -MySQL must listen to all interfaces instead of localhost/127.0.0.1, which is the default value. Edit the following file: +MySQL must listen to all interfaces instead of localhost/127.0.0.1, which is the default value. Add the following lines to a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`): ```shell -/etc/mysql/mysql.conf.d/mysqld.cnf +[mysqld] +bind-address=0.0.0.0 ``` -Set the **bind-address** parameter to **0.0.0.0** and restart mysql. +Then restart mysql. ```shell systemctl restart mysql @@ -1142,7 +1148,7 @@ You must modify the **LimitNOFILE** limitation. Changing this option in `/etc/my mkdir -p /etc/systemd/system/mysql.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf systemctl daemon-reload -systemctl restart mysql +systemctl enable mysql ``` If the MySQL service fails to start, delete the *ib_logfile* files (MySQL MUST be stopped) and then restart MySQL again: From 0b6f7b97b024942d23adb2e3d0ec05176fb9d67f Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Mon, 12 Oct 2026 16:42:42 +0200 Subject: [PATCH 12/18] partial implementation of feedback --- .../reporting/installation/centreon-mysql.cnf | 54 +++++ .../reporting/installation/centreon.cnf | 1 - .../version-26.10/reporting/installation.md | 222 ++++++++++++------ .../version-26.10/reporting/upgrade.md | 63 +++-- .../reporting/installation/centreon-mysql.cnf | 54 +++++ .../reporting/installation/centreon.cnf | 1 - .../version-26.10/reporting/installation.md | 209 ++++++++++++----- .../version-26.10/reporting/upgrade.md | 63 +++-- 8 files changed, 485 insertions(+), 182 deletions(-) create mode 100644 i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf create mode 100644 versioned_docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf new file mode 100644 index 000000000000..3c78e5ba9c3e --- /dev/null +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf @@ -0,0 +1,54 @@ +[mysqld] +#datadir=/var/lib/mysql +#tmpdir = /var/lib/mysql/tmp +port = 3306 + +max_heap_table_size=512M +open_files_limit = 32000 +group_concat_max_len = 1M + +#By request( all engines) +tmp_table_size=512M +sort_buffer_size = 64M +join_buffer_size = 256M + +#During load or enable keys +bulk_insert_buffer_size = 1G +myisam_sort_buffer_size=1G + +table_open_cache = 2048 +thread_cache_size = 64 + +#Time out and linked problems +connect_timeout=28800 +innodb_lock_wait_timeout=28800 +wait_timeout=28800 +interactive_timeout=28800 +max_allowed_packet = 128M + +#Low query +slow_query_log=1 +slow_query_log_file=slow-queries.log +long_query_time=120 + +#At startup +key_buffer_size = 2G +innodb_buffer_pool_size = 2G + + +#Innob DB +innodb_stats_on_metadata=0 +innodb_flush_method=O_DIRECT +innodb_flush_log_at_trx_commit=2 +innodb_log_buffer_size=1G #taille buffer redo log +innodb_log_file_size=512M +innodb_file_per_table +innodb_open_files=1024 +innodb_max_dirty_pages_pct=30 + + +[mysqld_safe] +log-error=/var/log/mysqld.log +pid-file=/var/run/mysqld/mysqld.pid +innodb_lock_wait_timeout=1500 + diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf index 02751848d984..0c5bc2e05b45 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf @@ -45,7 +45,6 @@ innodb_flush_method=O_DIRECT innodb_flush_log_at_trx_commit=2 innodb_log_buffer_size=1G #taille buffer redo log innodb_log_file_size=512M -innodb_log_files_in_group=3 innodb_file_per_table innodb_open_files=1024 innodb_max_dirty_pages_pct=30 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 3fe9aa6c939c..a147526c3594 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -89,6 +89,8 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu configuration MariaDB `/etc/my.cnf`. Elles interrompent l'exécution de longues requêtes et peuvent arrêter les jobs d'ETL ou de génération de rapports : - wait_timeout - interactive_timeout + + Cette recommandation concerne uniquement la base de données de supervision. Le [fichier de configuration optimisé](#optimiser-la-base-de-données) de la base de données de reporting définit volontairement ces variables à 28800 secondes. | Utilisateur | Groupe | |----------------------|----------------------------| @@ -106,6 +108,8 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu configuration MariaDB `/etc/my.cnf`. Elles interrompent l'exécution de longues requêtes et peuvent arrêter les jobs d'ETL ou de génération de rapports : - wait_timeout - interactive_timeout + + Cette recommandation concerne uniquement la base de données de supervision. Le [fichier de configuration optimisé](#optimiser-la-base-de-données) de la base de données de reporting définit volontairement ces variables à 28800 secondes. | Utilisateur | Groupe | |----------------------|----------------------------| @@ -123,6 +127,8 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu configuration MariaDB `/etc/mysql/mariadb.cnf`. Elles interrompent l'exécution de longues requêtes et peuvent arrêter les jobs d'ETL ou de génération de rapports : - wait_timeout - interactive_timeout + + Cette recommandation concerne uniquement la base de données de supervision. Le [fichier de configuration optimisé](#optimiser-la-base-de-données) de la base de données de reporting définit volontairement ces variables à 28800 secondes. - Lors de la création de l'utilisateur CentreonBI, éxecutez la commande suivante : `adduser centreonBI --force-badname` #### Utilisateurs et groupes @@ -287,19 +293,33 @@ vgdisplay vg_data | grep -i free* - Firewalld : Désactivé ([voir ici](../installation/installation-of-a-central-server/using-packages.md#configurer-ou-désactiver-le-pare-feu)) - SELinux : Désactivé ([voir ici](../installation/installation-of-a-central-server/using-packages.md#désactiver-selinux)) -> Assurez-vous que le fuseau horaire du serveur de reporting est le même que celui du serveur central, sinon les publications de rapports échoueront (lien vers le téléchargement manquant). -> Le même fuseau horaire doit être affiché avec la commande `timedatectl`. -> Vous pouvez changer le fuseau horaire avec cette commande : -> ->```shell ->timedatectl set-timezone Europe/Paris ->``` +Assurez-vous que le fuseau horaire du serveur de reporting est le même que celui du serveur central, sinon les publications de rapports échoueront (lien vers le téléchargement manquant). Le fichier `/etc/localtime` doit également exister sur le serveur de reporting, sinon le script `install.sh` ne pourra pas créer le schéma de la base de données. + +1. Définissez le fuseau horaire du serveur de reporting pour qu'il soit le même que celui du serveur central (par exemple, `Europe/Paris`) : + + ```shell + timedatectl set-timezone Europe/Paris + ``` + + Si le serveur central utilise UTC, utilisez `Etc/UTC` plutôt que `UTC`. Si le serveur de reporting indique déjà UTC, la commande `timedatectl set-timezone UTC` n'a aucun effet et ne crée pas le fichier `/etc/localtime`. + +2. Vérifiez que le fichier `/etc/localtime` existe et pointe vers le bon fuseau horaire : + + ```shell + ls -l /etc/localtime + ``` + + Le résultat doit ressembler à ceci : `/etc/localtime -> ../usr/share/zoneinfo/Europe/Paris`. + +Veillez à optimiser MariaDB/MySQL sur votre serveur de reporting. Vous aurez BESOIN +d'au moins 12GB de mémoire vive afin d'utiliser le fichier de configuration optimisé. Autrement la base de données ne démarrera pas. Téléchargez le fichier correspondant à votre base de données : + +- MariaDB : [centreon.cnf](../assets/reporting/installation/centreon.cnf) +- MySQL : [centreon-mysql.cnf](../assets/reporting/installation/centreon-mysql.cnf) -Veillez à optimiser MariaDB/MySQL sur votre serveur de reporting. Vous aurez besoin -d'au moins 12GB de mémoire vive afin d'utiliser le -[fichier suivant](../assets/reporting/installation/centreon.cnf). +Vous enregistrerez ce fichier sous le nom `85-centreon-bi.cnf` lors de l'étape [Optimiser la base de données](#optimiser-la-base-de-données). Conservez ce nom : le préfixe `85-` garantit que le fichier est lu après le fichier `80-centreon.cnf` installé par les paquets Centreon, afin que ses valeurs ne soient pas écrasées. -> Si vous souhaitez utiliser un répertoire autre que `/var/lib/mysql/`, éditez les variables **datadir** et **tmpdir** du fichier centreon.cnf. +> Si vous souhaitez utiliser un répertoire autre que `/var/lib/mysql/`, éditez les variables **datadir** et **tmpdir** du fichier `85-centreon-bi.cnf`. Assurez-vous que le dossier **tmp** soit créé dans la même partition que **/var/lib/mysql**. @@ -337,6 +357,14 @@ Créez un fichier dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/cent log_bin_trust_function_creators=1 ``` +Assurez-vous que le logging binaire est activé : + +```shell +printf '[mysqld]\nlog_bin_trust_function_creators=1\n' > /etc/mysql/conf.d/90-centreon-bi.cnf +systemctl restart mysql +mysql -e "show global variables like 'log_bin_trust_function_creators'" # expected: ON +``` + @@ -420,10 +448,20 @@ apt install centreon-bi-server Dans la base de données du central, donnez des droits trigger à l'utilisateur **centreon** : -```shell -GRANT TRIGGER ON centreon.* TO `centreon`@'%'; -GRANT TRIGGER ON centreon_storage.* TO `centreon`@'%'; -``` +1. Identifiez le ou les hôtes sur lesquels l'utilisateur **centreon** existe : + + ```shell + SELECT user, host FROM mysql.user WHERE user = 'centreon'; + ``` + +2. Donnez les droits à l'utilisateur **centreon** : + + ```shell + GRANT TRIGGER ON centreon.* TO 'centreon'@''; + GRANT TRIGGER ON centreon_storage.* TO 'centreon'@''; + ``` + + Remplacez **<host>** par la valeur renvoyée par la requête précédente (par exemple, `localhost` si la base de données est locale au serveur central, ou `%` ou une adresse IP si elle est distante). Si la requête renvoie plusieurs hôtes, exécutez ces commandes pour chacun d'entre eux. ### Activer l'extension @@ -896,22 +934,47 @@ apt install centreon-bi-reporting-server -Assurez-vous qu'une version de Java 25 est installée. - - - Pour vérifier quelle version de Java est installée, entrez la commande suivante : - +Ensuite, assurez-vous que Java 25 est installé à l'emplacement attendu par le service **cbis**. Le service **cbis** n'utilise pas la commande `java` par défaut : son fichier d'unité appelle le binaire Java via un chemin codé en dur (**/usr/lib/jvm/java-25-openjdk/bin/java**). Une version de Java installée ailleurs (par exemple, téléchargée depuis le site d'Oracle) ou sélectionnée avec `update-alternatives` n'est pas utilisée par **cbis**. + +1. Affichez le binaire Java utilisé par **cbis** : + ```shell - java -version + systemctl cat cbis | grep ExecStart ``` - - - Pour une mise à jour de Java en version 25, allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java25). - - - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 25 : - + +2. Vérifiez que ce binaire existe et qu'il est en version 25 (si le chemin affiché à l'étape précédente est différent, utilisez ce chemin) : + ```shell - sudo update-alternatives --config java + /usr/lib/jvm/java-25-openjdk/bin/java -version ``` +3. Si la commande échoue, installez OpenJDK 25 depuis les dépôts de votre distribution : + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +apt update +apt install -y openjdk-25-jre-headless +``` + + + + #### Activer les services Activez le service **cbis** : @@ -933,7 +996,7 @@ systemctl start gorgoned && systemctl enable gorgoned -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon.cnf) fourni dans les prérequis vers `/etc/my.cnf.d/85-centreon-bi.cnf`, puis redémarrez le service MariaDB : ```shell systemctl restart mariadb @@ -964,7 +1027,7 @@ socket=$PATH_TO_SOCKET$ -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon.cnf) fourni dans les prérequis vers `/etc/my.cnf.d/85-centreon-bi.cnf`, puis redémarrez le service MariaDB : ```shell systemctl restart mariadb @@ -976,7 +1039,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimer les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrer à nouveau MariaDB : @@ -994,13 +1057,7 @@ socket=$PATH_TO_SOCKET$ -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MariaDB : - -Renommez le fichier en `80-centreon.cnf`: - -```shell -mv centreon.cnf 80-centreon.cnf -``` +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon.cnf) fourni dans les prérequis vers `/etc/mysql/mariadb.conf.d/85-centreon-bi.cnf`. MariaDB doit écouter toutes les interfaces au lieu de localhost/127.0.0.1, qui est la valeur par défaut. Éditez le fichier suivant : @@ -1043,7 +1100,7 @@ socket=$PATH_TO_SOCKET$ -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MySQL : +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon-mysql.cnf) fourni dans les prérequis vers `/etc/my.cnf.d/85-centreon-bi.cnf`, puis redémarrez le service MySQL : ```shell systemctl restart mysql @@ -1074,7 +1131,7 @@ socket=$PATH_TO_SOCKET$ -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/my.cnf.d/`, puis redémarrez le service MySQL : +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon-mysql.cnf) fourni dans les prérequis vers `/etc/my.cnf.d/85-centreon-bi.cnf`, puis redémarrez le service MySQL : ```shell systemctl restart mysql @@ -1105,14 +1162,7 @@ socket=$PATH_TO_SOCKET$ -Assurez vous que [le fichier](../assets/reporting/installation/centreon.cnf) -de configuration optimisé fourni dans les pré-requis est bien présent dans `/etc/mysql/conf.d/`. - -Renommez le fichier en `80-centreon.cnf`: - -```shell -mv centreon.cnf 80-centreon.cnf -``` +Copiez le [fichier de configuration optimisé](../assets/reporting/installation/centreon-mysql.cnf) fourni dans les prérequis vers `/etc/mysql/conf.d/85-centreon-bi.cnf`. Ne le nommez pas `80-centreon.cnf` : cela écraserait le fichier installé par le paquet **centreon-mysql**. MySQL doit écouter toutes les interfaces au lieu de localhost/127.0.0.1, qui est la valeur par défaut. Ajoutez les lignes suivantes dans un fichier situé dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) : @@ -1158,7 +1208,7 @@ socket=$PATH_TO_SOCKET$ ### Sécuriser la base de données Il est obligatoire de sécuriser l'accès root de la base de données avant d'installer Centreon. -Si vous utilisez une base de données locale, exécutez la commande suivante sur le serveur central, sinon sur le serveur de base de données : +Exécutez les commandes suivantes sur le serveur de reporting : @@ -1167,17 +1217,43 @@ Si vous utilisez une base de données locale, exécutez la commande suivante sur mariadb-secure-installation ``` +Répondez **oui** à toutes les questions, sauf à "Disallow root login remotely?" + -```shell -mysql_secure_installation -``` +1. Définissez le mot de passe de votre choix pour l'utilisateur **root** de la base de données (dans la commande suivante, remplacez **my_password** par votre propre mot de passe) : + + ```shell + db_root_password='my_password' + mysql_root_auth=(--ssl-mode=DISABLED -u root) + if ! mysql --ssl-mode=DISABLED -u root -e "SELECT 1" >/dev/null 2>&1; then + mysql_temp_pw=$(grep 'temporary password is generated for root@localhost' /var/log/mysqld.log \ + 2>/dev/null | tail -1 | sed -E 's/.*root@localhost: //') + if [ -z "$mysql_temp_pw" ]; then + echo "Could not authenticate to MySQL as root" >&2 + exit 1 + fi + mysql_root_auth=(--ssl-mode=DISABLED --connect-expired-password -u root -p"${mysql_temp_pw}") + fi + ``` + +2. Remplacez ensuite le mot de passe généré automatiquement par défaut par le vôtre : + + ```shell + mysql "${mysql_root_auth[@]}" --verbose < -- Répondez **oui** à toutes les questions, sauf à "Disallow root login remotely?" - Il est obligatoire de définir un mot de passe pour l'utilisateur **root** de la base de données. Vous aurez besoin de ce mot de passe pendant l'[installation web](../installation/web-and-post-installation.md). > Voir les procédures avancées pour [sécuriser votre plateforme MBI](../reporting/secure-your-mbi-platform.md). @@ -1343,7 +1419,7 @@ Pour activer la purge automatique des anciennes données, modifiez le fichier cr Vous pouvez exécuter ce cron quotidiennement ou hebdomadairement, en fonction du temps d'exécution du batch et de la charge générée sur le serveur. - + Redémarrez le service cron : @@ -1381,18 +1457,16 @@ Veuillez passer à la section suivante pour continuer l'installation. * Configurez et activez la rétention des données afin que seules les données requises soient importées et calculées. * Assurez-vous que [les données soient prêtes sur le serveur central](how-mbi-works.md#phase-1--les-données-sont-préparées-par-le-serveur-central). * Assurez-vous que le processus **gorgoned** finctionne correctement : `systemctl status gorgoned`. Si besoin, redémarrez-le: `systemctl restart gorgoned`. -* Attention, si vous créez la base de données MBI pour la première fois, vous devez importer toutes les données en une seule fois. Si vous disposez d'une grande quantité de données et/ou si vous démarrez le processus tard dans la journée, il est important de savoir que la phase de création de la base de données peut prendre un temps considérable, pouvant même se prolonger jusqu'au lendemain. Dans ce cas, vous devez désactiver [temporairement](#réactiver-lexécution-quotidienne-du-script) l'exécution quotidienne de l'ETL, jusqu'à ce que le provisionnement initial soit terminé, afin d'éviter les doublons ou d'autres problèmes. +* Attention, si vous créez la base de données MBI pour la première fois, vous devez importer toutes les données en une seule fois. Si vous disposez d'une grande quantité de données et/ou si vous démarrez le processus tard dans la journée, il est important de savoir que la phase de création de la base de données peut prendre un temps considérable, pouvant même se prolonger jusqu'au lendemain. C'est pourquoi l'exécution quotidienne de l'ETL est désactivée par défaut : dans le fichier cron **/etc/cron.d/centreon-bi-engine**, la ligne suivante est commentée. Elle doit le rester jusqu'à ce que le provisionnement initial soit terminé, afin d'éviter les doublons ou d'autres problèmes. Vous la [réactiverez](#réactiver-lexécution-quotidienne-du-script) à la fin de la procédure. - 1. Éditez le fichier cron **/etc/cron.d/centreon-bi-engine** et commentez la ligne suivante : - - ```shell - #30 4 * * * root /usr/share/centreon-bi/bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 - ``` + ```shell + #30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + ``` - 2. Redémarrez **crond**. + Si cette ligne n'est pas commentée (par exemple, si vous reconstruisez la base de données), commentez-la, puis redémarrez le service cron : - + ```shell systemctl restart crond @@ -1448,18 +1522,26 @@ Regardez le fichier de log **/var/log/centreon-bi/centreonBIETL.log** : vous dev ### Réactiver l'exécution quotidienne du script -Une fois le processus de reconstruction des données terminé, vous pouvez activer le calcul des -statistiques. -Sur le serveur de reporting, éditez le fichier **/etc/cron.d/centreon-bi-engine** et décommentez la ligne suivante : +> **Cette étape est obligatoire.** Le calcul quotidien des statistiques est désactivé par défaut. Si vous ignorez cette étape, aucune statistique quotidienne ne sera calculée, et aucune erreur ne sera affichée. -```shell -#30 4 * * * root /usr/share/centreon-bi/bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 -``` +Une fois le processus de reconstruction des données terminé, réactivez le calcul quotidien des statistiques : - - +1. Sur le serveur de reporting, éditez le fichier **/etc/cron.d/centreon-bi-engine** et décommentez la ligne suivante (supprimez le `#` initial) : + + ```shell + #30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + ``` + + La ligne doit maintenant ressembler à ceci : + + ```shell + 30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + ``` + +2. Redémarrez le service cron sur le serveur de reporting : -Redémarrez le service cron sur le serveur de reporting : + + ```shell systemctl restart crond @@ -1468,8 +1550,6 @@ systemctl restart crond -Redémarrez le service cron sur le serveur de reporting : - ```shell systemctl restart cron ``` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 207de1e7e461..644409117657 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -63,28 +63,42 @@ apt install --only-upgrade centreon-bi-server ## Étape 3 : Mettre à jour le serveur de reporting ### Prérequis de la version Java - - > Assurez-vous qu'une version de Java 25 est installée avant de commencer la procédure. - - - Pour vérifier quelle version de Java est installée, entrez la commande suivante : - - ```shell - java -version - ``` - - - Pour une mise à jour de Java en version 25, allez sur la [page officielle de téléchargement d'Oracle](https://www.oracle.com/java/technologies/downloads/#java25). - - - Si plusieurs versions de Java sont installées, vous devez activer la bonne version. Affichez les versions installées avec la commande suivante puis sélectionnez la version 25 : - - ```shell - sudo update-alternatives --config java - ``` - - Puis redémarrez le service : - - ```shell - systemctl restart cbis - ``` + +En version 26.10, le service **cbis** exécute Java 25 via un chemin codé en dur : **/usr/lib/jvm/java-25-openjdk/bin/java**. Il n'utilise pas la commande `java` par défaut : une version de Java installée ailleurs (par exemple, téléchargée depuis le site d'Oracle) ou sélectionnée avec `update-alternatives` n'est donc pas utilisée par **cbis**. + +Avant de commencer la procédure, assurez-vous qu'OpenJDK 25 est installé à cet emplacement : + +1. Vérifiez la version de Java à cet emplacement : + + ```shell + /usr/lib/jvm/java-25-openjdk/bin/java -version + ``` + +2. Si la commande échoue, installez OpenJDK 25 depuis les dépôts de votre distribution : + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +apt update +apt install -y openjdk-25-jre-headless +``` + + + + +Une fois le serveur de reporting mis à jour, vous pouvez vérifier quel binaire Java est utilisé par **cbis** avec la commande suivante : + +```shell +systemctl cat cbis | grep ExecStart +``` ### Procédure de montée de version @@ -104,7 +118,7 @@ Vous pouvez maintenant procéder à la montée de version : ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all -dnf update centreon-bi\* +dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common ``` @@ -112,7 +126,8 @@ dnf update centreon-bi\* ```shell apt clean -apt install --only-upgrade centreon-bi-reporting-server +apt update +apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb centreon-perl-libs-common ``` diff --git a/versioned_docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf b/versioned_docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf new file mode 100644 index 000000000000..d5ee8ea23914 --- /dev/null +++ b/versioned_docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf @@ -0,0 +1,54 @@ +[mysqld] +#datadir=/var/lib/mysql +#tmpdir = /var/lib/mysql/tmp +port = 3306 + +max_heap_table_size=512M +open_files_limit = 32000 +group_concat_max_len = 1M + +#By request( all engines) +tmp_table_size=512M +sort_buffer_size = 64M +join_buffer_size = 256M + +#During load or enable keys +bulk_insert_buffer_size = 1G +myisam_sort_buffer_size=1G + +table_open_cache = 2048 +thread_cache_size = 64 + +#Time out and linked problems +connect_timeout=28800 +innodb_lock_wait_timeout=28800 +wait_timeout=28800 +interactive_timeout=28800 +max_allowed_packet = 128M + +#Low query +slow_query_log=1 +slow_query_log_file=slow-queries.log +long_query_time=120 + +#At startup +key_buffer_size = 1G +innodb_buffer_pool_size = 1G + + +#Innob DB +innodb_stats_on_metadata=0 +innodb_flush_method=O_DIRECT +innodb_flush_log_at_trx_commit=2 +innodb_log_buffer_size=1G #taille buffer redo log +innodb_log_file_size=512M +innodb_file_per_table=1 +innodb_open_files=1024 +innodb_max_dirty_pages_pct=30 + + +[mysqld_safe] +log-error=/var/log/mysqld.log +pid-file=/var/run/mysqld/mysqld.pid +innodb_lock_wait_timeout=1500 + diff --git a/versioned_docs/version-26.10/assets/reporting/installation/centreon.cnf b/versioned_docs/version-26.10/assets/reporting/installation/centreon.cnf index cf63beaea6e9..2cb442c4dbe0 100644 --- a/versioned_docs/version-26.10/assets/reporting/installation/centreon.cnf +++ b/versioned_docs/version-26.10/assets/reporting/installation/centreon.cnf @@ -45,7 +45,6 @@ innodb_flush_method=O_DIRECT innodb_flush_log_at_trx_commit=2 innodb_log_buffer_size=1G #taille buffer redo log innodb_log_file_size=512M -innodb_log_files_in_group=3 innodb_file_per_table=1 innodb_open_files=1024 innodb_max_dirty_pages_pct=30 diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index f131a9e3bb8c..d7f6c4db28be 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -90,6 +90,8 @@ considerations. - wait_timeout - interactive_timeout + This only applies to the monitoring database. The [optimized configuration file](#optimize-the-database) of the reporting database sets these variables to 28800 seconds on purpose. + #### Users and groups | User | Group | @@ -108,6 +110,8 @@ considerations. - wait_timeout - interactive_timeout + This only applies to the monitoring database. The [optimized configuration file](#optimize-the-database) of the reporting database sets these variables to 28800 seconds on purpose. + #### Users and groups | User | Group | @@ -125,6 +129,8 @@ considerations. execution of long queries and can stop ETL or report generation jobs: - wait_timeout - interactive_timeout + + This only applies to the monitoring database. The [optimized configuration file](#optimize-the-database) of the reporting database sets these variables to 28800 seconds on purpose. - When creating the CentreonBI user, you must execute the following command: `adduser centreonBI --force-badname` #### Users and groups @@ -288,18 +294,33 @@ vgdisplay vg_data | grep -i free* - Firewalld: Disabled ([look here](../installation/installation-of-a-central-server/using-packages.md#configure-or-disable-the-firewall)) - SELinux: Disabled ([look here](../installation/installation-of-a-central-server/using-packages.md#disable-selinux)) -> Make sure that the reporting server and the central server have the same time zone; otherwise report publications will fail (the link to download them will be missing). -> The same time zone must be displayed with the `timedatectl` command. -> You can change the time zone with this command: -> ->```shell ->timedatectl set-timezone Europe/Paris ->``` +Make sure that the reporting server and the central server have the same time zone; otherwise report publications will fail (the link to download them will be missing). The `/etc/localtime` file must also exist on the reporting server; otherwise the `install.sh` script will fail to create the database schema. + +1. Set the time zone of the reporting server to the same time zone as the central server (for example, `Europe/Paris`): + + ```shell + timedatectl set-timezone Europe/Paris + ``` + + If the central server uses UTC, use `Etc/UTC` rather than `UTC`. If the reporting server already reports UTC, `timedatectl set-timezone UTC` does nothing and does not create `/etc/localtime`. + +2. Check that `/etc/localtime` exists and points to the right time zone: + + ```shell + ls -l /etc/localtime + ``` + + The output should look like this: `/etc/localtime -> ../usr/share/zoneinfo/Europe/Paris`. Be sure to optimize MariaDB/MySQL on your reporting server. -You will need at least 12 GB of RAM in order to use the [following file](../assets/reporting/installation/centreon.cnf). +You WILL need at least 12 GB of RAM in order to use the optimized configuration file. Without this, the database doesn't start. Download the file that matches your database: + +- MariaDB: [centreon.cnf](../assets/reporting/installation/centreon.cnf) +- MySQL: [centreon-mysql.cnf](../assets/reporting/installation/centreon-mysql.cnf) -> If you want to use a different directory than `/var/lib/mysql/`, edit the **datadir** and **tmpdir** variables in the centreon.cnf file. +You will save this file as `85-centreon-bi.cnf` when you [optimize the database](#optimize-the-database). Keep this name: the `85-` prefix makes sure the file is read after the `80-centreon.cnf` file installed by Centreon packages, so that its values are not overridden. + +> If you want to use a different directory than `/var/lib/mysql/`, edit the **datadir** and **tmpdir** variables in the `85-centreon-bi.cnf` file. Make sure a **tmp** folder is created inside the same partition as **/var/lib/mysql**. @@ -337,6 +358,14 @@ Create a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centre log_bin_trust_function_creators=1 ``` +Ensure binary logging is turned on: + +```shell +printf '[mysqld]\nlog_bin_trust_function_creators=1\n' > /etc/mysql/conf.d/90-centreon-bi.cnf +systemctl restart mysql +mysql -e "show global variables like 'log_bin_trust_function_creators'" # expected: ON +``` + @@ -420,10 +449,20 @@ apt install centreon-bi-server In the central database, grant trigger rights to the **centreon** user: -```shell -GRANT TRIGGER ON centreon.* TO `centreon`@'%'; -GRANT TRIGGER ON centreon_storage.* TO `centreon`@'%'; -``` +1. Find the host(s) on which the **centreon** user exists: + + ```shell + SELECT user, host FROM mysql.user WHERE user = 'centreon'; + ``` + +2. Grant the rights to the **centreon** user: + + ```shell + GRANT TRIGGER ON centreon.* TO 'centreon'@''; + GRANT TRIGGER ON centreon_storage.* TO 'centreon'@''; + ``` + + Replace **<host>** with the value returned by the previous query (for example, `localhost` if the database is local to the central server, or `%` or an IP address if it is remote). If the query returns several hosts, run these commands for each of them. ### Enable the extension @@ -898,22 +937,47 @@ apt install centreon-bi-reporting-server -Then, ensure a version of Java 25 is installed before you start the procedure. - - - If you need to check the Java version, enter the following command: - +Then, make sure that Java 25 is installed where the **cbis** service expects it. The **cbis** service does not use the default `java` command: its unit file calls the Java binary through a hard-coded path (**/usr/lib/jvm/java-25-openjdk/bin/java**). A Java version installed elsewhere (for example, downloaded from the Oracle website) or selected with `update-alternatives` is not used by **cbis**. + +1. Display the Java binary used by **cbis**: + ```shell - java -version + systemctl cat cbis | grep ExecStart ``` - - - If you need to upgrade the Java installation to Java 25, go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java25) page. - - - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 25 version: - + +2. Check that this binary exists and is version 25 (if the path displayed in the previous step is different, use that path): + ```shell - sudo update-alternatives --config java + /usr/lib/jvm/java-25-openjdk/bin/java -version ``` +3. If the command fails, install OpenJDK 25 from your distribution's repositories: + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +apt update +apt install -y openjdk-25-jre-headless +``` + + + + #### Enable services Enable the **cbis** service: @@ -935,8 +999,8 @@ systemctl start gorgoned && systemctl enable gorgoned -Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) provided -in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MariaDB service: +Copy the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided +in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MariaDB service: ```shell systemctl restart mariadb @@ -970,8 +1034,8 @@ socket=$PATH_TO_SOCKET$ -Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) provided -in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MariaDB service: +Copy the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided +in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MariaDB service: ```shell systemctl restart mariadb @@ -984,7 +1048,7 @@ option in `/etc/my.cnf` will NOT work. mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` If the MariaDB service fails to start, remove the *ib_logfile* files @@ -1005,14 +1069,8 @@ socket=$PATH_TO_SOCKET$ -Make sure that the optimized configuration [file](../assets/reporting/installation/centreon.cnf) -provided in the requirements is present in `/etc/mysql/mariadb.conf.d/`. - -Rename the file to `80-centreon.cnf`: - -```shell -mv centreon.cnf 80-centreon.cnf -``` +Copy the [optimized configuration file](../assets/reporting/installation/centreon.cnf) +provided in the prerequisites to `/etc/mysql/mariadb.conf.d/85-centreon-bi.cnf`. MariaDB should listen to all interfaces instead of localhost/127.0.0.1, which is the default. Edit the following file: @@ -1058,7 +1116,7 @@ socket=$PATH_TO_SOCKET$ -Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MySQL service: +Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MySQL service: ```shell systemctl restart mysql @@ -1089,7 +1147,7 @@ socket=$PATH_TO_SOCKET$ -Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/my.cnf.d/`, then restart the MySQL service: +Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MySQL service: ```shell @@ -1121,13 +1179,7 @@ socket=$PATH_TO_SOCKET$ -Ensure that the [optimized configuration file](../assets/reporting/installation/centreon.cnf) provided in the prerequisites is present in `/etc/mysql/conf.d/`. - -Rename the file as `80-centreon.cnf`: - -```shell -mv centreon.cnf 80-centreon.cnf -``` +Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/mysql/conf.d/85-centreon-bi.cnf`. Do not name it `80-centreon.cnf`: this would overwrite the file installed by the **centreon-mysql** package. MySQL must listen to all interfaces instead of localhost/127.0.0.1, which is the default value. Add the following lines to a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`): @@ -1173,7 +1225,7 @@ socket=$PATH_TO_SOCKET$ ### Secure the database It is mandatory to secure the root access of the database before installing Centreon. -If you use a local database, execute the following command on the central server, otherwise on the database server: +Execute the following commands on the reporting server: @@ -1182,17 +1234,43 @@ If you use a local database, execute the following command on the central server mariadb-secure-installation ``` +Answer **yes** to all questions except "Disallow root login remotely?" + -```shell -mysql_secure_installation -``` +1. Define the password you want for the database **root** user (replace **my_password** by your own in the following command): + + ```shell + db_root_password='my_password' + mysql_root_auth=(--ssl-mode=DISABLED -u root) + if ! mysql --ssl-mode=DISABLED -u root -e "SELECT 1" >/dev/null 2>&1; then + mysql_temp_pw=$(grep 'temporary password is generated for root@localhost' /var/log/mysqld.log \ + 2>/dev/null | tail -1 | sed -E 's/.*root@localhost: //') + if [ -z "$mysql_temp_pw" ]; then + echo "Could not authenticate to MySQL as root" >&2 + exit 1 + fi + mysql_root_auth=(--ssl-mode=DISABLED --connect-expired-password -u root -p"${mysql_temp_pw}") + fi + ``` + +2. Then replace the default autogenerated password with yours: + + ```shell + mysql "${mysql_root_auth[@]}" --verbose < -- Answer **yes** to all questions except "Disallow root login remotely?" - It is mandatory to define a password for the **root** user of the database. You will need this password during the [web-installation](../installation/web-and-post-installation.md). > See advanced procedures to [Secure your MBI platform](../reporting/secure-your-mbi-platform.md). @@ -1376,17 +1454,16 @@ systemctl restart cron * Configure the ETL and enable data retention so that only the required data is imported and calculated. * Make sure that [the data on the central server is ready](how-mbi-works.md#phase-1-data-is-prepared-by-the-central-server). * Make sure that the **gorgoned** process works fine: `systemctl status gorgoned`. If needed, restart it: `systemctl restart gorgoned`. -* Bear in mind that if you are building the MBI database for the first time, you have to import all of the data in one go. If you have a large amount of data and/or if you start the process late in the day, it's important to be aware that the database building phase might take a significant amount of time, possibly extending into the next day. In this case, you need to disable the daily build [temporarily](#reenable-daily-script-execution), until the initial build is complete, so as to avoid duplicate entries or other problems. - 1. Edit the **/etc/cron.d/centreon-bi-engine** cronfile and comment out the following line: +* Bear in mind that if you are building the MBI database for the first time, you have to import all of the data in one go. If you have a large amount of data and/or if you start the process late in the day, it's important to be aware that the database building phase might take a significant amount of time, possibly extending into the next day. This is why the daily build is disabled by default: in the **/etc/cron.d/centreon-bi-engine** cronfile, the following line is commented out. It must stay commented out until the initial build is complete, so as to avoid duplicate entries or other problems. You will [reenable it](#reenable-daily-script-execution) at the end of the procedure. - ```shell - #30 4 * * * root /usr/share/centreon-bi/bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 - ``` + ```shell + #30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + ``` - 2. Restart **crond**. + If this line is not commented out (for example, if you are rebuilding the database), comment it out, then restart the cron service: - + ```shell systemctl restart crond @@ -1442,12 +1519,20 @@ Go to the **/var/log/centreon-bi/centreonBIETL.log** log file: you should see so ### Reenable daily script execution -Once the data building process is complete, you can reenable the daily calculation of statistics. +> **This step is mandatory.** The daily calculation of statistics is disabled by default. If you skip this step, no daily statistics will be calculated, and no error will be displayed. + +Once the data building process is complete, reenable the daily calculation of statistics: -1. On the reporting server, edit the **/etc/cron.d/centreon-bi-engine** file and uncomment the following line: +1. On the reporting server, edit the **/etc/cron.d/centreon-bi-engine** file and uncomment the following line (remove the leading `#`): ```shell - #30 4 * * * root /usr/share/centreon-bi/bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + #30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 + ``` + + The line should now look like this: + + ```shell + 30 4 * * * root /usr/share/centreon-bi//bin/centreonBIETL -d >> /var/log/centreon-bi/centreonBIETL.log 2>&1 ``` 2. Restart the cron service on the reporting server: @@ -1469,6 +1554,8 @@ systemctl restart cron +> Make sure the **centreonBIETL** batch only starts once **eventReportBuilder** has ended on the monitoring server (check the cron file **etc/cron.d/centreon** on the monitoring server). + The installation of Centreon MBI is now complete. You can start creating [jobs](concepts.md#jobs) in order to generate reports. See [the tutorial](../getting-started/analyze-resources-availability.md). ## Monitor your MBI server with Centreon diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index ff4ebd5863f7..88bfcf03c077 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -63,28 +63,42 @@ Update button to update the extension and the widgets. ## Step 3: Upgrade the reporting server ### Java version requirement - - > Ensure a version of Java 25 is installed before you start the procedure. - - - If you need to check the Java version, enter the following command: - - ```shell - java -version - ``` - - - If you need to upgrade the Java installation to Java 25, go to the [Oracle official download](https://www.oracle.com/java/technologies/downloads/#java25) page. - - - If several Java versions are installed, you need to activate the right version. Display the installed versions using the following command and select the Java 25 version: - - ```shell - sudo update-alternatives --config java - ``` - - Then restart the service: - - ```shell - systemctl restart cbis - ``` + +In version 26.10, the **cbis** service runs Java 25 through a hard-coded path: **/usr/lib/jvm/java-25-openjdk/bin/java**. It does not use the default `java` command, so a Java version installed elsewhere (for example, downloaded from the Oracle website) or selected with `update-alternatives` is not used by **cbis**. + +Before you start the procedure, make sure that OpenJDK 25 is installed at this location: + +1. Check the Java version at this path: + + ```shell + /usr/lib/jvm/java-25-openjdk/bin/java -version + ``` + +2. If the command fails, install OpenJDK 25 from your distribution's repositories: + + + + +```shell +dnf install -y java-25-openjdk-headless +``` + + + + +```shell +apt update +apt install -y openjdk-25-jre-headless +``` + + + + +Once the reporting server is upgraded, you can check which Java binary **cbis** uses with the following command: + +```shell +systemctl cat cbis | grep ExecStart +``` ### Upgrade procedure @@ -104,7 +118,7 @@ Now you can start the upgrade process: ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all -dnf update centreon-bi\* +dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common ``` @@ -112,7 +126,8 @@ dnf update centreon-bi\* ```shell apt clean -apt install --only-upgrade centreon-bi-reporting-server +apt update +apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb centreon-perl-libs-common ``` From 85734c87ccd3d469784b5d63a896a6f01ef0a4bd Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Mon, 12 Oct 2026 17:32:18 +0200 Subject: [PATCH 13/18] fix broken link --- .../version-26.10/reporting/installation.md | 48 +++--------------- .../version-26.10/reporting/upgrade.md | 36 +------------ .../version-26.10/api/api-tokens.md | 4 +- .../version-26.10/reporting/installation.md | 50 +++---------------- .../version-26.10/reporting/upgrade.md | 36 +------------ 5 files changed, 17 insertions(+), 157 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index a147526c3594..239a00740a05 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -478,10 +478,13 @@ MBI, menu **Rapports > Monitoring Business Intelligence > Paramètres globaux** | Onglet | Option | Value | |----------------------------------------------------------------------------------------|----------------------------|--------------------------------------------------------------------------------------| | Options de l'ordonnanceur | Hôte de CBIS | Adresse IP du serveur de reporting | -| Options de l'ETL | Une base de données MySQL dédiée au reporting a été mise en place | Oui | | +| Options de l'ETL | Une base de données MySQL dédiée au reporting a été mise en place | Oui | | Widgets de reporting* | Reporting MySQL database | Adresse IP de la base de reporting (par défaut = adresse IP du serveur de reporting) | +| Widgets de reporting* | Mot de passe | Mot de passe de l'utilisateur de base de données **centreonbi** sur le serveur de reporting | -\* *Le test de connexion ne fonctionnera pas encore à ce moment de l'installation* +\* *Le test de connexion ne fonctionnera pas encore à ce moment de l'installation.* + +> Le champ **Mot de passe** de l'onglet **Widgets de reporting** est prérempli avec **centreonbi**. Ce n'est pas le mot de passe que les scripts d'installation (**centreonMysqlRights.pl** et **install.sh**) définissent pour l'utilisateur **centreonbi**. Si vous conservez la valeur par défaut, les widgets ne peuvent pas se connecter à la base de reporting, et le test de connexion échoue avec l'erreur suivante : `Access denied for user 'centreonbi'@''`. ### Accès à la base de données centrale @@ -934,46 +937,7 @@ apt install centreon-bi-reporting-server -Ensuite, assurez-vous que Java 25 est installé à l'emplacement attendu par le service **cbis**. Le service **cbis** n'utilise pas la commande `java` par défaut : son fichier d'unité appelle le binaire Java via un chemin codé en dur (**/usr/lib/jvm/java-25-openjdk/bin/java**). Une version de Java installée ailleurs (par exemple, téléchargée depuis le site d'Oracle) ou sélectionnée avec `update-alternatives` n'est pas utilisée par **cbis**. - -1. Affichez le binaire Java utilisé par **cbis** : - - ```shell - systemctl cat cbis | grep ExecStart - ``` - -2. Vérifiez que ce binaire existe et qu'il est en version 25 (si le chemin affiché à l'étape précédente est différent, utilisez ce chemin) : - - ```shell - /usr/lib/jvm/java-25-openjdk/bin/java -version - ``` - -3. Si la commande échoue, installez OpenJDK 25 depuis les dépôts de votre distribution : - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -apt update -apt install -y openjdk-25-jre-headless -``` - - - +Lors de l'installation des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk**. #### Activer les services diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 644409117657..520e4ec29ff3 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -64,41 +64,7 @@ apt install --only-upgrade centreon-bi-server ### Prérequis de la version Java -En version 26.10, le service **cbis** exécute Java 25 via un chemin codé en dur : **/usr/lib/jvm/java-25-openjdk/bin/java**. Il n'utilise pas la commande `java` par défaut : une version de Java installée ailleurs (par exemple, téléchargée depuis le site d'Oracle) ou sélectionnée avec `update-alternatives` n'est donc pas utilisée par **cbis**. - -Avant de commencer la procédure, assurez-vous qu'OpenJDK 25 est installé à cet emplacement : - -1. Vérifiez la version de Java à cet emplacement : - - ```shell - /usr/lib/jvm/java-25-openjdk/bin/java -version - ``` - -2. Si la commande échoue, installez OpenJDK 25 depuis les dépôts de votre distribution : - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -apt update -apt install -y openjdk-25-jre-headless -``` - - - - -Une fois le serveur de reporting mis à jour, vous pouvez vérifier quel binaire Java est utilisé par **cbis** avec la commande suivante : - -```shell -systemctl cat cbis | grep ExecStart -``` +La version 26.10 nécessite Java 25. Lors de la mise à jour des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk**. ### Procédure de montée de version diff --git a/versioned_docs/version-26.10/api/api-tokens.md b/versioned_docs/version-26.10/api/api-tokens.md index 9daa21ead9d5..ed97ea2f9580 100644 --- a/versioned_docs/version-26.10/api/api-tokens.md +++ b/versioned_docs/version-26.10/api/api-tokens.md @@ -4,9 +4,9 @@ title: API tokens description: "Generate and manage API tokens for third-party application access" --- -You need an API Token (a type of [authentication token](./authentication_tokens.md)) to authenticate with the Centreon APIs. To generate one, go to **Administration > Authentication tokens**. +Using an API token, a third-party application can call the Centreon API to perform actions in Centreon (webhooks). -An API token is linked to one [Centreon user](../users/users.md) and is valid only for a certain period of time. API calls will be executed according to the [rights assigned to this user](../users/users.md#user-roles). A specific user can have several tokens. +A token is linked to one [Centreon user](../monitoring/basic-objects/contacts.md) and is valid only for a certain period of time. API calls will be executed according to the [rights assigned to this user](../administration/access-control-lists.md#granting-rights-to-a-user). A specific user can have several tokens. ## Who can create API tokens? diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index d7f6c4db28be..69200123c89f 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -479,10 +479,13 @@ menu, *Reports > Monitoring Business Intelligence > General Options*: | Tabs | Option | Value | |----------------------------------------------------------------------------------------|----------------------------|--------------------------------------------------------------------------------------| | Scheduler options | CBIS Host | IP address of the reporting server | -| ETL options | Reporting engine uses a dedicated MySQL server | Yes | | -| Reporting widgets | Reporting MariaDB database | IP address of the reporting base (default = IP address of the reporting server) | +| ETL options | Reporting engine uses a dedicated MySQL server | Yes | +| Reporting widgets* | Reporting MariaDB database | IP address of the reporting base (default = IP address of the reporting server) | +| Reporting widgets* | Password | Password of the **centreonbi** database user on the reporting server | -\**The connection test will not work at this point in the installation*. +\* *The connection test will not work at this point in the installation.* + +> The **Password** field of the **Reporting widgets** tab is prefilled with **centreonbi**. This is not the password that the installation scripts (**centreonMysqlRights.pl** and **install.sh**) set for the **centreonbi** user. If you keep the default value, the widgets cannot connect to the reporting database, and the connection test fails with the following error: `Access denied for user 'centreonbi'@''`. ### Access to the Central database @@ -937,46 +940,7 @@ apt install centreon-bi-reporting-server -Then, make sure that Java 25 is installed where the **cbis** service expects it. The **cbis** service does not use the default `java` command: its unit file calls the Java binary through a hard-coded path (**/usr/lib/jvm/java-25-openjdk/bin/java**). A Java version installed elsewhere (for example, downloaded from the Oracle website) or selected with `update-alternatives` is not used by **cbis**. - -1. Display the Java binary used by **cbis**: - - ```shell - systemctl cat cbis | grep ExecStart - ``` - -2. Check that this binary exists and is version 25 (if the path displayed in the previous step is different, use that path): - - ```shell - /usr/lib/jvm/java-25-openjdk/bin/java -version - ``` - -3. If the command fails, install OpenJDK 25 from your distribution's repositories: - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -apt update -apt install -y openjdk-25-jre-headless -``` - - - +When installing the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk**. #### Enable services diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index 88bfcf03c077..61964bc6e33c 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -64,41 +64,7 @@ Update button to update the extension and the widgets. ### Java version requirement -In version 26.10, the **cbis** service runs Java 25 through a hard-coded path: **/usr/lib/jvm/java-25-openjdk/bin/java**. It does not use the default `java` command, so a Java version installed elsewhere (for example, downloaded from the Oracle website) or selected with `update-alternatives` is not used by **cbis**. - -Before you start the procedure, make sure that OpenJDK 25 is installed at this location: - -1. Check the Java version at this path: - - ```shell - /usr/lib/jvm/java-25-openjdk/bin/java -version - ``` - -2. If the command fails, install OpenJDK 25 from your distribution's repositories: - - - - -```shell -dnf install -y java-25-openjdk-headless -``` - - - - -```shell -apt update -apt install -y openjdk-25-jre-headless -``` - - - - -Once the reporting server is upgraded, you can check which Java binary **cbis** uses with the following command: - -```shell -systemctl cat cbis | grep ExecStart -``` +Version 26.10 requires Java 25. When upgrading the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk**. ### Upgrade procedure From 3a0c2ca550900700ab8b62f8dffd046ac035a101 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Tue, 13 Oct 2026 17:47:09 +0200 Subject: [PATCH 14/18] Apply batched suggestions from code review Co-authored-by: Jordan9131 <138499128+Jordan9131@users.noreply.github.com> --- .../version-26.10/reporting/installation.md | 15 +-------------- 1 file changed, 1 insertion(+), 14 deletions(-) diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 69200123c89f..79d15b03c2ec 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -892,10 +892,6 @@ echo "default-authentication-plugin=mysql_native_password" >> /etc/my.cnf.d/mysq systemctl daemon-reload systemctl restart mysqld systemctl list-units --type=service | grep -i mysql -sudo sed -Ei 's/LimitNOFILE\s*=\s*[0-9]+/LimitNOFILE = 32000/' /usr/lib/systemd/system/mysqld -sudo systemctl start mysqld -sudo systemctl status mysqld -``` @@ -1115,17 +1111,8 @@ Copy the [optimized configuration file](../assets/reporting/installation/centreo ```shell -systemctl restart mysql -``` - -You must modify the **LimitNOFILE** limitation. Changing this option in `/etc/my.cnf` will NOT work. +Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MySQL service: -```shell -mkdir -p /etc/systemd/system/mysql.service.d/ -echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf -systemctl daemon-reload -systemctl enable mysql -``` If the MySQL service fails to start, delete the *ib_logfile* files (MySQL MUST be stopped) and then restart MySQL again: From e68246240632070f86ad7b45b0cb6eaf86e41f28 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Tue, 13 Oct 2026 17:53:41 +0200 Subject: [PATCH 15/18] apply feedback --- .../version-26.10/reporting/installation.md | 19 ++++++++----------- .../version-26.10/reporting/installation.md | 16 ++++++++-------- 2 files changed, 16 insertions(+), 19 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 239a00740a05..8a1c9e772be8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -775,13 +775,13 @@ dnf config-manager --set-enabled ol8_codeready_builder Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` -Activez les dépôts powertools : +Activez les dépôts **crb** : ```shell -dnf config-manager --set-enabled 'powertools' +dnf config-manager --set-enabled 'crb' ``` @@ -789,13 +789,13 @@ dnf config-manager --set-enabled 'powertools' Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Activer les dépôts **codeready-builder** : ```shell -subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms +subscription-manager repos --enable codeready-builder-for-rhel-10-x86_64-rpms ``` @@ -804,13 +804,13 @@ subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Activez les dépôts **codeready-builder** : ```shell -dnf config-manager --set-enabled ol9_codeready_builder +dnf config-manager --set-enabled ol10_codeready_builder ``` @@ -818,7 +818,7 @@ dnf config-manager --set-enabled ol9_codeready_builder Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Exécutez la commande suivante : @@ -889,9 +889,6 @@ echo "default-authentication-plugin=mysql_native_password" >> /etc/my.cnf.d/mysq systemctl daemon-reload systemctl restart mysqld systemctl list-units --type=service | grep -i mysql -sudo sed -Ei 's/LimitNOFILE\s*=\s*[0-9]+/LimitNOFILE = 32000/' /usr/lib/systemd/system/mysqld -sudo systemctl start mysqld -sudo systemctl status mysqld ``` diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 69200123c89f..0de687a72c42 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -777,13 +777,13 @@ dnf config-manager --set-enabled ol8_codeready_builder Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` -Enable the **powertools** repository: +Enable the **crb** repository: ```shell -dnf config-manager --set-enabled 'powertools' +dnf config-manager --set-enabled 'crb' ``` @@ -791,13 +791,13 @@ dnf config-manager --set-enabled 'powertools' Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Enable the **codeready-builder** repositories: ```shell -subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms +subscription-manager repos --enable codeready-builder-for-rhel-10-x86_64-rpms ``` @@ -806,13 +806,13 @@ subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Enable the **codeready-builder** repositories: ```shell -dnf config-manager --set-enabled ol9_codeready_builder +dnf config-manager --set-enabled ol10_codeready_builder ``` @@ -820,7 +820,7 @@ dnf config-manager --set-enabled ol9_codeready_builder Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-10.noarch.rpm ``` Run the following command: From b5f1cf3b64d2157ece3629fdecb9999c47812df0 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Wed, 14 Oct 2026 16:51:29 +0200 Subject: [PATCH 16/18] implement feedback --- .../version-26.10/reporting/installation.md | 9 --------- versioned_docs/version-26.10/reporting/installation.md | 5 ++--- 2 files changed, 2 insertions(+), 12 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 8a1c9e772be8..199538869824 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -1098,15 +1098,6 @@ Copiez le [fichier de configuration optimisé](../assets/reporting/installation/ systemctl restart mysql ``` -Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/my.cnf` NE fonctionnera PAS. - -```shell -mkdir -p /etc/systemd/system/mysql.service.d/ -echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mysql.service.d/limits.conf -systemctl daemon-reload -systemctl enable mysql -``` - Si le service MySQL échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MySQL doit absolument être stoppé) puis redémarrez à nouveau MySQL : ```shell diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 70368ef5cac6..58da07caba44 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -1109,10 +1109,9 @@ socket=$PATH_TO_SOCKET$ Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MySQL service: - ```shell -Copy the [optimized configuration file](../assets/reporting/installation/centreon-mysql.cnf) provided in the prerequisites to `/etc/my.cnf.d/85-centreon-bi.cnf`, then restart the MySQL service: - +systemctl restart mysql +``` If the MySQL service fails to start, delete the *ib_logfile* files (MySQL MUST be stopped) and then restart MySQL again: From b8d06aec2ec9588186d994dcaabd144c09c8ce76 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Fri, 16 Oct 2026 19:02:48 +0200 Subject: [PATCH 17/18] implement feedback --- .../reporting/installation/centreon-mysql.cnf | 10 +- .../reporting/installation/centreon.cnf | 10 +- .../version-26.10/reporting/installation.md | 180 ++++++++--------- .../version-26.10/reporting/update.md | 3 + .../version-26.10/reporting/upgrade.md | 83 +++++++- .../version-26.10/reporting/installation.md | 185 +++++++++--------- .../version-26.10/reporting/update.md | 3 + .../version-26.10/reporting/upgrade.md | 83 +++++++- 8 files changed, 357 insertions(+), 200 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf index 3c78e5ba9c3e..d5ee8ea23914 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon-mysql.cnf @@ -32,17 +32,17 @@ slow_query_log_file=slow-queries.log long_query_time=120 #At startup -key_buffer_size = 2G -innodb_buffer_pool_size = 2G +key_buffer_size = 1G +innodb_buffer_pool_size = 1G -#Innob DB -innodb_stats_on_metadata=0 +#Innob DB +innodb_stats_on_metadata=0 innodb_flush_method=O_DIRECT innodb_flush_log_at_trx_commit=2 innodb_log_buffer_size=1G #taille buffer redo log innodb_log_file_size=512M -innodb_file_per_table +innodb_file_per_table=1 innodb_open_files=1024 innodb_max_dirty_pages_pct=30 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf index 0c5bc2e05b45..2cb442c4dbe0 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/assets/reporting/installation/centreon.cnf @@ -32,20 +32,20 @@ slow_query_log_file=slow-queries.log long_query_time=120 #At startup -key_buffer_size = 2G +key_buffer_size = 1G query_cache_size=8M query_cache_type=1 query_cache_limit=1048576 -innodb_buffer_pool_size = 2G +innodb_buffer_pool_size = 1G -#Innob DB -innodb_stats_on_metadata=0 +#Innob DB +innodb_stats_on_metadata=0 innodb_flush_method=O_DIRECT innodb_flush_log_at_trx_commit=2 innodb_log_buffer_size=1G #taille buffer redo log innodb_log_file_size=512M -innodb_file_per_table +innodb_file_per_table=1 innodb_open_files=1024 innodb_max_dirty_pages_pct=30 diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 199538869824..544b9c2fe557 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -129,14 +129,14 @@ Voir les [prérequis logiciels](../installation/prerequisites.md#caractéristiqu - interactive_timeout Cette recommandation concerne uniquement la base de données de supervision. Le [fichier de configuration optimisé](#optimiser-la-base-de-données) de la base de données de reporting définit volontairement ces variables à 28800 secondes. -- Lors de la création de l'utilisateur CentreonBI, éxecutez la commande suivante : `adduser centreonBI --force-badname` +- Lors de la création de l'utilisateur CentreonBI, éxecutez la commande suivante : `adduser centreonBI --allow-bad-names` #### Utilisateurs et groupes | Utilisateur | Groupe | |----------------------|------------------------------| | centreonBI (nouveau) | www-data,centreon,centreonBI | -| apache (existant) | centreonBI | +| www-data (existant) | centreonBI | @@ -325,67 +325,6 @@ Assurez-vous que le dossier **tmp** soit créé dans la même partition que **/v > Ne définissez pas ces optimisations MariaDB/MySQL sur votre serveur de supervision. -Si vous utilisez MySQL : - -1. Effectuez l'action suivante : - - - - -Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : - -```shell -log_bin_trust_function_creators=1 -``` - - - - -Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : - -```shell -log_bin_trust_function_creators=1 -``` - - - - -Créez un fichier dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) et ajoutez : - -```shell -[mysqld] -log_bin_trust_function_creators=1 -``` - -Assurez-vous que le logging binaire est activé : - -```shell -printf '[mysqld]\nlog_bin_trust_function_creators=1\n' > /etc/mysql/conf.d/90-centreon-bi.cnf -systemctl restart mysql -mysql -e "show global variables like 'log_bin_trust_function_creators'" # expected: ON -``` - - - - -2. Redémarrez MySQL. - -3. Vérifiez que la base de données que la variable suivante est appliquée : - -```shell -show global variables like 'log_bin_trust_function_creators'; -+---------------------------------+-------+ -| Variable_name | Value | -+---------------------------------+-------+ -| log_bin_trust_function_creators | ON | -``` - -Si la variable n'est pas appliquée, activez-la manuellement : - -```shell -mysql> SET GLOBAL log_bin_trust_function_creators = 1; -``` - Utilisateurs et groupes : | Utilisateur | Groupe | @@ -463,6 +402,61 @@ Dans la base de données du central, donnez des droits trigger à l'utilisateur Remplacez **<host>** par la valeur renvoyée par la requête précédente (par exemple, `localhost` si la base de données est locale au serveur central, ou `%` ou une adresse IP si elle est distante). Si la requête renvoie plusieurs hôtes, exécutez ces commandes pour chacun d'entre eux. +### Autoriser la création de fonctions (MySQL uniquement) + +Si la base de données du central utilise MySQL, effectuez les actions suivantes sur le serveur qui l'héberge avant d'activer l'extension. Sinon, l'installation échoue avec l'erreur `ERROR 1419` : l'extension apparaît comme installée, mais son menu et ses options sont absents. + +1. Effectuez l'action suivante : + + + + +Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : + +```shell +log_bin_trust_function_creators=1 +``` + + + + +Dans le fichier `/etc/my.cnf.d/mysql-server.cnf`, ajoutez : + +```shell +log_bin_trust_function_creators=1 +``` + + + + +Créez le fichier `/etc/mysql/conf.d/90-centreon-bi.cnf` et ajoutez : + +```shell +[mysqld] +log_bin_trust_function_creators=1 +``` + + + + +2. Redémarrez MySQL. + +3. Vérifiez que la base de données que la variable suivante est appliquée : + +```shell +show global variables like 'log_bin_trust_function_creators'; ++---------------------------------+-------+ +| Variable_name | Value | ++---------------------------------+-------+ +| log_bin_trust_function_creators | ON | +``` + +Si la variable n'est pas appliquée, activez-la manuellement : + +```shell +mysql> SET GLOBAL log_bin_trust_function_creators = 1; +``` + ### Activer l'extension Le menu **Administration > Extension > Gestionnaire** vous permet @@ -486,9 +480,9 @@ MBI, menu **Rapports > Monitoring Business Intelligence > Paramètres globaux** > Le champ **Mot de passe** de l'onglet **Widgets de reporting** est prérempli avec **centreonbi**. Ce n'est pas le mot de passe que les scripts d'installation (**centreonMysqlRights.pl** et **install.sh**) définissent pour l'utilisateur **centreonbi**. Si vous conservez la valeur par défaut, les widgets ne peuvent pas se connecter à la base de reporting, et le test de connexion échoue avec l'erreur suivante : `Access denied for user 'centreonbi'@''`. -### Accès à la base de données centrale +Le mot de passe peut être mis à jour dans **Rapports > Monitoring Business Intelligence > Paramètres globaux > Widgets de reporting**. -Téléchargez la licence envoyée par l'équipe Centreon pour pouvoir commencer à configurer les options générales. +### Accès à la base de données centrale @@ -501,10 +495,13 @@ La base de données de supervision MariaDB est hébergée sur le serveur de supe Lancez la commande ci-dessous pour autoriser le serveur de reporting à se connecter aux bases de données du serveur de supervision. Utilisez l'option suivante : ```shell -perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@ROOTPWD@ +perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@MYSQLROOTPASSWORD@ ``` -**@ROOTPWD@**: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option **root-password**. +Ce script retournera le mot de passe de l'utilisateur CentreonBI. +Le mot de passe peut être mis à jour dans **Rapports > Monitoring Business Intelligence > Paramètres globaux > Widgets de reporting**. + +@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. @@ -514,10 +511,13 @@ La base de données de supervision MySQL est hébergée sur le serveur de superv Lancez la commande ci-dessous pour autoriser le serveur de reporting à se connecter aux bases de données du serveur de supervision. Utilisez l'option suivante : ```shell -perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@ROOTPWD@ +perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@MYSQLROOTPASSWORD@ ``` -**@ROOTPWD@**: Mot de passe root de la base MySQL de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option **root-password**. +Ce script retournera le mot de passe de l'utilisateur CentreonBI. +Le mot de passe peut être mis à jour dans **Rapports > Monitoring Business Intelligence > Paramètres globaux > Widgets de reporting**. + +@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. @@ -710,6 +710,14 @@ apt update && apt install -y lsb-release ca-certificates apt-transport-https wge systemctl enable --now cron ``` +Vérifiez que le service **cron** est actif : + +```shell +systemctl is-active cron +``` + +La commande doit renvoyer `active`. + Installez les dépôts Centreon : ```shell @@ -721,13 +729,6 @@ echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.c apt update ``` -Ensuite, importez la clé du dépôt : - -```shell -wget -O- https://apt-key.centreon.com | gpg --dearmor | tee /etc/apt/trusted.gpg.d/centreon.gpg > /dev/null 2>&1 -apt update -``` - @@ -745,13 +746,13 @@ apt update Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` Activer les dépôts **codeready-builder** : ```shell -subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms +subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms ``` @@ -760,7 +761,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms Installez le dépôt **epel** : ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` Activer les dépôts **codeready-builder** : @@ -934,7 +935,7 @@ apt install centreon-bi-reporting-server -Lors de l'installation des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk**. +Lors de l'installation des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk** sur Alma / RHEL / Oracle Linux et **/usr/lib/jvm/java-25-openjdk-amd64** sur Debian 13. #### Activer les services @@ -969,7 +970,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimer les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrer à nouveau MariaDB : @@ -1038,7 +1039,7 @@ Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette opti mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` Si le service MariaDB échoue lors du démarrage, supprimez les fichiers *ib_logfile* (MariaDB doit absolument être stoppé) puis redémarrez à nouveau MariaDB : @@ -1129,7 +1130,7 @@ Puis redémarrez mysql. systemctl restart mysql ``` -Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans `/etc/my.cnf` NE fonctionnera PAS. +Il est nécessaire de modifier la limitation **LimitNOFILE**. Changer cette option dans les fichiers de configuration MySQL (`/etc/mysql/my.cnf` ou `/etc/mysql/conf.d/`) NE fonctionnera PAS. ```shell mkdir -p /etc/systemd/system/mysql.service.d/ @@ -1145,7 +1146,7 @@ rm -f /var/lib/mysql/ib_logfile* systemctl start mysql ``` -Si vous utilisez un fichier de socket spécifique pour MySQL, modifiez le fichier `/etc/my.cnf` et dans la section [client], ajoutez : +Si vous utilisez un fichier de socket spécifique pour MySQL, ajoutez la ligne suivante dans la section [client] d'un fichier situé dans `/etc/mysql/conf.d/` (par exemple `/etc/mysql/conf.d/centreon.cnf`) : ```shell socket=$PATH_TO_SOCKET$ @@ -1213,7 +1214,7 @@ Répondez **oui** à toutes les questions, sauf à "Disallow root login remotely #### Commencer à configurer Vérifiez que la base de reporting est bien démarrée puis lancez les -commandes ci dessous et répondez aux questions: +commandes ci dessous et répondez aux questions. Pour la question "database type for reporting database", sélectionnez MySQL ou MariaDB, ne laissez pas l'option par défaut "Automatic Discovery", cela cause une erreur. ```shell /usr/share/centreon-bi/config/install.sh @@ -1226,7 +1227,7 @@ Une fois l'installation terminée, poursuivez au chapitre suivant pour configure #### Problème avec l'échange de la clé SSH -Dans quelques cas, l'échange de clés SSH échoue. +Dans quelques cas, l'échange de clés SSH échoue, par exemple lorsque l'authentification par mot de passe est désactivée sur le serveur de supervision (`PasswordAuthentication no` dans `/etc/ssh/sshd_config`). Afin de résoudre le problème, procédez manuellement comme suit : Connectez-vous avec l'utilisateur `centreonBI` : @@ -1249,10 +1250,10 @@ cat /home/centreonBI/.ssh/id_ed25519.pub Maintenant, **sur le serveur de supervision** : -Créez un dossier `.ssh` dont `centreonBI` sera propriétaire, restreingez les droits sur ce fichier et collez dans le fichier `authorized_keys` le contenu de sa clé publique sur le serveur de reporting (affichée précédemment) : +Créez un dossier `.ssh` dont `centreonBI` sera propriétaire, restreignez les droits sur ce dossier et sur le fichier `authorized_keys`, et collez dans le fichier `authorized_keys` le contenu de sa clé publique sur le serveur de reporting (affichée précédemment) : ```bash -mkdir -p /home/centreonBI/.ssh/ && chown centreonBI: /home/centreonBI/.ssh/ && chmod 700 /home/centreonBI/.ssh/ && echo "@contenu de la clé publique@" > /home/centreonBI/.ssh/authorized_keys +mkdir -p /home/centreonBI/.ssh/ && chown centreonBI: /home/centreonBI/.ssh/ && chmod 700 /home/centreonBI/.ssh/ && echo "@contenu de la clé publique@" > /home/centreonBI/.ssh/authorized_keys && chown centreonBI: /home/centreonBI/.ssh/authorized_keys && chmod 600 /home/centreonBI/.ssh/authorized_keys ``` L'échange de clés doit enfin être validé par une première connexion qui acceptera la signature du serveur SSH. @@ -1265,7 +1266,6 @@ ssh centreonBI@@MONITORING_SERVER@ Vous pouvez maintenant quitter la session `centreonBI` avec `exit` ou `Ctrl-D`. Pour continuer, relancez le script d'installation (`/usr/share/centreon-bi/config/install.sh`) comme ci-dessus et répondez **Oui** lorsqu'on vous demande de procéder à l'échange de clés SSH. -Vous aurez une erreur lors de la création de l'USER car il existe déjà. Ce n'est pas une étape bloquante. ## Étape 4 : Configurez l'ETL dans l'interface de Centreon @@ -1453,7 +1453,7 @@ Vous pouvez l'exécuter en arrière-plan et rediriger la sortie du script vers u nohup /usr/share/centreon-bi//bin/centreonBIETL -r >> /var/log/centreon-bi/centreonBIETL.log 2>&1 & ``` -Regardez le fichier de log **/var/log/centreon-bi/centreonBIETL.log** : vous devriez voir des lignes avec les 4 parties suivantes : +La sortie s'affiche dans votre terminal ou, si vous avez exécuté la commande en arrière-plan, dans le fichier de log **/var/log/centreon-bi/centreonBIETL.log** (par exemple, utilisez `tail -f /var/log/centreon-bi/centreonBIETL.log` pour la suivre). Vous devriez voir des lignes avec les 4 parties suivantes : ```shell 2025-08-01 13:34:16 - INFO - [SCHEDULER] >>>>>>> start diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md index e75571aa676e..ed309d118c3a 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/update.md @@ -38,6 +38,7 @@ dnf update centreon-bi-server ```shell apt clean +apt update apt --only-upgrade install centreon-bi\* ``` @@ -84,6 +85,7 @@ dnf update centreon-bi\* ```shell apt clean +apt update apt --only-upgrade install centreon-bi\* ``` @@ -110,6 +112,7 @@ dnf update centreon-gorgone\* ```shell +apt update apt --only-upgrade install centreon-gorgone\* ``` diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md index 520e4ec29ff3..2380878e1edd 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/upgrade.md @@ -33,6 +33,55 @@ Lors d'une montée de version majeure (ex: 20.10.x à 26.10.x) il faut en premie Vous trouverez ce dépôt depuis votre compte sur notre [platefome de support, à la page **Dépôts**](https://support.centreon.com/hc/fr/categories/10341239833105-D%C3%A9p%C3%B4ts). +Sur le serveur de reporting, vous devez également installer le dépôt standard 26.10 : + + + + +```shell +dnf install -y dnf-plugins-core +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el9/centreon-26.10.repo +dnf clean all --enablerepo=* +``` + + + + +```shell +dnf install -y dnf-plugins-core +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el10/centreon-26.10.repo +dnf clean all --enablerepo=* +``` + + + + +> Si votre serveur de reporting est encore sous Debian 12, n'utilisez pas cette procédure. Suivez plutôt [Mettre à jour Centreon et Debian (12 vers 13) sur le même serveur](../migrate/upgrade-debian-in-place.md#step-11-upgrade-your-mbi-server-if-applicable) : cette procédure met à jour Debian et Centreon MBI en même temps et bascule les dépôts standard, business et plugins vers **trixie**. + +Sur Debian 13, les dépôts doivent pointer vers **trixie**. La ligne du dépôt standard est : + +```text +deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ trixie-26.10-stable main +``` + +La ligne du dépôt Business fournie sur le portail du support doit également utiliser **trixie**. Exécutez les commandes suivantes pour ajouter le dépôt standard : + +```shell +install -d /etc/apt/keyrings +wget -O /etc/apt/keyrings/centreon.asc https://apt-key.centreon.com +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee /etc/apt/sources.list.d/centreon-26.10-stable.list +apt update +``` + +Vérifiez que toutes les lignes des dépôts Centreon utilisent **trixie** : + +```shell +grep -h "packages.centreon.com" /etc/apt/sources.list.d/*.list +``` + + + + ## Étape 2 : Mettre à jour l'interface 1. Mettre à jour le paquet: se connecter sur le serveur Centreon et exécuter la commande suivante : @@ -64,7 +113,7 @@ apt install --only-upgrade centreon-bi-server ### Prérequis de la version Java -La version 26.10 nécessite Java 25. Lors de la mise à jour des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk**. +La version 26.10 nécessite Java 25. Lors de la mise à jour des paquets MBI, java (OpenJDK 25) sera automatiquement installé en tant que dépendance, si nécessaire. Le service **cbis** utilise toujours **/usr/lib/jvm/java-25-openjdk** sur Alma / RHEL / Oracle Linux et **/usr/lib/jvm/java-25-openjdk-amd64** sur Debian 13. Une fois la mise à jour terminée, vous pouvez supprimer les paquets Java 17 hérités de la version 25.10, si aucune autre application du serveur ne les utilise. ### Procédure de montée de version @@ -84,7 +133,7 @@ Vous pouvez maintenant procéder à la montée de version : ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all -dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common +dnf update -y centreon-bi\* centreon-perl-libs-common ``` @@ -93,9 +142,19 @@ dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common ```shell apt clean apt update -apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb centreon-perl-libs-common +apt install -y --only-upgrade centreon-bi-reporting-server centreon-perl-libs-common +``` + +Assurez-vous que le service **cron** est installé, activé et actif (il peut être absent sur les serveurs installés à l'origine sous Debian 12) : + +```shell +apt install -y cron +systemctl enable --now cron +systemctl is-active cron ``` +La dernière commande doit renvoyer `active`. + @@ -121,7 +180,23 @@ apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb cent 2. Voir [Mettre à jour MariaDB](../upgrade/upgrade-mariadb.md). -3. Démarrez le service **cbis** : + Sur Debian 13, si le paquet demande s'il faut remplacer `/etc/mysql/mariadb.conf.d/50-server.cnf`, conservez la version actuellement installée (répondez **N**). La version du paquet définit `bind-address = 127.0.0.1`, et le serveur central ne pourrait alors plus accéder à la base de données de reporting. + +3. Vérifiez que MariaDB fonctionne : + + ```shell + systemctl is-active mariadb + ``` + + La commande doit renvoyer `active`. Sur Debian 13, vérifiez également que MariaDB écoute toujours sur toutes les interfaces : + + ```shell + grep "^bind-address" /etc/mysql/mariadb.conf.d/50-server.cnf + ``` + + La valeur doit être `0.0.0.0`. Si elle est à `127.0.0.1`, remettez-la à `0.0.0.0` et redémarrez MariaDB avec `systemctl restart mariadb`. + +4. Démarrez le service **cbis** : ```shell systemctl start cbis diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 58da07caba44..2a2eb9250734 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -131,14 +131,14 @@ considerations. - interactive_timeout This only applies to the monitoring database. The [optimized configuration file](#optimize-the-database) of the reporting database sets these variables to 28800 seconds on purpose. -- When creating the CentreonBI user, you must execute the following command: `adduser centreonBI --force-badname` +- When creating the CentreonBI user, you must execute the following command: `adduser centreonBI --allow-bad-names` #### Users and groups | User | Group | |----------------------|------------------------------| | centreonBI (new) | www-data,centreon,centreonBI | -| apache (existing) | centreonBI | +| www-data (existing) | centreonBI | @@ -326,67 +326,6 @@ Make sure a **tmp** folder is created inside the same partition as **/var/lib/my > Do not set these MariaDB optimizations on your monitoring server. -If you are using MySQL: - -1. Perform the following action: - - - - -In the `/etc/my.cnf.d/mysql-server.cnf` file, add: - -```shell -log_bin_trust_function_creators=1 -``` - - - - -In the `/etc/my.cnf.d/mysql-server.cnf` file, add: - -```shell -log_bin_trust_function_creators=1 -``` - - - - -Create a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`) and add: - -```shell -[mysqld] -log_bin_trust_function_creators=1 -``` - -Ensure binary logging is turned on: - -```shell -printf '[mysqld]\nlog_bin_trust_function_creators=1\n' > /etc/mysql/conf.d/90-centreon-bi.cnf -systemctl restart mysql -mysql -e "show global variables like 'log_bin_trust_function_creators'" # expected: ON -``` - - - - -2. Restart MySQL. - -3. Check the database to confirm this variable is applied: - -```shell -show global variables like 'log_bin_trust_function_creators'; -+---------------------------------+-------+ -| Variable_name | Value | -+---------------------------------+-------+ -| log_bin_trust_function_creators | ON | -``` - -If the variable is not turned on, set it manually: - -```shell -mysql> SET GLOBAL log_bin_trust_function_creators = 1; -``` - Users and groups: | User | Group | @@ -464,6 +403,61 @@ In the central database, grant trigger rights to the **centreon** user: Replace **<host>** with the value returned by the previous query (for example, `localhost` if the database is local to the central server, or `%` or an IP address if it is remote). If the query returns several hosts, run these commands for each of them. +### Allow function creation (MySQL only) + +If the central database uses MySQL, perform the following actions on the server that hosts it before you enable the extension. Otherwise, the installation fails with `ERROR 1419`: the extension appears as installed, but its menu and options are missing. + +1. Perform the following action: + + + + +In the `/etc/my.cnf.d/mysql-server.cnf` file, add: + +```shell +log_bin_trust_function_creators=1 +``` + + + + +In the `/etc/my.cnf.d/mysql-server.cnf` file, add: + +```shell +log_bin_trust_function_creators=1 +``` + + + + +Create the `/etc/mysql/conf.d/90-centreon-bi.cnf` file and add: + +```shell +[mysqld] +log_bin_trust_function_creators=1 +``` + + + + +2. Restart MySQL. + +3. Check the database to confirm this variable is applied: + +```shell +show global variables like 'log_bin_trust_function_creators'; ++---------------------------------+-------+ +| Variable_name | Value | ++---------------------------------+-------+ +| log_bin_trust_function_creators | ON | +``` + +If the variable is not turned on, set it manually: + +```shell +mysql> SET GLOBAL log_bin_trust_function_creators = 1; +``` + ### Enable the extension The **Administration > Extension > Manager** menu allows you to install the extensions detected by Centreon. Click the **Centreon MBI** tile to install. @@ -487,9 +481,9 @@ menu, *Reports > Monitoring Business Intelligence > General Options*: > The **Password** field of the **Reporting widgets** tab is prefilled with **centreonbi**. This is not the password that the installation scripts (**centreonMysqlRights.pl** and **install.sh**) set for the **centreonbi** user. If you keep the default value, the widgets cannot connect to the reporting database, and the connection test fails with the following error: `Access denied for user 'centreonbi'@''`. -### Access to the Central database +The password can be updated in **Reporting > Monitoring Business Intelligence > General Options > Reporting widgets**. -Download the license sent by the Centreon team to start configuring the general options. +### Access to the Central database @@ -501,11 +495,15 @@ The MariaDB monitoring database is hosted on the central monitoring server. Run the command below to allow the reporting server to connect to the databases on the monitoring server. Use the following option: + ```shell -perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@ROOTPWD@ +perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@MYSQLROOTPASSWORD@ ``` -**@ROOTPWD@**: Root password of the MariaDB monitoring database. -If there is no password for the "root" user, do not specify the **root-password** option. + +This script will return the password for the CentreonBI user. +The password can be updated in **Reports > Monitoring Business Intelligence > General options > Reporting Widgets**. + +@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. @@ -517,11 +515,13 @@ Run the command below to allow the reporting server to connect to the databases Use the following option: ```shell -perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@ROOTPWD@ +perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRights.pl --root-password=@MYSQLROOTPASSWORD@ ``` -**@ROOTPWD@**: Root password of the MySQL monitoring database. -If there is no password for the "root" user, do not specify the **root-password** option. +This script will return the password for the CentreonBI user. +The password can be updated in **Reports > Monitoring Business Intelligence > General options > Reporting Widgets**. + +@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. @@ -712,6 +712,14 @@ apt update && apt install -y lsb-release ca-certificates apt-transport-https wge systemctl enable --now cron ``` +Check that the **cron** service is active: + +```shell +systemctl is-active cron +``` + +The command must return `active`. + Install the Centreon repositories: ```shell @@ -723,13 +731,6 @@ echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.c apt update ``` -Then import the repository key: - -```shell -wget -O- https://apt-key.centreon.com | gpg --dearmor | tee /etc/apt/trusted.gpg.d/centreon.gpg > /dev/null 2>&1 -apt update -``` - @@ -747,13 +748,13 @@ apt update Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` Enable the **codeready-builder** repositories: ```shell -subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms +subscription-manager repos --enable codeready-builder-for-rhel-9-x86_64-rpms ``` @@ -762,7 +763,7 @@ subscription-manager repos --enable codeready-builder-for-rhel-8-x86_64-rpms Install the **epel** repository: ```shell -dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm +dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm ``` Enable the **codeready-builder** repositories: @@ -892,6 +893,7 @@ echo "default-authentication-plugin=mysql_native_password" >> /etc/my.cnf.d/mysq systemctl daemon-reload systemctl restart mysqld systemctl list-units --type=service | grep -i mysql +``` @@ -936,7 +938,7 @@ apt install centreon-bi-reporting-server -When installing the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk**. +When installing the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk** on Alma / RHEL / Oracle Linux and **/usr/lib/jvm/java-25-openjdk-amd64** on Debian 13. #### Enable services @@ -973,7 +975,7 @@ option in `/etc/my.cnf` will NOT work. mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` If the MariaDB service fails to start, remove the *ib_logfile* files @@ -1051,7 +1053,7 @@ It is necessary to change the **LimitNOFILE** limitation. Changing this option i mkdir -p /etc/systemd/system/mariadb.service.d/ echo -ne "[Service]\nLimitNOFILE=32000\n" | tee /etc/systemd/system/mariadb.service.d/limits.conf systemctl daemon-reload -systemctl enable mariadb +systemctl restart mariadb ``` If the MariaDB service fails at the time of starting, remove the files *ib_logfile* @@ -1144,7 +1146,7 @@ Then restart mysql. systemctl restart mysql ``` -You must modify the **LimitNOFILE** limitation. Changing this option in `/etc/my.cnf` will NOT work. +You must modify the **LimitNOFILE** limitation. Changing this option in the MySQL configuration files (`/etc/mysql/my.cnf` or `/etc/mysql/conf.d/`) will NOT work. ```shell mkdir -p /etc/systemd/system/mysql.service.d/ @@ -1160,7 +1162,7 @@ rm -f /var/lib/mysql/ib_logfile* systemctl start mysql ``` -If you are using a specific socket file for MySQL, edit the `/etc/my.cnf` file and add the following to the [client] section: +If you are using a specific socket file for MySQL, add the following to the [client] section of a file inside `/etc/mysql/conf.d/` (for example `/etc/mysql/conf.d/centreon.cnf`): ```shell socket=$PATH_TO_SOCKET$ @@ -1229,7 +1231,7 @@ Answer **yes** to all questions except "Disallow root login remotely?" #### Start configuring -Make sure the MariaDB reporting system is started and then run the commands below and answer the questions: +Make sure the MariaDB reporting system is started and then run the commands below and answer the questions. For the "database type for reporting databse" select MySQL or MariaDB, do not leave the default option "Automatic Discovery" as this will result in an error. ```shell /usr/share/centreon-bi/config/install.sh @@ -1242,7 +1244,7 @@ Once the installation is complete, continue to the next chapter to configure the #### Problem with the SSH exchange key -In some cases, SSH key exchange fails. +In some cases, SSH key exchange fails, for example when password authentication is disabled on the monitoring server (`PasswordAuthentication no` in `/etc/ssh/sshd_config`). To solve the problem, do the following manually: Switch to the `centreonBI` user: @@ -1266,10 +1268,10 @@ cat /home/centreonBI/.ssh/id_ed25519.pub Now, **on the monitoring server**: -Create a `.ssh` folder that `centreonBI` will own, restrict permissions on this folder and paste into the `authorized_keys` file the contents of its public key on the reporting server (shown earlier): +Create a `.ssh` folder that `centreonBI` will own, restrict permissions on this folder and on the `authorized_keys` file, and paste into the `authorized_keys` file the contents of its public key on the reporting server (shown earlier): ```bash -mkdir -p /home/centreonBI/.ssh/ && chown centreonBI: /home/centreonBI/.ssh/ && chmod 700 /home/centreonBI/.ssh/ && echo "@reporting pub key content@" > /home/centreonBI/.ssh/authorized_keys +mkdir -p /home/centreonBI/.ssh/ && chown centreonBI: /home/centreonBI/.ssh/ && chmod 700 /home/centreonBI/.ssh/ && echo "@reporting pub key content@" > /home/centreonBI/.ssh/authorized_keys && chown centreonBI: /home/centreonBI/.ssh/authorized_keys && chmod 600 /home/centreonBI/.ssh/authorized_keys ``` The key exchange must then be validated by a first connection that will accept the SSH server signature. @@ -1282,7 +1284,6 @@ ssh centreonBI@@MONITORING_SERVER@ Then exit the `centreonBI` session with `exit` or `Ctrl-D` on both servers. To continue, run the installation script (`/usr/share/centreon-bi/config/install.sh`) as above and answer **Yes** when asked to proceed with the SSH key exchange. -You will get an error when creating the USER, because it already exists. This is not a blocking step. ## Step 4: Configure the ETL @@ -1448,7 +1449,7 @@ You may want to run it in the background and redirect the script's output to a l nohup /usr/share/centreon-bi//bin/centreonBIETL -r >> /var/log/centreon-bi/centreonBIETL.log 2>&1 & ``` -Go to the **/var/log/centreon-bi/centreonBIETL.log** log file: you should see some lines appear with 4 parts like: +The output is displayed in your terminal or, if you ran the command in the background, in the **/var/log/centreon-bi/centreonBIETL.log** log file (for example, use `tail -f /var/log/centreon-bi/centreonBIETL.log` to follow it). You should see some lines appear with 4 parts like: ```shell 2025-08-01 13:34:16 - INFO - [SCHEDULER] >>>>>>> start diff --git a/versioned_docs/version-26.10/reporting/update.md b/versioned_docs/version-26.10/reporting/update.md index 980c4b65554b..e5ea4d71183c 100644 --- a/versioned_docs/version-26.10/reporting/update.md +++ b/versioned_docs/version-26.10/reporting/update.md @@ -38,6 +38,7 @@ dnf update centreon-bi-server ```shell apt clean +apt update apt --only-upgrade install centreon-bi\* ``` @@ -85,6 +86,7 @@ dnf update centreon-bi\* ```shell apt clean +apt update apt --only-upgrade install centreon-bi\* ``` @@ -111,6 +113,7 @@ dnf update centreon-gorgone\* ```shell +apt update apt --only-upgrade install centreon-gorgone\* ``` diff --git a/versioned_docs/version-26.10/reporting/upgrade.md b/versioned_docs/version-26.10/reporting/upgrade.md index 61964bc6e33c..77714636cb72 100644 --- a/versioned_docs/version-26.10/reporting/upgrade.md +++ b/versioned_docs/version-26.10/reporting/upgrade.md @@ -32,6 +32,55 @@ When you upgrade from a previous major version to 26.10.x, you first need to upd You will find the new "Business" repository on the "Repositories" page in your [Centreon Support account](https://support.centreon.com/hc/en-us/categories/10341239833105-Repositories). +On the reporting server, you also need to install the 26.10 standard repository: + + + + +```shell +dnf install -y dnf-plugins-core +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el9/centreon-26.10.repo +dnf clean all --enablerepo=* +``` + + + + +```shell +dnf install -y dnf-plugins-core +dnf config-manager --add-repo https://packages.centreon.com/rpm-standard/26.10/el10/centreon-26.10.repo +dnf clean all --enablerepo=* +``` + + + + +> If your reporting server still runs Debian 12, do not use this procedure. Follow [Upgrading Centreon and Debian (12 to 13) on the same server](../migrate/upgrade-debian-in-place.md#step-11-upgrade-your-mbi-server-if-applicable) instead: it upgrades Debian and Centreon MBI together and switches the standard, business and plugins repositories to **trixie**. + +On Debian 13, the repositories must point to **trixie**. The standard repository line is: + +```text +deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ trixie-26.10-stable main +``` + +The Business repository line you get from the support portal must also use **trixie**. Run the following commands to add the standard repository: + +```shell +install -d /etc/apt/keyrings +wget -O /etc/apt/keyrings/centreon.asc https://apt-key.centreon.com +echo "deb [signed-by=/etc/apt/keyrings/centreon.asc] https://packages.centreon.com/apt-standard/ $(lsb_release -sc)-26.10-stable main" | tee /etc/apt/sources.list.d/centreon-26.10-stable.list +apt update +``` + +Check that all Centreon repository lines use **trixie**: + +```shell +grep -h "packages.centreon.com" /etc/apt/sources.list.d/*.list +``` + + + + ## Step 2: Upgrade the extension interface 1. Update the package, run the following commands: @@ -64,7 +113,7 @@ Update button to update the extension and the widgets. ### Java version requirement -Version 26.10 requires Java 25. When upgrading the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk**. +Version 26.10 requires Java 25. When upgrading the MBI packages, java (OpenJDK 25) is automatically installed as a dependency, if needed. The **cbis** service always uses **/usr/lib/jvm/java-25-openjdk** on Alma / RHEL / Oracle Linux and **/usr/lib/jvm/java-25-openjdk-amd64** on Debian 13. Once the upgrade is complete, you can remove the Java 17 packages left over from version 25.10, if no other application on the server uses them. ### Upgrade procedure @@ -84,7 +133,7 @@ Now you can start the upgrade process: ```shell dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarch.rpm dnf clean all -dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common +dnf update -y centreon-bi\* centreon-perl-libs-common ``` @@ -93,9 +142,19 @@ dnf update -y centreon-bi\* centreon-mariadb centreon-perl-libs-common ```shell apt clean apt update -apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb centreon-perl-libs-common +apt install -y --only-upgrade centreon-bi-reporting-server centreon-perl-libs-common +``` + +Make sure the **cron** service is installed, enabled and active (it may be missing on servers originally installed on Debian 12): + +```shell +apt install -y cron +systemctl enable --now cron +systemctl is-active cron ``` +The last command must return `active`. + @@ -121,7 +180,23 @@ apt install -y --only-upgrade centreon-bi-reporting-server centreon-mariadb cent 2. See [Upgrading MariaDB](../upgrade/upgrade-mariadb.md). -3. Start the **cbis** service: + On Debian 13, if the package asks whether to replace `/etc/mysql/mariadb.conf.d/50-server.cnf`, keep your currently installed version (answer **N**). The package version sets `bind-address = 127.0.0.1`, and the central server would then no longer be able to reach the reporting database. + +3. Check that MariaDB is running: + + ```shell + systemctl is-active mariadb + ``` + + The command must return `active`. On Debian 13, also check that MariaDB still listens on all interfaces: + + ```shell + grep "^bind-address" /etc/mysql/mariadb.conf.d/50-server.cnf + ``` + + The value must be `0.0.0.0`. If it is `127.0.0.1`, set it back to `0.0.0.0` and restart MariaDB with `systemctl restart mariadb`. + +4. Start the **cbis** service: ```shell systemctl start cbis From 868614236c3e330b97ec8f76d6dd713d69fd4c15 Mon Sep 17 00:00:00 2001 From: emgcentreon Date: Mon, 19 Oct 2026 11:12:32 +0200 Subject: [PATCH 18/18] Apply batched suggestions from code review Co-authored-by: emgcentreon --- .../version-26.10/reporting/installation.md | 2 +- versioned_docs/version-26.10/reporting/installation.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md index 544b9c2fe557..ea62e28b27e8 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md +++ b/i18n/fr/docusaurus-plugin-content-docs/version-26.10/reporting/installation.md @@ -767,7 +767,7 @@ dnf install -y https://dl.fedoraproject.org/pub/epel/epel-release-latest-9.noarc Activer les dépôts **codeready-builder** : ```shell -dnf config-manager --set-enabled ol8_codeready_builder +dnf config-manager --set-enabled ol9_codeready_builder ``` diff --git a/versioned_docs/version-26.10/reporting/installation.md b/versioned_docs/version-26.10/reporting/installation.md index 2a2eb9250734..c1b11211ba7b 100644 --- a/versioned_docs/version-26.10/reporting/installation.md +++ b/versioned_docs/version-26.10/reporting/installation.md @@ -503,7 +503,7 @@ perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRight This script will return the password for the CentreonBI user. The password can be updated in **Reports > Monitoring Business Intelligence > General options > Reporting Widgets**. -@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. +@MYSQLROOTPASSWORD@: The root password of the MariaDB monitoring database. If there is no password for the "root" user, do not specify the root-password option. @@ -521,7 +521,7 @@ perl /usr/share/centreon/www/modules/centreon-bi-server/tools/centreonMysqlRight This script will return the password for the CentreonBI user. The password can be updated in **Reports > Monitoring Business Intelligence > General options > Reporting Widgets**. -@MYSQLROOTPASSWORD@: Mot de passe root de la base MariaDB de supervision. S'il n'y a pas de mot de passe pour l'utilisateur "root", ne spécifiez pas l'option root-password. +@MYSQLROOTPASSWORD@: The root password of the MariaDB monitoring database. If there is no password for the "root" user, do not specify the root-password option.