Print Agent

Der Prismamed Print Agent druckt aus TCMSOFT auf die Drucker der Praxis. TCMSOFT erzeugt jedes Dokument als PDF und schickt es an einen Print Agent. Der Print Agent gibt es an einen Drucker weiter, den sein Betriebssystem kennt.

Diese Seite beschreibt alle drei Fassungen: unter Windows, am Mac und im TCMSOFT-Container. Dazu die Kopplung per Code und per Agent suchen, das Einrichten der Drucker, den Port 9632 und die Protokolle. Wie die Agenten sich aktualisieren und wie man Updates anhält, steht unter Updates der Agenten.

Die drei Fassungen

Aktuelle Version unter Windows und am Mac: 2026.10.10.1. Im Menü des Agenten, in TCMSOFT und im Update-Feed steht sie als 2026.10.1001.

Welche Fassung druckt was:

• Der Print Agent im Container erreicht Netzwerkdrucker, die sich per Bonjour/AirPrint melden oder mit ihrer Adresse eingetragen werden.
• Ein Drucker, der nur an einem Arbeitsplatz hängt (z. B. per USB) oder nur in Windows eingerichtet ist, druckt über den Print Agent dieses Arbeitsplatzes. Er druckt nur, solange dieser Rechner läuft.

Im Druckfenster von TCMSOFT wählt der Anwender Arbeitsplatz (den Rechner mit dem Print Agent, der Agent im Container heißt dort „Server“) und Drucker. Vorbelegt ist der feste Drucker des Drucklayouts, sonst der Drucker, mit dem in diesem Browser zuletzt im selben Papierformat gedruckt wurde.

Empfehlung: über die Arbeitsplätze drucken

Der Print Agent im Container druckt mit den Linux-Treibern aus CUPS. Für manche Drucker fehlen sie oder drucken fehlerhaft (leere Blätter, falsche Fächer, kein Duplex). Am Arbeitsplatz druckt der Treiber des Herstellers, den Windows bzw. macOS ohnehin nutzt, mit dessen Fachnamen und den dort hinterlegten Druckeinstellungen. Richten Sie deshalb in der Regel so ein:

1. Die Drucker an den Arbeitsplätzen in Windows bzw. macOS mit dem Treiber des Herstellers einrichten und eine Testseite drucken. Einen Netzwerkdrucker, auf den mehrere Plätze drucken, an jedem dieser Plätze unter demselben Druckernamen einrichten. Dann findet ein Drucklayout mit festem Drucker ihn auch an einem anderen Platz, wenn der eingetragene Rechner aus ist.
2. An diesen Plätzen den Print Agent installieren und per Code koppeln.
3. Sind alle Drucker so erreichbar: den Agent im Container abschalten.
4. Dokumenten, die immer auf denselben Drucker gehören (Rezeptdrucker, Briefpapier), in ihrem Drucklayout den festen Drucker mit Duplex und Fach eintragen (Benutzerhandbuch › Stammdaten: Praxis › Drucklayouts, Karte Drucken).

Der Agent im Container bleibt sinnvoll, wo kein Arbeitsplatz einen Print Agent haben kann (z. B. nur Linux-Rechner oder Tablets) und der Drucker treiberlos über AirPrint bzw. IPP Everywhere sauber druckt.

Voraussetzungen

