fix: Ghostscript-Angebot log nicht mehr, fehlende Voraussetzungen dokumentiert (v0.7.1)
Befunde aus dem ersten echten Erstinstallations-Test auf frischen Debian-12- und Debian-13-Containern. Der Weg selbst hat getragen (Basis-Install, Instanz-Anlage, zweite Instanz, Update mit Rauchtest, Rollback) — diese Stellen haben gelogen oder gefehlt: - Das Ghostscript-Backports-Angebot auf Debian 12 war ein garantierter Leerlauf, der "aktualisiert ✓" meldete: bookworm-backports enthaelt gar kein ghostscript (am Paketindex verifiziert). Die Routine sucht jetzt den echten Kandidaten, vergleicht vorher/nachher und raeumt eine nur zur Probe angelegte Quelle wieder weg. - Derselbe untaugliche Rat stand in der Preflight-Meldung, der pdfa_level-Warnung, config.example.toml und vier Doku-Dateien — ueberall ersetzt durch die echten Optionen. - Mehrzeilige Log-Hinweise waren durch "echo -e" zerrissen und nicht kopierbar; log_* nutzt jetzt printf mit %s. - pip-freeze.txt landete beim Rollback als /pip-freeze.txt im Wurzelverzeichnis, liegt jetzt unter opt/pdf-ocr-hotfolder/. - git und sudo fehlen auf dem Proxmox-Debian-Template; "sudo ./install.sh" scheitert dort. Beide Wege dokumentiert, git als Voraussetzung ergaenzt, HTTPS-Clone als Normalfall. - Rollback: systemctl start kann kein Glob. journald-Reparatur: Instanzen danach neu starten, sonst bleibt das Journal leer. 254 Tests gruen. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -1,5 +1,53 @@
|
||||
# Changelog
|
||||
|
||||
## [0.7.1] - 2026-09-23
|
||||
|
||||
Gefunden beim ersten echten Erstinstallations-Test auf frischen Debian-12-
|
||||
und Debian-13-Containern. Der Installationsweg selbst hat getragen; diese
|
||||
drei Stellen haben gelogen oder gefehlt.
|
||||
|
||||
### Fixed
|
||||
- **Das Ghostscript-Angebot auf Debian 12 war ein No-Op, der sich als Erfolg
|
||||
meldete** (`Ghostscript aktualisiert: 10.00.0 -> 10.00.0 ✓`). Grund:
|
||||
`bookworm-backports` enthaelt ueberhaupt kein `ghostscript` — am echten
|
||||
Paketindex verifiziert (2606 Pakete, ghostscript nicht dabei, Kontroll-
|
||||
pakete wie systemd/golang-go sehr wohl). Zurueck blieb eine nutzlose
|
||||
`sources.list.d`-Quelle. Die Routine (jetzt `check_ghostscript` in
|
||||
`lib/common.sh`) sucht nun erst den tatsaechlichen Kandidaten, vergleicht
|
||||
die Version vorher/nachher, meldet "unveraendert" als Warnung statt als
|
||||
Erfolg und entfernt eine nur zur Probe angelegte Quelle wieder. Eine
|
||||
bereits vorhandene Backports-Quelle bleibt unangetastet.
|
||||
- **Der Rat "Ghostscript aus bookworm-backports" ist ueberall raus** — er
|
||||
stand auch in der Preflight-Fehlermeldung, der pdfa_level-Warnung,
|
||||
config.example.toml und vier Doku-Dateien. Ersetzt durch die echten
|
||||
Optionen: pdfa_level leer lassen (Default), skip_text = false, oder
|
||||
Debian 13 (gs 10.05.1). Ein Test prueft negativ, dass der Rat nicht
|
||||
zurueckkommt.
|
||||
- **Mehrzeilige Log-Hinweise waren zerrissen und nicht kopierbar**: die
|
||||
log-Funktionen nutzten `echo -e`, wodurch `\n` in Hinweistexten zu echten
|
||||
Zeilenumbruechen ohne `[WARN]`-Praefix wurden. Jetzt `printf` mit `%s`
|
||||
fuer den Text — das Problem kann strukturell nicht wiederkommen.
|
||||
- **`pip-freeze.txt` landete beim Rollback im Wurzelverzeichnis.** Sie liegt
|
||||
im Backup jetzt unter `opt/pdf-ocr-hotfolder/` und damit nach dem
|
||||
Entpacken neben der Installation.
|
||||
|
||||
### Added (Doku)
|
||||
- Voraussetzungen, die auf einem frischen Proxmox-Debian-Template fehlen:
|
||||
**`git` und `sudo`** sind dort nicht installiert — der dokumentierte
|
||||
Aufruf `sudo ./install.sh` scheitert mit `sudo: command not found`.
|
||||
Beide Wege (root direkt / sudo) sind jetzt beschrieben.
|
||||
- HTTPS- statt SSH-Clone als Normalfall (funktioniert ohne Credentials);
|
||||
SSH-Variante mit dem Hinweis, dass der User `gitea` heisst, nicht `git`.
|
||||
- Entscheidungstabelle zu PDF/A auf Debian 12 vs. 13. Praezisierung: die
|
||||
Sackgasse ist PDF/A **zusammen mit** `skip_text = true`; mit
|
||||
`skip_text = false` geht PDF/A auch auf Debian 12, nur langsamer.
|
||||
- Rollback: `systemctl start` kann kein Glob (anders als `stop`), bei
|
||||
mehreren Instanzen jede einzeln starten. Dazu, was ein Rollback
|
||||
nachweislich zurueckholt und was nicht.
|
||||
- journald-Reparatur: die Instanzen danach einmal neu starten, sonst bleibt
|
||||
das Journal leer und die Reparatur sieht gescheitert aus.
|
||||
- "So sieht ein Erstlauf aus" — die Reihenfolge der Abfragen.
|
||||
|
||||
## [0.7.0] - 2026-09-23
|
||||
|
||||
Schliesst die stillen Datenverlust-Pfade: gleichnamige Dateien werden nirgends
|
||||
|
||||
Reference in New Issue
Block a user