Datenbank auf MariaDB 11 umziehen

agorum core wird ab Version 11.7 mit der MariaDB-Datenbank als Standard-Datenbank ausgeliefert. Wenn Sie agorum core ab Version 11.7 neu installieren, verwenden Sie mit den Standardeinstellungen automatisch MariaDB. Diese Dokumentation ist für Sie nur interessant, wenn Sie bereits eine agorum core-Installation haben und anstelle der bisher mitgelieferten MySQL-Datenbank eine neuere MariaDB-Datenbank installieren wollen. Auch wenn Sie ein Update auf Version 11.7 durchführen und auf MariaDB umsteigen wollen, sind diese Schritte erforderlich.

Der Umzug von MySQL auf MariaDB ist relativ einfach, weil MariaDB ein Nachfolger von MySQL ist. Im agorum core-Installationsverzeichnis wird MariaDB im Verzeichnis mysql installiert. Sie erkennen im Unterverzeichnis bin, dass es sich um eine MariaDB-Installation handelt: Hier befinden sich zusätzlich zu den ausführbaren Dateien für MySQL ausführbare Dateien für MariaDB. Sie können in der Regel auch die gewohnten MySQL-Aufrufe mit MariaDB weiterverwenden.

Voraussetzungen

Erstellen Sie einen aktuellen Datenbank-Dump sowie ein aktuelles Backup Ihrer Daten, bevor Sie eine vorhandene MySQL-Datenbank, die die Zeichenkodierung UTF-8 verwendet, auf MariaDB umziehen.
Lesen Sie zuvor die Dokumentation MariaDB-Datenbank einrichten.

Vorhandene interne MySQL-Datenbank umziehen

Gehen Sie nach folgendem Muster vor, um eine vorhandene, interne MySQL-Datenbank auf Linux oder Windows nach MariaDB umzuziehen. Sie sollten diesen Umzug in Ihrer Testumgebung testen, bevor Sie die Schritte auch in Ihrer Produktionsumgebung durchführen.

Beenden Sie agorum core.
Laden Sie die MariaDB-Version als Dateiarchiv herunter, die Sie installieren wollen, etwa mariadb-11.2.3-winx64.zip für eine Windows-Installation oder mariadb-11.2.3-linux-systemd-x86_64.tar.gz für eine Linux-Installation.

Hinweis: agorum core wird in Version 11.7 mit MariaDB 11.2.2 getestet.
Benennen Sie das Verzeichnis mysql im agorum core-Installationsverzeichnis um, etwa nach mysql.old.
Entpacken Sie das heruntergeladene MariaDB-Dateiarchiv in das agorum core-Installationsverzeichnis in ein Unterverzeichnis mysql. Anschließend sehen Sie die Verzeichnisse mysql und mysql.old nebeneinander auf einer Ebene. Der Unterschied zwischen diesen Verzeichnissen sollte nur darin bestehen, dass mysql.old mehr Unterverzeichnisse enthält, etwa das Verzeichnis data.
Kopieren oder verschieben Sie das Verzeichnis data von mysql.old nach mysql.

Hinweis: Dieses Verzeichnis kann in Ihrer Produktionsumgebung riesig sein.
Führen Sie das Upgrade auf MariaDB durch. Passen Sie dazu den folgenden Aufruf für Ihre Umgebung an.
```
mariadb-upgrade -uroot -hlocalhost -ppassword
```
Prüfen Sie folgende Einstellungen, die nach einem Update auf Version 11.7 in der Regel bereits vorhanden sind:

✓ Der MariaDB-JDBC-Connector, mariadb_jdbc.jar, befindet sich im Verzeichnis <InstallDir>/jboss/server/default/lib.
Wenn der MariaDB-JDBC-Connector nicht vorhanden ist, können Sie ihn hier herunterladen: MariaDB Java Connector.

✓ Die MariaDB-Verbindungseinstellungen sind in der Datei <InstallDir>/jboss/server/default/deploy/mysql-ds.xml eingetragen:
```
<connection-url><![CDATA[jdbc:mariadb://localhost:3306/roi?useUnicode=true&characterEncoding=UTF-8&useSSL=false]]>
</connection-url>
    <driver-class>org.mariadb.jdbc.Driver</driver-class>
```
Starten Sie agorum core.
Wenn Sie zuvor ein Backup im mysql Verzeichnis erstellt haben, prüfen Sie den Backup-Prozess.
Löschen Sie optional das zuvor verwendete mysql.old Verzeichnis.

Vorhandene externe Datenbank umziehen

Gehen Sie nach folgendem Muster vor, um eine vorhandene, externe MySQL-Datenbank auf MariaDB umzuziehen.

Vorgehen auf Linux (Debian)

Beenden Sie agorum core.

/opt/agorum/agorumcore/scripts/roi_jboss stop

Laden Sie MariaDB und den MariaDB-Java-Connector herunter.
Installieren Sie die MariaDB-Datenbank.
```
apt install mariadb-server
```
Führen Sie das Upgrade auf MariaDB durch. Passen Sie dazu den folgenden Aufruf für Ihre Umgebung an.
```
mariadb-upgrade -uroot -hlocalhost -ppassword
```
Verschieben Sie den MariaDB-Connector in das lib Verzeichnis. Passen Sie bei Bedarf die Version des Treibers an.
```
mv mariadb-java-client-3.3.3.jar /opt/agorum/agorumcore/jboss/server/default/lib
```
Editieren Sie die Konfigurationsdatei /opt/agorum/agorumcore/jboss/server/default/deploy/mysql-ds.xml und passen Sie den Treiber an.
```
<connection-url><![CDATA[jdbc:mariadb:
    <driver-class>org.mariadb.jdbc.Driver</driver-class>
```
Entfernen Sie optional die zuvor verwendete MySQL-Datenbank.
```
apt remove mysql-community-server
```

Starten Sie agorum core.

/opt/agorum/agorumcore/scripts/roi_jboss start

Vorgehen auf Windows

Beenden Sie agorum core.
Laden Sie die MariaDB-MSI-Installer und den MariaDB Java Connector herunter.
Führen Sie den MSI-Installer aus, um MariaDB zu installieren.
Führen Sie das Upgrade auf MariaDB durch. Passen Sie dazu den folgenden Aufruf für Ihre Umgebung an.
```
mariadb-upgrade -uroot -hlocalhost -ppassword
```
Kopieren Sie den MariaDB Java Connector in folgendes Verzeichnis, wenn er nicht schon vorhanden ist:
```
C:/Program Files (x86)/agorum/core/jboss/server/default/lib
```
Editieren Sie die Konfigurationsdatei C:/Program Files (x86)/agorum/core/jboss/server/default/deploy/mysql-ds.xml und passen Sie den Treiber an.
```
<connection-url><![CDATA[jdbc:mariadb:
    <driver-class>org.mariadb.jdbc.Driver</driver-class>
```
Deinstallieren Sie optional die zuvor verwendete MySQL-Datenbank.
Starten Sie agorum core.