Remarque importante :
La migration d’un système DocuWare est un processus complexe qui peut s’avérer encore plus difficile en cas de configurations différentes des bases de données, des systèmes d’exploitation et des versions de DocuWare. Ce processus nécessite une connaissance technique approfondie de DocuWare. Notre expérience a montré que des problèmes peuvent survenir en raison d'erreurs ou d'imprécisions lors de l'exécution de ce processus. La migration d'un système DocuWare vers un nouveau serveur ou la migration de composants d'un système DocuWare, ainsi que les problèmes résultant de la migration du système d'un serveur à un autre, ne font donc pas partie de nos services de Support. Si vous avez besoin d’une assistance du support DocuWare, nous ne pouvons vous la proposer que sur la base d’une facturation au temps passé et aux ressources utilisées. Dans ce cas, nous vous recommandons de contacter notre service Professional Services avant le lancement d’un tel projet en envoyant un E-mail à professional.services.emea@docuware.com ou professional.services.americas@docuware.com
Cet article décrit comment migrer l’ensemble du système DocuWare, y compris la base de données, vers un nouveau serveur.
Pour la migration d’une base de données MySQL interne, veuillez consulter l’article KBA-37402
Migration et mise à niveau
Si vous prévoyez une migration et une mise à niveau de votre système, veuillez suivre ces instructions :
Vous devez d'abord migrer le système DocuWare existant vers le nouveau serveur. Veuillez installer sur le nouveau serveur la même version de DocuWare que celle installée sur l'ancien serveur.
Remarque : l'installation directe d'une version plus récente de DocuWare ne fonctionne pas et n'est pas prise en charge ! Même à l'aide des « outils de mise à niveau », vous n'obtiendrez pas de résultats sans erreur. Veuillez donc suivre ces instructions.Sur le nouveau serveur, vous devez vérifier les fonctions les plus importantes telles que la recherche, l'affichage, le stockage, etc.
Vous pourrez ensuite lancer la mise à niveau vers une version plus récente de DocuWare.
Nouvelle machine :
Installez et configurez la nouvelle machine conformément à la configuration système obligatoire pour la version de DocuWare utilisée
Copiez le programme d'installation de DocuWare de l'ancien serveur vers le nouveau
Copiez la licence de l'ancien serveur vers le nouveau
Assurez-vous d’utiliser un fichier de licence portant le même nom d’organisation
Créez les lecteurs mappés obligatoires pour les emplacements de stockage
Créez l'utilisateur de service DocuWare – veuillez consulter l'article suivant :KBA-36218
Si nécessaire, installez sur le nouveau serveur DocuWare le même serveur de base de données que celui utilisé sur l’ancien serveur :
Remarque : la version de la base de données peut être différente. Veuillez vérifier la compatibilité descendante de votre base de données.
Ancienne machine :
Arrêtez tous les serveurs DocuWare et tous les pools d’applications sur l’ancien serveur.
Utilisez les applications appropriées pour créer des sauvegardes de toutes les bases de données DocuWare :
dwsystem
dwdata
dwlogging (facultatif ; si vous l'utilisez, veuillez le copier)
dwnotification
dwnotificationbackup (facultatif ; si vous l'utilisez, veuillez le copier)
dwworkflowengine
Les étapes suivantes doivent être effectuées avec le plus grand soin. Une fois celles-ci terminées et le programme Server Manager fermé, vous ne pourrez plus l'utiliser sur la machine actuelle. Toute erreur vous empêchera également de l'exécuter sur la nouvelle machine.
Veuillez noter que DocuWare ne fonctionnera plus sur la machine actuelle après ces étapes. Veuillez préparer les informations suivantes :
Le nom d'utilisateur et le Mot de passe du service DocuWare sur la nouvelle machine.
Le nom de la machine du nouveau serveur.
Le nom d'utilisateur et le Mot de passe de la base de données.
Une sauvegarde de la base de données du système existant, entièrement vérifiée.
Préparation de la base de données pour la migration :
Démarrez UNIQUEMENT les pools d'applications DocuWare Identity, DocuWare Platform Services et DocuWare Paramètres
Lancez le programme DocuWare Server Manager.
Étape 1 : Modifier les connexions à la base de données
Remarque : vous pouvez ignorer cette étape si le serveur de base de données ne change pas.Accédez à « Connexions à la base de données » > « Authentification »
Modifiez le serveur pour qu’il pointe vers le nouveau nom de la machine sur laquelle le serveur de base de données est installé.
Remarque : si le nom d'utilisateur et/ou le Mot de passe de la base de données sont différents sur le nouveau serveur, modifiez-les également à ce stade. Ne testez aucune de ces connexions.Répétez ces mêmes modifications pour toutes les autres connexions à la base de données qui pointent vers le même serveur, telles que « Contenu », « Journalisation », « Notifications » et « Workflow Engine ».
Étape 2 : Modifier la connexion Fulltext
Remarque : vous pouvez ignorer cette étape si le Fulltext Server est installé sur une machine distincte.Accédez à Connexions système > Services DocuWare externes > Connexion Fulltext par défaut
Modifiez l’URL Tomcat uniquement si le nouveau Fulltext Server se trouve sur la nouvelle machine.
Étape 3 : Modifier les connexions Web
Accédez à « Connexions système > Connexions Web »
Modifiez l'adresse interne et le répertoire racine HTTP si nécessaire.
Remarque : assurez-vous que les deux URL se terminent par un /S'il n'y a qu'une seule connexion Web, une fois la connexion modifiée, vous serez déconnecté du Gestionnaire de serveur.
Installation sur un nouveau serveur :
Sauvegardez la base de données dwsystem modifiée et nommez-la de manière appropriée afin de la différencier de la sauvegarde précédente non modifiée.
Importez les bases de données sauvegardées sur le nouveau serveur de bases de données.
Veillez à importer la sauvegarde modifiée de dwsystem plutôt que la sauvegarde d'origine.
Lancez le programme d'installation de DocuWare en utilisant la même version que celle installée sur l'ancien serveur.
Lorsque vous y êtes invité, choisissez «Étendre un système DocuWare existant ».
Saisissez les identifiants du nouveau serveur de base de données et suivez toutes les instructions.
Installez tous les rôles de serveur (Frontend, Backend, Fulltext, Server Messaging) selon vos besoins.
Une fois l'installation terminée
Avant d'autoriser l'accès à DocuWare par les utilisateurs, assurez-vous que les étapes suivantes ont bien été effectuées :
Copiez tous les emplacements de stockage des documents et des Bacs s'ils existent sur le serveur.
Copiez les index Fulltext de l'ancienne machine vers la nouvelle (si Fulltext a été migré)
Copiez les données des formulaires de fusion depuis le répertoire C:\ProgramData\DocuWare\SystemStorage de l’ancienne machine vers la nouvelle.
Redéployez la recherche plein texte sur toutes les armoires compatibles avec cette fonctionnalité via Configurations > Armoires : décochez la case « Plein texte », enregistrez, cochez à nouveau la case « Plein texte », puis enregistrez.
Répétez les étapes de désinstallation et de réinstallation sur tous les serveurs DocuWare Frontend et Backend.
Si Fulltext est installé sur une machine distincte, aucune désinstallation ni réinstallation n'est obligatoire.
Testez le système.
Cette base de connaissances s'applique UNIQUEMENT aux organisations disposant d'une installation sur site.
Veuillez noter : Cet article est une traduction de l'anglais. Les informations contenues dans cet article sont basées sur la ou les versions originales des produits en langue anglaise. Il peut y avoir des erreurs mineures, notamment dans la grammaire utilisée dans la version traduite de nos articles. Bien que nous ne puissions pas garantir l'exactitude complète de la traduction, dans la plupart des cas, vous la trouverez suffisamment informative. En cas de doute, veuillez revenir à la version anglaise de cet article.