> 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/annexes/faq-installation.md).
# FAQ Installation
Réponses aux questions techniques les plus fréquentes sur l'installation, la configuration serveur et le dépannage de Multigest.
***
## Caractères Spéciaux Acceptés
### Dans les Mots de Passe
Les caractères spéciaux suivants ont été testés et validés dans les mots de passe Multigest :
```
& " ' ( - _ ) = + - $ * ! : ; , ? . / # { \ [ |
```
Les caractères accentués (`á`, `ç`, `è`, `é`…) ne sont **pas acceptés** dans les mots de passe.
{% hint style="info" %}
Cette liste a été testée et confirmée, mais ne constitue pas une liste exhaustive. En cas de doute sur un caractère spécifique, testez-le lors de la création du compte utilisateur.
{% endhint %}
### Dans les Index et Champs de Recherche
| Contexte | Recommandation |
| -------------------------- | -------------------------------------------------------------------------------------------------- |
| **Noms de champs d'index** | Évitez les accents, espaces et caractères spéciaux dans les noms de champs |
| **Valeurs d'index** | Les caractères accentués sont supportés si la base de données est configurée en `latin1` ou `utf8` |
| **Appels API** | Le séparateur \` |
### Dans les Noms de Fichiers
Évitez dans les noms de fichiers importés dans Multigest :
* Les caractères `/ \ : * ? " < > |`
* Les noms de plus de 255 caractères
***
## Erreur DAX Error (Composants ActiveX)
### Symptôme
L'erreur **DAX Error** est une violation d'accès liée à l'utilisation des composants **ActiveX** dans Internet Explorer. Elle se manifeste lors de l'ouverture de documents ou de la numérisation dans Multigest.
### Causes
| Cause | Description |
| -------------------------------- | ------------------------------------------------------------------------ |
| **Composants ActiveX obsolètes** | Version du Pack Collaboratif incompatible avec le système d'exploitation |
| **Navigateur non mis à jour** | Internet Explorer dans une version trop ancienne |
| **Cache navigateur corrompu** | Fichiers temporaires Internet Explorer en conflit avec les ActiveX |
### Solutions
{% stepper %}
{% step %}
### Mettre à jour le système d'exploitation
Installez toutes les mises à jour Windows disponibles, en particulier les correctifs de sécurité liés à Internet Explorer et aux composants COM/ActiveX.
{% endstep %}
{% step %}
### Vérifier la version d'Internet Explorer
La version **Internet Explorer 11** est requise pour le bon fonctionnement des composants ActiveX Multigest. Les versions antérieures ne sont pas supportées.
Vérifiez via **Aide** → **À propos d'Internet Explorer**.
{% endstep %}
{% step %}
### Vider le cache d'Internet Explorer
1. Ouvrez Internet Explorer
2. **Outils** → **Options Internet** → onglet **Général**
3. Section **Historique de navigation** → cliquez sur **Supprimer**
4. Cochez : **Fichiers Internet temporaires**, **Cookies**, **Historique**
5. Cliquez sur **Supprimer**
6. Redémarrez Internet Explorer
{% endstep %}
{% step %}
### Réinstaller le Pack Collaboratif
Si l'erreur persiste après les étapes précédentes :
1. Désinstallez le Pack Collaboratif depuis **Panneau de configuration** → **Programmes**
2. Redémarrez le poste
3. Réinstallez la dernière version depuis le serveur Multigest → [Déploiement sur les postes clients](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/installation/deploiement-postes-clients.md)
{% endstep %}
{% endstepper %}
{% hint style="info" %}
Les fonctionnalités ActiveX (Pack Collaboratif) nécessitent Internet Explorer 11. Chrome et Firefox ne supportent pas les ActiveX — utilisez ces navigateurs pour la consultation uniquement.
{% endhint %}
***
## Échec de Fusion PDF
### Symptômes
La fusion de documents PDF dans Multigest échoue ou génère un fichier PDF corrompu ou incomplet.
### Causes Courantes
| Cause | Description |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **PDF protégé par mot de passe** | Les PDF avec restrictions de modification ne peuvent pas être fusionnés |
| **PDF non standard** | Certains PDF générés par des applications tierces ne respectent pas strictement la norme PDF — ils peuvent provoquer des erreurs de traitement |
| **PDF/A en conflit** | La fusion de documents PDF et PDF/A peut poser des problèmes de compatibilité de version |
| **Fichier corrompu** | Un des documents sources est endommagé |
| **Ressources insuffisantes** | Traitement de très grands PDF sur un serveur avec peu de mémoire disponible |
### Résolution
{% stepper %}
{% step %}
### Vérifier les documents sources
Ouvrez chaque document PDF individuellement dans un lecteur PDF (Adobe Reader, PDFTron) pour confirmer qu'ils ne sont pas corrompus et ne sont pas protégés par mot de passe.
{% endstep %}
{% step %}
### Convertir les PDF problématiques
Si un document pose problème, réimprimez-le via une imprimante PDF virtuelle (PDFXChange, Microsoft Print to PDF) pour créer une version PDF standard conforme.
{% endstep %}
{% step %}
### Vérifier les logs Multigest
Consultez les logs de l'Automate MultiGest Webserveur pour identifier le message d'erreur exact lors de la fusion. Les logs indiquent généralement quel fichier pose problème.
{% endstep %}
{% step %}
### Vérifier l'espace disque et la mémoire
Assurez-vous que le serveur dispose de suffisamment d'espace disque temporaire et de mémoire RAM lors de la fusion de documents volumineux.
{% endstep %}
{% endstepper %}
Peut-on fusionner des PDF/A avec des PDF standards ?
La fusion d'un PDF/A avec un PDF non conforme PDF/A peut produire un document qui ne respecte plus la norme PDF/A. Si la conformité PDF/A est requise, convertissez d'abord tous les documents en PDF/A avant la fusion.
Y a-t-il une limite de taille pour la fusion ?
Il n'y a pas de limite absolue, mais la fusion de fichiers très volumineux (plusieurs centaines de Mo) peut provoquer des dépassements de mémoire. Si c'est le cas, fusionnez les documents en plusieurs étapes ou augmentez la mémoire disponible sur le serveur.
***
## Authentification Basique Office Désactivée
### Contexte
Microsoft a désactivé l'**authentification basique** (Basic Authentication) pour les protocoles Exchange/MAPI dans les versions récentes de Microsoft Office et Microsoft 365. Cette désactivation affecte la connexion de Multigest aux boîtes mail via les anciens protocoles.
### Impact sur Multigest
| Fonctionnalité | Impact |
| ----------------------------------- | ----------------------------------------------------- |
| **Récupération des mails entrants** | Peut échouer si configuré en authentification basique |
| **Envoi de notifications** | Non impacté (passe par SMTP, non concerné) |
| **Complément Office Outlook** | Peut nécessiter une reconfiguration |
### Solution
Migrez vers l'authentification **OAuth2** pour la connexion IMAP/Exchange :
→ [Intégrations — Paramétrage Office 365 IMAP OAuth2](/documentations/multigest/administration/integrations-admin.md)
Cette procédure configure l'authentification moderne via Azure Active Directory, compatible avec les politiques de sécurité Microsoft actuelles.
### Vérification
Après migration vers OAuth2 :
1. Testez la récupération des mails depuis l'interface d'administration Multigest
2. Vérifiez que les bannettes mail reçoivent bien les nouveaux messages
3. Contrôlez les logs de l'Automate MultiGest Webserveur en cas d'erreur
{% hint style="warning" %}
Si votre installation Multigest utilise encore l'authentification basique pour la connexion mail, planifiez la migration vers OAuth2 dès que possible. Microsoft désactive progressivement ce protocole sur tous les tenants Microsoft 365.
{% endhint %}
***
## Préconisations de Paramétrage Serveur
### Démarrage des Services
Respectez l'ordre de démarrage suivant pour éviter les erreurs de connexion au démarrage :
1. **MariaDB / MySQL** — démarrer en premier
2. *(Attendre 10 à 15 minutes)* — laisser la base de données finaliser son démarrage
3. **Apache**
4. **Automate MultiGest Webserveur**
5. **Automate MultiGest Conversion**
{% hint style="warning" %}
Ne lancez pas Apache ou les services Multigest immédiatement après MariaDB. La base de données a besoin de 10 à 15 minutes pour terminer son initialisation, surtout sur un serveur avec un volume important de données.
{% endhint %}
### Maintenance Hebdomadaire
**Redémarrez le serveur applicatif et le serveur de base de données chaque week-end** (hors heures ouvrées) pour :
* Libérer la mémoire accumulée au fil de la semaine
* Appliquer les mises à jour Windows en attente
* Permettre la rotation des logs
Configurez ce redémarrage dans le **Planificateur de tâches Windows** pour qu'il s'effectue automatiquement (ex. : dimanche à 3h00).
### Optimisation MariaDB
| Paramètre `my.ini` | Recommandation |
| ------------------------- | --------------------------- |
| `innodb_buffer_pool_size` | 60-70% de la RAM disponible |
| `wait_timeout` | 28800 (8 heures) |
| `interactive_timeout` | 28800 |
| `max_connections` | 200 minimum |
### Espace Disque
Surveillez régulièrement l'espace disque disponible sur :
* Le volume hébergeant les **armoires GED** (croissance continue)
* Le volume hébergeant la **base de données** (index et logs)
* Le volume **temporaire** (conversion et traitement)
Configurez des alertes de supervision lorsque l'espace libre passe sous 20%.
### Sauvegardes
| Élément | Fréquence recommandée |
| -------------------------------- | ----------------------- |
| **Base de données `mtgweb`** | Quotidien |
| **Base de données `mgworkflow`** | Quotidien |
| **Répertoires armoires** | Quotidien (incrémental) |
| **Répertoire Multigest** | Hebdomadaire |
Conservez les sauvegardes sur un emplacement **externe au serveur** (NAS, cloud, bande…).
***
## Paramétrer l'Antivirus
Un antivirus mal configuré peut bloquer les processus Multigest, interférer avec la conversion de documents ou verrouiller les fichiers en cours de traitement.
### Répertoires à Exclure de l'Analyse
L'antivirus doit exclure les répertoires suivants de l'analyse en temps réel :
| Répertoire | Description |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------- |
| **Répertoire d'installation Multigest** | Ex. : `C:\Multigest\` — contient les exécutables et fichiers de configuration |
| **Répertoires de stockage des armoires** | Répertoires `IMAGES\`, `INDEX\`, `OCR\`, `CORBEILLE\` de chaque armoire |
| **Répertoires des bannettes** | Zones de dépôt des documents entrants |
| **Répertoires temporaires** | Répertoires utilisés pour la conversion et le traitement des documents |
| **Répertoire MariaDB/MySQL** | Ex. : `C:\MariaDB\data\` — les fichiers de base de données ne doivent pas être analysés en temps réel |
{% hint style="warning" %}
L'analyse en temps réel des fichiers de base de données MariaDB peut provoquer des corruptions. Excluez systématiquement le répertoire de données MySQL/MariaDB.
{% endhint %}
### Services à Exclure
Ajoutez les services Windows suivants à la liste des exclusions de processus :
| Service | Description |
| ------------------------ | --------------------------------- |
| `httpd.exe` | Serveur Apache |
| `AutomateWebServeur.exe` | Automate MultiGest Webserveur |
| `ConversionSrv.exe` | Service de conversion bureautique |
| `mysqld.exe` | Service MariaDB/MySQL |
### Exécutables à Exclure
Ajoutez également les processus suivants aux exclusions :
* `php-cgi.exe` (ou `php.exe`)
* `PDFXCview.exe` (visionneuse PDF)
* `ImportMgest.exe` (import standard)
* `IMPORTPDF_pix.EXE` (import SPOOL PDF)
### Résolution des Problèmes Antivirus
Si Multigest présente des comportements anormaux après installation d'un antivirus :
1. Vérifiez les logs de l'antivirus pour identifier les fichiers/processus bloqués
2. Ajoutez les exclusions correspondantes
3. Redémarrez les services Multigest
En cas de doute, désactivez temporairement l'antivirus pour confirmer que c'est bien lui la cause du problème.
***
## Procédures Stockées — Changer le DEFINER
### Contexte
Les procédures stockées de Multigest sont créées dans MariaDB/MySQL sous le nom d'un utilisateur spécifique (le compte utilisé lors de l'installation). Si cet utilisateur est supprimé ou renommé, les procédures stockées deviennent inaccessibles.
### Symptôme
Multigest affiche des erreurs du type **"Accès refusé"** ou **"Procédure stockée introuvable"** lors de certaines opérations, notamment dans le workflow ou les bannettes.
### Cause
Le **DEFINER** (créateur) d'une procédure stockée MariaDB/MySQL est l'utilisateur qui l'a créée. Si cet utilisateur n'existe plus, l'exécution de la procédure est refusée même si le compte appelant a les droits nécessaires.
### Solution
{% stepper %}
{% step %}
### Identifier les procédures stockées concernées
Connectez-vous à la base de données `mtgweb` (ou `mgworkflow`) et listez les procédures avec leur créateur :
```sql
SELECT ROUTINE_NAME, DEFINER
FROM INFORMATION_SCHEMA.ROUTINES
WHERE ROUTINE_SCHEMA = 'mtgweb'
AND ROUTINE_TYPE = 'PROCEDURE';
```
{% endstep %}
{% step %}
### Recréer le compte si supprimé
Si l'utilisateur créateur a été supprimé, le recréer avec les mêmes droits est la solution la plus simple. Sinon, continuez vers l'étape suivante.
{% endstep %}
{% step %}
### Modifier le DEFINER des procédures
Exportez les procédures stockées avec `mysqldump`, modifiez le DEFINER dans le fichier SQL, puis réimportez :
```bat
mysqldump -u root -p --routines --no-data mtgweb > routines.sql
```
Ouvrez `routines.sql` et remplacez toutes les occurrences de l'ancien DEFINER par le nouveau compte :
```sql
-- Avant :
/*!50003 CREATE DEFINER=`ancien_user`@`localhost` PROCEDURE ... */
-- Après :
/*!50003 CREATE DEFINER=`root`@`localhost` PROCEDURE ... */
```
Réimportez les procédures modifiées.
{% endstep %}
{% step %}
### Utiliser configurator.exe
L'outil `configurator.exe` fourni avec Multigest peut régénérer les procédures stockées sous le compte courant. Exécutez-le en tant qu'administrateur et lancez la vérification/réparation des procédures.
{% endstep %}
{% endstepper %}
{% hint style="warning" %}
Ces opérations nécessitent un accès administrateur à la base de données MariaDB/MySQL et doivent être effectuées hors heures de production. Sauvegardez les bases avant toute modification.
{% endhint %}
***
## Paramétrage des Dossiers Temporaires du PDF Viewer
### Symptôme
Le PDF Viewer (PDFTron/PDFXCview) rencontre des erreurs d'ouverture ou d'affichage de documents, ou génère des fichiers temporaires qui s'accumulent sur le disque.
### Répertoires Concernés
| Répertoire | Rôle |
| ----------------------------------- | -------------------------------------------------------------------- |
| **Répertoire temporaire système** | `%TEMP%` ou `%TMP%` — utilisé par les composants ActiveX |
| **Répertoire temporaire Multigest** | Configuré dans `webserveur.ini` — pour les fichiers de rendu serveur |
### Configuration
**Côté Serveur (PDFTron)**
Vérifiez dans `webserveur.ini` que le répertoire temporaire défini pour la visionneuse PDF est :
* Accessible en lecture/écriture par le compte de service Apache
* Sur un volume avec suffisamment d'espace disque
* Régulièrement purgé (les fichiers temporaires s'accumulent sinon)
**Côté Client (PDFXCview — Pack Collaboratif)**
Si vous utilisez la visionneuse ActiveX (Internet Explorer) :
1. Vérifiez que le répertoire `%TEMP%` utilisateur est accessible
2. Accordez les droits en écriture si un problème de permission est détecté
3. Configurez le chemin dans `PrinterDrv.bat` si la conversion PDF est utilisée
### Nettoyage des Fichiers Temporaires
Pour éviter l'accumulation de fichiers temporaires :
1. **Automatique** : configurez une tâche planifiée pour vider le répertoire temporaire Multigest périodiquement (ex. : toutes les semaines)
2. **Manuel** : videz le répertoire temporaire en dehors des heures ouvrées
Le répertoire temporaire de la visionneuse doit être exclu de l'analyse antivirus en temps réel pour éviter les verrouillages de fichiers.
***
**Pour aller plus loin :**
* [Installation de Multigest](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/installation/installation-multigest.md)
* [Fichiers de configuration](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/installation/fichiers-configuration.md)
* [Installation de la base de données](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/installation/installation-base-donnees.md)
* [Déploiement sur les postes clients](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/installation/deploiement-postes-clients.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/annexes/faq-installation.md?ask=&goal=
```
`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.