1.4.5.5.6.3. Konfigurationsdatei pappcache.cfg

Die Konfiguration wird in folgender Datei gespeichert:

$CADENAS_SITESETUP/pappcache.cfg

Die Datei verwendet das PARTsolutions-Konfigurationsformat mit Blöcken. Jeder Server wird über einen Block [server:<Hostname>] konfiguriert, wobei Hostname dem Computernamen des Servers entspricht.

[Wichtig]Wichtig

Die Konfiguration wird automatisch alle 60 Sekunden neu eingelesen. Änderungen, die keinen Neustart erfordern, werden sofort wirksam.

Beispielkonfiguration:

[server:meinserver]
# RFS-Cache-Einstellungen
rfsdataseparated = false
rfsdataupdate = true
rfsdataupdatetime = 60
rfsdataupdatecatalogs = standard,mechatronik

# Cache-Groesse und -Pfad
rfssize = 20
rfspath = $CADENAS_USER/rfs2

# Server-Einstellungen
certname =
dnsname = server1.firma.de,server2.firma.de
allowproxy = false
httpport = 9020
httpsport = 9022
http2 = false

[COMMON]
MaxPostSizeMB = 5000
MemPostSizeMB = 150
WorkerPoolSize = 250
WorkerPoolTimeout = 5000
IoPoolSize = 0
BackLogSize = 500
EnableWatchDog = true
WatchdogTimeout = 60
1.4.5.5.6.3.1. RFS-Cache-Einstellungen
SchlüsselTypStandardBeschreibung
rfsdataseparated boolfalseCache nach API-Key/Hash trennen (Mandantentrennung). Wenn aktiviert, erhält jeder Mandant einen eigenen Cache-Bereich, identifiziert durch die HTTP-Header X-ApiKey und X-Hash. Entspricht der Option "Usergruppen haben separate Caches für $CADENAS_DATA".
rfsdataupdate boolfalseHintergrund-Cache-Aufwärmung aktivieren. Der Server liest periodisch Dateien vom Backend, um den Cache vorab zu füllen.
rfsdataupdatetime int60Intervall der Cache-Aufwärmung in Minuten.
rfsdataupdatecatalogs stringleerKommagetrennte Liste der Kataloge, die aufgewärmt werden sollen. Leer = alle konfigurierten Kataloge.
rfssize int10Maximale Cache-Größe in Gigabyte. Älteste Einträge werden bei Überschreitung entfernt.
rfspath Pfad–Verzeichnis für den Cache-Speicher. Unterstützt Umgebungsvariablen (z. B. $CADENAS_USER/rfs2).
1.4.5.5.6.3.2. Server-Einstellungen
SchlüsselTypStandardBeschreibung
certname stringleerName des SSL-Zertifikats im Windows-Zertifikatsspeicher. Leer = automatische Suche nach Hostnamen.
dnsname stringleerKommagetrennte Liste erlaubter CORS-Origin-Hostnamen.
httpport int9020Port für HTTP-Verbindungen.
httpsport int9022Port für HTTPS-Verbindungen.
http2 boolfalseHTTP/2 über ALPN-Negotiation aktivieren.
allowproxy boolfalseProxied-Verbindungen akzeptieren (wertet den X-Forwarded-For-Header aus). Nur aktivieren, wenn ein vorgeschalteter Proxy verwendet wird.
1.4.5.5.6.3.3. Gemeinsamer Block [COMMON]
SchlüsselTypStandardBeschreibung
MaxPostSizeMB int5000Maximale Größe von POST-Anfragen in Megabyte.
MemPostSizeMB int150POST-Daten bis zu dieser Größe (MB) werden im Speicher gehalten, darüber auf die Festplatte geschrieben.
WorkerPoolSize int250Anzahl der Worker-Threads im Thread-Pool.
WorkerPoolTimeout int5000Idle-Timeout für Worker-Threads in Millisekunden.
IoPoolSize int0Anzahl der IO-Threads (0 = automatische Erkennung anhand der CPU-Kerne).
BackLogSize int500Größe der TCP-Listen-Backlog-Warteschlange.
EnableWatchDog booltrueWatchdog für automatische Crash-Recovery aktivieren.
WatchdogTimeout int60Zeitlimit in Sekunden, nach dem der Watchdog den Server als nicht reagierend betrachtet.
1.4.5.5.6.3.4. Neustart-Verhalten bei Änderungen
EinstellungNeustart erforderlich?
rfsdataseparated, rfsdataupdatecatalogs, allowedOrigins, allowProxyNein (Hot-Reload)
httpport, httpsport, certname, http2Ja (automatischer Webserver-Neustart)
rfssize, rfspathJa (Cache-Rekonfiguration)