3.11. Die Standard-Datenbank ändern

3.11.1. MariaDB
3.11.2. Microsoft SQL-Server
3.11.3. MySQL
3.11.4. PostgreSQL

Initial verwendet Klaros-Test­management die Apache-Derby-Datenbank, die keine weitere Installation oder Konfiguration erfordert, aber im Vergleich zu anderen Datenbanken eine erheblich geringere Leistung aufweist. Für den produktiven Einsatz wird daher dringend empfohlen, ein leistungsfähigeres Datenbanksystem zu verwenden, wie z.B. die Open Source-Datenbankserver PostgreSQL oder MariaDB/MySQL oder das kommerzielle Datenbankprodukt Microsoft SQLServer.

Um zu einem anderen Datenbanksystem zu wechseln, muss Klaros-Test­management gestoppt werden und die Datei hibernate.properties, die sich in <user.home>/.klaros/hibernate.properties befindet, muss wie unten gezeigt bearbeitet werden.

Die Eigenschaft hibernate.connection.url muss mit dem Standort der Datenbank in Ihrem Netzwerk übereinstimmen. Bitte wenden Sie sich an Ihren Datenbankadministrator um die Zugangsdaten für hibernate.connection.username und hibernate.connection.password zu erhalten.

[Warnung] Warnung

Leerzeichen am Ende von Zeilen in der Datei hibernate.properties könnten von hibernate falsch interpretiert werden! Zum Beispiel ist 'hibernate.connection.password=root ' nicht dasselbe wie 'hibernate.connection.password=root' (Anführungszeichen ignorieren).

3.11.1. MariaDB

Ändern Sie für MariaDB den Inhalt der Datei in:

MariaDB 10.3 oder höher:

hibernate.connection.driver_class=org.mariadb.jdbc.Driver
hibernate.connection.url=jdbc:mariadb://localhost:3306/klaros
hibernate.connection.username=root
hibernate.connection.password=root

3.11.2. Microsoft SQL-Server

Um einen Microsoft SQL-Server zu verwenden, ändern Sie den Inhalt der Datei in:

Microsoft SQL-Server 2008 oder nachfolgende Versionen:

hibernate.connection.driver_class=com.microsoft.sqlserver.jdbc.SQLServerDriver
hibernate.connection.url=jdbc:sqlserver://localhost:1433;databaseName=KLAROS
hibernate.connection.username=root
hibernate.connection.password=root

3.11.3. MySQL

Ändern Sie für MySQL den Inhalt der Datei in:

MySQL 5.5 oder nachfolgende Versionen:

hibernate.connection.driver_class=com.mysql.jdbc.Driver
hibernate.connection.url=jdbc:mysql://localhost:3306/klaros
hibernate.connection.username=root
hibernate.connection.password=root
[Wichtig] Wichtig

Wenn Sie eine MySQL-Datenbank verwenden, ist es wichtig, die folgende Option in der Datei my.ini zu setzen.

# The maximum size of a query packet the server can handle as well as
# maximum query size server can process (Important when working with
# large BLOBs).  enlarged dynamically, for each connection.
max_allowed_packet = 64M

3.11.4. PostgreSQL

Um PostgreSQL zu verwenden, ändern Sie den Inhalt der Datei in:

PostgreSQL 9.4 oder nachfolgende Versionen:

hibernate.connection.driver_class = org.postgresql.Driver
hibernate.connection.url = jdbc:postgresql://localhost/klaros
hibernate.connection.username=root
hibernate.connection.password=root

Eine ausführliche Liste aller Parameter finden Sie im Hibernate Core Manual.

[Tipp] Datenbank-Instanz erzeugen

Klaros-Test­management legt nicht automatisch die Datenbankinstanz ( klaros im obigen Beispiel) oder den Datenbankbenutzer (Benutzer root mit Kennwort root im obigen Beispiel) auf dem Datenbankserver an.

Das Anlegen einer Datenbankinstanz und das Hinzufügen eines Benutzers sind im entsprechenden Datenbankhandbuch beschrieben und werden hier nicht behandelt. Der Datenbankbenutzer benötigt Berechtigungen zum Erstellen, Löschen und Ändern von Tabellen, um die Klaros-Test­management Datenbankinstanz ordnungsgemäß zu starten.

[Tipp] Unterstützung für den UTF-8 Schriftsatz sicherstellen!

Je nach Datenbank kann es erforderlich sein, die Unterstützung für UTF-8-Zeichensätze manuell zu aktivieren, was für die Unterstützung von Sprachen mit ungewöhnlichen Zeichensätzen erforderlich sein kann. Insbesondere MySQL ist dafür bekannt, dass es nur eine begrenzte Zeichenunterstützung in seiner Standardkonfiguration hat. Das folgende Beispiel zeigt, wie dies durch Editieren der Konfigurationsdatei mysql.cnf aktiviert werden kann.

character-set-server=utf8
collation-server=utf8_general_ci

Beispiel 3.2. Zusätzliche Einträge in mysql.cnf um UTF-8 Character Sets zu unterstützen


Zurückschalten auf die integrierte Derby-Datenbank:

hibernate.connection.driver_class=org.apache.derby.jdbc.EmbeddedDriver
hibernate.connection.url=jdbc\:derby\:${user.home}/.klaros/klarosDerby;create\=true
hibernate.connection.username=root
hibernate.connection.password=root