R-S Server Konfigurationsdatei

Über die Konfigurationsdatei 'rs.server.properties' können wesentliche Eigenschaften des R-S konfiguriert werden.

Konfigurationsdatei für den R-S Server

Die Konfiguration befindet sich in der Datei rs.server.properties, welche im Verzeichnis [RS_INSTALL]/conf zu finden ist. Für die meisten der definierten Eigenschaften gibt es meist programmtechnisch vorgegebene, sinnvolle Vorgabe-Werte. Aus diesem Grund sollten die Eigenschaften nur über die Konfigurationsdatei definiert werden, wenn die Vorgabe-Werte des Programms bewusst überschrieben werden sollen. Dies ist zum Beispiel für die Definition von Backup-Zyklen der R-S Datenbank sinnvoll.

Folgende Einträge sind in dieser Konfigurationsdatei beispielsweise möglich (nur Werte, welche sinnvollerweise durch Administratoren geändert werden sollten):

Authentifizierung

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.auth.password.min-length	Die Mindestlänge für Passwörter.	Numerisch, >= 0	0
rs.auth.email-validation	Gibt an, ob geprüft werden soll, ob eingegebene E-Mail-Adressen gültige Form haben.	false \| true	false
rs.auth.token-expire-time		Numerisch, >= 0, in ms	300000
rs.auth.expired-token-collector.start		Numerisch, >= 0, in ms	100000
rs.auth.expired-token-collector.repeat		Numerisch, >= 0, in ms	100000

Backups

Eintrag

Beschreibung

Mögliche Werte

Standardwert

rs.server.server-maintenance.enable-backup

Gibt an, ob periodische Backups aktiviert werden sollen (empfohlen!).

false | true

true

rs.server.server-maintenance.schedule-backup

Parameter A: Anzahl der Sekunden [0-59]
Parameter B: Anzahl der Minuten [0-59]
Parameter C: Anzahl der Stunden [0-23]
Parameter D: Tag Im Monat [1-31]
Parameter E: Monat im Jahr [1-12]
Parameter F: Wochentag [1-7]
Parameter G: Das Jahr der Ausführung [leer|JJJJ-JJJJ]
Platzhalter:

- '*' - steht für alle Werte die in dem Feld erlaubt sind (steht der Wert '*' im Parameter D, so wird das Backup jeden Tag im Monat ausgeführt)
- '?' - als nicht definierten Wert

Weitere Informationen unter: http://quartz-scheduler.org/documentation/quartz-1.x/tutorials/crontrigger

0 0 * * * ?

rs.server.db-backup-dir

Ist das Verzeichnis, in welchem die zyklisch erstellten Datenbank-Backups für das R-S abgelegt werden.

Relative Pfadangabe

../data/rs/db-backup

Datenbank

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.server.dao	Gibt den Typ des genutzen Datenbank-Systems für das R-S an.	mysql \| mssql \| derby	derby
rs.core.db.driver	Beschreibt den JDBC-Treiber für das verwendete Datenbank-System. Die JDBC-Treiber werden in Form von JAR-Dateien vom Datenbank-Hersteller zur Verfügung gestellt und in das Verzeichnis [RS_INSTALL]/lib kopiert.	org.apache.derby.jdbc.ClientDriver \| com.microsoft.sqlserver.jdbc.SQLServerDriver \| com.mysql.jdbc.Driver	org.apache.derby.jdbc.ClientDriver
rs.core.db.url	Die Verbindungs-URL, unter der der angegebene Datenbankserver erreichbar ist.	Beliebig, typische Form: <TREIBER>:<DB>://<IP>:<PORT>/<DBNAME>;<PARAMETER...>	jdbc:derby://localhost:8888/rs;create=false
rs.core.db.user	Ist der Nutzername, mit dem sich das R-S an der Datenbank anmeldet.	Beliebig	rs
rs.core.db.password	Ist das Passwort für den Nutzer, mit dem sich das R-S an der Datenbank anmeldet.	Beliebig	rs
rs.core.db.schema	Ist der Name des verwendeten Datenbankschemas auf dem DB-System.	Beliebig	rs
rs.core.db.enable-structure-check	Gibt an, ob bei Start die Struktur der Datenbank geprüft werden soll.	false \| true	true
rs.server.db.connect-retries	Gibt die maximale Anzahl fehlgeschlagener Verbindungsaufbauversuche an, bevor das System keine weiteren Versuche unternimmt.	Numerisch, >= 0	10
rs.server.db.connect-timeout	Gibt an, wie lange (in ms) gewartet werden soll, bevor nach einem fehlgeschlagenen Verbindungsaufbauversuch ein neuer Versuch unternommen wird.	Numerisch, >= 0	1000

