> For the complete documentation index, see [llms.txt](https://openjverein.gitbook.io/doku/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://openjverein.gitbook.io/doku/allgemeines/allgemein/mysql-support.md).

# MySQL-Support

## Vorbemerkungen

JVerein verwendet standardmäßig eine embedded Datenbank (H2), die beim ersten Start automatisch eingerichtet wird. Es wird auch MySQL/MariaDB unterstützt.

Der Vorteil ist, dass so auch von mehreren Computern auf die gleiche Datenbank zugegriffen werden kann. Genaueres dazu unter [Multiuser](/doku/allgemeines/allgemein/multiuser.md).

## Erstellung der MySQL-Datenbank

Verwenden Sie Ihr bevorzugtes Administrationswerkzeug (z.B. [PhpMyAdmin](https://www.phpmyadmin.net/) oder [MySQL-Workbench](https://dev.mysql.com/downloads/workbench/)), um eine Datenbank mit dem Namen "jverein" sowie einen Benutzer anzulegen. Der angelegte Benutzer muss Lese- und Schreibrechte in dieser Datenbank besitzen. Sie können auch der nachfolgenden Anleitung für die Kommandozeile folgen, um Datenbank und Benutzer mit dem Linux Kommandozeilen-Werkzeug "mysql" ("mysql.exe" unter Windows) anzulegen.

* Als Benutzer "root" auf dem Datenbanksystem anmelden.
* Datenbank anlegen.
* Benutzer "jverein" anlegen und Passwort vergeben. Esetzen Sie "\<passwort>" mit dem persönlichen Kennwort für den Benutzer "jverein".
* Benutzerrechte vergeben. Wenn die Datenbank im ganzen Intranet erreichbar sein soll, verwenden Sie statt "localhost" beispielsweise "192.168.1.%", wenn die IP-Adressen aller PCs in Ihrem LAN mit "192.168.1." beginnen. Sie können auch "%" verwenden, wenn keine IP-Einschränkung gelten soll.

```
mysql -u root -p
mysql> create database jverein;
mysql> CREATE USER 'jverein'@'localhost' IDENTIFIED BY '<passwort>';
mysql> GRANT ALL PRIVILEGES ON jverein.* TO 'jverein'@'localhost';
```

Hinweis: Der Benutzer sollte nur Zugriff auf die JVerein Datenbank haben. Insbesondere wenn Hibiscus ebenfalls in einer MySQL Datenbank gespeichert ist, kommt es immer wieder zu Fehlern, wenn der JVerein Benutzer auch Zugriff auf die Hibiscus Datenbank hat (Und umgekehrt).

## Konfigurieren von JVerein

Damit JVerein auf eine MySQL/MariaDB-Datenbank zugreifen kann, muss eine Konfigurationdatei erstellt werden.

* Erstellen Sie ein Verzeichnis "cfg" im Programm-Verzeichnis von Jameica (Ordner ".jameica").
* Erstellen Sie im cfg-Verzeichnis (Ordner ".jameica/cfg") eine Datei mit dem Namen "de.jost\_net.JVerein.rmi.JVereinDBService.properties".
* Öffnen Sie die Datei "de.jost\_net.JVerein.rmi.JVereinDBService.properties" mit einem Texteditor und tragen Sie folgende Inhalte ein:

```
database.driver=de.jost_net.JVerein.server.DBSupportMySqlImpl
database.driver.mysql.username=<username>
database.driver.mysql.password=<password>
database.driver.mysql.scriptprefix=mysql-
```

für MySQL:

```
database.driver.mysql.jdbcurl=jdbc:mysql://<ip>:<port>/<database>?useUnicode=Yes&characterEncoding=UTF-8
```

für MariaDB:

```
database.driver.mysql.jdbcurl=jdbc:mariadb://<ip>:<port>/<database>?useUnicode=Yes&characterEncoding=UTF-8
database.driver.mysql.jdbcdriver=org.mariadb.jdbc.Driver
```

* Ersetzen Sie die Werte \<username>, \<password>, \<ip>, \<port> und \<database> durch den Benutzername und Passwort des MySQL-Benutzers, den Hostnamen/IP-Adresse des MySQL-Servers, den Port (Standard: 3306), sowie den Datenbanknamen. (Siehe folgender Schritt für die Einrichtung der Datenbank).

Bei **Datenbanksystemen ohne Serverzertifikat** muss die Zertifikatsprüfung deaktiviert werden. Setzen Sie dafür die Parameter "\&trustServerCertificate=true\&allowPublicKeyRetrieval=true\&useSSL=false" ans Ende der Zeile von "database.driver.mysql.jdbcurl=...".

Beispiel für MySQL:

```
database.driver.mysql.jdbcurl=jdbc:mysql://<ip>:<port>/<database>?useUnicode=Yes&characterEncoding=UTF-8&trustServerCertificate=true&allowPublicKeyRetrieval=true&useSSL=false
```

**Hinweis:** Auf allen Arbeitsplätzen muss die gleiche Version von OpenJVerein im Einsatz sein. Durch neue Versionen wird unter Umständen die Datenbankstruktur so verändert, dass ältere Versionen damit nicht klar kommen.

## Sicherheitshinweise

Nutzen Sie MySQL/MariaDB nur in gesicherten und vertrauenswürdigen Netzwerken, da die Datenübertragung von MySQL/MariaDB ggf. unverschlüsselt erfolgt. Lesen Sie alternativ die entsprechenden Dokumentation zu Grundlegenden SSL-Konzepten sowie der Einrichtung von SSL für MySQL/MariaDB. Die manuelle Erstellung sowie der Import des Server-Zertifikats sollte auf den Arbeitsplätzen jedoch nicht nötig sein, da Jameica einen eigenen Keystore verwendet und den Benutzer automatisch bei Bedarf zum Import des Zertifikats auffordert.

### Probleme

Unter Debian/Ubuntu: Gegebenfalls muss das Paket libmariadb-java (für MariaDB und MySQL) oder libmysql-java (für MySQL) installiert werden.