Rolle `cups_print_server`
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-ansible/rollen/cups_print_server.md
Rolle cups_print_server
Druckserver, QPDL-Treiber-Build, zweite Warteschlange.
| Läuft gegen | controlplane-0 |
| Tags | cups-print-server, printer |
| Quellcode | roles/cups_print_server |
Variablen
Defaults aus defaults/main.yml. Überschreiben in group_vars/ oder host_vars/.
| Variable | Default | Bedeutung |
|---|---|---|
cups_print_server_enabled |
true |
– |
cups_print_server_printer_name |
Samsung_M2026 |
– |
cups_print_server_printer_description |
Samsung Xpress M2026 (USB, homeserver) |
– |
cups_print_server_printer_location |
2.OG Homeserver |
– |
cups_print_server_device_uri |
`` | – |
cups_print_server_ppd |
`` | – |
cups_print_server_media_size |
A4 |
– |
cups_print_server_set_default |
true |
– |
cups_print_server_remote_admin |
true |
– |
cups_print_server_remote_any |
true |
– |
cups_print_server_share_printers |
true |
– |
cups_print_server_packages |
[cups, cups-client, cups-ipp-utils, printer-driver-splix, hplip, avahi-daemon, usbutils] |
– |
cups_print_server_disabled_services |
[cups-browsed.service] |
Dienste, die gestoppt und deaktiviert werden (CUPS, SANE und Avahi bleiben bewusst, siehe 038) |
cups_print_server_admin_users |
[ubuntu] |
– |
cups_print_server_build_qpdl_driver |
false |
– |
cups_print_server_qpdl_repo |
https://gitlab.com/ScumCoder/splix.git |
– |
cups_print_server_qpdl_repo_version |
f97086c367d926dc4b6f84facabc9c3029729cba |
– |
cups_print_server_qpdl_build_dir |
/usr/local/src/splix-qpdl |
– |
cups_print_server_extra_queues |
[] |
– |
cups_print_server_tls_names |
[homeserver, homeserver.local, homeserver.fritz.box, logs-write.tech.homeserver, ubuntu… |
– |
cups_print_server_tls_ip |
{{ network_static_ip \| default('192.168.178.94') }} |
– |
Ablauf
- CUPS-/Drucker-Pakete installieren
- Admin-Nutzer zur lpadmin-Gruppe hinzufügen
- cups + avahi-daemon aktivieren und starten
- nicht benötigte cups-dienste stoppen und deaktivieren
- Warten, bis cupsd auf Port 631 antwortet
- Aktuelle cupsd-Einstellungen auslesen
- CUPS-Sharing/Remote-Zugriff setzen
- Aktuelle Subject-Alternative-Names des cupsd-TLS-Zertifikats auslesen
- TLS-Zertifikat für cupsd mit allen bekannten Selbst-Identifikationsnamen erzeugen (Anleitung: 20040)
- temporäres verzeichnis für das schlüsselpaar anlegen (
tempfile) - Temporäres Schlüssel-/Zertifikatspaar generieren
- Zertifikat unter allen Selbst-Identifikationsnamen ablegen (
0644) - Key unter allen Selbst-Identifikationsnamen ablegen (
0600) - Temporäre Zertifikatsdateien entfernen (
always, auch nach Fehlern) - bestehende tls-schlüssel auf modus 0600 setzen
- Build-Abhängigkeiten für den QPDL-Treiber installieren
- QPDL-Treiber-Quellcode klonen (gepinnter Commit)
- Patch: PPDFile::getDefaultChoice() deklarieren (ppdfile.h)
- Patch: PPDFile::getDefaultChoice() implementieren (ppdfile.cpp)
- Patch: Printer::loadInformation() erzwingt PPD-PageSize (printer.cpp)
- QPDL-Filter kompilieren
- QPDL-Filter + PPDs installieren
- Install-Ausgabe des QPDL-Treibers anzeigen
- Handler sofort ausführen, damit lpinfo -m die neue PPD sieht
- Verfügbare Drucker-Device-URIs ermitteln
- Erkannte Device-URIs anzeigen
- Verfügbare PPDs ermitteln
- Samsung/SPL-passende PPDs anzeigen
- Warnen, wenn Device-URI/PPD noch nicht gesetzt sind
- Druckerwarteschlange anlegen/aktualisieren
- Warteschlange aktivieren
- Job-Annahme für Warteschlange aktivieren
- Warteschlange als System-Default setzen
- Extra-Queues: Splix-Katalog nach passenden PPDs durchsuchen (Debug)
- Extra-Queues: warnen, wenn ppd noch nicht gesetzt ist
- Extra-Queues: Warteschlange anlegen/aktualisieren
- Extra-Queues: Warteschlange aktivieren
- Extra-Queues: Job-Annahme aktivieren
- Extra-Queues: als System-Default setzen (falls gewünscht)
- Status aller Warteschlangen anzeigen
- Warteschlangen-Status ausgeben
Handler
- cups neu starten
Fehlersuche
Allgemeines Vorgehen bei Rollen: ansible-playbook <playbook>.yml --limit <host> --tags <tag> --check --diff -vvv zeigt Änderungen ohne sie anzuwenden (make <ziel>-check bei den Playbooks mit Dry-Run). Die Rollenübersicht mit Make-Zielen: Rollen.
sudo systemctl status cups avahi-daemon
lpstat -t
sudo journalctl -u cups -n 100 --no-pager
sudo tail -50 /var/log/cups/error_log
lpinfo -v; lpinfo -m | grep -i M2026
| Symptom | Ursache | Lösung |
|---|---|---|
| Drucker erscheint nicht | USB-Gerät nicht erkannt oder cups_print_server_device_uri leer und nicht automatisch ermittelbar |
lpinfo -v, lsusb, URI in host_vars setzen |
| Druckauftrag bleibt hängen | Filter (QPDL) fehlt oder PPD stimmt nicht | error_log, lpinfo -m, Drucker |
| QPDL-Build scheitert | Build-Abhängigkeiten oder Quellstand (die Rolle patcht ppdfile.h, ppdfile.cpp, printer.cpp) |
Task-Ausgabe der Patch- und Compile-Schritte lesen |
| Zertifikatsfehler beim Zugriff über AirPrint/IPP | Selbstsigniertes cupsd-Zertifikat enthält den genutzten Namen nicht (die Rolle erzeugt alle bekannten SAN) | Namen prüfen, Rolle erneut ausrollen |
| Drucker nicht aus dem Heimnetz oder Tailnet erreichbar | Sharing aus (cups_print_server_remote_*), UFW |
cupsctl, Firewall |
Allgemeine Fehlersuche: Host-Troubleshooting, zentrale Fehlersuche.