Die Installation von MySQL-Datenbanken ist nicht Teil des DocuWare-Supports.
Da es sich bei MySQL um eine Drittanbieter-Anwendung handelt, haben wir keine Möglichkeit, Fehler zu beheben, zusätzliche Einstellungen zu empfehlen oder zu prüfen, ob die Installation vollständig abgeschlossen ist.
DocuWare übernimmt keine Verantwortung für beschädigte Systeme, wenn die Datenbank während oder nach der Installation beschädigt wird.
Frage:
Wie aktualisiert man eine interne Datenbank V2 (MySQL 5.6) auf eine interne Datenbank V3 (MySQL 8)
Antwort:
Das Update von MySQL 5.6 auf MySQL 8 erfolgt in drei Schritten.
Sie können Ihre aktuell installierte MySQL-Version überprüfen, indem Sie
SHOW VARIABLES LIKE "%version%";
ausführen. Alle benötigten Dateien können mit dem folgenden Download gefunden werden:
Download-MySQL56TO8
Wichtige Hinweise:
Stellen Sie sicher, dass alle Anwendungen, die auf die Datenbank zugreifen, vor einem Backup/Dump-Versuch heruntergefahren werden.
Stellen Sie sicher, dass Sie ein gültiges Backup Ihrer Datenbank haben.
Stellen Sie sicher, dass Sie ein Backup Ihres Installationsverzeichnisses haben.
Führen Sie ein Upgrade von DocuWarenicht direkt nach dem Upgrade von MySQL durch.
Lassen Sie das System einige Zeit laufen, um zu prüfen, ob die volle Funktionalität noch gegeben ist.
Grundlegende Informationen zu MySQL:
Während der KBA wird das Installationsverzeichnis sowie das Datenverzeichnis genannt.
Das Installationsverzeichnis enthält alle Dateien, die für den Betrieb des MySQL-Dienstes benötigt werden, und befindet sich je nach vorheriger Installation in C:\Program Files (x86)\DocuWare\Internal Database V1\ oder C:\Program Files (x86)\DocuWare\Internal Database V2\.
Wenn Sie sich nicht sicher sind, wo Sie Ihr Installationsverzeichnis finden, überprüfen Sie bitte den MySQL-Dienst innerhalb der Windows-Dienste, Sie erhalten den Pfad zur Datei MySQLD.exe und damit den Installationsordner.
In diesem Ordner finden Sie die my.ini und viele Unterordner, z.B. \bin.
\bin enthält die meisten ausführbaren Dateien und wird später benötigt, um die Upgrader auszuführen.
Das Verzeichnis data befindet sich in C:\ProgramData\DocuWare\Internal Database\.
Der Ordner heißt passenderweise data.
Er enthält den Inhalt und die Struktur aller Datenbanktabellen der installierten MySQL-Datenbank.
Für den ersten Teil des Upgrades müssen Sie nur im Installationsordner arbeiten.
Während des Upgrades auf MySQL 8 müssen Sie einen Ordner auf derselben Ebene wie das Datenverzeichnis hinzufügen.
MySQL 5.6 auf MySQL 5.6 final
Stoppen Sie den MySQL-Dienst
Extrahieren Sie mysql-5.6.51-winx64.zip
Löschen Sie nicht, sondern ersetzen Sie die Dateien im Installationsordner (Standard: C:\Programme (x86)\DocuWare\Interne Datenbank V2)
HINWEIS: Die enthaltenen Dateien stellen einen Ordner "Data" bereit.Kopieren Sie nicht den Ordner "Data", da das Kopieren dieses Ordners zu unerwartetem Verhalten führt.
Starten Sie den MySQL-Dienst, entweder über ServiceControl oder Windows-Dienste.
Starten Sie eine Befehlszeile mit Administratorrechten und navigieren Sie zum Installationsverzeichnis und dessen Unterordner \bin.
(Standard: C:\Program Files (x86)\DocuWare\Internal Database V2\bin)
Führen Sie den folgenden Befehl aus.
mysql_upgrade --user=root --password=admin
Wählen Sie einen administrativen MySQL-Benutzer (z.B. root).
Dies wird Ihre Datenbanktabellen auf die 5.6 final aktualisieren
MySQL 5.6 final auf MySQL 5.7
Stoppen Sie den MySQL-Dienst
Extrahieren Sie mysql-5.7.38-winx64.zip
Löschen Sie die Dateien nicht, sondern ersetzen Sie sie im Installationsordner (Standard: C:\Programme (x86)\DocuWare\Internal Database V2)
Öffnen Sie die vorhandene my.ini und suchen Sie nach "innodb_additional_mem_pool_size".
Entfernen Sie das Attribut, indem Sie entweder die Zeile löschen oder durch Hinzufügen eines # am Anfang der Zeile kommentieren.
Starten Sie den MySQL-Dienst, entweder über ServiceControl oder die Windows-Dienste.
Verwenden Sie wie zuvor die administrative cmd, um den Upgrade-Befehl auszuführen.
mysql_upgrade --user=root --password=admin
Dadurch werden Ihre Datenbanktabellen auf die Version 5.7 aktualisiert.
Mysql 5.7 to MySQL 8
HINWEIS: Bevor Sie die beschriebenen Schritte durchführen, erstellen Sie am besten ein vollständiges Datenbank-Backup aller DocuWare-Datenbanken und legen Sie es an einem anderen Ort außerhalb des DocuWare-Servers ab.
- Stoppen Sie die MySQL-Dienste in DocuWare, indem Sie mit der rechten Maustaste auf die DocuWare Service Controls klicken und Dienste stoppen wählen, um einen Soft Shutdown durchzuführen.
HINWEIS: SCHALTEN SIE NICHT ALLE DIENSTE AB! DAS ABSCHALTEN ALLER DIENSTE WIRD EINEN KILL AUF DEN PROZESS FÜHREN UND EINE SCHWERWIEGENDE DATENBANKKORRUPTION VERURSACHEN, DIE EINE KOMPLETTE DATENBANKUMSTRUKTUR ERFORDERT. - Entpacken Sie die Datei Interne Datenbank V3.zip.
- Verschieben Sie den Ordner "Interne Datenbank V3" in den Installationsordner, in dem sich die Interne Datenbank V2 unter C:\Programme (x86)\DocuWare Internal Database V2 befindet.
- Öffnen Sie den Ordner "Interne Datenbank V3" und erstellen Sie einen neuen Ordner namens "Uploads".
- Fügen Sie den kopierten Datenordner aus der Internen Datenbank V2 zur Internen Datenbank V3 hinzu.
- Laden Sie die Datei "my.ini" aus der Haupt-Zip-Datei in den Ordner "Interne Datenbank V3" herunter.
HINWEIS: Es wird empfohlen, für die Bearbeitung der Datei "my.ini" Notepad++ zu verwenden. Stellen Sie beim Bearbeiten der Datei sicher, dass das Kodierungsformat auf UTF-8 eingestellt ist.
- Passen Sie in der Datei my.ini die folgenden Pfade an:
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 - Löschen Sie nun den V2-Dienst, indem Sie die folgende Abfrage in der Eingabeaufforderung als Administrator ausführen.
sc delete DWMySQL2
Um den Dienst für V3 zu erstellen, führen Sie den folgenden Befehl aus.
“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"
Hinweis: Der Befehl muss genau so verwendet werden, wie er geschrieben ist.
Nach Abschluss des Befehls führen Sie den folgenden Befehl aus, um den MySQL-Dienst zu starten.
sc start DWMySQL3
Nach dem Start von MySQL 8 werden die Tabellen automatisch aktualisiert. Wenn während des Upgrades ein Fehler auftritt, können Sie den Fehler in der Datei InternalDatabasev3.err finden, die sich in C:Program Files (x86)\Internal Database v3\Data befindet. Nachdem Sie den spezifischen Fehler gelesen haben, gibt es zwei Möglichkeiten, ihn zu beheben.
Eine Lösung besteht darin, die folgenden Schritte auszuführen, um das Upgrade zu erzwingen.
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Folgen Sie im Datei-Explorer dem Dateipfad C:\Programme (x86)\DocuWare\Interne Datenbank V3\bin\
3. führen Sie in der Eingabeaufforderung den folgenden Befehl aus
mysqld --upgrade=Force
HINWEIS: Dieser Vorgang kann einige Zeit in Anspruch nehmen, Sie müssen jedoch sicherstellen, dass der Vorgang erfolgreich abgeschlossen wird.
Eine weitere Möglichkeit, den Fehler zu beheben, ist die folgende:
- Verschieben Sie den Ordner InternalDatabaseV3, der sich in C:\Program Files (x86)\DocuWare\Internal Database V3\ befindet, in einen anderen Dateipfad.
- Öffnen Sie die Eingabeaufforderung als Administrator.
- Öffnen Sie den Dateipfad C:\Program Files (x86)\DocuWare\Internal Database V3\bin\
- Führen Sie den Befehl mysqld --initialize -- console aus. Dadurch wird eine neue Datenbank mit einer neuen Datenbanksystemtabelle und einem neuen Benutzer erstellt. Bitte beachten Sie, dass der Befehl den Root-Benutzer und ein temporäres Passwort vergibt.
- Starten Sie den MySQL-Server und werden Sie beim Öffnen der Anwendung aufgefordert, Ihr Passwort zu ändern. Wenn Sie als Benutzer root verwenden, geben Sie bitte das gleiche Passwort ein, das Sie für den DocuWare-Datenbankbenutzer verwendet haben. Wenn Sie einen anderen Datenbankbenutzer verwendet haben, legen Sie diesen mit dem gleichen Passwort neu an.
Nach diesen Schritten sollten Sie die Dienste starten und Ihr DocuWare-System testen können. Sollten Sie bei der Wiederherstellung Fehler feststellen, wenden Sie sich an Ihren Datenbankmanager. Wenn Sie die Dienste nicht starten können und das System auf V2 zurücksetzen müssen, beachten Sie, dass der Ordner V2 verfügbar ist, da er nicht gelöscht wurde. Nennen Sie den V3 Ordner "Nicht löschen" und erstellen Sie ein Ticket für den DocuWare Support, damit dieser Ihnen bei der Lösung des Problems helfen kann. Bitte geben Sie alle Schritte an, die Sie bis zu dem Punkt durchgeführt haben, an dem Sie nicht mehr weiterkommen.
So kehren Sie zu den V2-Diensten zurück:
1. Öffnen Sie die Eingabeaufforderung als Administrator.
2. Führen Sie den folgenden Befehl aus
sc delete DWMySQL3
Um den Dienst für V2 zu erstellen, führen Sie den folgenden Befehl aus:
“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"
Hinweis: Der Befehl muss genau so verwendet werden, wie er geschrieben ist.
Um den MySQL-Dienst zu starten, verwenden Sie entweder Service Control, Windows Services oder führen Sie den Befehl aus:
sc start DWMySQL2
Bitte beachten Sie: Dieser Artikel ist eine Übersetzung aus dem Englischen. Die in diesem Artikel enthaltenen Informationen basieren auf der/den englischsprachigen Originalversion(en) des Produkts. In der übersetzten Version unserer Artikel können kleinere Fehler enthalten sein, z.B. in der Grammatik. Wir können zwar nicht für die vollständige Richtigkeit der Übersetzung garantieren, aber in den meisten Fällen werden Sie sie als ausreichend informativ empfinden. Im Zweifelsfall wechseln Sie bitte zurück zur englischen Version dieses Artikels.