Checkliste Produktivbetrieb

Diese Checkliste fasst zusammen, was vor dem Produktivbetrieb des jadice web toolkit eingerichtet sein sollte. Viele dieser Punkte fallen in einer Entwicklungs- oder Testumgebung mit nur einer Instanz nicht auf und zeigen sich erst unter Last.

tip

Geben Sie diese Seite an das Team weiter, das die Anwendung betreibt – insbesondere die Punkte zu Load-Balancer und Container.

Betrieb und Infrastruktur

• Session Affinity am Load-Balancer ist eingerichtet, sobald mehr als eine Instanz läuft. Ohne Session Affinity funktioniert der Viewer zwar, lädt Dokumente aber auf jeder Instanz erneut. → Load-Balancing
• Server sind dimensioniert (Instanzen, CPU, RAM, Heap) und durch einen Performance-Test mit dem eigenen Dokumentenbestand bestätigt. → Dimensionierung
• CPU- und Speicherlimit sind im Container gesetzt. Ohne CPU-Limit starten die Thread-Pools zu klein, ohne Speicherlimit greift MaxRAMPercentage nicht. → Container-Betrieb, JVM-Parameter
• JVM-Parameter sind gesetzt, insbesondere Heap-Anteil und G1HeapRegionSize. → JVM-Parameter
• Heap-Dumps werden auf ein Volume mit ausreichend Platz geschrieben, nicht nach /tmp. → Heap-Dumps und GC-Log
• WebSocket ist durch alle Proxies hindurch möglich, oder ein anderer Verbindungstyp ist bewusst gewählt. → Connection API
• Schriften, die in den Dokumenten verwendet werden, sind auf dem Server bzw. im Image installiert. → Systemvoraussetzungen

Konfiguration

• Lizenzdatei liegt auf dem Klassenpfad. → Lizenzdatei
• Tile-Format ist im Container PNG-basiert, nicht WebP. → Tile-Format im Container
• Serverseitiger Cache ist zur erwarteten Last konfiguriert. → Serverseitiger Cache
• Spring-Boot-Anwendung ist als JAR gebaut, nicht als WAR. → Packaging

Sicherheit und Datenschutz

• Sitzungstrennung im Dokument-Cache ist aktiv, wenn mehrere Benutzer oder Mandanten denselben Server nutzen (webtoolkit.useSessionSpecificDocumentKey: true oder eigene getClientIdFunction). → Konfiguration
• Authentifizierung und Berechtigungen sind in der Integration umgesetzt; der DocumentDataProvider prüft den Zugriff auf jedes Dokument. → Authentifizierung, Berechtigungen
• Der mitgelieferte HTTP-URI-Provider (webtoolkit.uriProviderHttpEnabled) ist im Produktivbetrieb deaktiviert. → Dokumente
• Logs und Heap-Dumps sind als potenziell personenbezogene Daten behandelt (Zugriffsschutz, Aufbewahrungsfrist). → Logging

Überwachung

• Metriken werden erfasst, insbesondere Tile-Rendering, Laden und Wiederherstellen von Dokumenten sowie Cache-Belegung. → Monitoring