MS SQL Server einrichten

Achtung: Defekte Datenbank durch falsche Berechtigungen. Von außen darf keinesfalls jeder schreibend auf die Datenbank zugreifen, da ansonsten die Datenbank beschädigt werden kann und keine kostenfreie Wartung mehr gegeben ist. Erlauben Sie den Zugriff von außen nur für agorum core selbst.

Bei der Installation wird die Datenbank innerhalb der SQL Server-Datenbank automatisch angelegt. Der zur Verfügung gestellte Benutzer benötigt ausreichend Rechte, um die Datenbank anzulegen. Abhängig von der Version der MS SQL Server-Datenbank müssen Sie den Datenbanktreiber austauschen.

Die Konfigurationen vornehmen

TCP-Verbindungen zulassen

Der SQL-Server muss TCP-Verbindungen entgegennehmen und der Port frei sein. Wenn die Datenbank bei TCP auf dynamische Ports steht, müssen Sie zwei Einstellungen anpassen:

Angabe des Datenbanknamens
Eintragung von Port 0.

Beispiele

DBSERVERNAME.domain.tld\DATENBANKNAME
Port: 0

READ_COMMITTED_SNAPSHOT aktivieren

Bei Deaktivierung sind Verzögerungen deutlich wahrscheinlicher.

Stellen Sie Folgendes ein:

 ALTER DATABASE roi SET READ_COMMITTED_SNAPSHOT ON

Port 80 belegt

Beim Betrieb des SQL-Servers auf demselben Server, auf dem auch agorum core installiert ist, kann der Dienst SQL Server Reporting Services den Port 80 belegen. Dieser Port wird jedoch von agorum core benötigt. Deaktivieren Sie daher diesen Port in den Einstellungen des Dienstes in Windows.

Datenbankwachstum zu groß

Werden auf dem SQL-Server viele Dokumente angelegt und gelöscht, kann es vorkommen, dass der Speicherplatz nicht automatisch freigegeben wird. Mit einem Befehl können Sie die Freigabe erzwingen.

Führen Sie Folgendes in der SQL-Konsole des SQL-Servers aus:

dbcc shrinkdatabase(roi)

roi steht für das Datenbank-Schema von agorum core.

Des Weiteren werden bei jeder Transaktion Log-Einträge erzeugt. Diese werden generell im selben Verzeichnis wie das Datenbank-File gespeichert. Die Einträge enthalten im Namen _Log und können bei vielen Transaktionen groß werden.

In der Administration des SQL-Servers finden Sie generell diverse Einstellungen zur Einschränkung des Wachstums.

Hinweis: Die nachfolgende Einstellmöglichkeit führen Sie auf eigene Verantwortung aus.

Öffnen Sie die Eigenschaften im SQL Server Management.
Stellen Sie das Wiederherstellungsmodell auf einfach - Recovery Model Simple.

Hinweis: Sie können ab diesem Zeitpunkt nur noch vollständige sowie differenzielle Back-ups erzeugen. Transaktionsprotokolle lassen sich in diesem Zustand nicht sichern und damit nicht für die Wiederherstellung einsetzen.

Datenbanktreiber für MS SQL Server

Dieser Abschnitt beschreibt die Prüfung und den Austausch der in agorum core mitgelieferten MS SQL Datenbanktreiber. Abhängig von der Version der installierten MS SQL Server-Datenbank müssen Sie eine andere Version des Datenbanktreibers installieren und verwenden. Einen Überblick über die Versionskompatibilität zwischen der SQL Server-Datenbank und dem Datenbanktreiber finden Sie in der Microsoft-Dokumentation.

MS SQL Server-Treiberversion prüfen

Sie können die Version des installierten MS SQL Server-Datenbanktreibers folgendermaßen überprüfen:

Öffne die Eingabeaufforderung (Windows) oder ein Terminal (Linux) auf dem Server, auf dem agorum core installiert ist.

Wechsel in das Verzeichnis mit den agorum core-Standardbibliotheken:

• Windows:

cd "C:\Programme (x86)\agorum\core\jboss\server\default\lib"

• Linux:

cd /opt/agorum/core/jboss/server/default/lib

Führe folgenden Java-Befehl aus:
```
java -cp mssql_jdbc.jar com.microsoft.sqlserver.jdbc.SQLServerDriver
```
Ergebnis: Die Konsolenausgabe zeigt die installierte Treiberversion an. Beispiel:
```
Microsoft JDBC Driver 9.4 for SQL Server
```
Wenn die Treiberversion laut der Microsoft-Dokumentation nicht kompatibel mit der verwendeten Version von MS SQL Server ist, müssen Sie den Treiber austauschen.

MS SQL Server-Datenbanktreiber austauschen

Gehen Sie wie folgt vor, um den mitgelieferten MS SQL Server-Datenbanktreiber durch eine andere Version des Treibers zu ersetzen:

Laden Sie eine kompatible Version des Microsoft JDBC Drivers von Microsoft herunter.

Kopiere die heruntergeladene Datei mssql-jdbc-x.x.x.jar in das Verzeichnis mit den agorum core-Standardbibliotheken:

• Windows:

copy "Pfad\zum\neuen\Treiber\mssql-jdbc-x.x.x.jar" "C:\Programme (x86)\agorum\core\jboss\server\default\lib\mssql_jdbc.jar"

• Linux:

cp /pfad/zum/neuen/treiber/mssql-jdbc-x.x.x.jar /opt/agorum/core/jboss/server/default/lib/mssql_jdbc.jar

Starte agorum core neu:

• Windows: Öffne das Windows-Startmenü und verwende die Menü-Einträge zum Stoppen und Starten von agorum core oder verwende folgende Befehle in der Eingabeaufforderung:
```
C:\Program Files (x86)\agorum\core\scripts\agorum-core-stop.bat
C:\Program Files (x86)\agorum\core\scripts\agorum-core-start.bat
```
• Linux:
```
/opt/agorum/agorumcore/scripts/
./agorumcore start/stop
```
Ergebnis: Der heruntergeladene Datenbanktreiber wird verwendet.

• Sie können die Treiberversion überprüfen, um sicherzustellen, dass der korrekte Treiber verwendet wird.
• Kontrollieren Sie die Einträge in den agorum core-Logs, um auszuschließen, dass Fehler durch den Treiber auftreten.

Betrieb

Indexe (de)fragmentieren

Die Indexe eines MS SQL-Servers fragmentieren schnell, was die Performance beeinträchtigt. Regelmäßige Defragmentierung durch Datenbank-Jobs ist daher essenziell. Indexe mit einem Fragmentierungsgrad über 30 % sollten defragmentiert werden. Während dieser Prozesse sollte agorum core nicht parallel laufen, da dies zu blockierenden Statements führen kann.

Eine gute Grundlage für die Defragmentierung von MS SQL Server durch Datenbank-Jobs sowie deren Überwachung bietet die offizielle Dokumentation von Microsoft.