TCMSOFT – Inhalt

Typische Supportfälle

Diese Seite führt Schritt für Schritt durch die häufigsten Fehler. Jeder Fall nennt die Anzeichen, die Schritte, woran Sie den Erfolg erkennen und was zu tun ist, wenn es nicht klappt. Die genaue Bedeutung einzelner Meldungen steht unter Meldungen und ihre Bedeutung, die Fundorte der Protokolle unter Protokolle und Diagnose.

Bevor Sie anfangen

Was Sie brauchen

Sie brauchen SSH-Zugang zur NAS bzw. zum Server. Auf einer Synology melden Sie sich als Administrator an und wechseln mit sudo -i zu root.

In den Befehlen steht <Datenordner> für den Datenordner von TCMSOFT. Er steht in der Startzeile des Update-Dienstes:

docker logs tcmsoft-updater 2>&1 | grep "startet: Datenordner"

Die Version des Update-Dienstes zeigt:

grep UpdaterVersion <Datenordner>/updater/status.json

Grundregeln

  1. Läuft gerade ein Update, greifen Sie nicht ein. Sie erkennen es an der Datei <Datenordner>/updater/vorgang.json, an einem Container tcmsoft-vorher in docker ps -a oder am laufenden Schritt auf der Karte Programmversion und Updates unter Stammdaten › Backup. Eine neue Version darf bis zu 30 Minuten zum Starten brauchen, ein Rückfall weitere 10 Minuten.

  2. Wollen Sie von Hand an den Containern arbeiten, halten Sie vorher den Update-Dienst an. Sonst legt er einen entfernten Container sofort wieder an.

    docker stop tcmsoft-updater

    Danach wieder starten. Ein angehaltener Update-Dienst bleibt auch nach einem Neustart der NAS aus.

    docker start tcmsoft-updater

  3. Löschen Sie nie: mongodb/, keys/, tcmsoft.env, cups/, printagent/, treiber/ und schriften/ (falls benutzt), updater/vorgang.json und die Images tcmsoft:<Version>.

  4. Kopieren Sie die Datenbank nie als Dateien im laufenden Betrieb. Gesichert wird über Stammdaten › Backup (siehe Datensicherung und Umzug).

  5. Geben Sie keine Geheimnisse weiter: nicht keys/, nicht keys/mongo-passwort, nicht agent.json, nicht pairings.json.

Container neu anlegen lassen

Nach einer Änderung an tcmsoft.env muss der Container tcmsoft neu angelegt werden. docker restart tcmsoft liest tcmsoft.env nicht neu.

docker rm -f tcmsoft

Ab Update-Dienst 2026.10.7.1 legt der Dienst ihn spätestens nach 10 Minuten mit derselben Version wieder an. Bei einem älteren Update-Dienst vorher auf der Backup-Seite Jetzt prüfen wählen und, wenn eine neue Version bereitliegt, stattdessen Jetzt aktualisieren – sonst käme die neue Version ohne Sicherung. Läuft TCMSOFT bei einem älteren Update-Dienst nicht, fragen Sie vor docker rm -f tcmsoft beim TCMSOFT-Support nach.

TCMSOFT startet nicht oder ist nicht erreichbar

Anzeichen: Der Browser zeigt TCMSOFT nicht an, oder die Glocke meldet „TCMSOFT startet nicht“.

Schritte

  1. Im Browser http://<Server>:8085/health aufrufen (anderer Port, falls in tcmsoft.env geändert). Auf dem Mikroserver lauscht TCMSOFT nur auf 127.0.0.1:5000; dort per SSH curl http://127.0.0.1:5000/health ausführen.

    • ok: TCMSOFT läuft. Dann liegt es an der Adresse, am Reverse-Proxy oder am Netz des Arbeitsplatzes. Prüfen Sie Adresse und Proxy, siehe Netzwerk und HTTPS.
    • Datenbank antwortet nicht: weiter mit Schritt 3.
    • keine Antwort: weiter mit Schritt 2.

  2. Per SSH die Container ansehen:

    docker ps -a
    Befund Was tun
    tcmsoft-vorher ist da oder updater/vorgang.json existiert Ein Update läuft. Abwarten (siehe Grundregeln).
    tcmsoft fehlt Der Update-Dienst legt ihn spätestens nach 10 Minuten an. Ob das klappt, zeigt docker logs --tail 50 tcmsoft-updater („TCMSOFT konnte nicht eingerichtet werden: …“).
    tcmsoft-updater läuft nicht docker start tcmsoft-updater. Beendet er sich wieder, docker logs tcmsoft-updater lesen (siehe Im Protokoll des Update-Dienstes).
    tcmsoft steht auf „Exited“ docker start tcmsoft. Einen vorhandenen, aber angehaltenen Container startet der Update-Dienst nicht von selbst.
    tcmsoft startet immer wieder neu oder ist nicht „healthy“ weiter mit Schritt 3

  3. Das Protokoll lesen und nach Zeilen mit [tcmsoft] suchen:

    docker logs --tail 300 tcmsoft
    Zeile (Anfang) Was tun
    „Dieser Prozessor unterstützt kein AVX …“ Das Gerät ist ungeeignet; ein anderes ist nötig.
    „Port … ist auf diesem Gerät schon belegt …“ Andere Datenbank bzw. alten Dienst beenden oder in tcmsoft.env einen freien Port eintragen, dann docker rm -f tcmsoft.
    „Der Datenordner /data ist nicht beschreibbar …“ Rechte und Einbindung des Datenordners prüfen.
    „MongoDB konnte nicht gestartet werden …“ Speicherplatz (siehe Speicherplatz voll) und Rechte auf mongodb/ prüfen.
    „Die Anmeldung an der Datenbank schlägt fehl …“ keys/mongo-passwort passt nicht zur Datenbank. Den TCMSOFT-Support informieren.
    „TCMSOFT startet noch (… s) …“ Warten. Nach einem Update bis zu 30 Minuten.
    „TCMSOFT bricht beim Start wiederholt ab …“ Die Fehlermeldung weiter oben lesen und an den Support geben.
    „Migration … is already running according to tracking data …“ Bekannter Fehler; die TCMSOFT-Entwicklung einschalten.

    Alle Meldungen stehen unter Im Protokoll von TCMSOFT.

  4. Haben Sie tcmsoft.env korrigiert, den Container neu anlegen lassen (siehe Container neu anlegen lassen). Für einen reinen Neustart genügt docker restart tcmsoft.