Flash

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.server.flash-vars.static-background	Aktiviert die Hintergrundanimation auf dem Anmeldebildschirm (false) oder deaktiviert sie (true)	false \| true	false
rs.server.flash-vars.use-js-upload	Aktiviert die Fallback-Funktion für Uploads mit Javascript.	false \| true	false

Jobs

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.job.terminated-live-time	Ist die Anzahl der Millisekunden (der Standardwert bedeutet 24 Stunden) nach welchen terminierte Jobs	Numerisch, >= 0, in ms	86400000
rs.job.terminated-job-collector.start	Ist die Anzahl der Millisekunden nach Systemstart (der Standardwert bedeutet 6 Stunden), nach welchen die Löschroutine für terminierte Jobs gestartet wird. Wird dieser Wert zu klein gewählt (z.B. 1 Sekunde), so kann es zu Verzögerungen beim Systemstart des R-S kommen.	Numerisch, >= 0, in ms	21600000
rs.job.terminated-job-collector.repeat	Ist die Anzahl der Millisekunden für das Intervall (der Standardwert bedeutet 6 Stunden), nach welchen sich die Löschroutine für terminierte Jobs wiederholt (seit der letzten Löschroutine). Wird dieser Wert zu klein gewählt (zum Beispiel 1 Sekunde), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen.	Numerisch, >= 0, in ms	21600000
rs.job.expired-job-collector.start		Numerisch, >= 0, in ms	60000
rs.job.expired-job-collector.repeat		Numerisch, >= 0, in ms	60000

