Seminar Stirling PDF Administration I: Installation, Deployment, Basiskonfiguration

Inhaltsverzeichnis

• Abstract
• Zielbild und Nutzen
• Zielgruppe
• Voraussetzungen
• Inhalte und Agenda
• Praxis
• Ergebnisse und Transfer

Abstract

Dieses Admin-Seminar vermittelt die produktionsnahe Installation und Konfiguration von Stirling PDF. Thematisiert werden Deployment-Pfade (Container/Server), Konfigurationsmethoden (UI vs Dateien/Umgebungsvariablen), Persistenz, Updates/Rollbacks sowie Basishärtung. Ziel ist ein stabiler Betrieb mit nachvollziehbarer Konfiguration.

Zielbild und Nutzen

• Reproduzierbares Deployment mit sauberer Persistenz
• Konfiguration als dokumentierter Standard (für Audits und Betrieb)
• Minimierung von Ausfallrisiken durch Update- und Backup-Disziplin

Zielgruppe

• Systemadministration, DevOps, Plattformteams
• IT-Betrieb mit Verantwortung für PDF-Services

Voraussetzungen

• Grundkenntnisse Containerbetrieb oder Serverbetrieb
• Verständnis von Ports, Volumes, Reverse Proxy (Basis)
• Optional: Testumgebung mit Docker/VM

Inhalte und Agenda

• Tag 1: Deployment-Basics
  • Deployment-Optionen: Single-Container, Compose, Orchestrierung, ggf. JAR
  • Persistenz: Konfigurations- und Datenverzeichnisse, Upload-/Temp-Strategien
  • Konfigurationsmethoden
    • In-App Settings (Admin)
    • settings.yml und custom_settings.yml
    • Environment-Variablen (Naming-Logik)
  • Login aktivieren, Admin-Account, Grundparameter (Locale, Limits)
• Tag 2: Produktionsstandard
  • Reverse Proxy und TLS-Strategie (Konzept, keine Herstellerbindung)
  • Basishärtung
    • Zugriff nur intern oder per Auth
    • API-Key-Strategie
    • CORS-Grundsätze (für Integrationen)
  • Update und Rollback
    • Versionierung und Testfenster
    • Wiederherstellungspfade
  • Ressourcenplanung
    • CPU/RAM, Concurrent Operations, Dateigrößenlimits
    • Speichermanagement und Cleanup

Praxis

• Compose-Deployment mit Persistenz
  • Verzeichnisstruktur für Deployment anlegen
  • Compose-Datei erstellen (Service, Ports, Volumes)
  • Dienst starten, UI-Check, Persistenz prüfen (Neustart-Test)
  • Basiswerte setzen (App-Name, Locale, Limits)
• Admin-Konfiguration über UI vs Datei
  • Login aktivieren, Admin anmelden
  • In-App Settings ändern und Wirksamkeit prüfen
  • Gleiche Änderung in Konfigurationsdatei simulieren, Konfliktprinzip klären
  • Standard festlegen: „UI-first“ oder „Config-as-Code“ je Umgebung
• Update-Übung
  • Update durchführen (Image-Tag/Artefaktwechsel)
  • Smoke-Test: Kernfunktionen, Login, API, OCR (wenn aktiviert)
  • Rollback simulieren
  • Checkliste erstellen: Pre-Checks und Post-Checks

Ergebnisse und Transfer

• Referenz-Deployment-Struktur (Ordner, Volumes, Konfig-Schema)
• Admin-Runbook (Start/Stop/Update/Rollback)
• Parameterkatalog für Standardlimits (Dateigröße, Timeouts, Parallelität)