L'installation des bases de données MySQL ne fait pas partie du support DocuWare.
MySQL étant une application tierce, nous n'avons aucun moyen de résoudre les problèmes, de recommander des paramètres supplémentaires ou de vérifier si l'installation est complète.
DocuWare n'est pas responsable des systèmes corrompus si la base de données est endommagée pendant ou après l'installation.
Question :
Comment mettre à niveau une base de données interne V2 (MySQL 5.6) vers une base de données interne V3 (MySQL 8)
Réponse :
La mise à niveau de MySQL 5.6 vers MySQL 8 s'effectue en trois étapes.
Vous pouvez vérifier la version de MySQL actuellement installée en exécutant
SHOW VARIABLES LIKE "%version%" ;
Tous les fichiers nécessaires peuvent être trouvés en utilisant le téléchargement suivant :
Download-MySQL56TO8
Notes importantes :
Assurez-vous d'arrêter toutes les applications accédant à la base de données avant toute tentative de sauvegarde/décharge.
Assurez-vous d'avoir une sauvegarde valide de votre base de données.
Assurez-vous d'avoir une sauvegarde de votre répertoire d'installation.
Ne mettezpas DocuWare à niveau directement après la mise à niveau de MySQL.
Laissez le système fonctionner pendant un certain temps pour vérifier si toutes les fonctionnalités sont toujours présentes.
Informations de base sur MySQL :
Au cours du KBA, le répertoire d'installation ainsi que le répertoire de données seront mentionnés.
Le répertoire d'installation contient tous les fichiers nécessaires à l'exécution du service MySQL et se trouve dans C:\NProgram Files (x86)\NDocuWare\NInternal Database V1\Nou C:\NProgram Files (x86)\NDocuWare\NInternal Database V2\Nselon les installations précédentes.
Si vous ne savez pas où se trouve votre répertoire d'installation, vérifiez le service MySQL dans les services Windows, vous obtiendrez le chemin vers le fichier MySQLD.exe et avec lui le dossier d'installation.
Dans ce dossier, vous trouverez le my.ini et de nombreux sous-dossiers, par exemple \bin.
\bin contient la plupart des exécutables et est plus tard nécessaire pour exécuter les mises à jour.
Le répertoire data est situé dans C:\NProgramData\NDocuWare\NInternal Database\N.
C'est à juste titre que le dossier est nommé data.
Il contient le contenu et la structure de toutes les tables de la base de données MySQL installée.
Pour la partie initiale de la mise à niveau, vous ne devez travailler que dans le dossier d'installation.
Lors de la mise à niveau vers MySQL 8, vous devez ajouter un dossier au même niveau que le répertoire data.
MySQL 5.6 to MySQL 5.6 final
Stop MySQL service
Extract mysql-5.6.51-winx64.zip
Ne supprimez pas, mais remplacez les fichiers dans le dossier d'installation (par défaut C:\Program Files (x86)\NDocuWare\NInternal Database V2)
NOTE : Les fichiers inclus fourniront un dossier "Data".Ne copiez pas le dossier Data, la copie de ce dossier entraînera des comportements inattendus.
Démarrez le service MySQL, soit via ServiceControl, soit via les services Windows.
Démarrez une ligne de commande avec les droits d'administration et naviguez jusqu'au répertoire d'installation et son sous-dossier \bin.
(par défaut : C:\NProgram Files (x86)\NDocuWare\NInternal Database V2\Nbin)
Exécutez la commande suivante.
mysql_upgrade --user=root --password=admin
Choisissez un utilisateur MySQL administratif (par ex. root).
Cela mettra à niveau les tables de votre base de données vers la version 5.6 final
MySQL 5.6 final vers MySQL 5.7
Arrêtez le service MySQL
Extrayez mysql-5.7.38-winx64.zip
Ne supprimez pas, mais remplacez les fichiers dans le dossier d'installation (par défaut C:\Program Files (x86)\DocuWare\Internal Database V2)
Ouvrez le fichier my.ini existant et recherchez "innodb_additional_mem_pool_size".
Supprimez l'attribut, soit en supprimant la ligne, soit en ajoutant un # au début de la ligne.
Démarrez le service MySQL, via ServiceControl ou Windows Services.
Comme précédemment, utilisez la commande administrative cmd pour exécuter la commande de mise à niveau.
mysql_upgrade --user=root --password=admin
Cela mettra à niveau les tables de votre base de données vers la version 5.7
Mysql 5.7 vers MySQL 8
REMARQUE : Avant d'effectuer les étapes décrites, la meilleure pratique consiste à créer une sauvegarde complète de toutes les bases de données DocuWare et à la placer dans un autre emplacement que le serveur DocuWare.
- Arrêtez les services MySQL dans DocuWare en cliquant avec le bouton droit de la souris sur les contrôles de service DocuWare et en sélectionnant Arrêter les services pour procéder à un arrêt progressif.
REMARQUE : N'ARRÊTEZ PAS TOUS LES SERVICES ! L'ARRÊT DE TOUS LES SERVICES METTRAIT FIN AU PROCESSUS ET CAUSERA UNE CORRUPTION IMPORTANTE DE LA BASE DE DONNÉES, OBLIGATOIRE D'UNE RESTRUCTURE COMPLÈTE DE LA BASE DE DONNÉES. - Extraire le fichier Internal Database V3.zip.
- Déplacez le dossier Base de données interne V3 dans le dossier d'installation de la base de données interne V2 situé dans C:\NProgram Files (x86)\NDocuWare Internal Database V2.
- Ouvrez le dossier de la base de données interne V3, créez un nouveau dossier nommé "Uploads".
- Ajoutez le dossier de données copié de la Base de données interne V2 à la Base de données interne V3.
- Dans le fichier zip principal, téléchargez le fichier my.ini dans le dossier de la base de données interne V3.
NOTE : Il est recommandé d'utiliser Notepad++ pour éditer le fichier my.ini. Lors de la modification du fichier, assurez-vous que le format d'encodage est défini sur UTF-8.
- Dans le fichier my.ini, modifiez les chemins suivants :
basedir=C:/Program Files (x86)/DocuWare/Internal Database V3
datadir=C:/Program Files (x86)/DocuWare/Internal Database V3/data
secure-file-priv=C:/Program Files (x86)/DocuWare/Internal Database V3/Uploads - Maintenant, supprimez le service V2 en exécutant la requête suivante dans l'Invite de commande en tant qu'administrateur.
sc delete DWMySQL2
Pour créer le service pour la V3, exécutez la commande suivante.
“Adjust the paths as needed for your environment.”
sc create DWMySQL3 binPath= "\"C:\Program Files (x86)\DocuWare\Internal Database V3\bin\mysqld.exe\" --defaults-file=\"C:\Program Files (x86)\DocuWare\Internal Database V3\my.ini\"
DWMySQL3" DisplayName= "DocuWare Internal Database V3" start= "auto"
Remarque : La commande doit être utilisée exactement telle qu'elle est écrite.
Une fois la commande terminée, exécutez la commande suivante pour démarrer le service MySQL.
sc start DWMySQL3
Au démarrage de MySQL 8, les tables seront mises à jour automatiquement. Si une erreur survient pendant la mise à jour, vous pouvez la trouver dans le fichier InternalDatabasev3.err situé dans C:Program Files (x86)\NInternal Database v3\NData. Après avoir lu l'erreur spécifique, vous pouvez procéder de deux manières pour la résoudre.
La première solution consiste à suivre les étapes suivantes pour forcer la mise à niveau.
- Ouvrez l'Invite de commande en tant qu'administrateur.
- Dans l'explorateur de fichiers, suivez le chemin d'accès au fichier C:\NProgram Files (x86)\NDocuWare\NInternal Database V3\Nbin\N.
3) Exécutez la commande suivante dans l'Invite de commande
mysqld --upgrade=Force
NOTE : Ce processus peut prendre un certain temps, mais vous devez vous assurer qu'il se termine avec succès.
Une autre option pour corriger l'erreur est la suivante :
- Déplacer le dossier de données InternalDatabaseV3 situé dans C:\NProgram Files (x86)\NDocuWare\NInternal Database V3\Nvers un chemin d'accès différent.
- Ouvrez l'Invite de commande en tant qu'administrateur.
- Ouvrez le chemin d'accès au fichier C:\NProgram Files (x86)\NDocuWare\NInternal Database V3\Nbin\N.
- Exécutez la commande mysqld --initialize -- console. Cette commande recréera une nouvelle base de données avec une nouvelle table de système de base de données et un nouvel utilisateur. Veuillez noter que la commande donnera l'utilisateur root et un mot de passe temporaire.
- Démarrez le serveur MySQL et, à l'ouverture de l'application, vous serez invité à modifier votre mot de passe. Si vous utilisez l'utilisateur root, entrez le même mot de passe que celui utilisé pour l'utilisateur de la base de données DocuWare. Si vous utilisiez un autre utilisateur de la base de données, recréez l'utilisateur avec le même mot de passe que précédemment.
Une fois ces étapes terminées, vous devriez pouvoir démarrer les services et tester votre système DocuWare. Si vous rencontrez des erreurs lors du processus de restauration, contactez votre gestionnaire de base de données pour obtenir de l'aide. Si vous ne pouvez pas démarrer les services et que vous devez rétablir le système en V2, notez que le Dossier V2 est disponible car il n'a pas été supprimé. Nommez le dossier V3 " Ne pas supprimer " et créez un ticket pour que le Support DocuWare vous aide à résoudre le problème. Veuillez indiquer toutes les étapes mises en œuvre jusqu'au moment où vous ne pouvez plus continuer.
Pour revenir aux services V2 :
1. Ouvrez l'Invite de commande en tant qu'administrateur.
2. Exécutez la commande suivante
sc delete DWMySQL3
Pour créer le service pour la V2, exécutez la commande suivante :
“Adjust the paths as needed for your environment.”
sc create DWMySQL2 binPath= "\"C:\Program Files (x86)\DocuWare\Internal Database V2\bin\mysqld.exe\" --defaults-file=\"C:\Program Files (x86)\DocuWare\Internal Database V2\my.ini\" DWMySQL2" DisplayName= "DocuWare Internal Database V2" start= "auto"
Remarque : La commande doit être utilisée exactement telle qu'elle est écrite.
Pour démarrer le service MySQL, utilisez Service Control, Windows Services ou exécutez la commande :
sc start DWMySQL2
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.