Woran Sie den Erfolg erkennen: Dieser Befehl zeigt healthy, /health antwortet ok, und im Browser erscheint die Anmeldeseite.

docker inspect --format '{{.State.Health.Status}}' tcmsoft

Wenn es im Browser trotzdem hakt

Wenn nicht: Meldet die Glocke „TCMSOFT startet nicht“ mit „… ohne Sicherung der Datenbank neu geladen …“, dann nichts weiter versuchen, den Container nicht erneut entfernen und sofort den TCMSOFT-Support informieren. In allen anderen Fällen die Angaben unter „Was der TCMSOFT-Support braucht“ in Protokolle und Diagnose sammeln und den Support anrufen.

Update fehlgeschlagen

So läuft ein Update ab – nachts ab der eingestellten Uhrzeit (Standard 03:00, nur innerhalb von 3 Stunden) oder sofort über Jetzt aktualisieren:

  1. Versionsangabe und Signatur prüfen, Image laden.
  2. Platz für die Sicherung prüfen.
  3. TCMSOFT beenden und in tcmsoft-vorher umbenennen.
  4. mongodb/ nach vor-update/ sichern.
  5. Neue Version starten und bis zu 30 Minuten warten, bis sie „healthy“ ist.
  6. Bei Erfolg den alten Container, die Sicherung, die Downloads und alte Images entfernen. Die laufende und die vorige Version bleiben als Image.

Rückfall. Startet die neue Version dreimal neu, ist sie „dead“ oder nach 30 Minuten nicht gesund, holt der Update-Dienst die alte zurück:

Wird der Server mittendrin neu gestartet, macht der Dienst anhand von updater/vorgang.json an der richtigen Stelle weiter.

Glocke „Update auf Version … fehlgeschlagen“

TCMSOFT läuft mit der alten Version und dem Datenstand von vor dem Update.

  1. Prüfen, ob sich die Praxis normal anmelden und arbeiten kann.

  2. Diese Angaben an den TCMSOFT-Support geben:

    • die Datei <Datenordner>/updater/protokoll/tcmsoft-<Version>.log,
    • die Ausgabe von docker logs --tail 300 tcmsoft-updater.

  3. Sonst nichts tun. Eine Korrektur kommt in der Regel mit einer neuen Versionsnummer.

  4. Nur wenn der Support es sagt, dieselbe Version noch einmal versuchen. Dafür die Sperrdatei ansehen und löschen:

    cat <Datenordner>/updater/fehlgeschlagen-tcmsoft.txt
rm <Datenordner>/updater/fehlgeschlagen-tcmsoft.txt

    Die Datei sperrt alle Versionen, die darin stehen; nach dem Löschen sind sie wieder erlaubt. Danach auf der Backup-Seite Jetzt prüfen wählen – erst dann ist die Version wieder als Verfügbare Version bekannt – und Jetzt aktualisieren.

Erfolg: In der Glocke steht „Update auf Version …“, die Backup-Seite zeigt die neue Installierte Version.

Glocke „Update auf Version … unterbrochen“

Das Update brach ab, bevor die neue Version lief, z. B. weil der Server neu gestartet wurde. TCMSOFT läuft mit der alten Version; der nächste Versuch folgt in der nächsten Nacht. Nichts tun. Wiederholt es sich, docker logs tcmsoft-updater lesen und den Grund an den Support geben.

Glocke „TCMSOFT läuft nach einem Update nicht“ oder „TCMSOFT nach einem Update nicht wiederhergestellt“

