> For the complete documentation index, see [llms.txt](https://documentation.efalia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.efalia.com/documentations/multigest/installation/migration-mise-a-jour.md).

# Migration et mise à jour

Cette page couvre la migration de Multigest entre environnements et l'application de patches de mise à jour.

***

## Migration entre Deux Environnements

Cette procédure permet de transférer une installation Multigest complète d'un serveur vers un autre (migration physique, changement d'infrastructure, duplication d'environnement production → recette).

### Composants à Migrer

| Composant                        | Description                                                    |
| -------------------------------- | -------------------------------------------------------------- |
| **Répertoire Multigest**         | Fichiers applicatifs et configuration                          |
| **Base de données `mtgweb`**     | Données GED                                                    |
| **Base de données `mgworkflow`** | Données workflow                                               |
| **Répertoire armoires**          | Fichiers documents (`IMAGES/`, `INDEX/`, `OCR/`, `CORBEILLE/`) |
| **Répertoire bannettes**         | Documents en attente de traitement                             |

{% hint style="warning" %}
Les répertoires armoires et bannettes doivent être copiés vers des **chemins identiques** sur le nouveau serveur. Tout changement de chemin nécessite une mise à jour de la configuration dans Multigest.
{% endhint %}

### Procédure de Migration

{% stepper %}
{% step %}

### Préparer le nouveau serveur

Sur le nouveau serveur :

1. Installez Apache + PHP → [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md)
2. Installez MariaDB → [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md)
3. Installez Multigest (installation fraîche) → [Installation de l'application](/documentations/multigest/installation/installation-application.md)
   {% endstep %}

{% step %}

### Sauvegarder l'ancien serveur

Sur l'ancien serveur, arrêtez les services Multigest :

* Automate MultiGest Webserveur
* Automate MultiGest Conversion
* Apache

**Exporter les bases de données :**

```bat
mysqldump -u root -p --default-character-set=latin1 ^
  --max_allowed_packet=104857600 --extended-insert ^
  --lock-tables --single-transaction ^
  mtgweb > C:\backup\mtgweb.sql

mysqldump -u root -p --default-character-set=latin1 ^
  --max_allowed_packet=104857600 --extended-insert ^
  --lock-tables --single-transaction ^
  mgworkflow > C:\backup\mgworkflow.sql
```

**Copier les répertoires :**

* Répertoire d'installation Multigest (`Multigest\`)
* Répertoire de chaque armoire (contenant `IMAGES/`, `INDEX/`, `OCR/`, `CORBEILLE/`)
* Répertoire des bannettes
  {% endstep %}

{% step %}

### Restaurer sur le nouveau serveur

**Importer les bases de données :**

```bat
mysql -u root -p mtgweb < C:\backup\mtgweb.sql
mysql -u root -p mgworkflow < C:\backup\mgworkflow.sql
```

**Restaurer les fichiers :**

* Remplacez le répertoire Multigest installé par la copie de l'ancien serveur
* Copiez les répertoires armoires et bannettes aux **mêmes chemins**
  {% endstep %}

{% step %}

### Adapter la configuration

Vérifiez et mettez à jour `webserveur.ini` si des chemins ou paramètres ont changé (nom de serveur, adresses IP, chemins de stockage).

Si le nom du serveur change, mettez à jour les références dans les options générales de Multigest.
{% endstep %}

{% step %}

### Vérifier l'intégrité de la base

Lancez `configurator.exe` pour vérifier l'intégrité des tables et des index. Effectuez cette vérification pendant une période de faible utilisation.
{% endstep %}

{% step %}

### Valider la migration

1. Démarrez les services sur le nouveau serveur
2. Connectez-vous à Multigest et vérifiez l'accès aux armoires
3. Ouvrez plusieurs documents pour confirmer que les fichiers sont accessibles
4. Testez les fonctionnalités critiques (workflow, bannettes, conversion)
   {% endstep %}
   {% endstepper %}

### Migration MySQL vers MariaDB

Si vous migrez simultanément le SGBD :

1. Vérifiez que toutes les tables sont en **InnoDB** (pas MyISAM) — exécutez `configurator.exe` si nécessaire
2. Sauvegardez avec `mysqldump` depuis MySQL
3. Installez MariaDB 10.6 sur le nouveau serveur
4. Restaurez les sauvegardes dans MariaDB
5. Optimisez `my.ini` pour MariaDB (paramètres InnoDB)

***

## Installation de la Mise à Jour (Patch)

Cette section décrit comment mettre à jour Multigest vers une nouvelle version via l'application d'un patch.

### Avant de Commencer

{% hint style="warning" %}
Effectuez toujours une **sauvegarde complète** (base de données + répertoire Multigest) avant d'appliquer un patch. Conservez la possibilité de revenir en arrière en cas de problème.
{% endhint %}

**Checklist pré-patch :**

* [ ] Sauvegarde base `mtgweb` effectuée
* [ ] Sauvegarde base `mgworkflow` effectuée
* [ ] Répertoire Multigest sauvegardé (renommé avec la date)
* [ ] Patch compatible avec la version Multigest en place vérifiée
* [ ] Intervention planifiée hors heures de production

### Procédure Automatisée (Recommandée)

{% stepper %}
{% step %}

### Préparer le répertoire Patchs

Créez un répertoire `Patchs\` dans le répertoire d'installation de la GED.
{% endstep %}

{% step %}

### Déposer le fichier patch

Copiez le fichier patch fourni par Efalia dans le répertoire `Patchs\`.
{% endstep %}

{% step %}

### Arrêter les services

Arrêtez les services dans cet ordre :

1. **Apache**
2. **Automate MultiGest Webserveur**
3. **Automate MultiGest Conversion**
   {% endstep %}

{% step %}

### Exécuter le patch

Lancez le fichier patch **en tant qu'administrateur**. L'assistant propose :

* Sauvegarde automatique de la base MariaDB (recommandé — laissez cochée)
* Application des mises à jour des fichiers et de la base de données
  {% endstep %}

{% step %}

### Redémarrer les services

Redémarrez les services dans l'ordre inverse :

1. **Automate MultiGest Conversion**
2. **Automate MultiGest Webserveur**
3. **Apache**
   {% endstep %}
   {% endstepper %}

### Procédure Manuelle

Utilisée lorsque le patch se présente sous forme d'archive compressée (sans exécutable) :

{% stepper %}
{% step %}

### Identifier les fichiers fournis

Un patch manuel contient généralement des répertoires partiels :

* `bin\` — exécutables et configuration
* `nef\` — fichiers interface
* `convbur\` — service de conversion
* `webserveur\` — fichiers PHP (répertoire complet)
* `docs\` — documentation interne (répertoire complet)
  {% endstep %}

{% step %}

### Arrêter les services

Arrêtez Apache, Automate MultiGest Webserveur et Automate MultiGest Conversion.
{% endstep %}

{% step %}

### Sauvegarder et remplacer

Pour chaque répertoire fourni dans le patch :

1. Renommez le répertoire existant avec la date (ex. : `bin_20260101\`)
2. Copiez le nouveau répertoire à la place
3. Si des fichiers de configuration ont été personnalisés (`webserveur.ini`, `automate.ini`…), reportez les modifications dans les nouveaux fichiers
   {% endstep %}

{% step %}

### Vérifier les points de configuration

| Point                           | Vérification                                |
| ------------------------------- | ------------------------------------------- |
| **OCR / Recherche plein texte** | Modules toujours installés et opérationnels |
| **SMTP**                        | Paramètre `SMTP` dans `php.ini` préservé    |
| **Portail de diffusion**        | Paramètres de configuration préservés       |
| **OnlyOffice**                  | Version compatible avec le patch appliqué   |
| **Intégrité BDD**               | Lancer `configurator.exe` après le patch    |
| {% endstep %}                   |                                             |

{% step %}

### Redémarrer et tester

Redémarrez les services et validez le bon fonctionnement de Multigest.
{% endstep %}
{% endstepper %}

### Retour Arrière (Rollback)

En cas de problème après le patch :

1. Arrêtez les services
2. Supprimez les répertoires mis à jour
3. Restaurez les répertoires sauvegardés (renommés avec la date)
4. Restaurez la sauvegarde de la base de données si nécessaire
5. Redémarrez les services

***

**Pour aller plus loin :**

* [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md)
* [Intégrations et connecteurs](/documentations/multigest/installation/integrations-connecteurs.md)
* [Notes de version](/documentations/multigest/annexes/notes-version.md)


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://documentation.efalia.com/documentations/multigest/installation/migration-mise-a-jour.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.