Workspace

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.workspace.txform.inactive-expire-time	Ist die Anzahl der Millisekunden (der Standardwert bedeutet 24 Stunden), nach welchen die Ergebnisse einer Druckvorschau aus dem Storage des R-S gelöscht werden kann. Dieser Wert sollte nur angepasst werden, wenn durch eine Vielzahl von Nutzern eine hohe Menge von Druckvorschauen angefordert werden.	Numerisch, >= 0, in ms	86400000
rs.workspace.txform.inactive-collector.start	Ist die Anzahl der Millisekunden (der Standardwert bedeutet 6 Stunden) nach welchen die Löschroutine für Druckvorschau-Objekte nach Systemstart des R-S angestartet wird. Wird dieser Wert zu kleine gewählt (zum Beispiel 1 Sekunde), so kann es zu Verzögerungen beim Systemstart des R-S kommen.	Numerisch, >= 0, in ms	21600000
rs.workspace.txform.inactive-collector.repeat	Ist die Anzahl der Millisekunden für das Intervall (der Standardwert bedeutet 6 Stunden), nach welchen sich die Löschroutine für Druckvorschau-Objekte nach Systemstart des R-S wiederholt. Wird dieser Wert zu kleine gewählt (zum Beispiel 1 Sekunde), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen.	Numerisch, >= 0, in ms	21600000
rs.workspace.txform-revision.inactive-expire-time		Numerisch, >= 0, in ms	86400000
rs.workspace.txform-revision.inactive-collector.start		Numerisch, >= 0, in ms	21600000
rs.workspace.txform-revision.inactive-collector.repeat		Numerisch, >= 0, in ms	21600000
rs.workspace.schema.inactive-expire-time		Numerisch, >= 0, in ms	86400000
rs.workspace.schema.inactive-collector.start		Numerisch, >= 0, in ms	21600000
rs.workspace.schema.inactive-collector.repeat		Numerisch, >= 0, in ms	21600000
rs.workspace.schema-revision.inactive-expire-time		Numerisch, >= 0, in ms	86400000
rs.workspace.schema-revision.inactive-collector.start		Numerisch, >= 0, in ms	21600000
rs.workspace.schema-revision.inactive-collector.repeat		Numerisch, >= 0, in ms	21600000
rs.workspace.library.inactive-expire-time		Numerisch, >= 0, in ms	86400000
rs.workspace.library.inactive-collector.start		Numerisch, >= 0, in ms	21600000
rs.workspace.library.inactive-collector.repeat		Numerisch, >= 0, in ms	21600000
rs.workspace.library-revision.inactive-expire-time		Numerisch, >= 0, in ms	86400000
rs.workspace.library-revision.inactive-collector.start		Numerisch, >= 0, in ms	21600000
rs.workspace.library-revision.inactive-collector.repeat		Numerisch, >= 0, in ms	21600000
rs.workspace.schema-revision-preview.expire-time	Ist die Anzahl der Millisekunden (der Standardwert bedeutet 24 Stunden) nach welchen die Ergebnisse einer Druckvorschau aus dem Storage des R-S gelöscht werden kann. Dieser Wert sollte nur angepasst werden, wenn durch eine Vielzahl von Nutzern eine hohe Menge von Druckvorschauen angefordert werden.	Numerisch, >= 0, in ms	86400000
rs.workspace.schema-revision-preview.expired-collector.start	Ist die Anzahl der Millisekunden (der Standardwert bedeutet 6 Stunden) nach welchen die Löschroutine für Druckvorschau-Objekte nach Systemstart des R-S angestartet wird. Wird dieser Wert zu klein gewählt (z.B. 1 Sekunde), so kann es zu Verzögerungen beim Systemstart des R-S kommen.	Numerisch, >= 0, in ms	21600000
rs.workspace.schema-revision-preview.expired-collector.repeat	Ist die Anzahl der Millisekunden für das Intervall (der Standardwert bedeutet 2 Stunden) nach welchen sich die Löschroutine für Druckvorschau-Objekte wiederholt nach Systemstart des R-S wiederholt. Wird dieser Wert zu klein gewählt (z.B. 6 Sekunde), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen.	Numerisch, >= 0, in ms	21600000
rs.workspace.production-bundle.dispatcher.start	Ist die Anzahl der Millisekunden für das Intervall (der Standardwert bedeutet 15 Minuten) nach welchem nach Systemstart des R-S geprüft wird, ob ein Binär-Paket produktiv gesetzt werden muss. Wird dieser Wert zu klein gewählt (z.B. 30 Sekunde), kann es zu einer hohen Systembelastung des R-S durch Prüfanforderungen kommen.	Numerisch, >= 0, in ms	900000
rs.workspace.schema-revision-preview.expired-collector.repeat	Ist die Anzahl der Millisekunden für das Intervall (der Standardwert bedeutet 15 Minuten) nach welchem des R-S prüft, ob ein Binär-Paket produktiv gesetzt werden muss. Wird dieser Wert zu klein gewählt (z.B. 30 Sekunde), kann es zu einer hohen Systembelastung des R-S durch Prüfanforderungen kommen	Numerisch, >= 0, in ms	900000