Das ist ein Notfall: Auch die alte Version kommt nicht hoch, oder der Rückfall selbst ist gescheitert.

  1. Nichts entfernen. Keine Container löschen, updater/vorgang.json und vor-update/ nicht anfassen. Der Update-Dienst setzt einen unterbrochenen Rückfall nach seinem Neustart selbst fort.

  2. Nur lesen und die Ausgaben sichern:

    docker ps -a
docker logs --tail 300 tcmsoft
docker logs --tail 300 tcmsoft-updater
ls -l <Datenordner>/updater/

  3. Sofort den TCMSOFT-Support informieren.

  4. Im Protokoll von TCMSOFT nach Ursachen suchen, die nichts mit dem Update zu tun haben (Speicherplatz, Port, siehe TCMSOFT startet nicht oder ist nicht erreichbar), und sie dem Support nennen.

Glocke „Update nicht installiert“

Das angebotene Paket wurde abgelehnt (Signatur, Architektur, unlesbar). TCMSOFT läuft unverändert. Die Praxis muss nichts tun. Den Wortlaut der Meldung an den TCMSOFT-Support geben.

Glocke „Update-Dienst nicht aktualisiert“

Der neue Update-Dienst hat nicht übernommen; der bisherige arbeitet weiter. Die Datei <Datenordner>/updater/protokoll/updater-<Version>.log an den Support geben. Die Version steht danach in updater/fehlgeschlagen-updater.txt. Ob und wie sie wieder zugelassen wird, ist nicht dokumentiert – beim TCMSOFT-Support nachfragen.

Zurück zur vorigen Version von Hand

Der Update-Dienst behält das Image der vorigen Version, spielt aber nie selbst eine ältere Version ein. Ein freigegebenes Verfahren für den Rückweg von Hand gibt es nicht; die Datenbank ist nach einem gelungenen Update schon angepasst. Nach einem Wechsel der MongoDB-Version hebt TCMSOFT das Datenformat nach 7 Tagen an; danach führt der Weg zurück nur noch über eine Rücksicherung. Wenden Sie sich in diesem Fall an den TCMSOFT-Support.

Speicherplatz voll

Anzeichen

Wie viel Platz ein Update braucht. Liegt der Datenordner auf Btrfs (Standard bei Synology) oder XFS, kostet die Sicherung vor dem Update keinen zusätzlichen Platz. Sonst müssen frei sein: Größe der Datenbank plus 10 % plus 2 GB Reserve. Fehlt der Platz, bleibt das geladene Image liegen, und der Dienst versucht es jede Nacht erneut.

