Datenbank auf MySQL 5 unter Windows umziehen

Voraussetzungen

---

• Sie benötigen einen aktuellen Datenbank-Dump sowie ein aktuelles Backup Ihrer Daten, bevor Sie die Datenbank auf MySQL 5 unter Windows umziehen.
• Laden Sie zudem das MySQL-Installationspaket unter http://dev.mysql.com/downloads/mysql/ herunter.

Die Datenbank umziehen

---

1. Beenden Sie agorum core und den dataRep-Prozess.
2. Entfernen Sie den vorhandenen MySQL-Dienst mithilfe des folgenden Befehls:

   sc delete agorumcore.mysql

3. Benennen Sie den vorhandenen MySQL-Ordner um. Den Ordner finden Sie unter dem Pfad <InstallDir>\agorum\core, wobei <InstallDir> Ihren Installationspfad beschreibt.
   
   Name des Ordners VOR Umbenennung

   mysql
   

   Name des Ordners NACH Umbenennung (Beispiel)

   mysql.old
   

4. Legen Sie im Pfad <InstallDir>\agorum\core den Ordner mysql an.
5. Entpacken Sie das Installationspaket in den eben angelegten Ordner mysql.
6. Initialisieren Sie den Ordner data mit folgendem Befehl:

   <InstallDir>\agorum\core\mysql\bin\mysqld --initialize-insecure
   

7. Öffnen Sie folgenden Pfad:

   <InstallDir>\agorum\core\mysql.old\data
   

8. Kopieren Sie die Datei my.ini.
9. Fügen Sie die Datei my.ini in folgenden Pfad ein:

   <InstallDir>\agorum\core\mysql\data
   

10. Installieren Sie den neuen MySQL-Dienst mit folgendem Befehl und geben Sie ihm den Namen agorumcore.mysql. Ersetzen Sie die blau markierten Teile durch Ihre eigenen Angaben:
     
    <InstallDir>\agorum\core\mysql\bin\mysqld --install agorumcore.mysql --defaults-file="Pfad zur my.ini des neuen Ordners data"
    
    Beispiel einer vollständigen Installation
    Ersetzen Sie die blau markierten Teile durch Ihre eigenen Angaben:
     
    "C:\Program Files (x86)\agorum\core\mysql\bin\mysqld" --install agorumcore.mysql --defaults-file="C:\Program Files (x86)\agorum\core\mysql\data\my.ini"

Die Datenbank konfigurieren

---

Um einen korrekten Betrieb zu gewährleisten, müssen Sie entweder die vorhandenen oder die neuen Konfigurationsdateien anpassen.

Für die erforderlichen Parameter siehe Parameter der mitgelieferten Datenbank.

Da sich in dem hier beschriebenen Weg der Installationspfad nicht ändert, bietet es sich an, die vorhandene Datei my.ini aus der alten Installation zu verwenden und anzupassen. Der entsprechende Kopiervorgang und Registrierung des Dienstes wurde im vorhergehenden Schritt bereits durchgeführt.

my.ini anpassen

1. Benennen Sie die Variable table_cache folgendermaßen um:

   table_open_cache

2. Setzen Sie die Variable innodb_file_per_table auf OFF. Seit MySQL 5.6.6 ist diese im Standard auf ON gesetzt. Mit folgender Abfrage prüfen Sie, ob die Variable auf OFF oder ON gesetzt ist:

   show variables like '%inno%';

3. Stellen Sie sicher, dass die Datenbank (Dienst agorumcore.mysql) beendet ist.
4. Bearbeiten Sie die Datei my.ini mit einem geeigneten Editor und ändern Sie die blau markierten Teile:
    
   ...
