Ü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]
| <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). Setzen Sie diese Eigenschaft auf true, falls Anzeigeprobleme auftreten. | false | true | false |
rs.server.flash-vars.use-js-upload | Aktiviert die Fallback-Funktion für Uploads mit Javascript. Setzen Sie diese Eigenschaft auf true, falls Uploadprobleme auftreten. | 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 |
| 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), 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 | 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen. | 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen. | 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen. | 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen. | 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. 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.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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), kann es zu einer hohen Systembelastung des R-S durch Löschanforderungen kommen. | 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 | 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. 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 | 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. Wird dieser Wert zu klein gewählt (z.B. 1 Minute), 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 (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 |
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 | Gibt an, ob beim Upload in den Storage eine Überprüfung stattfindet. | 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