Upgrade der MySQL-Datenbank 5.0 / V1 auf MySQL 5.6 / V2

Während des DocuWare Server Setups erscheint die Meldung "Das Setup kann nicht fortgesetzt werden, da auf Ihrem Rechner eine nicht unterstützte Datenbankserverversion läuft. Weitere Details finden Sie in der Knowledge Base".

• Um sicherzustellen, dass im Falle eines Fehlers während des Upgrades keine Daten verloren gehen, sichern Sie bitte vor dem Start alle Datenbanken an einem sicheren Ort.
• Wenn das Verzeichnis <DocuWare-Installationsverzeichnis>\Internal Database nicht existiert, verwenden Sie stattdessen immer <DocuWare-Installationsverzeichnis>\DWDatabase, das bereits existieren sollte. Wenn Sie zum Beispiel in einem Schritt aufgefordert werden, Dateien in das Verzeichnis <DocuWare-Installationsverzeichnis>\Internal Database zu extrahieren, dieses Verzeichnis aber nicht existiert, extrahieren Sie die Dateien in das Verzeichnis <DocuWare-Installationsverzeichnis>\DWDatabase.
• In dieser Anleitung wird davon ausgegangen, dass Sie das Verzeichnis <DocuWare-Installationsverzeichnis> <Internal Database> zur Umgebungsvariablen Path hinzugefügt haben, die über Systemsteuerung → System und Sicherheit → System → Erweiterte Systemeinstellungen → Umgebungsvariablen geändert werden kann.
• Für einige Schritte müssen mehrere MySQL-Tools ausgeführt werden - diese finden Sie in <DocuWare-Installationsverzeichnis>\Internal Database\bin. Zur Vereinfachung des Upgrades öffnen Sie eine CMD als Administrator und navigieren Sie zu dem oben genannten bin-Ordner.

Downloads

MySQL 5.0.96 64Bit
MySQL 5.1.72 64Bit
MySQL 5.5.52 64Bit
MySQL 5.6.33 64Bit

Upgrade der MySQL-Datenbank
Stellen Sie sicher, dass Sie ein gültiges Backup Ihrer Datenbank haben.

Interne Datenbank V1 auf MySQL 5.0.96
MySQL 5.0.96 auf MySQL 5.1.72
MySQL 5.1.72 auf MySQL 5.5.52
MySQL 5.5.52 auf Interne Datenbank V2

Upgrade von interner Datenbank V1 auf MySQL 5.0.96

1. Löschen Sie die Verzeichnisse bin, docs, scripts und share aus dem <DocuWare-Installationsverzeichnis> >Internal Database und ersetzen Sie diese durch die entsprechenden Verzeichnisse aus dem MySQL 5.0.96 ZIP-Archiv.
   Löschen oder ersetzen Sie nicht das Verzeichnis data.
2. Starten Sie den Dienst Interne Datenbank
3. Führen Sie den Befehl mysql_upgrade --user=<user> --password in CMD aus, wobei <user> der Name eines Datenbankbenutzers mit administrativen Rechten und sein Passwort ist.

Upgrade von MySQL 5.0.96 auf MySQL 5.1.72

1. Erstellen Sie einen Dump des aktuellen Datenbankstatus, indem Sie den Befehl mysqldump --user=<user> --password --all-databases --add-drop-table --routines --triggers --quote-names > <file> in CMD ausführen, wobei <user> der Name eines Datenbankbenutzers mit Administratorrechten und <file> der Pfad ist, in dem der Dump erstellt werden soll.
2. Stoppen Sie den internen Datenbankdienst.
3. Löschen Sie die Verzeichnisse bin, data, docs, scripts und share aus dem <DocuWare-Installationsverzeichnis> >Internal Database und ersetzen Sie diese durch die entsprechenden Verzeichnisse aus dem MySQL 5.1.72 ZIP-Archiv. Das alte Datenverzeichnis wird später aus dem in Schritt 1 erstellten Dump wiederhergestellt.
4. Starten Sie die Datenbank, indem Sie den Befehl START mysqld --skip-grant-tables in CMD ausführen. Dadurch wird die Interne Datenbank in einem temporären Debugging-Modus gestartet, in dem keine Benutzernamen und Kennwörter angegeben werden müssen. Dies ist wichtig, da das Datenverzeichnis - und damit auch die Benutzeranmeldeinformationen - im vorherigen Schritt durch die Standardwerte ersetzt wurden.
5. Stellen Sie den Dump aus Schritt 1 wieder her, indem Sie den Befehl mysql < <Datei> in CMD ausführen, wobei <Datei> dem Pfad entspricht, in dem der Dump erstellt wurde.
6. Führen Sie den Befehl mysql_upgrade --user=<user> --password in CMD aus, wobei <user> der Name eines Datenbankbenutzers mit Administratorrechten ist.
7. Stoppen Sie die Datenbank, indem Sie den Befehl TASKKILL /f /im mysqld.exe in CMD ausführen. Dadurch werden auch alle anderen laufenden MySQL-Datenbanken auf diesem Rechner beendet.
8. Löschen Sie den internen Datenbankdienst, indem Sie den Befehl SC delete DWMySQL in einer erweiterten CMD ausführen.
9. Installieren Sie den internen Datenbankdienst neu, indem Sie den Befehl mysqld --install DWMySQL in einer erhöhten CMD ausführen.
10. (optional) Ändern Sie den Anzeigenamen der internen Datenbank, indem Sie den Befehl SC config DWMySQL DisplayName= "DocuWare Internal Database" (das Leerzeichen hinter dem Gleichheitszeichen ist wichtig) in einer erweiterten CMD ausführen.
11. Prüfen Sie, ob der Dienst Interne Datenbank gestartet werden kann. Wenn nicht, führen Sie den Befehl SC delete DWMySQL in einer erweiterten CMD aus, starten Sie den Rechner neu, navigieren Sie in einer erweiterten CMD zu <DocuWare-Installationsverzeichnis> >Internal Database< und wiederholen Sie die letzten beiden Schritte.

