Technische Administration

Betrieb, Konfiguration, Sicherung, Aktualisierung und Fehlersuche

Zielgruppe: Technische Administration

Überblick

Dieser Teil richtet sich an alle, die den Docker-Stack von oPBWeb betreiben: Host, Container, Konfigurationsdateien, Secrets, Sicherung und Aktualisierung. Für die Arbeit in der Oberfläche brauchst du hier keine Rolle in oPBWeb, wohl aber Zugriff auf den Docker-Host und das Projektverzeichnis.

Alle Befehle führst du im Projektverzeichnis auf dem Docker-Host aus. Die Einstellungen, die ein Administrator in der Oberfläche vornimmt (Configserver, Depot-Stufen, Benutzer, Bereinigung des Objektspeichers), beschreibt die Fachliche Administration . Die Erstinstallation steht unter Installation .

Kapitel

  1. Architektur – Dienste, Netze, Datenfluss, Aufbau des Objektspeichers, Worker und Jobs, Auslieferung des Handbuchs.
  2. Konfiguration – Variablen in der .env, Secrets, TLS und COOKIE_SECURE, Ports, Zeitlimits, Image-Overrides und Einstellungen ohne .env-Variable.
  3. LDAP-Anmeldung – Anmeldung über LDAP oder Active Directory, Zuordnung von Gruppen zu Rollen, CA-Zertifikat, Fehlersuche.
  4. Betrieb und Aktualisierung – start.sh und stop.sh, Container, Logs, Health-Endpunkte, Update, Versionierung, Entwicklungs-Stack, Cron-Jobs.
  5. Sicherung und Wiederherstellung – was du sicherst, Befehle, Reihenfolge und Konsistenz bei der Wiederherstellung.
  6. Fehlersuche – typische Symptome mit Ursache und Abhilfe, Tabelle wichtiger Fehlermeldungen.
  7. Build und Auslieferung – Images, GitLab-CI-Pipeline, Handbuch lokal bauen und als PDF erzeugen.