> For the complete documentation index, see [llms.txt](https://academy.cegedim.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.cegedim.cloud/francais/bases-de-donnees/mariadb/mariadb-mise-a-jour.md).

# MariaDB - Mise à jour

## **Processus de mise à niveau**

### Requête <a href="#mariadbupgradeinplace-requete" id="mariadbupgradeinplace-requete"></a>

La mise à jour d'un PaaS MariaDB est de la responsabilité de **cegedim.cloud** et peut être demandée via un ticket requête soumis depuis ITCare en précisant un créneau de disponibilité pour l'opération.

Merci de préciser si celle-ci doit être réalisée en heures non ouvrées pour planification d'une RFC.

Il est recommandé de procéder à la mise à jour de vos environnements de non production d'abord afin de pouvoir estimer le temps d'interruption généré par l'opération ainsi que de recetter vos applications dans la nouvelle version du moteur.

### Déroulement <a href="#mariadbupgradeinplace-deroulement" id="mariadbupgradeinplace-deroulement"></a>

La mise à jour d'un déploiement MariaDB (mono-instance ou Cluster MariaDB) se déroule en deux étapes complètement automatisées :

* Mise à jour du système d'exploitation préalable pour la version MariaDB corespondant
  * Plusieurs mises à jour selon le scénario : Debian 10 → Debian 11 -> Debian 12
* Mise à jour du moteur MariaDB dans la version cible

Selon la version source et cible de MariaDB, il peut donc être nécessaire de migrer d'abord le système d'exploitation dans une version supportée par **cegedim.cloud**

```mermaid
graph TD
    start["MariaDB X<br/>Debian X"] --> debian["Mise à jour Debian<br/>(une fois, deux fois ou non requise)"]
    debian --> mariadb["Mise à jour MariaDB"]
    mariadb --> done["MariaDB Y<br/>Debian Y"]

    debian -.->|Pris en charge par cegedim.cloud| mariadb

    style start fill:#e8e8e8,stroke:#000,stroke-width:2px,color:#000
    style debian fill:#ffe0b2,stroke:#e8820c,stroke-width:2px,color:#000
    style mariadb fill:#c8e6c9,stroke:#2ca02c,stroke-width:2px,color:#000
    style done fill:#e8e8e8,stroke:#000,stroke-width:2px,color:#000
```

### Impacts <a href="#mariadbupgradeinplace-impacts" id="mariadbupgradeinplace-impacts"></a>

* La durée d'une mise à jour est variable selon :
  * Les ressources cpu et ram configurées
  * La quantité de données dont les entêtes doivent être modifiés par le moteur MariaDB.
  * La quantité de données à réindexer suite au changement de librairie C, après une mise à jour de l'OS.
* Le mode de sauvegarde :
  * Point-in-time Recovery (PITR) à partir de la sauvegarde Rubrik.

### Temps de référence <a href="#mariadbupgradeinplace-tempsdereference" id="mariadbupgradeinplace-tempsdereference"></a>

A titre indicatif, voici les durées pour chaque étape d'une mise à jour d'une base de données mariaDB (mono-instance) de 30 Go :

* Mise à jour de Debian : 10 minutes en moyenne
* Mise à jour de MariaDB : 5 minute en moyenne

A titre indicatif, voici les durées pour chaque étape d'une mise à jour d'une base de données mariaDB (cluster Galera) de 30 Go :

* Mise à jour de Debian pour les 3 nœuds : 30 minutes en moyenne
* Mise à jour de MariaDB pour les 3 nœuds: 15 minute en moyenne

## **Matrice de support OS / MariaDB** <a href="#mariadbupgradeinplace-matricedesupportos-mariadbmatrice" id="mariadbupgradeinplace-matricedesupportos-mariadbmatrice"></a>

Distribution Linux supportées par **cegedim.cloud** en fonction de la version de mariaDB :

<table><thead><tr><th width="258">Versions de MariaDB</th><th>Distribution Linux supportée</th></tr></thead><tbody><tr><td>mariaDB 10.6</td><td>Debian 11</td></tr><tr><td>mariaDB 10.11</td><td>Debian 12</td></tr><tr><td>mariaDB 11.4</td><td>Debian 12</td></tr></tbody></table>

## **Chemins de mises à jour mariaDB supportés** <a href="#mariadbupgradeinplace-cheminsdemisesajourmariadbsupportes" id="mariadbupgradeinplace-cheminsdemisesajourmariadbsupportes"></a>

La mise à jour du système d'exploitation, si elle a lieu, peut nécessiter une réindexation complète (aussi prise en charge par **cegedim.cloud**) du fait des évolutions de la librairie C lors de la mise à jour du système d'exploitation.

Selon la quantité de données, cette opération peut prendre un certains temps.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.cegedim.cloud/francais/bases-de-donnees/mariadb/mariadb-mise-a-jour.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