• Für Print Agents an Arbeitsplätzen (Windows, Mac): Die Kopplung per Code geht auch ohne HTTPS – der Agent verbindet sich mit der Adresse, die beim Koppeln eingetragen wird (http:// oder https://; bei https:// muss der Arbeitsplatz dem Zertifikat vertrauen). Agent suchen dagegen braucht HTTPS mit einem Zertifikat, dem der Arbeitsplatz vertraut; ohne HTTPS lassen Chrome und Edge es nicht zu (Ausnahme: http://localhost auf dem Rechner, auf dem TCMSOFT selbst läuft). Einzelheiten unter Kopplung per „Agent suchen“; das Einrichten von HTTPS steht unter Netzwerk und HTTPS.
• Browser: Chrome oder Edge. „Agent suchen“ in Safari und anderen Browsern ist nicht geprüft.
• Netz: Der Print Agent verbindet sich von sich aus zu TCMSOFT, über dieselbe Adresse und denselben Port wie der Browser. Eingehende Verbindungen aus dem Praxisnetz braucht er dafür nicht.
• Updates: Der Arbeitsplatz erreicht https://downloads.tcmsoft.de (Port 443), siehe Updates der Agenten.
• Edition: Drucken gibt es in allen Editionen.

Print Agent unter Windows

Installieren

Wozu: Der Print Agent macht die Drucker dieses Windows-Rechners in TCMSOFT verfügbar.

1. Melden Sie sich am Arbeitsplatz mit dem Windows-Konto an, mit dem dort gearbeitet wird.

2. Öffnen Sie TCMSOFT und wählen Sie Stammdaten › Drucker › Print Agent herunterladen (ab TCMSOFTpro auch Stammdaten › Agenten › Print Agent herunterladen…). Klicken Sie in der Karte Windows auf Herunterladen. Ohne TCMSOFT am Rechner führt dieser Link immer zum aktuellen Setup:

   https://downloads.tcmsoft.de/printagent/PrismamedPrintAgent-Setup.exe
   

3. Führen Sie das Setup in diesem Windows-Konto aus. Administratorrechte sind nicht nötig. Das Setup installiert nur für dieses Konto.

4. Das Setup legt „Prismamed Print Agent“ im Startmenü und im Autostart an und startet den Agenten.

Woran Sie den Erfolg erkennen:

• Das Fenster „Prismamed Print Agent“ öffnet sich mit Mit TCMSOFT koppeln - das tut es bei jedem Start, solange der Agent mit keinem TCMSOFT gekoppelt ist.
• Im Infobereich der Taskleiste erscheint ein Druckersymbol, einfarbig (weiß auf dunkler, schwarz auf heller Taskleiste). Unter Windows 11 liegt es zunächst oft hinter dem Pfeil neben der Uhr.
• Zeigt die Maus darauf, steht dort „Prismamed Print Agent – nicht gekoppelt“.
• Ein Klick öffnet das Fenster, ein Rechtsklick das Menü. Die erste Zeile des Menüs lautet „Prismamed Print Agent 2026.10.701“.
• Im Task-Manager heißt der Prozess „Prismamed Print Agent“ (Datei Prismamed.PrintAgent.Win.exe).

Danach koppeln Sie den Agenten, siehe Kopplung per Code oder Kopplung per „Agent suchen“.

Hinweise:

• Der Prismamed Agent (Geräte, Labor, Scans) zeigt die Raute des TCMSOFT-Logos, der Print Agent den Drucker. Ältere Print Agents zeigten ebenfalls die Raute; mit dem Update bekommen sie das Druckersymbol.
• Ein Betrieb als Windows-Dienst wird nicht unterstützt; sc create funktioniert mit dem Programm nicht.
• Legen Sie keine eigene Kopie mit eigener Verknüpfung in shell:startup an. So eine Kopie aktualisiert sich nicht.

Fenster und Menü

Der Print Agent ist wie der Prismamed Agent mit Avalonia gebaut - Fenster und Menü sehen unter Windows und am Mac gleich aus. Das Fenster (Klick auf das Symbol unter Windows, Koppeln … im Menü, am Mac auch Doppelklick auf das laufende Programm) hat zwei Bereiche:

• Mit TCMSOFT koppeln: Server-Adresse und Code aus Arbeitsplatz koppeln, Knopf Koppeln, darunter das Ergebnis (siehe Kopplung per Code).
• Verbindungen: je gekoppeltem Server eine Zeile wie im Menü; bei einer nicht verbundenen Kopplung entfernen… (mit Rückfrage).
• Unten Version, Agent-ID und Protokollordner sowie Protokoll öffnen.

Das Menü (Rechtsklick unter Windows, Klick am Mac):

„Prismamed WebApp“ ist der Name, unter dem der Agent eine Kopplung aus Agent suchen führt. Der Menüpunkt zum Entfernen heißt dann Kopplung „Prismamed WebApp“ entfernen…. Am Mac steht unter einer gestörten Verbindung zusätzlich ein Hinweis zum lokalen Netzwerk oder zum Zertifikat.

Datenordner und Rechte

Der Datenordner gilt für alle Windows-Konten des Rechners:

%ProgramData%\Prismamed\PrintAgent

• Beim Start gibt der Agent der Gruppe „Benutzer“ das Recht „Ändern“ auf diesen Ordner. So kann auch ein zweites Windows-Konto koppeln und protokollieren.

• Hat ein anderes Konto den Ordner angelegt und klappt das deshalb nicht, einmal in der Eingabeaufforderung als Administrator ausführen:

  icacls "%ProgramData%\Prismamed\PrintAgent" /grant *S-1-5-32-545:(OI)(CI)(M,DC)
  

• Der Zustand des Selbst-Updates liegt je Benutzer unter %LocalAppData%\Prismamed\PrintAgent.

• Die Umgebungsvariable PrintAgent__DataDirectory ersetzt den Datenordner. Ist ein Ordner nicht verwendbar, weicht der Agent auf den Ordner je Benutzer aus.

Mehrere Windows-Konten und Terminalserver

• Ein Print Agent je Rechner. Er läuft im zuerst angemeldeten Konto; gedruckt wird für alle über ihn. Startet er in einem zweiten Konto, meldet er „Der Prismamed Print Agent läuft an diesem PC bereits unter einem anderen Windows-Benutzer. Gedruckt wird über diesen Agenten, Sie müssen nichts tun. …“ und beendet sich.
• Die Kopplung liegt im gemeinsamen Datenordner und gilt deshalb für alle Konten.
• Jedes Konto hat aber seine eigene Installation. Führen Sie das Setup in jedem Konto aus, das sich als erstes anmelden könnte. Sonst druckt nach dessen Anmeldung niemand.
• Terminalserver: Es läuft ein Print Agent für den ganzen Server. Drucker, die nur in einer Sitzung umgeleitet sind, sieht er nicht. Richten Sie die Drucker deshalb fest in Windows ein.
• Absturz: Stürzt der Agent nach mindestens einer Minute Laufzeit ab, startet er sich selbst neu. Bei einem Absturz gleich nach dem Start oder durch einen fehlerhaften Druckertreiber geht das nicht. Dann über das Startmenü starten und den Treiber prüfen.

Entfernen

• Die Deinstallation unter Windows ist nicht beschrieben und nicht getestet. Vor dem Entfernen beim TCMSOFT-Support nachfragen.
• In TCMSOFT entfernen Sie den Agenten unter Stammdaten › Drucker mit Agent entfernen. Das geht nur, solange er nicht verbunden ist.

Print Agent am Mac

Welche Fassung

Apple-Menü › Über diesen Mac:

• „Chip Apple M…“: Fassung für Apple-Chip
• „Prozessor … Intel …“: Fassung für Intel

Der Print Agent braucht macOS 12 oder neuer.

Installieren

1. Melden Sie sich mit dem Benutzerkonto an, mit dem am Mac gearbeitet wird.

2. Laden Sie in TCMSOFT unter Stammdaten › Drucker › Print Agent herunterladen die DMG aus der Karte Mac mit Apple-Chip bzw. Mac mit Intel-Prozessor. Ohne TCMSOFT am Mac:

   https://downloads.tcmsoft.de/printagent/PrismamedPrintAgent-osx-arm64.dmg
   https://downloads.tcmsoft.de/printagent/PrismamedPrintAgent-osx-x64.dmg
   

   Die erste Zeile ist die Fassung für Apple-Chip, die zweite die für Intel.

3. Öffnen Sie die DMG und ziehen Sie „Prismamed Print Agent“ auf den Ordner „Applications“ (= „Programme“). Ohne Administratorrechte: Legen Sie im Benutzerordner einen Ordner Applications an und ziehen Sie den Agenten dorthin. macOS legt diesen Ordner nicht von selbst an.

4. Starten Sie den Agenten in diesem Ordner mit Doppelklick.

Woran Sie den Erfolg erkennen:

• macOS meldet einmal „Hintergrundobjekt hinzugefügt“. Das ist normal: Der Agent startet ab jetzt bei jeder Anmeldung. Er legt dafür ~/Library/LaunchAgents/de.prismamed.printagent.plist an.
• Das Fenster „Prismamed Print Agent“ öffnet sich mit Mit TCMSOFT koppeln, solange der Agent nicht gekoppelt ist.
• Oben rechts in der Menüleiste erscheint ein Druckersymbol. Das Menü beginnt mit „Prismamed Print Agent 2026.10.701“ und zeigt „Für „Agent suchen“ erreichbar (Port 9632)“ sowie „Noch mit keinem TCMSOFT gekoppelt - „Koppeln …“ wählen, Code aus Stammdaten › Drucker › „Arbeitsplatz koppeln““.
• In der Aktivitätsanzeige heißt der Prozess „Prismamed Print Agent“.
• Ist die Menüleiste voll (bei MacBooks hinter der Kamera-Aussparung), öffnet ein Doppelklick auf das Programm in „Programme“ das Fenster des Agenten.

Was tun, wenn nicht:

• Startet der Agent direkt aus der DMG, meldet er „Bitte ziehen Sie „Prismamed Print Agent“ in den Ordner „Programme“ … Direkt aus der heruntergeladenen Datei kann er nicht laufen.“ und beendet sich. Dann wie oben in „Programme“ ziehen.
• Darf das Benutzerkonto das Programm nicht ändern (ein anderes Konto hat es hineingezogen), druckt der Agent, aktualisiert sich aber nicht. Siehe Updates der Agenten.

Danach koppeln Sie den Agenten, siehe Kopplung per Code oder Kopplung per „Agent suchen“. Nach der Kopplung fragt macOS einmal, ob der Print Agent Geräte im lokalen Netzwerk nutzen darf. Wählen Sie Erlauben, sonst erreicht er TCMSOFT nicht.

Datenordner

Je Benutzerkonto:

~/Library/Application Support/Prismamed/PrintAgent

Darin liegen Kopplung, Agent-ID, der Zustand des Selbst-Updates, die Sperrdatei agent.lock und das Protokoll logs/log<JJJJMMTT>.txt (30 Tage). PrintAgent__DataDirectory ersetzt den Ordner.

Grenzen

• Ein Print Agent je Mac. Port 9632 lässt sich nur einmal belegen. Sind mehrere Konten gleichzeitig angemeldet, läuft nur der Agent des zuerst angemeldeten Kontos. Im zweiten Konto meldet er „Der Prismamed Print Agent kann nicht starten, weil Anschluss 9632 auf diesem Mac schon belegt ist. …“.
• Jedes Konto hat eine eigene Kopplung und eine eigene Agent-ID. In TCMSOFT erscheint der Agent jedes Kontos als eigener Agent. Richten Sie den Print Agent deshalb am besten nur im Konto ein, mit dem am Mac gearbeitet wird.
• Kein systemweiter Dienst. Ein launchd-Daemon wird nicht unterstützt. Drucker, Schlüsselbund und die Freigabe „Lokales Netzwerk“ gehören zur Anmeldesitzung.
• Ruhezustand: Schläft der Mac, ist sein Print Agent offline. Einen Mac, über den andere drucken, in den Systemeinstellungen (Energie) nicht in den Ruhezustand gehen lassen.
• Schläft der Bildschirm beim Start (typisch nach einem nächtlichen Update), druckt der Agent ohne Symbol weiter. Das Symbol kommt, sobald der Bildschirm wieder an ist.

Entfernen

1. Agent beenden: Menü › Beenden.

2. „Prismamed Print Agent“ aus „Programme“ in den Papierkorb legen.

3. Autostart und Datenordner im Terminal desselben Benutzerkontos löschen:

   rm "$HOME/Library/LaunchAgents/de.prismamed.printagent.plist"
   

   rm -r "$HOME/Library/Application Support/Prismamed/PrintAgent"
   

4. In TCMSOFT unter Stammdaten › Drucker den Agenten mit Agent entfernen löschen.

Kopplung per Code

Wozu: Der Print Agent eines Arbeitsplatzes erfährt Server-Adresse und Kopplungsgeheimnis, ohne dass der Browser ihn erreichen muss. Das geht ohne HTTPS, ohne Freigabe „lokales Netzwerk“ im Browser und von jedem Rechner aus – bevorzugter Weg für Arbeitsplätze.

Ablauf

1. In TCMSOFT Stammdaten › Drucker › Arbeitsplatz koppeln (an einem beliebigen Rechner). Das Fenster zeigt einen sechsstelligen Code und die Server-Adresse, unter der TCMSOFT gerade im Browser geöffnet ist.
2. Am Arbeitsplatz im Fenster des Agenten (öffnet sich beim Start, solange er nicht gekoppelt ist; sonst Windows: Klick auf das Druckersymbol im Infobereich, Mac: Klick auf das Symbol in der Menüleiste › Koppeln …) Server-Adresse und Code eintragen und Koppeln klicken. Ohne http:// bzw. https:// nimmt der Agent https:// an.
3. Der Agent meldet sich bei POST <Server-Adresse>/prismamed-print-kopplung mit Code, Agent-ID, Rechnername und Betriebssystem. TCMSOFT registriert ihn und antwortet mit Mandant, Kopplungsgeheimnis und Hub-Pfad.
4. Der Agent speichert die Kopplung und verbindet sich unter der eingegebenen Adresse mit /prismamed-print-hub (SignalR), wie nach Agent suchen. In TCMSOFT steht er danach als Arbeitsplatz mit dem Rechnernamen in der Liste.

Regeln

• Ein Code gilt 15 Minuten und nur einmal. Er liegt nur im Arbeitsspeicher von TCMSOFT; nach einem Neustart des Servers gilt er nicht mehr.
• Nach 10 falschen Codes verfallen alle offenen Codes – dann in der Druckerverwaltung einen neuen anzeigen lassen.
• Der Endpunkt /prismamed-print-kopplung ist ohne Anmeldung erreichbar; geschützt ist er durch den Code. Ein Reverse-Proxy muss ihn wie den Hub an TCMSOFT weiterreichen.
• Die Adresse im Fenster ist die, unter der der Browser TCMSOFT geöffnet hat. Öffnen Sie TCMSOFT zum Koppeln deshalb unter der Adresse, unter der der Arbeitsplatz den Server dauerhaft erreicht (nicht localhost, wenn Sie am Server sitzen).
• Eine bestehende Kopplung desselben TCMSOFT (z. B. mit einer alten Adresse nach einem Umzug) ersetzt der Agent – ohne die Prüfung unter Wer koppeln darf, denn die Eingabe am Rechner selbst ist eine bewusste Handlung.
• Mit dem Code lässt sich ein beliebiger Rechner an TCMSOFT koppeln. Zeigen Sie ihn deshalb nur, wenn gleich ein Arbeitsplatz gekoppelt wird, und geben Sie ihn nicht weiter.

Meldungen im Fenster

Kopplung per „Agent suchen“

Wozu: Die Kopplung sagt dem Print Agent eines Arbeitsplatzes, mit welchem TCMSOFT er sich verbinden soll. Für den Print Agent im Container ist sie nicht nötig.

Was dabei passiert

1. Der Browser am Arbeitsplatz fragt den Print Agent desselben Rechners ab: http://127.0.0.1:9632/api/print-agent/discover (Wartezeit 5 Sekunden).
2. TCMSOFT registriert den Agenten und erzeugt ein Kopplungsgeheimnis.
3. Der Browser übergibt dem Agenten Server-Adresse und Geheimnis (POST /api/print-agent/pair). Die Server-Adresse ist die Adresse, unter der TCMSOFT gerade im Browser geöffnet ist, mit /prismamed-print-hub dahinter.
4. Der Agent speichert die Kopplung und baut von sich aus eine Verbindung zu TCMSOFT auf (SignalR). Reißt sie ab, versucht er es nach 5 Sekunden erneut, höchstens im Abstand von einer Minute.
5. Alle 5 Minuten meldet sich der Agent neu an und übermittelt Druckerliste, Version und Update-Stand.

Daraus folgt: Öffnen Sie TCMSOFT zum Koppeln unter der endgültigen HTTPS-Adresse. Unter dieser Adresse verbindet sich der Agent später.

Voraussetzung 1: HTTPS

Chrome und Edge erlauben einer Webseite den Zugriff auf 127.0.0.1 nur, wenn sie über HTTPS geladen ist. Ausnahme: Auf dem Rechner, auf dem TCMSOFT selbst läuft, genügt http://localhost.

Wird TCMSOFT über http:// aufgerufen, meldet TCMSOFT nach Agent suchen: „Chrome und Edge lassen die Suche nach dem Print Agent nur zu, wenn diese Seite über HTTPS aufgerufen wird – bitte die HTTPS-Adresse verwenden.“

HTTPS richten Sie am Reverse-Proxy der NAS bzw. mit Caddy ein, siehe Netzwerk und HTTPS.

Voraussetzung 2: Freigabe für das lokale Netzwerk im Browser

Chrome und Edge fragen beim ersten Agent suchen, ob die Seite auf Geräte im lokalen Netzwerk zugreifen darf (in Chrome „Local Network Access“). Wählen Sie Zulassen.

Wurde die Frage abgelehnt, geben Sie den Zugriff über das Symbol links neben der Adresse › Website-Einstellungen wieder frei. TCMSOFT weist darauf hin: „Hat der Browser nach dem Zugriff auf Geräte im lokalen Netzwerk gefragt, bitte „Zulassen“ wählen (sonst über das Symbol links neben der Adresse › Website-Einstellungen freigeben).“

Voraussetzung 3: Ein Zertifikat, dem der Arbeitsplatz vertraut

Nicht nur der Browser, auch der Print Agent selbst verbindet sich über HTTPS mit TCMSOFT. Deshalb gilt:

• Das Zertifikat muss für genau die Adresse gelten, unter der die Arbeitsplätze TCMSOFT öffnen.
• Windows bzw. macOS muss ihm vertrauen. Zeigt der Browser eine Zertifikatswarnung, verbindet sich der Agent nicht.

Abhilfe, eine von beiden:

• ein Zertifikat einer anerkannten Stelle, z. B. Let's Encrypt mit festem Namen, oder
• das Zertifikat der NAS an jedem Arbeitsplatz als vertrauenswürdige Stammzertifizierungsstelle importieren. Am Mac: in der Schlüsselbundverwaltung importieren und „Immer vertrauen“ wählen.

Woran Sie ein Zertifikatsproblem erkennen:

• Im Menü des Agenten steht bei der Verbindung „✖ Prismamed WebApp – getrennt: …“ mit „SSL“ oder „certificate“ im Grund.
• Am Mac steht darunter „Dieser Mac vertraut dem Zertifikat von TCMSOFT nicht - im Schlüsselbund „Immer vertrauen“ einstellen (IT-Betreuung)“.

Ablauf

1. Prüfen Sie, dass der Print Agent am Arbeitsplatz läuft (Symbol im Infobereich bzw. in der Menüleiste).
2. Öffnen Sie an diesem Rechner TCMSOFT über die HTTPS-Adresse und melden Sie sich an.
3. Wählen Sie Stammdaten › Drucker und klicken Sie auf Agent suchen. Während der Suche steht dort „Suche läuft...“.
4. Fragt der Browser nach dem Zugriff auf Geräte im lokalen Netzwerk: Zulassen.
5. Nur am Mac: Fragt macOS danach, ob der Print Agent das lokale Netzwerk nutzen darf: Erlauben.

Woran Sie den Erfolg erkennen

• TCMSOFT meldet Print Agent verbunden: „Der Print Agent dieses Rechners (…) ist verbunden.“
• In der Karte Agent steht beim Status „Online“, bei Version „2026.10.701 – aktualisiert sich selbst“.
• Der Reiter Drucker zeigt die Drucker dieses Rechners.
• Im Menü des Agenten steht „✔ Prismamed WebApp – verbunden seit …“. Unter Windows lautet der Text beim Daraufzeigen „Prismamed Print Agent – 1/1 verbunden“.
• Drucken Sie zur Probe eine Seite.

Was tun, wenn nicht

Test, ob der Agent für den Browser erreichbar ist: Öffnen Sie am Arbeitsplatz im Browser diese Adresse:

http://127.0.0.1:9632/api/print-agent/discover

Antwortet der Agent, erscheint ein kurzer Text (JSON) mit "agentId" und "isPaired". Erscheint nichts, läuft der Agent nicht, oder Port 9632 ist belegt (siehe Port 9632).

Wer koppeln darf

Damit niemand einen Print Agent auf einen fremden Server umlenkt, nimmt der Agent eine Kopplung nur an:

• von TCMSOFT auf demselben Rechner (127.0.0.1, ohne Browser),
• von der TCMSOFT-Seite im Browser, und nur für deren eigenen Server,
• als erste Kopplung oder als erneute Kopplung an denselben Server.

Ist der Agent schon mit einem anderen Server gekoppelt, lehnt er ab: „Dieser Print Agent ist bereits mit dem TCMSOFT unter „…“ gekoppelt. Um ihn mit einem anderen TCMSOFT zu verbinden, entfernen Sie zuerst diese Kopplung am Gerät des Print Agents …“. Kommt die Kopplung nicht von der TCMSOFT-Seite selbst, lautet der Grund „Die Kopplung muss von der TCMSOFT-Seite selbst kommen. …“.

Neue Adresse oder neuer Port von TCMSOFT: Für Agent suchen ist das ein anderer Server. Am einfachsten koppeln Sie an jedem Arbeitsplatz per Code neu: TCMSOFT unter der neuen Adresse öffnen, Arbeitsplatz koppeln, am Arbeitsplatz Koppeln … – das ersetzt die alte Kopplung. Über Agent suchen:

1. Im Menü des Agenten Kopplung „…“ entfernen… wählen. Das geht, sobald die alte Adresse nicht mehr verbunden ist.
2. TCMSOFT unter der neuen Adresse öffnen und erneut Agent suchen.

Aufräumen in TCMSOFT

• Agent entfernen unter Stammdaten › Drucker löscht den gewählten Agenten nach der Rückfrage „Soll der Agent "…" wirklich entfernt werden?“. Das geht nur bei nicht verbundenen Agenten. Er kann sich danach nicht mehr verbinden, bis er neu gekoppelt wird.
• Registrierungen, die länger als 90 Tage nicht verbunden waren, entfernt TCMSOFT automatisch.

Print Agent im Docker-Container

Aufbau

• Der TCMSOFT-Container enthält neben der Anwendung das Drucksystem CUPS mit Druckertreibern und einen Print Agent für Linux. Der Container startet ihn selbst.
• Der Agent lauscht nur auf 127.0.0.1:9632. TCMSOFT koppelt ihn automatisch. Agent suchen ist für ihn nicht nötig.
• In Stammdaten › Drucker erscheint er mit System „Linux“.
• CUPS lauscht nur auf seinem Socket im Container und belegt keinen Port der NAS, auch nicht 631. Eine CUPS-Weboberfläche gibt es deshalb nicht. Drucker richten Sie nur in TCMSOFT ein.
• Der Container läuft im Host-Netz der NAS (der Update-Dienst legt ihn so an). Nur dort erreichen die Bonjour-Meldungen der Drucker den Container.
• Der Agent im Container aktualisiert sich nicht selbst. Er kommt mit jedem Update von TCMSOFT neu, siehe Updates von TCMSOFT.

Abschalten

Druckt die Praxis nur über die Arbeitsplätze, schalten Sie den Agent im Container unter Stammdaten › Drucker mit Drucker am Server: an / aus (oben in der Leiste, mit Rückfrage) ab. Standard ist „an“, auch bei neuen Installationen.

• Aus heißt: TCMSOFT blendet den Agent aus – im Druckfenster, in der Druckerverwaltung und bei der Vorwahl des Druckers. Niemand druckt mehr versehentlich über ihn.
• Der Agent und CUPS laufen im Container weiter, Drucker und Kopplung bleiben erhalten. Wieder einschalten wirkt sofort, ein Neustart ist nicht nötig. Andere Arbeitsplätze sehen die Änderung, sobald dort die Seite neu geladen wird.
• Die Einstellung gilt für die ganze Praxis (Betriebsstätte, Feld DruckerAmServer).
• Drucklayouts, in denen ein Drucker am Server fest eingetragen ist, stellen Sie vorher auf einen Drucker an einem Arbeitsplatz um. Sonst schlägt das Druckfenster dort den zuletzt benutzten Drucker vor und zeigt einen Hinweis.

Drucker einrichten

Voraussetzung: Der Drucker ist eingeschaltet, im selben Netz wie die NAS, und Bonjour/AirPrint (mDNS) ist am Drucker eingeschaltet.

1. Stammdaten › Drucker, bei mehreren Agenten im Feld Agent den Agenten mit System „Linux“ wählen.
2. Im Reiter Drucker auf Drucker hinzufügen klicken.
3. Im Reiter Erkannte Drucker sucht TCMSOFT die Drucker im Netz. Die Suche dauert bis zu 30 Sekunden. Wählen Sie den Drucker aus.
4. Bei Bedarf Beschreibung und Standort eintragen und Als Standarddrucker festlegen einschalten.
5. Hinzufügen klicken. Während „Drucker wird eingerichtet – das kann bis zu zwei Minuten dauern …“ angezeigt wird, prüft der Agent den Drucker und wählt den Treiber.

Woran Sie den Erfolg erkennen: TCMSOFT meldet Drucker hinzugefügt, der Drucker steht im Reiter Drucker. Drucken Sie eine Probeseite.

Drucker ohne Bonjour: Im Reiter Manuell eintragen.

Einen Drucker entfernen Sie über den Papierkorb in seiner Zeile (Drucker löschen).

Wie der Agent den Treiber wählt

Der Agent fragt den Drucker, was er kann, und nimmt in dieser Reihenfolge:

1. eine passende PPD-Datei aus dem Ordner treiber/ im Datenordner,
2. bei Laserdruckern mit PCL: den HP-Treiber für HP-Geräte, sonst den allgemeinen PCL-Treiber,
3. einen Modelltreiber aus dem Container (z. B. für Brother-, Samsung- und Epson-Geräte ohne PCL),
4. treiberlos (AirPrint/IPP Everywhere),
5. zuletzt PostScript.

Klappt ein Treiber nicht, probiert er den nächsten. Welchen er gewählt hat, steht in docker logs tcmsoft in der Zeile „Printer … added with …“. Ein schon eingerichteter Drucker behält seinen Treiber, bis er neu hinzugefügt wird.

Im Container sind unter anderem enthalten: OpenPrinting/Foomatic-PPDs, hplip, Gutenprint und Treiber für Brother (brlaser), Epson (escpr), Oki, Dymo sowie Samsung/Xerox (splix).

Eigene Treiber

PPD-Datei des Herstellers (.ppd oder .ppd.gz, für Linux/CUPS):

1. Datei in den Ordner treiber/ im Datenordner legen.

2. TCMSOFT neu starten:

   docker restart tcmsoft
   

3. Den Drucker in TCMSOFT entfernen und neu hinzufügen.

Passt der Modellname der PPD nicht zum Drucker, meldet der Agent das beim Hinzufügen. Dann im Reiter Manuell als Treiber eigene-treiber/<Dateiname> eintragen. Den Dateinamen zeigt das Protokoll beim Start; Leerzeichen und Klammern werden zu _.

.deb-Pakete des Herstellers:

• Unverändert nach treiber/ legen (auch in einen Unterordner) und docker restart tcmsoft ausführen.
• TCMSOFT installiert sie bei jedem Start, bevor das Drucksystem startet. Im Protokoll steht dann „Treiberpakete installiert: …“.
• Die Pakete müssen liegen bleiben, solange ein Drucker sie nutzt. Fehlt ein Paket, nennt das Protokoll beim Start den betroffenen Drucker („Warnung: Der Drucker … ist mit einem Treiber eingerichtet, der nicht installiert ist“).
• Pakete für 32-Bit-Intel (i386, so liefert Brother seine Linux-Treiber) laufen nur auf NAS mit Intel- oder AMD-Prozessor.
• .rpm-Pakete und Installationsprogramme (.sh, Brothers „Driver Install Tool“) werden nicht ausgeführt.
• Bei einer neuen Treiberversion die alte Datei aus treiber/ löschen.

Beispiel Brother-Schwarzweißlaser mit PCL: Von der Brother-Downloadseite (Betriebssystem „Linux (deb)“) beide Pakete des Generic-Treibers laden (brgenml1lpr-….i386.deb und brgenml1cupswrapper-….i386.deb), nach treiber/ legen, TCMSOFT neu starten, Drucker neu hinzufügen.

Ausgeschaltete Drucker

Ein ausgeschalteter Drucker hält die Warteschlange nicht an. Aufträge werden einen Tag lang alle 5 Minuten erneut versucht. Ältere Aufträge verwirft das Drucksystem.

Was gesichert werden muss

Befehle für den Support

Warteschlangen anzeigen:

docker exec tcmsoft lpstat -v

Gefundene Drucker anzeigen:

docker exec tcmsoft lpinfo -v

Bonjour-Meldungen der Drucker im Netz anzeigen:

docker exec tcmsoft avahi-browse -rt _ipp._tcp

Drucksystem, Treiberinstallation und gewählte Treiber (Zeilen mit [tcmsoft] und „Printer … added with …“):

docker logs tcmsoft

Drucker einrichten – Übersicht

• Bei Windows- und Mac-Agenten lassen sich Drucker in TCMSOFT weder hinzufügen noch entfernen.
• Windows listet auch Netzwerkverbindungen wie \\server\drucker.
• Drucker ohne Papier („Microsoft Print to PDF“, XPS, Fax, OneNote) bietet TCMSOFT nicht an. Zum Speichern gibt es im Druckfenster Als PDF laden.

Port 9632

• Für Agent suchen genügt der Zugriff über 127.0.0.1 am selben Rechner. Eine Freigabe im Praxisnetz ist dafür nicht nötig.
• Ob Windows beim ersten Start eine Firewall-Rückfrage zeigt, ist nicht dokumentiert.
• Die Verbindung vom Agenten zu TCMSOFT geht ausgehend über die Adresse und den Port von TCMSOFT (z. B. 443 über den Reverse-Proxy).

Port belegt:

Protokolle

• Unter Windows und am Mac öffnet der Menüpunkt Protokoll öffnen den Ordner, Datenordner öffnen den Datenordner.
• Im Protokoll stehen auch die Meldungen des Selbst-Updates. Zeilen von Velopack beginnen mit „Velopack: “.
• Ein nicht erreichbarer Server steht als eine Warnzeile mit Grund im Protokoll, Wiederholungen höchstens einmal je Stunde.
• In TCMSOFT zeigt Stammdaten › Drucker, Reiter Druck-Warteschlange, je Auftrag Status und Meldung.

Weitere Protokolle: Protokolle und Diagnose.

Typische Störungen

Fehlercodes in Protokoll und Warteschlange (Auswahl): printer_not_found (Drucker gibt es am Agent-Rechner nicht), virtual_printer (Drucker ohne Papier), printer_timeout (Treiber nimmt den Auftrag nicht an), printer_waiting, spooler_rejected, agent_updating, printer_attention (gedruckt, mit Hinweis wie „Papier fehlt“).

Siehe auch

• Die Agenten im Überblick
• Updates der Agenten
• Netzwerk und HTTPS
• Datenordner und tcmsoft.env
• Protokolle und Diagnose
• Benutzerhandbuch › Stammdaten › Drucker