Ü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.
Der Aufbau der Konfigurationsdatei orientiert sich am Nucleus properties file format.
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 | Gibt an, wie lange Sicherheitstoken gültig bleiben. | 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]
| <A> <B> <C> <D> <E> <F> <G> | 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 |
Setzen Sie diese Eigenschaft auf true, falls Anzeigeprobleme auftreten.
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.
| 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).
| 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 |
Wird dieser Wert zu klein gewählt (z.B. 1 Sekunde), so kann es zu Verzögerungen beim Systemstart des R-S kommen.Workspace
| Eintrag | Beschreibung | Mögliche Werte | Standardwert |
|---|---|---|---|
| rs.workspace.acl.auto-repair-system-users | true | false | false | |
| rs.workspace.txform.inactive-expire-time |
| Numerisch, >= 0, in ms | 86400000 |
| rs.workspace.txform.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Transaktions-Formulare an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.txform.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Transaktions-Formularen an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.txform-revision.inactive-expire-time | Numerisch, >= 0, in ms | 86400000 | |
| rs.workspace.txform-revision.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Transaktions-Formular-Versionen an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.txform-revision.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Transaktions-Formular-Versionen an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.schema.inactive-expire-time | Numerisch, >= 0, in ms | 86400000 | |
| rs.workspace.schema.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Schemas an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.schema.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Schemas an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.schema-revision.inactive-expire-time | Numerisch, >= 0, in ms | 86400000 | |
| rs.workspace.schema-revision.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Schema-Versionen an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.schema-revision.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Schema-Versionen an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.library.inactive-expire-time | Numerisch, >= 0, in ms | 86400000 | |
| rs.workspace.library.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Bibliotheken an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.library.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Bibliotheken an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.library-revision.inactive-expire-time | Numerisch, >= 0, in ms | 86400000 | |
| rs.workspace.library-revision.inactive-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Bibliotheks-Versionen an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
| rs.workspace.library-revision.inactive-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Bibliotheks-Versionen an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| 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.
| Numerisch, >= 0, in ms | 86400000 |
rs.workspace.schema-revision-preview.expired-collector.start | Gibt die Verzögerung in ms nach Systemstart für das Starten der Löschroutine für Vorschauen (von Schema-Versionen) an. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
rs.workspace.schema-revision-preview.expired-collector.repeat | Gibt die Intervalllänge in ms für die Ausführung der Löschroutine von Vorschauen (von Schema-Versionen) an. Die Löschroutine wird periodisch nach Ablauf der Intervalllänge gestartet. Die Löschroutine prüft für Objekte mit Status DELETED, ob diese noch Abhängigkeiten besitzen. Ist dies nicht der Fall, wird das Objekt durch die Löschroutine endgültig gelöscht.
| Numerisch, >= 0, in ms | 21600000 |
rs.workspace.production-bundle.dispatcher.start | Ist die Anzahl der Millisekunden (der Standardwert bedeutet 15 Minuten) nach welchem nach Systemstart des R-S geprüft wird, ob ein Binär-Paket produktiv gesetzt werden muss.
| 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).
| 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}} |
Druckvorschau
| Eintrag | Beschreibung | Mögliche Werte | Standardwert |
|---|---|---|---|
| rs.workspace.schema-revision-preview.worker.keep-previewdir | Pro Druckvorschau des R-S wird einem Verzeichnis mit einem eineindeutigem Namen unterhalb des definierten Preview-Verzeichnisses angelegt. Ist die Druckvorschau erfolgreich beendet wird dieses Verzeichnis in Abhängigkeit dieser Option gelöscht oder beibehalten. Hinweis: Wird die Druckvorschau mit einem fehlerhaftem Returncode beendet, bleibt das Verzeichnis für die Druckvorschau unabhängig von dieser Option, erhalten. Hinweis: Bleiben Verzeichnisse für die einzelnen Druckvorschauen erhalten, muss seitens des System-Managements für ein zeitgestütztes Löschen dieser Dateien gesorgt werden. | false | true | false |
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 | Gibt an, ob beim Upload in den Storage eine Überprüfung stattfindet. | false | true | true |
Ä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
Überblick
Inhalte