Schritte

  1. Freien Platz ansehen:

    df -h <Datenordner>

  2. Sehen, was im Datenordner groß ist:

    du -sh <Datenordner>/*

  3. Was der Update-Dienst selbst aufräumt, müssen Sie nicht löschen: Downloads in updater/download/, einen übrig gebliebenen tcmsoft-vorher, eine alte Sicherung in vor-update/ (vor jedem Update) und alte Images (nach jedem gelungenen Update).

  4. Nie löschen: siehe Grundregeln. Auch Docker-Images von TCMSOFT nicht von Hand löschen: Fehlt dann einmal der Container, lädt der Dienst die aktuelle Version ohne Sicherung.

  5. Laut Anleitung müssen updater/, vor-update/, bibliothek/, pharmindex/ und tmp/ nicht gesichert werden. Ob man dort von Hand löschen darf, ist nicht dokumentiert – vorher beim TCMSOFT-Support nachfragen. vor-update/ während eines Updates nie anfassen.

  6. Platz auf dem Gerät schaffen, z. B. andere Daten auf der NAS verschieben, oder den Datenträger vergrößern.

  7. Das alte Programmprotokoll prüfen: Bis TCMSOFT 2026.10.7.1 stand es in der Datenbank tcmsoft und wurde dort nie bereinigt. Ab 2026.10.8.1 wächst es dort nicht mehr, die alten Einträge bleiben aber liegen. Die Datenbank-Konsole öffnen und dort show dbs eingeben; es zeigt die Größe jeder Datenbank.

    docker exec -it tcmsoft tcmsoft-mongosh

    Ist tcmsoft auffällig groß, den TCMSOFT-Support informieren. Eine freigegebene Bereinigung gibt es nicht.

Erfolg: In der nächsten Nacht kommt „Update auf Version …“ in die Glocke. Sofort geht es mit Jetzt aktualisieren auf der Backup-Seite; das Image liegt dann schon bereit.

Wenn nicht: Den Wortlaut der Warnung (mit Datenbankgröße und freiem Platz) und die Ausgabe von df -h an den TCMSOFT-Support geben.

Update wird nicht gefunden

Anzeichen: Eine neue Version ist angekündigt, aber die Backup-Seite zeigt bei Verfügbare Version „keine neuere bekannt“. Oder ein bekanntes Update wird nachts nicht eingespielt.

Schritte

  1. Stammdaten › Backup, Karte Programmversion und Updates öffnen.

    • Warnkarte „Der Update-Dienst meldet sich nicht …“: docker start tcmsoft-updater; startet er nicht, docker logs tcmsoft-updater lesen.
    • Andere Warnkarte: Sie nennt den Grund; die Bedeutung steht unter Meldungen und ihre Bedeutung.

  2. Jetzt prüfen wählen. Die Seite wartet bis zu einer Minute.

    • „Neue Version verfügbar“: fertig. Jetzt aktualisieren oder bis zur Nacht warten.
    • „TCMSOFT … ist aktuell.“: Der Update-Dienst kennt keine neuere Version. Weiter mit Schritt 3.
    • Warnkarte „Die Versionsprüfung bei downloads.tcmsoft.de ist fehlgeschlagen …“: weiter mit Schritt 4.

  3. Im Browser nachsehen, was der Download-Server anbietet. Welche Datei passt, zeigt auf dem Server uname -m: x86_64 braucht tcmsoft-x64.json, aarch64 braucht tcmsoft-arm64.json.

    https://downloads.tcmsoft.de/docker/tcmsoft-x64.json
    Ergebnis Bedeutung Was tun
    Version ist gleich oder kleiner als die Installierte Version Es gibt kein neueres Update. Nichts.
    Version ist größer, wird aber nicht angeboten Die Version ist hier gesperrt, oder das Paket wurde abgelehnt. In <Datenordner>/updater/fehlgeschlagen-tcmsoft.txt nachsehen und in der Glocke nach „Update nicht installiert“ suchen; siehe Update fehlgeschlagen.
    Architektur passt nicht zum Server Falsches Paket. Den TCMSOFT-Support informieren.
    Seite nicht gefunden Für diese Architektur ist keine Version veröffentlicht. Der Update-Dienst meldet das nicht als Fehler, sondern zeigt nur „keine neuere bekannt“. Den TCMSOFT-Support informieren.

  4. Prüfen, ob der Server selbst den Download-Server erreicht. Per SSH:

    curl -fsS https://downloads.tcmsoft.de/docker/tcmsoft-x64.json

    Kommt hier ein Fehler, obwohl der Browser am Arbeitsplatz die Datei zeigt, fehlt dem Server der Weg ins Internet (DNS, Gateway, Firewall). Der Update-Dienst braucht ausgehend HTTPS zu downloads.tcmsoft.de.

  5. Eine bekannte Version wird nachts nicht eingespielt? Mögliche Gründe:

    • Automatisch spielt der Dienst nur innerhalb von 3 Stunden ab der Uhrzeit unter Prüfung täglich um ein. War der Server in dieser Zeit aus, oder startete der Update-Dienst erst nach dieser Uhrzeit neu, holt er den Lauf an diesem Tag nicht nach.
    • Es fehlt Platz für die Sicherung (Warnkarte, siehe Speicherplatz voll).
    • Eine Datenübernahme läuft („Das Update auf … wartet, bis die laufende Datenübernahme beendet ist.“).

    Sofort einspielen: Jetzt aktualisieren.

  6. Neue Version des Update-Dienstes: Vergleichen Sie UpdaterVersion aus status.json mit Version in https://downloads.tcmsoft.de/docker/tcmsoft-updater-x64.json. Jetzt prüfen sieht nicht nach einem neuen Update-Dienst. Er kommt in der Nacht oder mit Jetzt aktualisieren – das geht nur, wenn zugleich ein TCMSOFT-Update bereitliegt.

Erfolg: Die Karte zeigt die neue Version unter Verfügbare Version; nach dem Update steht sie unter Installierte Version.

Agenten. Prismamed Agent und Print Agent holen ihre Updates selbst vom Download-Server. Welche Fassung zum Herunterladen bereitsteht, zeigt https://downloads.tcmsoft.de/agent/aktuell-windows.txt bzw. https://downloads.tcmsoft.de/printagent/aktuell-windows.txt. Kommt ein Agent-Update nicht an, prüfen Sie:

Einzelheiten stehen unter Updates der Agenten.

Agent offline

Prismamed Agent (Geräte, Labor, Scans; ab TCMSOFTpro)

Anzeichen: Unter Stammdaten › Agenten steht der Status „Offline“ (länger als 90 Sekunden kein Kontakt) oder „Gestört“. Am Arbeitsplatz ist die Raute blass oder trägt ein Ausrufezeichen.

Schritte

  1. Läuft der Agent?
    • Windows: Symbol im Infobereich; unter Windows 11 oft im ausgeblendeten Bereich. Sonst „Prismamed Agent“ über das Startmenü starten.
    • Mac: Symbol in der Menüleiste. Sonst „Prismamed Agent“ im Ordner „Programme“ starten. Ist die Menüleiste voll, öffnet ein Doppelklick auf das Programm das Fenster.
  2. Das Fenster öffnen (Windows: Klick auf das Symbol; Mac: Menü › Einstellungen…) und die Statuszeile lesen.
  3. „Keine Verbindung: Keine Verbindung zum Server: …“:
    • Unter Verbindung steht die Server-Adresse. Sie muss die Adresse sein, unter der TCMSOFT im Browser läuft.
    • Diese Adresse am selben Rechner im Browser öffnen. Kommt TCMSOFT nicht, liegt es am Netz oder am Server (siehe TCMSOFT startet nicht oder ist nicht erreichbar).
    • Zeigt der Browser eine Zertifikatswarnung, siehe Zertifikatsfehler. Der Agent selbst zeigt dann nur einen technischen Fehlertext.
    • Hat sich die Adresse von TCMSOFT geändert (z. B. nach einem Umzug), im Fenster Kopplung aufheben und mit einem neuen Kopplungscode und der neuen Adresse neu koppeln (Schritt 4).
    • Mac: Die Frage nach dem lokalen Netzwerk muss mit „Erlauben“ beantwortet sein. Nachträglich unter Systemeinstellungen › Datenschutz & Sicherheit › Lokales Netzwerk.
  4. „Der Agent ist nicht (mehr) gekoppelt. …“: Der Agent wurde in TCMSOFT entfernt oder deaktiviert.
    • Unter Stammdaten › Agenten den Agenten öffnen und Aktiv einschalten, oder
    • mit dem Schlüsselsymbol (Kopplungscode erzeugen) einen neuen Code holen (6 Ziffern, 15 Minuten gültig, nur einmal). Im Fenster des Agenten unter Mit TCMSOFT koppeln die Server-Adresse und den Code eintragen und Koppeln klicken.
  5. Status „Gestört“: Die Spalte Letzte Meldung nennt den Fehler. Bei einem Ordnerproblem zeigt das Fenster unter Überwachte Ordner, welcher Ordner nicht erreichbar ist (Laufwerk nicht verbunden, Rechte). Am Mac den Ordner unter Systemeinstellungen › Datenschutz & Sicherheit › Dateien und Ordner für den „Prismamed Agent“ erlauben.
  6. Das Protokoll lesen: Menü › Protokoll öffnen.
  7. Auf dem Server zeigt docker logs tcmsoft abgewiesene Versuche als „Agent-Schnittstelle: ungültiger Schlüssel von …“ bzw. „Kopplung fehlgeschlagen von …“, jeweils mit der IP-Adresse des Arbeitsplatzes.

Erfolg: Die Raute ist kräftig, die Statuszeile lautet „Verbunden mit …“, und unter Stammdaten › Agenten steht nach spätestens einer Minute „Online“ (die Liste lädt sich alle 30 Sekunden neu).

Wenn nicht: Das Protokoll des Tages und den Text der Statuszeile an den TCMSOFT-Support geben.

Anzeichen: Unter Stammdaten › Drucker steht beim Agenten „Offline seit …“ oder „Nie verbunden“, darunter die Warnkarte „Der Agent ist nicht verbunden. …“. Beim Drucken kommt „Der Print Agent „…“ ist nicht verbunden. …“.

Schritte

  1. Ist der Rechner an? Ein Mac im Ruhezustand ist offline. Einen Mac, über den andere drucken, nicht schlafen lassen.

  2. Läuft der Print Agent?

    • Windows: Druckersymbol im Infobereich, sonst „Prismamed Print Agent“ über das Startmenü starten. Nach einem Absturz im Druckertreiber startet er nicht von selbst neu.
    • Mac: Druckersymbol oben rechts in der Menüleiste, sonst „Prismamed Print Agent“ im Ordner „Programme“ öffnen.

  3. Das Menü öffnen (Windows: rechte Maustaste auf das Druckersymbol; Mac: Klick auf das Symbol) und die Zeile zum Server lesen:

    Menüzeile Was tun
    „✔ … – verbunden seit …“ Verbunden. Zeigt TCMSOFT ihn trotzdem als offline, die Seite neu laden.
    „✖ … – getrennt: …“ Den Grund lesen. Steht dort „SSL“ oder „Zertifikat“, siehe Zertifikatsfehler.
    „⚠ … – vom Server abgelehnt, bitte neu koppeln“ Kopplung „…“ entfernen…, dann neu koppeln: Koppeln … mit einem Code aus Stammdaten › Drucker › Arbeitsplatz koppeln oder am selben Rechner Agent suchen.
    Mac: „TCMSOFT nicht erreichbar: Ist der Mac im Praxisnetz (nicht im Gäste-WLAN) …“ Netz prüfen; unter Systemeinstellungen › Datenschutz & Sicherheit › Lokales Netzwerk „Prismamed Print Agent“ einschalten.
    „Noch mit keinem TCMSOFT gekoppelt …“ (ältere Agents unter Windows: „Kein Server gekoppelt“) Per Code koppeln (Koppeln …) oder am selben Rechner Agent suchen.

  4. Haben sich Adresse oder Port von TCMSOFT geändert (Umzug, neuer Port, HTTPS eingerichtet), ist der Agent noch mit der alten Adresse gekoppelt: mit einem neuen Code und der neuen Adresse neu koppeln (Koppeln … ersetzt die alte Kopplung) oder Kopplung „…“ entfernen… (der Eintrag erscheint nur, solange dieser Server nicht verbunden ist) und Agent suchen.

  5. Je PC läuft nur ein Print Agent. Läuft er unter einem anderen Windows-Konto, wird über ihn gedruckt. Meldet sich dieses Konto ab, den Print Agent im aktuellen Konto über das Startmenü starten.

  6. Der Print Agent des Servers koppelt sich von selbst neu, sobald er läuft. Ist er offline, docker logs tcmsoft nach „Warnung: Port 9632 ist auf diesem Gerät schon belegt …“ durchsuchen.

  7. Das Protokoll lesen: Menü › Protokoll öffnen.

Erfolg: Im Menü steht „✔ … – verbunden seit …“, in TCMSOFT „Online“.

Wenn nicht: Das Protokoll des Tages und den Wortlaut der Menüzeile an den TCMSOFT-Support geben.

Agent suchen findet nichts

Wozu: Bei Agent suchen koppelt der Browser den Print Agent desselben Arbeitsplatzes. Stammdaten › Drucker › Agent suchen fragt dafür den Print Agent auf demselben Rechner unter http://127.0.0.1:9632 ab.

Schneller ist meist die Kopplung per Code: Stammdaten › Drucker › Arbeitsplatz koppeln, am Arbeitsplatz im Menü des Agenten Koppeln …. Sie braucht weder HTTPS noch die Freigabe im Browser (siehe Print Agent). Die folgenden Schritte gelten, wenn es trotzdem Agent suchen sein soll.

Anzeichen: Nach Agent suchen kommt „Kein Print Agent gefunden“ oder „Kein Print Agent auf diesem Rechner“.

Schritte

  1. Sitzen Sie am richtigen Rechner? Gesucht wird immer der Print Agent des Rechners, an dem der Browser läuft – nicht ein Agent an einem anderen Platz.

  2. Läuft der Print Agent (Druckersymbol im Infobereich bzw. in der Menüleiste)? Wenn nicht, starten. Meldet er beim Start „… kann nicht starten, weil Anschluss 9632 … schon belegt …“, läuft er meist schon unter einem anderen Benutzerkonto.

  3. Steht in der Adresszeile https://? Chrome und Edge erlauben die Suche nur über HTTPS. Ausnahme: Auf dem Rechner, auf dem TCMSOFT selbst läuft, genügt http://localhost. Ohne HTTPS zuerst HTTPS einrichten, siehe Netzwerk und HTTPS.

  4. Zeigt der Browser eine Zertifikatswarnung? Dann zuerst Zertifikatsfehler beheben.

  5. Hat der Browser nach dem Zugriff auf Geräte im lokalen Netzwerk gefragt, „Zulassen“ wählen. Nachträglich: Symbol links neben der Adresse › Website-Einstellungen.

  6. Chrome oder Edge verwenden. „Agent suchen“ in Safari ist nicht geprüft.

  7. Prüfen, ob der Agent antwortet: am selben Rechner im Browser diese Adresse aufrufen.

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

    Eine kurze JSON-Antwort mit agentId zeigt, dass der Agent läuft und erreichbar ist. Dieser Prüfweg ist aus dem Code abgeleitet und nicht getestet.

  8. Erneut Agent suchen und die Meldung auswerten:

    Meldung Was tun
    „Print Agent verbunden“ fertig
    „Print Agent gekoppelt – noch nicht verbunden“ bis zu einer Minute warten; am Mac die Frage nach dem lokalen Netzwerk mit „Erlauben“ beantworten
    „Print Agent nicht verbunden“ die alte Kopplung am Agenten entfernen (Kopplung „…“ entfernen…), erneut suchen
    „Print Agent nicht gekoppelt“ mit „Dieser Print Agent ist bereits mit dem TCMSOFT unter „…“ gekoppelt. …“ die alte Kopplung am Agenten entfernen, sobald der alte Server nicht mehr verbunden ist; erneut suchen

Besondere Rechner

Erfolg: „Print Agent verbunden“; der Agent steht mit „Online“ und seinen Druckern in der Liste.

Wenn nicht: Den Wortlaut der Meldung, die Adresse aus der Adresszeile und das Protokoll des Print Agent an den TCMSOFT-Support geben.

Drucker druckt nicht oder Blatt bleibt leer

Klären Sie zuerst, über welchen Print Agent gedruckt wird: über den eines Arbeitsplatzes (Windows, Mac) oder über den des Servers (im TCMSOFT-Container, druckt über CUPS auf Netzwerkdrucker). Sind mehrere Print Agents registriert, wählen Sie unter Stammdaten › Drucker in der Karte Agent im Feld Agent aus, welchen Agenten Sie ansehen.

Druck über einen Arbeitsplatz

  1. Im Reiter Druck-Warteschlange Status und Meldung des Auftrags lesen. Die Bedeutung steht unter Meldungen und ihre Bedeutung, Abschnitt „Druckaufträge“.

  2. Ist der Agent „Online“? Wenn nicht, siehe Agent offline.

  3. Drucker werden im System des Rechners eingerichtet, nicht in TCMSOFT:

    • Windows: Einstellungen › Bluetooth und Geräte › Drucker und Scanner,
    • Mac: Systemeinstellungen › Drucker & Scanner.

    Neue oder entfernte Drucker erscheinen in TCMSOFT nach spätestens 5 Minuten. Der Reiter Drucker zeigt den Zustand,

      1. „Papier fehlt“, „Offline“ oder „Angehalten“.

  4. „Am Rechner „…“ wartet noch ein früherer Auftrag … auf eine Eingabe …“: Am Agent-Rechner das offene Fenster des Druckertreibers beantworten. Ist keins offen, den Print Agent beenden und neu starten.

  5. Das Protokoll des Print Agent lesen (Menü › Protokoll öffnen).

Druck über den Server

  1. Im Reiter Druck-Warteschlange Status und Meldung lesen.

  2. Auf dem Server die Warteschlangen, die gefundenen Drucker und die Bonjour-Meldungen ansehen:

    docker exec tcmsoft lpstat -v
docker exec tcmsoft lpinfo -v
docker exec tcmsoft avahi-browse -rt _ipp._tcp

    Welcher Treiber gewählt wurde, steht in docker logs tcmsoft in den Zeilen „Printer … added with …“.

  3. Auftrag „erfolgreich“, aber das Blatt bleibt leer: Der Drucker versteht die gesendeten Daten nicht.

    1. Im Reiter Drucker den Drucker mit dem Papierkorb (Drucker löschen) entfernen.

    2. Mit Drucker hinzufügen neu anlegen. Der Print Agent wählt den Treiber dabei neu.

    3. Hilft das nicht: im Fenster Drucker hinzufügen den Reiter Manuell wählen, Druckername und Geräte-URI angeben und im Feld Treiber den allgemeinen PCL-Treiber eintragen:

      drv:///sample.drv/generpcl.ppd

  4. „Erkannte Drucker“ findet den Drucker nicht: Ist der Drucker eingeschaltet, im selben Netz wie der Server, und ist Bonjour/AirPrint am Drucker aktiv? Die Suche dauert bis zu 30 Sekunden. Sonst im Reiter Manuell die Geräte-URI eintragen, z. B. ipp://192.168.1.50/ipp/print oder socket://192.168.1.50:9100.

  5. Eigener Treiber des Herstellers: die .ppd-Datei oder die .deb-Pakete nach <Datenordner>/treiber/ legen, dann docker restart tcmsoft und den Drucker neu hinzufügen. Danach in docker logs tcmsoft die Zeilen zu den Treiberpaketen lesen (siehe Im Protokoll von TCMSOFT). .deb-Pakete müssen liegen bleiben, solange ein Drucker sie nutzt.

  6. Drucker war aus: Aufträge an einen ausgeschalteten Drucker wiederholt das Drucksystem einen Tag lang alle 5 Minuten.

  7. Steht in docker logs tcmsoft „Warnung: Port 9632 ist auf diesem Gerät schon belegt …“, druckt der Server gar nicht. Den alten Dienst beenden (Mikroserver: systemctl disable --now printagent), dann docker restart tcmsoft.

Erfolg: Der Auftrag steht auf „An Drucker übergeben“, und das Blatt ist bedruckt.

Wenn nicht: Den Drucker über einen Arbeitsplatz anbinden: dort in Windows bzw. macOS mit dem Treiber des Herstellers einrichten, Print Agent per Code koppeln, Drucklayouts mit festem Drucker umstellen und gegebenenfalls Drucker am Server ausschalten (siehe Print Agent). Für die Fehlersuche am Server die Ausgabe von docker exec tcmsoft lpstat -v, die Zeilen „Printer … added with …“ und das Druckermodell an den TCMSOFT-Support geben.

Zertifikatsfehler

Wozu: TCMSOFT selbst spricht nur HTTP; HTTPS macht der Reverse-Proxy der NAS bzw. Caddy. Agent suchen geht nur über HTTPS, ein mit einer https://-Adresse gekoppelter Print Agent verbindet sich nur mit gültigem Zertifikat, und Passkeys brauchen HTTPS. Das Zertifikat muss für genau die Adresse gelten, unter der die Arbeitsplätze TCMSOFT öffnen, und Windows bzw. macOS müssen ihm vertrauen.

Anzeichen

Schritte

  1. Am betroffenen Arbeitsplatz in Chrome oder Edge genau die Adresse öffnen, die dort für TCMSOFT verwendet wird. Gilt das Zertifikat für einen anderen Namen (z. B. Name statt IP-Adresse), die Adresse wechseln oder das Zertifikat passend ausstellen.
  2. Das Zertifikat vertrauenswürdig machen – einer der Wege:
    • ein Zertifikat einer anerkannten Stelle verwenden, 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.
  3. Prüfen, ob der Reverse-Proxy eingerichtet ist (Synology: Systemsteuerung › Anmeldeportal › Erweitert › Reverse Proxy) und dem Namen ein Zertifikat zugeordnet ist, siehe Netzwerk und HTTPS. Das Erneuern des Zertifikats ist Sache des Proxys; in TCMSOFT gibt es dazu nichts.
  4. Erst wenn HTTPS läuft: in tcmsoft.env Server__SichereCookies=true aktivieren und den Container neu anlegen lassen (docker rm -f tcmsoft).
  5. Hat sich die Adresse geändert, an jedem Arbeitsplatz den Print Agent mit einem neuen Code und der neuen Adresse neu koppeln (Koppeln …) oder die alte Kopplung entfernen und erneut Agent suchen. Beim Prismamed Agent Kopplung aufheben und mit einem neuen Kopplungscode und der neuen Adresse neu koppeln.

Erfolg: Keine Warnung im Browser; im Menü des Print Agent „✔ … – verbunden seit …“; der Prismamed Agent meldet „Verbunden mit …“.

Wenn nicht: Den Fehlertext aus dem Menü des Agenten bzw. aus seinem Protokoll an den TCMSOFT-Support geben.

Passwort vergessen oder 2FA verloren

Hier steht nur, was in TCMSOFT belegt ist. Mehr zu Konten und Rollen unter Benutzer, Anmeldung und Zugang.

  1. Anmeldenamen prüfen. Angemeldet wird im Feld E-Mail. Konten aus dem bisherigen TCMSOFT melden sich dort mit ihrem bisherigen Kürzel (Ärzte) bzw. Benutzernamen (Mitarbeiter) an.
  2. Sperre nach Fehlversuchen. Ab 3 Fehlversuchen sperrt TCMSOFT die Anmeldung, zuerst für 15 Sekunden. Die Sperre verdoppelt sich mit jedem weiteren Fehlversuch, höchstens auf 30 Minuten. Nach Code-Lage zählt TCMSOFT die Fehlversuche zusätzlich am Konto, und dieser Zähler beginnt erst nach einer gelungenen Anmeldung neu – nach einer Pause kann der nächste Fehlversuch also gleich wieder sperren (nicht im laufenden System geprüft). Während der Sperre scheitert auch das richtige Passwort. Falsches Passwort, Sperre und ein Konto, bei dem Anmeldung erlaubt aus ist, melden alle gleich: „Anmeldung fehlgeschlagen. Bitte prüfe deine Eingaben.“ – also auch diesen Schalter prüfen und die Sperre (höchstens 30 Minuten) abwarten.
  3. Passwort vergessen auf der Anmeldeseite. Die Seite meldet immer „E-Mail versendet“. Nach Code-Lage ist der Versand in TCMSOFT nicht eingerichtet; die E-Mail kommt also vermutlich nicht an (nicht im laufenden System geprüft). Verlassen Sie sich nicht darauf, sondern gehen Sie wie in Schritt 4 vor.
  4. Passwort von einer berechtigten Person setzen lassen. Berechtigt sind die Rolle „Arzt“ und Rollen mit dem Recht Mitarbeiterkonten und Rollen verwalten. Das neue Passwort braucht mindestens 8 Zeichen.
    • Mitarbeiter (ab TCMSOFTpro): Stammdaten › MFA-Benutzer, Benutzer öffnen, Karte Passwort zurücksetzen: Neues Passwort und Wiederholen ausfüllen, Passwort setzen. Beim eigenen Konto fehlt diese Karte.
    • Arzt: Stammdaten › Leistungserbringer, Arzt öffnen, Karte Login: Neues Passwort und Wiederholen ausfüllen, dann Speichern.
  5. Niemand Berechtigtes kann sich anmelden (z. B. der einzige Arzt einer Einzelpraxis): Der TCMSOFT-Support kann sich mit dem Support-Konto anmelden und das Passwort beim Leistungserbringer neu setzen. Das geht nur, solange die Praxis den Supportzugriff unter Stammdaten › Betriebsstätte, Karte Support, freigegeben hat. Die Zugangsdaten des Support-Kontos erfragen Sie beim TCMSOFT-Support. Ist der Supportzugriff gesperrt und kann sich niemand anmelden, gibt es in der Oberfläche keinen Weg, auch nicht mit Datenverlust: Datenbank neu initialisieren im Servermanagement braucht ebenfalls das Support-Konto. Eine freigegebene Anleitung für einen anderen Weg gibt es nicht. Wenden Sie sich an den TCMSOFT-Support.
  6. Zwei-Faktor-Gerät verloren. Bei der Anmeldung statt des Codes einen Recovery-Code in das Feld 2FA-Code eintragen. Nach 5 Fehlversuchen binnen 5 Minuten ist die Eingabe 15 Minuten gesperrt. Ohne Recovery-Codes gibt es in der Oberfläche von TCMSOFT keine Funktion, mit der jemand die Zwei-Faktor-Anmeldung zurücksetzt, auch nicht für eine andere Person; eine freigegebene Anleitung dafür gibt es nicht. Wenden Sie sich an den TCMSOFT-Support.

Erfolg: Der Benutzer meldet sich mit dem neuen Passwort an.

Danach: War der Supportzugriff für den Einsatz freigegeben, die Praxis bitten, ihn wieder zu sperren (Stammdaten › Betriebsstätte, Karte Support, Supportzugriff sperren).

Erstellt mit PrismaDocs | Autoren: Prismamed