Der Druckweg besteht aus vier Gliedern — virtueller Drucker, Hintergrunddienst, Statusleisten-App und Docuflair Server. Jedes kann separat ausfallen; die Tabellen sind entsprechend gegliedert. Ein Neustart des Dienstes behebt die meisten Symptome.
| Komponente |
Betriebssystem |
Pfad |
| Dienst |
Windows |
C:\ProgramData\Docuflair\PrintAgent\logs\service-<Datum>.log |
| Dienst |
Linux |
journalctl -u docuflair-printagent.service |
| Dienst |
macOS |
/Library/Logs/Docuflair/PrintAgent/ |
| Statusleisten-App |
Windows |
%LOCALAPPDATA%\Docuflair\PrintAgent\logs\tray-<Datum>.log |
| Statusleisten-App |
Linux |
~/.config/docuflair-printagent/logs/tray-<Datum>.log |
| Statusleisten-App |
macOS |
~/Library/Application Support/Docuflair/PrintAgent/logs/tray-<Datum>.log |
| CUPS-Backend |
Linux/macOS |
/var/log/cups/error_log (nach docuflair filtern) |
| Symptom |
Ursache / Lösung |
| Drucker fehlt unter Windows |
Installation ohne Administratorrechte — MSI reparieren (msiexec /f). Prüfen mit Get-Printer -Name 'FollowYou' und Get-PrinterPort -Name 'FollowYou_TCP_9100'. |
Warteschlange fehlt unter Linux/macOS (lpstat: … not found) |
Die Einrichtung lief nicht durch — CUPS neu starten (sudo systemctl restart cups) und das Paket erneut installieren. |
| Warteschlange „deaktiviert“ (Linux/macOS), Aufträge stauen sich |
CUPS hat die Warteschlange nach einem Fehler angehalten — sudo cupsenable FollowYou && sudo cupsaccept FollowYou. |
| CUPS ignoriert die Warteschlange kommentarlos |
Falsche Rechte am Backend: /usr/lib/cups/backend/docuflair (macOS: /usr/libexec/…) muss root:root bzw. root:wheel mit Modus 0700 sein — sudo chmod 0700 … und CUPS neu starten. |
Testdruck ohne Anwendung: "Test" | Out-Printer -Name 'FollowYou' (Windows) bzw. echo "Test" | lp -d FollowYou (Linux/macOS).
| Symptom |
Ursache / Lösung |
| Windows: „Der Dienst antwortete nicht rechtzeitig“ |
Ungültige ServerUrl oder ProxyUrl in der Konfiguration — Wert korrigieren (siehe Konfigurationsreferenz) und Restart-Service DocuflairPrintAgent. |
Konfiguration per reg add bleibt wirkungslos |
Die Registry ist keine Konfigurationsquelle — Umgebungsvariable oder appsettings.Production.json verwenden. |
Linux: Failed with result 'exit-code' |
Fast immer eine ungültige Serveradresse — journalctl -u docuflair-printagent -n 200 zeigt die Meldung; Wert per systemctl edit setzen. |
| macOS: Dienst startet und verschwindet sofort |
Quarantäne-Attribut entfernen: sudo xattr -d com.apple.quarantine /usr/local/docuflair/printagent/Docuflair.PrintAgent.Service. |
Statusabfrage: Get-Service DocuflairPrintAgent (Windows), systemctl status docuflair-printagent.service (Linux), sudo launchctl print system/com.docuflair.printagent (macOS).
| Symptom |
Ursache / Lösung |
| „Service nicht erreichbar“ |
Dienst läuft nicht (siehe oben) — oder ein geänderter PipeName stimmt zwischen Dienst und App nicht überein. |
| Kein Symbol, kein Fenster (v. a. GNOME) |
GNOME blendet Statusleisten-Symbole ohne AppIndicator-Erweiterung aus. Den App-Starter Docuflair Print Agent anklicken — er holt das Fenster der laufenden Instanz nach vorn; ohne Anmeldung öffnet sich das Fenster beim Start automatisch. |
| App startet nach Intune-Installation nicht sofort |
Der maschinenweite Autostart greift erst bei der nächsten Benutzeranmeldung — sofort über den Startmenü-Eintrag starten. |
| Rechtsklick An Docuflair senden fehlt |
Windows: MSI reparieren (msiexec /f); der „Senden an“-Eintrag entsteht beim ersten Start der App. macOS: Dienste-Cache erneuern (/System/Library/CoreServices/pbs -update). |
| Meldung |
Ursache / Lösung |
| „Server nicht erreichbar“ |
DNS, Firewall, Proxy oder falsche Adresse — https://<Server>/api/Mobile/AuthInfo im Browser öffnen; die Adresse muss mit https:// beginnen. |
| „OIDC not enabled“ / „OIDC not configured“ |
Microsoft-Anmeldung serverseitig nicht (vollständig) eingerichtet — siehe Rollout. |
| „Invalid id_token“ |
Tenant- oder Client-ID der App-Registrierung stimmt nicht mit den Docuflair-Einstellungen überein. |
| „Domain not allowed“ |
Die UPN-Domäne fehlt in OIDC Allowed Domains. |
| „Unknown user“ |
Kein Docuflair-Benutzer mit dem UPN als Anmeldename — Benutzer anlegen oder LDAP-Synchronisation prüfen. |
| „Unauthorized“ (Passwort) |
Falsches Kennwort oder gesperrtes Konto — dieselbe Anmeldung an der Weboberfläche testen. |
407 Proxy Authentication Required |
Proxy-Zugangsdaten im Einstellungsdialog eintragen; NTLM-/Kerberos-Proxys werden nicht unterstützt. |
| Status |
Ursache / Lösung |
| Anmeldung erforderlich |
Kein gültiges Token — die App öffnet das Anmeldefenster automatisch; nach der Anmeldung läuft der Auftrag weiter. |
| Wiederholungsversuch dauerhaft, Verbindungstest der App gelingt aber |
Klassisches Proxy-Problem: Der Dienst sieht die Benutzer-Proxyeinstellungen nicht — Proxy im Einstellungsdialog der App setzen (siehe Konfigurationsreferenz). |
| Gerät gesperrt |
Ein Administrator hat das Gerät gesperrt — Entsperren unter Connectors → Mobile-Geräte. |
| Hochgeladen, aber der Auftrag erscheint nicht zur Freigabe |
Serverseitiges Problem in der Verarbeitungskette — Server-Log auf SubmitPrintJobs prüfen bzw. den Docuflair-Administrator einschalten. |
Senden Sie an den Support: das Dienst-Log, die Ausgabe von Get-Printer (Windows) bzw. lpstat -p (Linux/macOS) und das Ergebnis des Browseraufrufs https://<Server>/api/Mobile/AuthInfo.
