Einführung / Konfiguration des FirstSpirit-Servers / Datenbankanbindung / Konfiguration von Datenquellen
Konfiguration von Datenquellen
Die Konfiguration der Datenbankanbindung des FirstSpirit-Servers erfolgt über den ServerManager (siehe Datenbanken) oder direkt über den Eintrag „DATABASES“ in der Konfigurationsdatei fs-database.conf. Empfohlen wird das Bearbeiten der Datenbankkonfiguration über den ServerManager (siehe Datenbanken), da hier alle Änderungen automatisch in die fs-database.conf geschrieben und auf dem Server aktualisiert werden. Außerdem ist es möglich, die konfigurierte Datenbankanbindung zu testen (siehe Abbildung in Abschnitt JDBC Parameter konfigurieren).
Die FirstSpirit Datenbankanbindung kann für verschiedene Zwecke genutzt werden:
- Anlegen von „internen Datenquellen“
- Einbindung von externen Datenbanken („externe Datenquellen“)
Voraussetzung für die Nutzung von Datenquellen in FirstSpirit:
- Datenbank-Konfiguration über den ServerManager (empfohlen) oder direkt über die Datei firstspirit5/conf/fs database.conf
Für einen FirstSpirit-Server können beliebig viele Datenquellen definiert werden, die über die Administratoren-Oberfläche den Projekten individuell zugeordnet bzw. beim Importieren eines Projektes ausgewählt werden können.
Für die direkte Konfiguration über die Datei fs-database.conf gilt:
- Es können mehrere Datenbanken kommasepariert hintereinander aufgelistet werden.
- Die Namen der externen Datenquellen können beliebig gewählt werden, wobei die folgenden Konventionen eingehalten werden müssen.
Erlaubte Zeichen: A-Z, a-z, 0-9, _, -
Beispiel:
DATABASES=content1, content2, extern1, extern2
Für jedes Element der in „DATABASES“ angegebenen Datenbanken müssen zusätzlich folgende Parameter in der Konfiguration definiert werden (Schema):
<database>.jdbc.DRIVER=<JDBC-Driver-Class>
<database>.jdbc.URL=<JDBC-Connection-url>
<database>.jdbc.SCHEMA=<dbName>
<database>.jdbc.USER= <db_login>
<database>.jdbc.PASSWORD=<db_passwort>
<database>.jdbc.layerclass=<FirstSpirit-DB-Layer-Klasse>
Konfigurationsbeispiel (für DATABASE=content1):
content1.jdbc.DRIVER=com.mysql.jdbc.Driver
content1.jdbc.URL=jdbc:mysql://localhost:3306/mydb
content1.jdbc.SCHEMA=mydb
content1.jdbc.USER=cms
content1.jdbc.PASSWORD=cms
content1.jdbc.layerclass=de.espirit.or.impl.mysql.MySQLLayer
Beschreibung der Pflicht-Parameter
Optional können folgende Parameter verwendet werden:
content1.jdbc.SCHEMA=dbName
content1.jdbc.CATALOG=dbCatalogname
content1.jdbc.POOLMIN=10
content1.jdbc.POOLMAX=15
content1.jdbc.POOLCYCLE=120
content1.jdbc.POOLTIMEOUT=240
content1.jdbc.CONNECTIONTIMEOUT=3600
content1.jdbc.CONNECTIONRETRY=3
content1.jdbc.CONNECTIONRETRYCYCLE=500
content1.jdbc.MAXSTRINGLENGTH=4000