> 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/installation-application.md). # Installation de Multigest Cette page couvre l'installation complète de Multigest : installation initiale, finalisation, conversion bureautique et import des utilisateurs LDAP. *** ## Installation de Multigest Cette procédure décrit l'installation initiale de Multigest sur un serveur Windows. ### Prérequis Avant de lancer l'installation, vérifiez que les composants suivants sont en place : * **Base de données** MariaDB 10.5+ ou MySQL installée et configurée → [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md) * **Apache + PHP** installés → [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md) * Compte **administrateur local** disponible sur le serveur * Fichier d'installation Multigest fourni par Efalia ### Procédure d'Installation {% stepper %} {% step %} ### Lancer l'installeur Exécutez le fichier d'installation Multigest **en tant qu'administrateur**. Suivez les étapes de l'assistant : * Acceptez le contrat de licence * Choisissez le répertoire d'installation (ex. : `C:\Multigest\`) * Sélectionnez les composants à installer {% endstep %} {% step %} ### Configurer la connexion à la base de données Renseignez les paramètres de connexion MySQL/MariaDB : | Paramètre | Description | | ------------------ | ------------------------------------- | | **Hôte** | Adresse du serveur de base de données | | **Port** | 3306 (par défaut) | | **Nom de la base** | `mtgweb` (par défaut) | | **Utilisateur** | Compte MySQL dédié Multigest | | **Mot de passe** | Mot de passe du compte | {% hint style="info" %} Les bases de données standard sont `mtgweb` (données GED) et `mgworkflow` (données workflow). {% endhint %} {% endstep %} {% step %} ### Configurer le compte de service Après l'installation, modifiez le compte de service sur chaque service Multigest et Apache : 1. Ouvrez les **Propriétés** du service Windows 2. Onglet **Connexion** — saisissez les identifiants du compte local dédié 3. Redémarrez le service {% hint style="warning" %} Tous les services Multigest (Automate MultiGest Webserveur, Automate MultiGest Conversion, Apache) doivent utiliser un compte disposant des droits d'administrateur local. {% endhint %} {% endstep %} {% step %} ### Ajouter la licence PCU Les fonctionnalités PDFTron (visionneuse PDF) et OnlyOffice (édition bureautique) nécessitent une licence Efalia : 1. Localisez `module_PCU.exe` dans les sources d'installation 2. Exécutez-le **en tant qu'administrateur** 3. Laissez cochée l'option de redémarrage automatique du service Automate MultiGest Webserveur La licence est fournie par Efalia lors de la commande. {% endstep %} {% step %} ### Configurer le pare-feu Windows Ajoutez Apache aux exceptions du pare-feu Windows : 1. Ouvrez **Pare-feu Windows Defender** → Autoriser une application 2. Ajoutez l'exécutable Apache (`httpd.exe`) 3. Activez les profils **Domaine** et **Privé** (et **Public** si accès externe requis) {% endstep %} {% endstepper %} ### Vérification de l'Installation Après installation, accédez à l'URL de Multigest depuis un navigateur sur le serveur : ``` http://localhost/multigest/ ``` La page de connexion Multigest doit s'afficher. *** ## Finalisation de l'Installation Après l'installation initiale, trois étapes de finalisation sont nécessaires : configuration du compte de service, ajout de la licence PCU, et paramétrage du pare-feu Windows. ### Compte de Service Tous les services Multigest doivent s'exécuter sous un compte Windows disposant des droits d'administrateur local. {% stepper %} {% step %} ### Identifier les services à configurer Les services concernés sont : * **Automate MultiGest Webserveur** * **Automate MultiGest Conversion** * **Apache2.4** {% endstep %} {% step %} ### Modifier le compte de connexion Pour chaque service : 1. Ouvrez **services.msc** 2. Double-cliquez sur le service 3. Onglet **Connexion** → sélectionnez **Ce compte** 4. Saisissez le login et le mot de passe du compte local dédié 5. Cliquez sur **OK** puis redémarrez le service {% hint style="warning" %} Utilisez un compte local (et non un compte de domaine) pour éviter les problèmes d'accès aux fichiers en cas de changement de politique Active Directory. {% endhint %} {% endstep %} {% endstepper %} ### Licence PCU Les modules PDFTron (visionneuse PDF avancée) et OnlyOffice (édition bureautique en ligne) nécessitent une licence **PCU** fournie par Efalia. {% stepper %} {% step %} ### Localiser l'installeur de licence Le fichier `module_PCU.exe` se trouve dans le répertoire des sources d'installation Multigest. {% endstep %} {% step %} ### Installer la licence 1. Exécutez `module_PCU.exe` **en tant qu'administrateur** 2. Suivez les étapes de l'assistant 3. **Laissez cochée** l'option : *"Laisser cocher la case, pour que le service Automate MultiGest Webserveur redémarre automatiquement"* {% hint style="info" %} Le redémarrage automatique du service est nécessaire pour que la licence soit prise en compte immédiatement. {% endhint %} {% endstep %} {% endstepper %} ### Pare-feu Windows Apache doit être autorisé dans le pare-feu Windows pour que les utilisateurs puissent accéder à Multigest. {% stepper %} {% step %} ### Ajouter une exception Apache 1. Ouvrez **Panneau de configuration** → **Pare-feu Windows Defender** 2. Cliquez sur **Autoriser une application ou une fonctionnalité** 3. Cliquez sur **Modifier les paramètres** puis **Autoriser une autre application** 4. Parcourez jusqu'à l'exécutable Apache (`httpd.exe`, dans le répertoire d'installation Apache) {% endstep %} {% step %} ### Activer les profils réseau Cochez les profils selon le contexte de déploiement : | Profil | Quand l'activer | | ---------------- | ------------------------------------------------------------- | | **Domaine** | Toujours (accès réseau interne entreprise) | | **Privé** | Toujours | | **Public** | Uniquement si accès externe (hors réseau d'entreprise) requis | | {% endstep %} | | | {% endstepper %} | | *** ## Installation de la Conversion Bureautique Le service de conversion bureautique permet à Multigest de convertir automatiquement les documents Office (Word, Excel, PowerPoint) en PDF lors de leur import ou de leur archivage. ### Principe de Fonctionnement La conversion s'effectue via le service Windows **ConversionSrv.exe**, qui : * Surveille les demandes de conversion émises par l'automate Multigest * Utilise **PDFXChange** (version 4, compatible 64 bits) comme moteur de conversion * Peut être déployé sur le serveur Multigest principal ou sur un **poste réseau dédié** **Communication réseau :** | Connexion | Port | | ----------------------------- | ---- | | Automate MultiGest Webserveur | 1500 | | Base de données MySQL/MariaDB | 3306 | ### Prérequis * **Microsoft Office** 2003, 2007, 2010 ou 2013 installé sur la même machine que le service de conversion * Compte Windows avec droits **administrateur local** * Répertoire d'échange accessible en lecture/écriture par tous les composants {% hint style="warning" %} Microsoft Word doit être lancé au moins une fois avec le compte de service pour initialiser correctement les paramètres Office avant le démarrage du service de conversion. {% endhint %} ### Installation {% stepper %} {% step %} ### Choisir le mode d'installation Deux options sont disponibles : | Mode | Description | | --------------- | --------------------------------------------------------------------------------------------- | | **Automatique** | Exécutable avec assistant pas à pas — recommandé | | **Manuel** | Copie du répertoire `convbur\` depuis les sources d'installation dans le répertoire Multigest | | {% endstep %} | | {% step %} ### Créer le répertoire d'échange Créez un répertoire partagé servant au transit des documents en cours de conversion. Ce répertoire doit être : * Accessible en lecture/écriture par le service de conversion * Accessible par l'automate Multigest * De préférence local au serveur pour des raisons de performance {% endstep %} {% step %} ### Configurer ConversionSrv.ini Renseignez les chemins dans le fichier `ConversionSrv.ini` : | Paramètre | Description | | ------------------------ | ------------------------------------------------------- | | **Répertoire d'échange** | Chemin du répertoire de transit des documents | | **Moteur de conversion** | Imprimante virtuelle ou Microsoft Office | | **Timeout** | Délai maximal d'une conversion (en secondes) | | **Répertoire d'erreurs** | Répertoire de dépôt des fichiers en échec de conversion | | {% endstep %} | | {% step %} ### Installer l'imprimante virtuelle PDFXChange Installez l'imprimante PDFXChange à l'aide du numéro de série fourni dans les sources d'installation. Configurez ensuite `PrinterDrv.bat` avec les chemins des répertoires temporaires. {% endstep %} {% step %} ### Enregistrer le service Windows Depuis une invite de commande en tant qu'**administrateur**, enregistrez ConversionSrv comme service Windows avec la commande fournie dans la documentation d'installation. Configurez ensuite le **compte de connexion** du service (onglet Connexion dans les propriétés du service) avec un compte disposant des droits administrateur local. {% endstep %} {% step %} ### Vérifier l'installation Démarrez le service **ConversionSrv** et testez en déposant un document Word dans Multigest. La conversion en PDF doit s'effectuer automatiquement. Consultez les logs du service en cas d'erreur. {% endstep %} {% endstepper %} ### Déploiement sur Poste Distant Le service de conversion peut être installé sur un poste réseau séparé du serveur Multigest. Dans ce cas : 1. Installez ConversionSrv sur le poste distant 2. Configurez l'accès réseau au répertoire d'échange (partage Windows) 3. Accordez au compte de service Apache les droits en lecture/écriture sur ce partage 4. Vérifiez la connectivité réseau sur les ports 1500 et 3306 *** ## Import des Utilisateurs LDAP Cette section décrit la configuration de l'import des utilisateurs depuis Active Directory et l'activation de l'authentification SSO NTLM. {% hint style="info" %} Cette section couvre la **configuration côté installation**. Pour les options de synchronisation dans l'interface d'administration, voir [LDAP](https://github.com/Efalia/documentation-publique/blob/main/docs/documentations/multigest/administration/ldap.md) et [Utilisateurs et groupes](/documentations/multigest/administration/utilisateurs-groupes.md). {% endhint %} ### Prérequis | Prérequis | Détail | | ----------------------- | ------------------------------------------------------------------------------------------------------------- | | **Compte de domaine** | Doit disposer d'un accès en lecture sur l'Active Directory | | **Droits serveur GED** | Droits administrateur sur le serveur Multigest | | **Services configurés** | Le compte de domaine doit être configuré sur les services **Automate MultiGest Webserveur** et **Apache 2.4** | ### Fichiers de Configuration LDAP Deux fichiers dans le répertoire `Multigest\bin\` définissent la connexion à l'Active Directory : **ldap\_adresses** Contient les chemins LDAP vers les unités organisationnelles (OU) de l'Active Directory, avec un libellé d'affichage par entrée. Format : ``` Libellé;LDAP://DC=domaine,DC=local/OU=utilisateurs,DC=domaine,DC=local ``` {% hint style="warning" %} Le préfixe `LDAP://` doit être en majuscules. {% endhint %} **ldap\_domains** Associe les domaines utilisateurs aux domaines d'authentification. Contient généralement une seule entrée si l'entreprise utilise un domaine unique. Format : ``` domaine_utilisateur;domaine_authentification ``` ### Configuration du Domaine dans Multigest 1. Ouvrez **Administration** → **Options générales** 2. Section **Options de connexion Active Directory** 3. Saisissez le **nom du domaine** Windows ### Modes d'Authentification Le mode d'authentification se configure dans `Multigest\bin\webserveur.ini` : | Valeur `AUTH=` | Mode | | -------------- | ------------------------------------------------------------------------------ | | `0` | Login + mot de passe standard | | `1` | SSO NTLM — Internet Explorer uniquement | | `2` | SSO NTLM — tous navigateurs (IE + Firefox ou Chrome selon `NTLM_AUTH_BROWSER`) | | `3` | WSSO | ### Import des Utilisateurs depuis l'Interface Une fois les fichiers configurés : 1. Accédez à **Administration** → **Utilisateurs et groupes** 2. Cliquez sur **Annuaire Active Directory** 3. Sélectionnez une unité organisationnelle 4. Recherchez les utilisateurs 5. Cochez les comptes à importer 6. Validez l'import {% hint style="info" %} Une fois importé, un utilisateur disparaît de la liste d'import AD. Seules les **modifications de mot de passe** seront resynchronisées lors des imports suivants. {% endhint %} ### Niveaux de Sécurité de Connexion | Mode | Description | | ------------ | --------------------------------------------- | | **FULL** | Aucune authentification requise | | **SSO** | Module Apache d'authentification tierce | | **SSOMATCH** | SSO avec correspondance de profil utilisateur | *** **Pour aller plus loin :** * [Infrastructure serveur](/documentations/multigest/installation/infrastructure-serveur.md) * [Déploiement client](/documentations/multigest/installation/deploiement-client.md) * [Intégrations et connecteurs](/documentations/multigest/installation/integrations-connecteurs.md) * [Migration et mise à jour](/documentations/multigest/installation/migration-mise-a-jour.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/installation-application.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.