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:

1. Anlegen von „internen Datenquellen“
2. 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

Beschreibung der optionalen Parameter