innodb_file_per_table=0   //setzt "innodb_file_per_table" auf OFF
key_buffer=10M
table_open_cache=256       //Umbenennen der Variable "table_cache" in "table_open_cache"
#innodb_additional_mem_pool_size     //Parameter entfernen oder kommentieren, deprecated mit MySQL 5.7
#innodb_file_io_threads     //Parameter entfernen oder kommentieren, veraltet mit MySQL 5.7 und mit folgenden Variablen ersetzen:
  innodb_read_io_threads und innodb_write_io_threads
key_buffer_size     //Umbenennen der Variable "key_buffer in key_buffer_size"
sort_buffer_size      //Umbenennen der Variable "sort_buffer in sort_buffer_size"
...
5. Tragen Sie VOR dem Start der Datenbank die Byte-Größe von ibdata in die Datei my.ini ein. Die Größe muss exakt passen. Bei Neuinstallationen hat diese in der Regel 12 MB.
   
   Auszug aus der Datei „my.ini“ (Beispiel)

   ...
   lower_case_table_names=1
   innodb_log_files_in_group=3
   innodb_data_file_path=ibdata1:12M:autoextend
   ...

Die Datenbankverbindung prüfen

1. Starten Sie den Dienst agorumcore.mysql und stellen wie folgt eine Verbindung über die Konsole her:

   <InstallDir>\agorum\core\mysql\bin\mysql.exe -uroot -p -hlocalhost --port=3306 mysql 

Bei einer Neuinstallation des MySQL-Servers ist in der Regel kein Passwort vergeben, sodass Sie kein Passwort eintragen müssen.

Das root-Passwort setzen

1. Setzen Sie das root-Passwort, wobei es genau dem Passwort entsprechen muss, das zuvor für die Datenbank verwendet wurde:

   <InstallDir>\agorum\core\mysql\bin\mysqladmin -uroot -hlocalhost password PASSWORT

Abschließende Anpassungen durchführen

Windows-Installationen sind in der Regel so konfiguriert, dass agorum core sich mit der Datenbank über roihost verbindet.

1. Ändern Sie diesen Wert in localhost um.
2. Tauschen Sie den Treiber der MySQL-Datenbank aus.

Das roi-Schema vorbereiten

---

Um den Restore der zuvor gesicherten Daten vorzubereiten, muss das roi-Schema (Standard) angelegt werden. In dieses werden im nächsten Schritt die Daten importiert.

1. Verbinden Sie sich mit der Datenbank.

2. Legen Sie das roi-Schema mit folgendem Befehl an:

   
   Für NICHT-UTF8-Installationen

   create database roi;
   

   
   Für UTF8-Installationen (Standard ab agorum core 7.7)

   create database roi character set utf8 collate=utf8_bin; 
   

Daten importieren

---

1. Beenden Sie agorum core.
2. Entpacken Sie die Backup-Dateien Table-Datei: agorum_core_Tabledef.dmp und Data-Datei: agorum_core_Data.dmp, falls erforderlich.
3. Starten Sie die Datenbank über den Dienst oder die Konsole mit folgendem Befehl:

   net start agorumcore.mysql

4. Importieren Sie zuerst die Tabledef-Datei, dann die Data-Datei:
   
   Tabledef-Datei

   <InstallDir>\agorum\core\mysql\bin\mysql.exe -uroot -p -hlocalhost --port=3306 roi < agorum_core_Tabledef.dmp
   

   Data-Datei

   <InstallDir>\agorum\core\mysql\bin\mysql.exe -uroot -p -hlocalhost --port=3306 roi < agorum_core_Data.dmp
   

5. Stoppen Sie die Datenbank mit folgendem Befehl:

   net stop agorumcore.mysql
   

agorum core starten

---

1. Stellen Sie sicher, dass die Datenbank gestoppt ist.

2. Starten Sie agorum core mit folgendem Skript:

   <InstallDir>\agorum\core\scripts\agorumcore start

   
   Ergebnis: Die Datenbank startet automatisch.
3. Prüfen Sie, ob der Zugriff auf agorum core fehlerfrei möglich ist.