Upload

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.workspace.upload-check.enabled	Gibt an, ob bei Dateiuploads Format und Größe limitiert sein sollen.	false \| true	true
rs.workspace.upload-check.allowed-file-extensions	Komma-getrennte Liste erlaubter Dateiformate für Dateiuploads (nur falls rs.workspace.upload-check.enabled = true).	bmp \| tiff \| jpeg \| jpg \| pdf \| png \| gif \| xdp	bmp,tiff,jpeg,jpg,pdf,png,gif
rs.workspace.upload-check.allowed-file-size	Maximale Dateigröße (nur falls rs.workspace.upload-enabled = true). Dieser Parameter wird nur beim Upload von Binären Ressourcen in Schema-Versionen oder zum Beispiel in Bibliotheken angewendet. Der Upload von Binär-Paketen oder zum Beispiel von Schema-Versionen welche importiert werden - sind davon nicht betroffen.	Numerisch, >= 0, in Bytes oder -1 für keine Beschränkung	-1
rs.workspace.upload-check.command-line	Ist das Programm, welches gestartet wird um Dateien, die in das R-S geladen werden vor der Speicherung zu prüfen. Diese Prüfung kann z.B. ein Prüfung auf Viren oder eine inhaltliche Prüfung sein. Beendet das angegebene Programm/Script mit einem Rückgabewert ungleich 0, so wird die Speicherung im R-S mit Fehler abgebrochen, der Nutzer erhält einen Hinweis.	Kommandozeilenübergabe	antivir.bat {{checkFile}}

Temporäre Dateien und Verzeichnisse

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.workspace.upload-check.worker.dir	Verzeichnis, in welchem hochgeladene Dateien für das R-S geprüft werden.	Relative Pfadangabe	../data/rs/tmp/upload
rs.workspace.txform-revision.worker.dir	Verzeichnis, in welchem Transaktions-Formulare und Input-Pakete temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/txform
rs.workspace.production-bundle.worker.dir	Verzeichnis, in welchem Produktions-Pakete temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/bundle
rs.workspace.schema.io.workdir	Verzeichnis, in welchem Schema-Versionen temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/io
rs.workspace.library.io.workdir	Verzeichnis, in welchem Bibliotheks-Versionen temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/io
rs.workspace.resources.io.workdir	Verzeichnis, in welchem Ressourcen temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/io
rs.bin.binary-bundle.fetcher.dir	Verzeichnis, in welchem Binär-Pakete temporär abgelegt werden.	Relative Pfadangabe	../data/rs/tmp/binary
rs.workspace.schema-revision-preview.worker.dir	Ist das Verzeichnis, in welchem die Druckvorschau aus dem R-S aufbereitet wird.	Relative Pfadangabe	../data/rs/tmp/preview

Verzeichniskonfiguration

Eintrag	Beschreibung	Mögliche Werte	Standardwert
rs.storage.workdir	Ist das Verzeichnis in welchem der File-Storrage (Dateien des R-S) aufgebaut wird.	Relative Pfadangabe	../data/rs/storage
rs.storage.upload-check		false \| true	true

Eintrag	Wert	Beschreibung
rs.workspace.schema-revision-preview.worker.keep-previewdir	false\|true	Vorgabewert: false Ist der Wert 'false' definiert, so werden die für die Druckvorschau temporär erzeugten Verzeichnisse nach einer erfolgreichen Druckvorschau gelöscht. Bei einer fehlerhaften Druckvorschau bleibt das temporäre Verzeichnis für die systemnahe Fehlersuche erhalten. Ist der Wert 'true' definiert, so werden die für die Druckvorschau temporär erzeugten Verzeichnisse nach einer erfolgreichen Druckvorschau beibehalten.

Änderungen an der Konfigurationsdatei werden erst nach einem Neustart des R-S Servers wirksam !

Kommentare starten in der ersten Position einer Zeile mit dem Zeichen '#'.

4.4 HTTP-Status-Codes durch Client- oder Server-Fehler im WEB-Browser | 5. System-Administration _{Administrations-Clients}

rs.storage.workdir

Seitenhierarchie