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

Beenden Sie agorum core und den dataRep-Prozess.
Entfernen Sie den vorhandenen MySQL-Dienst mithilfe des folgenden Befehls:
```
sc delete agorumcore.mysql
```
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
```
Legen Sie im Pfad <InstallDir>\agorum\core den Ordner mysql an.
Entpacken Sie das Installationspaket in den eben angelegten Ordner mysql.

Initialisieren Sie den Ordner data mit folgendem Befehl:

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

Öffnen Sie folgenden Pfad:

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

Kopieren Sie die Datei my.ini.
Fügen Sie die Datei my.ini in folgenden Pfad ein:
```
<InstallDir>\agorum\core\mysql\data
```
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

Benennen Sie die Variable table_cache folgendermaßen um:
```
table_open_cache
```
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%';
```
Stellen Sie sicher, dass die Datenbank (Dienst agorumcore.mysql) beendet ist.
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" ...
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

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

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.

Ändern Sie diesen Wert in localhost um.
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.

Verbinden Sie sich mit der Datenbank.
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

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

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

Stoppen Sie die Datenbank mit folgendem Befehl:
```
net stop agorumcore.mysql
```

agorum core starten

Stellen Sie sicher, dass die Datenbank gestoppt ist.
Starten Sie agorum core mit folgendem Skript:
```
<InstallDir>\agorum\core\scripts\agorumcore start
```
Ergebnis: Die Datenbank startet automatisch.
Prüfen Sie, ob der Zugriff auf agorum core fehlerfrei möglich ist.

Hinweis: In dem von agorum ausgelieferten Backup-Skript muss der Parameter SQL_HOST in localhost geändert werden. Je nach Art des Back-ups müssen Sie ebenfalls prüfen, ob etwa in dem dafür verwendeten Skript die Verbindungsdaten aufgrund der Umstellung auf localhost aktualisiert werden müssen.