Upgrade von MySQL 5.1.72 auf MySQL 5.5.52

1. Beenden Sie den Dienst Interne Datenbank.
2. Löschen Sie die Verzeichnisse bin, docs, scripts und share aus dem <DocuWare-Installationsverzeichnis>\Internal Database und ersetzen Sie sie durch die entsprechenden Verzeichnisse aus dem MySQL 5.5.52 ZIP-Archiv.
   Löschen oder ersetzen Sie nicht das Datenverzeichnis.
3. Öffnen Sie die Datei <DocuWare-Installationsverzeichnis>\Internal Database\my.ini in einem gehobenen Texteditor.
   • Ersetzen Sie default-character-set durch character-set-server.
     Hinweis: Wenn default-character-set mehrfach vorkommt, ersetzen Sie den Wert nur im Abschnitt [mysqld] durch character-set-server, nicht im Abschnitt [mysql] der Datei.
   • Löschen Sie die Option myisam_max_extra_sort_file_size.
   • Speichern und schließen Sie die Datei.
4. Starten Sie den internen Datenbankdienst.
5. Führen Sie den Befehl mysql_upgrade --user=<user> --password in CMD aus, wobei <user> der Name eines Datenbankbenutzers mit Administratorrechten und sein Passwort ist.

Upgrade von MySQL 5.5.52 auf die interne Datenbank V2

1. Beenden Sie den Dienst "Interne Datenbank".
2. Löschen Sie die Verzeichnisse bin, docs, scripts und share aus dem <DocuWare-Installationsverzeichnis> >Internal Database und ersetzen Sie diese durch die entsprechenden Verzeichnisse aus dem MySQL 5.6.33 ZIP-Archiv.
   Löschen oder ersetzen Sie nicht das Verzeichnis data.
3. Öffnen Sie die Datei <DocuWare-Installationsverzeichnis>\Internal Database\my.ini in einem gehobenen Texteditor.
   • Ersetzen Sie alle Vorkommen von table_cache durch table_open_cache.
   • Speichern und schließen Sie die Datei.
4. Löschen Sie den internen Datenbankdienst, indem Sie den Befehl SC delete DWMySQL in einer erweiterten CMD ausführen.
5. Installieren Sie den Dienst Interne Datenbank V2, indem Sie den Befehl mysqld --install DWMySQL2 in einer erhöhten CMD ausführen.
6. (optional) Ändern Sie den Anzeigenamen der internen Datenbank V2, indem Sie den Befehl SC config DWMySQL2 DisplayName= "DocuWare Internal Database V2" (das Leerzeichen hinter dem Gleichheitszeichen ist wichtig) in einer erweiterten CMD ausführen.
7. Prüfen Sie, ob der Dienst Interne Datenbank V2 gestartet werden kann. Wenn nicht, führen Sie den Befehl SC delete DWMySQL2 in einer erweiterten CMD aus, starten Sie den Rechner neu, navigieren Sie in einer erweiterten CMD zu <DocuWare-Installationsverzeichnis> >Internal Database< und wiederholen Sie die letzten beiden Schritte.
8. Führen Sie den Befehl mysql_upgrade --user=<user> --password in CMD aus, wobei <user> der Name eines Datenbankbenutzers mit administrativen Rechten und sein Passwort ist.

KBA ist NUR für Vor-Ort-Organisationen anwendbar.

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.