TCMSOFT – Inhalt

Meldungen und ihre Bedeutung

Diese Seite erklärt die Meldungen, die TCMSOFT, der Update-Dienst und die Agenten zeigen: was sie bedeuten und was Sie dann tun. Die Meldungen sind nach dem Ort geordnet, an dem sie erscheinen. Suchen Sie am besten mit der Suchfunktion des Browsers nach einem Wort aus der Meldung.

So lesen Sie die Tabellen:

In der Glocke

Die Glocke steht unten links in TCMSOFT. Ihre Nachrichten gelten für alle Benutzer.

Vom Update-Dienst

TCMSOFT liest die Ergebnisse des Update-Dienstes alle 30 Sekunden aus <Datenordner>/updater/status.json und zeigt jedes genau einmal in der Glocke. Der Titel ist die fett gedruckte Zeile der Nachricht.

Titel Art Bedeutung Was tun
„TCMSOFT … eingerichtet“ mit „TCMSOFT ist eingerichtet und aktualisiert sich ab jetzt jede Nacht selbst.“ Erfolg Die Erstinstallation ist fertig. Mit der Ersteinrichtung der Praxis weitermachen.
„TCMSOFT … neu angelegt“ mit „Der TCMSOFT-Container wurde mit Version … neu angelegt (z. B. nach geänderten Einstellungen). …“ Erfolg Nach docker rm -f tcmsoft hat der Dienst den Container mit derselben Version wieder angelegt. Nichts.
„TCMSOFT … neu geladen“ mit „Auf dem Server lag kein passendes TCMSOFT-Programm mehr. Der Update-Dienst hat Version … neu geladen und ohne die sonst übliche Sicherung der Datenbank gestartet. …“ Warnung Der Container fehlte, und das Image der zuletzt gelaufenen Version war nicht mehr da (z. B. von Hand gelöscht). Der Dienst hat die aktuelle Version vom Download-Server geladen, ohne vorher die Datenbank zu sichern. Prüfen, ob TCMSOFT wie gewohnt läuft. Bei Auffälligkeiten sofort den TCMSOFT-Support informieren.
„TCMSOFT startet nicht“ mit „… Bitte den TCMSOFT-Support informieren.“ Fehler Bei der Erstinstallation kam TCMSOFT nicht hoch. Davor steht der Grund: „Die neue Version bricht beim Start wiederholt ab.“ oder „Die neue Version war nach 30 Minuten nicht betriebsbereit.“ docker logs tcmsoft lesen (siehe Im Protokoll von TCMSOFT). Das Startskript meldet dort z. B. einen Prozessor ohne AVX, einen belegten Port oder einen nicht beschreibbaren Datenordner.
„TCMSOFT startet nicht“ mit „Version … wurde ohne Sicherung der Datenbank neu geladen und startet nicht. Bitte nichts weiter versuchen (den Container nicht erneut entfernen) …“ Fehler Die ohne Sicherung geladene Version startet nicht. Nichts entfernen, nichts weiter versuchen. Sofort den TCMSOFT-Support informieren.
„TCMSOFT startet nicht“ mit „TCMSOFT … wurde neu angelegt, startet aber nicht. Meist liegt es an der letzten Änderung in tcmsoft.env im Datenordner …“ Fehler Nach docker rm -f tcmsoft startet der neu angelegte Container nicht, meist wegen einer falschen Zeile in tcmsoft.env (z. B. belegter Port). docker logs tcmsoft lesen, tcmsoft.env korrigieren, danach erneut docker rm -f tcmsoft.
„Update auf Version …“ mit „TCMSOFT wurde auf Version … aktualisiert. Neu: …“ Erfolg Das Update ist eingespielt. Nichts.
„Update auf Version … verschoben“ mit „Für die Sicherung der Datenbank vor dem Update fehlt Speicherplatz (Datenbank … GB, frei … GB). …“ Warnung Vor dem Update ist zu wenig Platz für die Sicherung der Datenbank. Die Meldung kommt einmal je Version; der Dienst versucht es jede Nacht neu. Siehe Typische Supportfälle.
„Update auf Version … fehlgeschlagen“ mit „… TCMSOFT läuft weiter mit Version …, die Datenbank ist auf dem Stand vor dem Update. Diese Version wird nicht erneut eingespielt …“ Fehler Die neue Version lief nicht an. Der Dienst hat die alte Version mit dem alten Datenstand zurückgeholt und die neue gesperrt. Vorn steht der Grund, z. B. „Die neue Version bricht beim Start wiederholt ab.“ Die Datei <Datenordner>/updater/protokoll/tcmsoft-<Version>.log an den TCMSOFT-Support geben. Siehe Typische Supportfälle.
„Update auf Version … unterbrochen“ mit „… TCMSOFT läuft weiter mit Version …; das Update wird in der nächsten Nacht erneut versucht.“ Warnung Das Update brach ab, bevor die neue Version lief. Vorn steht der Grund, z. B. „Das Update wurde unterbrochen (Server oder Update-Dienst neu gestartet).“ oder „Die Datenbank konnte vor dem Update nicht gesichert werden: …“. Nichts. Wiederholt es sich, docker logs tcmsoft-updater lesen.
„TCMSOFT läuft nach einem Update nicht“ mit „Nach dem gescheiterten Update auf … ist auch Version … nicht betriebsbereit. …“ Fehler Nach dem Rückfall kommt auch die alte Version nicht hoch (Frist 10 Minuten). Sofort den TCMSOFT-Support informieren. Vorher docker ps -a, docker logs tcmsoft und docker logs tcmsoft-updater sichern.
„TCMSOFT nach einem Update nicht wiederhergestellt“ mit „Beim Zurückkehren zu Version … ist ein Fehler aufgetreten (…). …“ Fehler Der Rückfall selbst ist gescheitert. Der Dienst beendet sich, Docker startet ihn nach 30 Sekunden neu, und er setzt den Rückfall fort. Sofort den TCMSOFT-Support informieren. Nichts von Hand entfernen, updater/vorgang.json nicht löschen.
„Update nicht installiert“ mit „… TCMSOFT läuft unverändert weiter.“ Fehler Das angebotene Paket wurde abgelehnt und wird nie eingespielt. Die Gründe stehen unten. Jeder Grund wird einmal gemeldet. Die Praxis muss nichts tun. Den TCMSOFT-Support mit dem Wortlaut informieren.
„Update-Dienst nicht aktualisiert“ mit „Der Update-Dienst konnte nicht auf Version … wechseln (…) und arbeitet mit Version … weiter. …“ Warnung Der neue Update-Dienst hat nicht binnen 3 Minuten übernommen. Der alte arbeitet weiter, die neue Version wird nicht erneut versucht. Die Datei <Datenordner>/updater/protokoll/updater-<Version>.log an den TCMSOFT-Support geben.

Gründe für „Update nicht installiert“ (Wortlaut, gekürzt):

Vom automatischen Backup

Titel Art Bedeutung Was tun
„SFTP Backup erfolgreich“, „S3 Backup erfolgreich“ Erfolg Die tägliche Sicherung ist am Ziel angekommen. Nichts.
„SFTP Backup war nicht erfolgreich.“, „S3 Backup war nicht erfolgreich.“ mit „… Bitte die SFTP-Einstellungen unter Backup prüfen.“ bzw. „… Bitte die S3-Einstellungen unter Backup prüfen.“ Fehler Das Hochladen zu diesem Ziel ist gescheitert. Der Grund steht im Text. Der nächste Versuch folgt am nächsten Tag. Ziel und Zugangsdaten unter Stammdaten › Backup prüfen; siehe Datensicherung und Umzug.
„Das Backup konnte nicht erstellt werden.“ mit „… Bitte die Einstellungen unter Backup prüfen.“ Fehler Schon das Erstellen der Sicherung ist gescheitert. TCMSOFT legt sie zuerst im Ordner tmp/ des Datenordners an; dort muss Platz für eine Sicherungsdatei sein. Speicherplatz prüfen (df -h <Datenordner>), den Grund im Text lesen.

Von den Online-Terminen

Die Meldung „Online-Termin prüfen: um Uhr“ mit dem Text „Das Terminportal kennt diesen Termin nicht. …“ kommt vom Abgleich mit dem bisherigen Portal. Der Termin bleibt im Kalender. Prüfen Sie mit der Praxis, ob er noch gilt, und löschen Sie ihn sonst von Hand.

Titel Bedeutung Was tun
„Fehler im Online-Termin Worker.“, „Fehler beim Verarbeiten der Online-Termin Servernachrichten.“ Meist ist das Online-Terminportal nicht erreichbar, oder Domainname bzw. API-Schlüssel stimmen nicht. Der Dienst versucht es etwa alle 2 Sekunden; dieselbe Meldung kommt höchstens einmal je Stunde in die Glocke, das Programmprotokoll zeigt jeden Versuch. Stammdaten › Betriebsstätte, Karte Terminportal, Schalter Aktiv aus. Domainname und API Key klären, danach wieder einschalten.
„Abgleich mit Billsphere fehlgeschlagen“ mit dem Grund, z. B. „Billsphere ist unter … nicht erreichbar …“ oder „Billsphere lehnt den API-Schlüssel ab …“ Der Abgleich der Patienten mit Billsphere (alle 15 Minuten, nachts vollständig) ist gescheitert. Dieselbe Meldung kommt höchstens einmal je Stunde in die Glocke; der nächste Versuch übernimmt, was fehlt. Stammdaten › Betriebsstätte, Karte Billsphere: Adresse und API-Schlüssel prüfen, Verbindung testen. Ist Billsphere erreichbar, aber der Schlüssel falsch: in Billsphere unter Firma › Praxissoftware-Abgleich neu erzeugen.
„Betriebsstätte nicht abrufbar.“ Der Dienst findet in der Datenbank keine Betriebsstätte. Auch diese Meldung wiederholt sich höchstens einmal je Stunde. docker logs tcmsoft lesen und den TCMSOFT-Support informieren.

Umstellungen in der Abrechnung (ab TCMSOFT 2026.10.8.1)

Ab TCMSOFT 2026.10.8.1 steigert TCMSOFT nur noch Gebühren (Ziffern vom Typ „Standard“), und ein Freitext ist eine Textzeile ohne Betrag. Bei jedem Start und am Ende jeder Datenübernahme prüft TCMSOFT die Abrechnungsdaten auf diese beiden Regeln. Umgestellt werden nur offene Abrechnungsfälle und Rechnungen, die noch nicht gedruckt, nicht an eine Abrechnungsstelle übergeben und ohne erfasste Zahlung sind. Im Reiter Protokoll solcher Rechnungen steht dann „Umstellung Faktor: …“ bzw. „Umstellung Freitext: …“. Gestellte Rechnungen ändert TCMSOFT nie. Die Bedienung für die Praxis beschreibt das Benutzerhandbuch unter „Abrechnung › Leistungen und Diagnosen erfassen“.

Titel Art Bedeutung Was tun
„Auslagen werden jetzt ohne Steigerungsfaktor berechnet“ Information Auslagen, Wegegeld, Reisekosten, Fixbeträge und Produkte in offenen Abrechnungsfällen und noch nicht gestellten Rechnungen wurden ohne Faktor neu berechnet. Der Text nennt die Anzahl. Die Nachricht kommt nur, wenn etwas umgestellt wurde. Nichts.
„Rechnung …: Auslagen mit Faktor berechnet“ Warnung Eine gestellte oder schon bezahlte Rechnung enthält Auslagen, Wegegeld o. Ä. mit Steigerungsfaktor und ist dadurch zu hoch. Der Text nennt den richtigen Betrag und je nach Lage Zahlungen, PADx-Auftrag, Anwalt oder Mahnungen. Die Nachricht kommt einmal je Rechnung, auch für Rechnungen aus der Datenübernahme. Im Reiter Protokoll der Rechnung steht „Hinweis an die Praxis: …“; Öffnen führt zur Rechnung. Die Praxis entscheidet. Korrigiert wird über Storno mit Korrekturrechnung, die ohne Faktor rechnet (Benutzerhandbuch › Abrechnung › Storno, Korrektur, Ausfall). Ist die Rechnung noch nicht gedruckt, aber schon bezahlt: die betroffenen Positionen doppelklicken, mit Ok bestätigen, danach die erfasste Zahlung prüfen.
„Freitexte erscheinen jetzt ohne Betrag“ Information Freitext-Zeilen mit Betrag in offenen Abrechnungsfällen und noch nicht gestellten Rechnungen heißen jetzt „Sonstiges Honorar“; der Betrag bleibt. Nichts. Soll eine Zeile nur Text sein: löschen und den Freitext neu hinzufügen.
„Freitext-Ziffern mit Betrag prüfen“ Warnung Unter Stammdaten › Ziffern haben Freitext-Ziffern einen Betrag (früher ein Pflichtfeld). Neu gebucht ergeben sie eine Textzeile ohne Betrag. Der Text nennt bis zu 15 Ziffern; Öffnen führt zu den Ziffern. Mit der Praxis klären: Soll der Betrag berechnet werden, den Typ auf „Sonstiges Honorar“ oder „Fixbetrag“ stellen, sonst die Ziffer einmal öffnen und speichern (das leert den Betrag). Nach Alle löschen in der Glocke kommt die Nachricht beim nächsten Start wieder, solange eine Freitext-Ziffer einen Betrag hat.

Rechnungsnummern und gleichzeitiges Arbeiten (ab TCMSOFT 2026.10.9.1)

Rechnungs- und Stornonummern werden nie doppelt vergeben. Jede vergebene Nummer steht in der Sammlung VergebeneRechnungsnummer (die Nummer ist dort der Schlüssel); beim Start trägt TCMSOFT dort die Nummern vorhandener Rechnungen ein, etwa nach einer Datenübernahme. Ist eine Nummer schon vergeben, nimmt TCMSOFT die nächste freie - dabei entstehen Lücken. Kalender und Wartezimmer aktualisieren sich an allen Arbeitsplätzen von selbst; wer einen veralteten Stand speichern will, bekommt eine Meldung, statt die Änderung eines anderen Arbeitsplatzes zu überschreiben. Diese Meldungen erscheinen im Programm, nicht in der Glocke; die Protokolleinträge stehen in docker logs tcmsoft.

Meldung Wo Bedeutung Was tun
„Für die Rechnungsvorlage „…“ lässt sich keine Rechnungsnummer bilden: Im Format fehlt der Zähler …“ Programm Das Format der Rechnungsvorlage enthält keinen Zähler (oder ihn nicht in geschweiften Klammern) - jede Rechnung bekäme dieselbe Nummer. Unter Stammdaten › Rechnungsvorlagen das Format korrigieren, z. B. {[Jahr] + PadLeft([Zaehler], 5, '0')}. Beim Speichern prüft TCMSOFT das Format.
„… ergab der Zähler 1000-mal hintereinander eine Rechnungsnummer, die schon vergeben ist …“ Programm Sehr viele passende Nummern sind schon belegt (z. B. Zähler beginnt jedes Jahr neu, ohne Jahr im Format). Der Zähler steht danach hinter diesen Nummern. Rechnung erneut speichern. Bleibt es dabei: Format und Zählerstand bei Jahreswechsel der Vorlage prüfen.
„… Rechnungsnummern kommen in den vorhandenen Rechnungen mehrfach vor …“ Protokoll (Warnung, beim Start) Altdaten (meist aus der Datenübernahme: das Altsystem hatte getrennte Nummernkreise) enthalten doppelte Nummern. Ändern lässt sich das nicht. Nichts - neue Nummern überspringen sie.
„Rechnungsvorlage …: n schon vergebene Rechnungsnummer(n) übersprungen …“ Protokoll (Warnung) Erklärt eine Lücke in der Nummernfolge, z. B. weil zwei Vorlagen dasselbe Format haben. Nichts.
„Der eindeutige Index für die Zählerstände der Rechnungsvorlagen konnte nicht angelegt werden.“ Protokoll (Warnung, beim Start) Es gibt zwei Zählerstände für dieselbe Vorlage und dasselbe Jahr. Doppelte Nummern verhindert das Register trotzdem. TCMSOFT-Support informieren.
„Der Termin wurde inzwischen an einem anderen Arbeitsplatz geändert …“ bzw. „… gelöscht …“, „Der Patient wurde inzwischen an einem anderen Arbeitsplatz verschoben, abgeschlossen oder bearbeitet …“ Programm Normal bei gleichzeitigem Arbeiten: ein anderer Arbeitsplatz war schneller. Nichts wurde überschrieben, die Ansicht zeigt danach den aktuellen Stand. Die Änderung dort erneut vornehmen, falls sie noch nötig ist. Kommt die Meldung ständig, obwohl niemand anderes arbeitet: TCMSOFT-Support informieren.

Auf der Backup-Seite

Unter Stammdaten › Backup zeigt die Karte Programmversion und Updates den Stand des Update-Dienstes. Sie erscheint nur im Docker-Betrieb.

Warnkarten

Meldung Bedeutung Was tun
„Der Update-Dienst meldet sich nicht (zuletzt …). Solange er nicht läuft, werden keine Updates eingespielt - bitte den TCMSOFT-Support informieren.“ Der Update-Dienst hat status.json seit mehr als 5 Minuten nicht geschrieben. Steht darunter zugleich ein laufender Schritt (z. B. „Version … wird heruntergeladen …“), arbeitet er nach Code-Lage noch – dann abwarten (nicht getestet). docker start tcmsoft-updater. Startet er nicht, zeigt docker logs tcmsoft-updater den Grund (siehe Im Protokoll des Update-Dienstes).
„Die Versionsprüfung bei downloads.tcmsoft.de ist fehlgeschlagen - bitte die Internetverbindung des Servers prüfen (…).“ Der Server erreicht den Download-Server nicht (Internet, DNS, Firewall). Internetverbindung des Servers prüfen, siehe Typische Supportfälle.
„Version … ist auf diesem Server fehlgeschlagen und wird nicht erneut eingespielt.“ Diese Version steht in updater/fehlgeschlagen-tcmsoft.txt. Erst mit dem TCMSOFT-Support klären, ob sie noch einmal versucht werden soll (siehe Typische Supportfälle).
„Das Update auf … wartet, bis die laufende Datenübernahme beendet ist.“ Eine Datenübernahme läuft; so lange spielt der Dienst nichts ein. Abwarten. Danach kommt das Update sofort, wenn es nachts ist oder Jetzt aktualisieren gewählt war, sonst in der nächsten Nacht.
„Für die Sicherung der Datenbank vor dem Update fehlt Speicherplatz (…). …“ wie die Glocken-Meldung „Update auf Version … verschoben“ Siehe Typische Supportfälle.
„Das Update auf … ist fehlgeschlagen: …“ Das Update scheiterte, bevor TCMSOFT angehalten wurde. TCMSOFT läuft unverändert, der nächste Versuch folgt in der nächsten Nacht. Den Grund dahinter lesen (siehe unten).
Einer der Gründe für „Update nicht installiert“ (siehe In der Glocke), z. B. „Das angebotene Update auf Version … ist nicht signiert und wird nicht installiert. …“ Das angebotene Paket wurde abgelehnt. Den TCMSOFT-Support mit dem Wortlaut informieren.
„TCMSOFT konnte nicht eingerichtet werden: …“ Der Container tcmsoft fehlt und konnte nicht angelegt werden. Neuer Versuch alle 10 Minuten. Da TCMSOFT dann nicht läuft, sehen Sie diese Meldung meist nur in status.json und in docker logs tcmsoft-updater. Den Grund dahinter lesen (siehe unten).

Gründe hinter „Das Update auf … ist fehlgeschlagen: …“:

Gründe hinter „TCMSOFT konnte nicht eingerichtet werden: …“:

Nach „Jetzt prüfen“ und „Jetzt aktualisieren“

Meldung Bedeutung Was tun
„Neue Version verfügbar“: „Version … liegt bereit - „Jetzt aktualisieren“ spielt sie ein, sonst geschieht das in der kommenden Nacht.“ Eine neuere Version ist bekannt. Jetzt aktualisieren oder bis zur Nacht warten.
„Versionsprüfung“: „TCMSOFT … ist aktuell.“ Es gibt keine neuere Version. Nichts.
„Versionsprüfung“: „Der Update-Dienst hat noch nicht geantwortet. Bitte die Seite in einer Minute neu laden.“ Der Dienst hat binnen einer Minute nicht geprüft. Seite neu laden. Erscheint dann „Der Update-Dienst meldet sich nicht …“, siehe oben.
keine Rückmeldung, aber eine Warnkarte Die Prüfung ist gescheitert; der Grund steht in der Warnkarte. Siehe Tabelle „Warnkarten“.
„Fehler bei der Versionsprüfung.“ (nach Jetzt aktualisieren: „Das Update konnte nicht angefordert werden.“) mit „Der Update-Dienst ist auf diesem Server nicht eingerichtet. Bitte den TCMSOFT-Support informieren.“ Der Ordner updater/ fehlt im Datenordner. Einrichtung des Update-Dienstes prüfen (TCMSOFT einrichten).
Rückfrage „Jetzt auf Version … aktualisieren?“ Vor dem sofortigen Update. TCMSOFT startet dabei für alle Anwender neu. Bestätigen, wenn alle gespeichert haben.
„Update angefordert“: „Der Update-Dienst spielt die neue Version gleich ein. TCMSOFT ist dabei einige Minuten nicht erreichbar und meldet das Ergebnis danach in den Nachrichten.“ Die Anforderung liegt beim Dienst. Warten; das Ergebnis kommt in die Glocke.

Im Protokoll des Update-Dienstes

Diese Meldungen stehen in docker logs tcmsoft-updater. Bei den ersten sechs Meldungen der Tabelle beendet sich der Dienst danach, und Docker startet ihn nach 30 Sekunden neu – bis der Fehler behoben ist. Bei den letzten beiden läuft er weiter und versucht es später erneut.

Meldung Bedeutung Was tun
„TCMSOFT_DATEN fehlt: beim Anlegen des Updaters den Datenordner angeben, z. B. -e TCMSOFT_DATEN=… -v …:…“ Beim docker run fehlt -e TCMSOFT_DATEN=…. Den Update-Dienst neu anlegen (siehe unten).
„TCMSOFT_DATEN muss ein vollständiger Pfad sein (beginnt mit /), nicht „…“.“ Der Pfad ist relativ angegeben. Neu anlegen mit vollständigem Pfad.
„Der Datenordner … ist im Updater nicht eingebunden - beim Anlegen „-v …:…“ angeben.“ -v <Datenordner>:<Datenordner> fehlt. Neu anlegen.
„Der Datenordner muss im Updater unter demselben Pfad eingebunden sein wie auf dem Server: -v …:…“ Links und rechts vom Doppelpunkt stehen verschiedene Pfade. Neu anlegen; der Pfad steht dreimal gleich im Befehl.
„Der Updater erreicht Docker nicht: … - ist beim Anlegen „-v /var/run/docker.sock:/var/run/docker.sock“ angegeben?“ Der Docker-Socket ist nicht eingebunden, oder er liegt nicht unter /var/run/docker.sock. Neu anlegen mit -v /var/run/docker.sock:/var/run/docker.sock.
„Der Update-Dienst findet seinen eigenen Container nicht - neuer Versuch nach dem Neustart.“ Ein Update-Dienst, den ein Selbst-Update angelegt hat, kann sich keinem Container zuordnen. Während eines Selbst-Updates abwarten: Der alte Dienst entfernt den neuen nach 3 Minuten, arbeitet weiter und meldet „Update-Dienst nicht aktualisiert“. Bleibt die Meldung danach stehen, den TCMSOFT-Support informieren.
„TCMSOFT konnte nicht eingerichtet werden: … - neuer Versuch in 10 Minuten.“ siehe Auf der Backup-Seite Den Grund lesen.
„Versionsprüfung fehlgeschlagen: …“ Der Download-Server war nicht erreichbar. Internetverbindung des Servers prüfen.

So legen Sie den Update-Dienst neu an:

docker rm -f tcmsoft-updater

Danach den docker run-Befehl aus TCMSOFT einrichten mit den richtigen Pfaden erneut ausführen. Der Container tcmsoft und die Daten bleiben dabei unberührt.

Im Protokoll von TCMSOFT

Diese Meldungen stehen in docker logs tcmsoft, die meisten in Zeilen mit [tcmsoft].

Start und Datenbank

Meldung Bedeutung Was tun
„Dieser Prozessor unterstützt kein AVX - MongoDB 8.3 läuft auf diesem Gerät nicht. …“ Das Gerät ist für TCMSOFT zu alt. Ein anderes Gerät ist nötig, siehe Voraussetzungen.
„Port … ist auf diesem Gerät schon belegt - vermutlich läuft dort eine andere MongoDB …“ Der Datenbank-Port (Standard 27017) ist auf dem Gerät belegt. Im Host-Netz teilt sich der Container die Ports mit dem Gerät. Die andere Datenbank beenden (Mikroserver: systemctl disable --now mongod) oder in tcmsoft.env Mongo__Port=27018 eintragen, dann docker rm -f tcmsoft.
„Port … ist auf diesem Gerät schon belegt, TCMSOFT kann dort nicht erreichbar sein. …“ Der Web-Port (Standard 8085) ist belegt. In tcmsoft.env einen freien Port eintragen, z. B. ASPNETCORE_URLS=http://+:8086, dann docker rm -f tcmsoft. Danach die Print Agents neu koppeln. Mikroserver: den alten Dienst beenden, systemctl disable --now tcmsoft.
„Der Datenordner /data ist nicht beschreibbar. …“ Der eingebundene Ordner ist schreibgeschützt oder per NFS/SMB mit root_squash eingebunden. Schreibrechte und Einbindung prüfen; ein lokaler Ordner ist nötig.
„MongoDB konnte nicht gestartet werden - bitte das Protokoll oben prüfen (Speicherplatz? Rechte auf …? Meldung 'Illegal instruction' = Prozessor ohne AVX).“ Die Datenbank startet nicht. Die Zeilen darüber lesen, Speicherplatz und Rechte auf mongodb/ prüfen.
„MongoDB antwortet nach 120 s nicht“ Die Datenbank startet, antwortet aber nicht. Wie oben.
„MongoDB cannot start: Linux kernel versions 6.19 and newer has a known incompatibility with this version of MongoDB“, dahinter „MongoDB konnte nicht gestartet werden - … Linux-Kernel …: Ab Kernel 6.19 startet MongoDB nur mit der Zeile GLIBC_TUNABLES=glibc.pthread.rseq=1 in tcmsoft.env …“ Der Linux-Kernel des Geräts ist für die MongoDB im Image zu neu (z. B. Ubuntu 26.04 mit Kernel 7.0). In tcmsoft.env die Zeile GLIBC_TUNABLES=glibc.pthread.rseq=1 einschalten bzw. eintragen, dann docker rm -f tcmsoft (siehe Datenordner und tcmsoft.env).
„Die Anmeldung an der Datenbank schlägt fehl: das Passwort in … passt nicht zum Konto in der Datenbank. …“ keys/mongo-passwort gehört nicht zu dieser Datenbank, z. B. weil keys/ aus einer anderen Installation stammt. keys/mongo-passwort aus der Sicherung des Datenordners zurückholen. Den Inhalt nie anzeigen oder weitergeben. Den TCMSOFT-Support informieren.
„MongoDB … läuft noch mit dem Datenformat … - es wird nach … Tagen ohne Rückfall angehoben.“ Nach einem Wechsel der MongoDB-Version bleibt das alte Datenformat 7 Tage, damit der Rückweg offen bleibt. Nichts.
„Datenformat der MongoDB von … auf … angehoben.“ Das Datenformat ist jetzt auf der neuen Version. Ein Rückweg zur vorigen MongoDB geht ab jetzt nur über eine Rücksicherung. Nichts.
„Warnung: Das Datenformat der MongoDB konnte nicht auf … angehoben werden - nächster Versuch morgen.“ Das Anheben ist gescheitert. Wiederholt es sich, den TCMSOFT-Support informieren.
„TCMSOFT startet noch (… s) - bei großen Datenbeständen dauert das Anpassen der Datenbank einige Minuten“ Normal nach Updates und beim ersten Start. Warten. Nach einem Update darf das bis zu 30 Minuten dauern.
„TCMSOFT wurde beendet (Code …) - Neustart in 10 s“ Die Anwendung ist beendet und wird neu gestartet. Wiederholt es sich, die Ausnahme darüber lesen.
„TCMSOFT bricht beim Start wiederholt ab (zuletzt Code … nach … s) - der Container endet; Docker startet ihn neu, ein Update nimmt der Updater zurück.“ Dreimal kurz hintereinander abgestürzt. Die Fehlermeldung weiter oben lesen. Während eines Updates rollt der Update-Dienst selbst zurück.
„MongoDB wurde beendet - der Container endet, damit Docker ihn neu startet“ Die Datenbank ist abgestürzt. Speicherplatz prüfen; wiederholt es sich, den TCMSOFT-Support informieren.
„Programmordner … fehlt - das Image ist beschädigt.“ Das Image ist unvollständig. Den TCMSOFT-Support informieren.
„Rechnungsvorlagen: Schalter „Kleinunternehmer (§ 19 UStG)“ eingerichtet - … Vorlage(n) jetzt …“ Beim ersten Start nach dem Update, das den Schalter „Kleinunternehmer“ bringt: Der frühere, unsichtbare Schalter „Steuerfrei“ der Rechnungsvorlagen heißt jetzt „Kleinunternehmer“. Vorhandene Vorlagen außer der Art MwSt. stehen danach auf „Kleinunternehmer“, wenn die Datenübernahme die Praxis als umsatzsteuerbefreit übernommen hat (Steuer-Vorlage „steuerfrei“ oder „MwstBefreit“ im Archiv der Betriebsstätte), sonst auf „aus“. Die Praxis bekommt dazu eine Warnung in der Glocke. Vorlagen, die danach angelegt, übernommen oder gespeichert werden, stellt TCMSOFT nicht mehr um – auch nicht nach einer Datenübernahme oder „Neu initialisieren“. Ältere Rechnungen zeigen den Ausweis beim Nachdruck nach dem neuen Schalter, ihre Beträge bleiben. Nichts. Ist die Praxis anders eingestuft: unter Stammdaten › Rechnungsvorlagen den Schalter je Vorlage umstellen und speichern.
„Rechnungsvorlage …: Der Schalter „Kleinunternehmer (§ 19 UStG)“ ließ sich nicht einrichten - der nächste Start versucht es erneut.“ (Warnung) Die Umstellung einer Vorlage ist gescheitert, z. B. wegen eines Datenbankfehlers. TCMSOFT startet trotzdem, meldet es der Praxis in der Glocke und versucht es beim nächsten Start erneut. Ursache weiter oben im Protokoll suchen, TCMSOFT neu starten. Bleibt die Meldung: mit der Praxis unter Stammdaten › Rechnungsvorlagen bei jeder Vorlage den Schalter Kleinunternehmer prüfen und speichern.
„Migration … is already running according to tracking data …“ (englisch) Ein beim Start abgebrochener Datenbank-Umbau sperrt TCMSOFT. Bekannter Fehler; die Sperre kann bis zu 6 Stunden halten. Die TCMSOFT-Entwicklung einschalten. Eine freigegebene Handanweisung gibt es noch nicht.

Produkt und Praxisart

Ob eine Installation TCMSOFT (Arztpraxis) oder Salvia Software (Heilpraktiker-Praxis) ist, entscheidet der Start anhand der Zeile Produkt in tcmsoft.env und des Produkts in der Datenbank. Diese Einträge stehen in den Zeilen der Anwendung, nicht in den [tcmsoft]-Zeilen, und zusätzlich im Reiter Logs des Servermanagements. Das Produkt steht darin als „Salvia“ oder „Tcmsoft“. In einer TCMSOFT-Installation ohne die Zeile Produkt kommen davon nur die beiden Einträge zum Wiederherstellen einer Sicherung und der Fehler beim Festlegen des Produkts vor. Hintergrund und Rückweg: Produkt und Praxisart.

Meldung Bedeutung Was tun
„Neue Installation als Salvia eingerichtet (Parameter Produkt in tcmsoft.env).“ Der erste Start einer frischen Installation hat Produkt=Salvia übernommen. Die Installation ist jetzt Salvia Software und bleibt es, auch ohne die Zeile. Kommt nur bei dem Start, der die Installation umstellt. Nichts. Die Anmeldeseite zeigt jetzt „Salvia Software“.
„Praxisart von Arzt auf Heilpraktiker gestellt von …: … Vorlagen, … Leistungserbringer, … Ziffernketten, … eigene Ziffern, … Dokumentationstypen, … Verträge angepasst.“ Die Heilpraktiker-Praxis von Salvia Software ist eingerichtet: Rechnungsvorlage „GebüH Rechnung“, Katalog „GebüH“, Typen „Bescheinigung“ und „Arzneimittelempfehlung“, Behandlungsvertrag. Kommt beim ersten Start (dort „von unbekannt“) und nach Datenbank neu initialisieren bzw. Demodaten installieren in Salvia Software. Nichts.
„Datenbank neu angelegt als Salvia Software (Heilpraktiker-Praxis).“ Nach Datenbank neu initialisieren bzw. Demodaten installieren im Servermanagement ist die neue Datenbank als Salvia Software eingerichtet: weil Produkt=Salvia in tcmsoft.env steht oder die Installation ohne die Zeile schon Salvia war. Davor stehen „Servermanagement: Datenbank neu initialisiert von …“ bzw. „Servermanagement: Demodaten installiert von …“. Nichts. Sollte die Installation TCMSOFT werden, siehe den Rückweg unter Produkt und Praxisart.
„Der Parameter Produkt=Salvia wird ignoriert: Diese Installation enthält schon Daten und bleibt TCMSOFT. Salvia Software lässt sich nur auf einer neuen Installation einrichten.“ (Warnung) In tcmsoft.env steht Produkt=Salvia, die Installation hat aber schon Patienten (auch gelöschte), Rechnungen oder Abrechnungsfälle mit Leistungen. Sie bleibt TCMSOFT. Der Eintrag kommt bei jedem Start, solange die Zeile steht. Gehört die Installation zu TCMSOFT: die Zeile aus tcmsoft.env entfernen und docker rm -f tcmsoft. Sonst würde ein späteres Datenbank neu initialisieren sie zu Salvia Software machen. Soll sie Salvia Software werden: „Zeile vergessen“ unter Produkt und Praxisart.
„Unbekannter Wert „…“ für Produkt (tcmsoft.env) - erlaubt sind Salvia und TCMSOFT. Er wird ignoriert.“ (Warnung) Tippfehler in der Zeile Produkt=. Groß- und Kleinschreibung spielen keine Rolle. TCMSOFT startet, als stünde die Zeile nicht da: mit dem Produkt aus der Datenbank, bei einer neuen Installation als TCMSOFT. Die Zeile auf Produkt=Salvia korrigieren (für TCMSOFT entfernen) und docker rm -f tcmsoft. Für Salvia Software nur, solange noch nichts erfasst ist, sonst „Zeile vergessen“ unter Produkt und Praxisart.
„Salvia Software ist keine Heilpraktiker-Praxis und enthält schon Daten - es wird nichts umgestellt. Bitte den Prismamed-Support prüfen lassen.“ (Warnung) Das Produkt ist Salvia Software, die Einrichtung der Heilpraktiker-Praxis ist aber nicht durchgelaufen, und inzwischen wurde etwas erfasst. Eine Praxis mit Daten stellt TCMSOFT nie um. Nach einem gescheiterten Demodaten installieren erscheint der Eintrag auch ohne eigene Daten der Praxis. Den Prismamed-Support einschalten. Nach gescheitertem Demodaten installieren: es im Servermanagement noch einmal ausführen.
„Das Produkt konnte beim Start nicht festgelegt werden - es gilt ….“ (Fehler, mit dem Grund darunter) Beim Festlegen des Produkts ist ein Fehler aufgetreten, z. B. weil die Betriebsstätte nicht gelesen werden konnte. TCMSOFT startet trotzdem, mit dem gespeicherten Produkt, sonst als TCMSOFT. docker restart tcmsoft. Eine unterbrochene Einrichtung holt der Start nach, solange die Installation frisch ist. Bleibt der Eintrag, docker logs tcmsoft an den Support geben.
„Backup wiederhergestellt: Produkt jetzt … (vorher …).“ (Warnung) Die wiederhergestellte Sicherung stammt aus dem anderen Produkt. Das Produkt kommt mit der Sicherung. Anmeldeseite und Mails folgen ihm sofort, geöffnete Fenster nach dem Neuladen. Wer die Sicherung wiederherstellt, sieht dazu die Meldung „Backup eines anderen Produkts“. War das gewollt (Umzug), alle geöffneten Fenster neu laden (F5). Sonst die richtige Sicherung wiederherstellen.
„Backup wiederhergestellt von …: Edition … beibehalten (Sicherung: …), Support-Konto zurückgesetzt.“ (Warnung) Nach jedem Backup wiederherstellen: wer es war, welche Edition weiter gilt und welche die Sicherung trug („gleich“, wenn sie übereinstimmt). Das Support-Konto hat wieder seinen festen Zugang. Nichts. Soll die Praxis eine andere Edition haben, im Servermanagement einstellen.
„Das Produkt des wiederhergestellten Backups ließ sich nicht lesen - es gilt nach dem nächsten Neustart.“ (Fehler) Die Wiederherstellung ist gelungen, nur Name und Logo wurden nicht umgestellt. docker restart tcmsoft, wenn niemand arbeitet.

Drucken

Meldung Bedeutung Was tun
„Die Druckersuche (Avahi) startet nicht - … Drucker lassen sich weiterhin mit ihrer Adresse einrichten.“, „D-Bus startet nicht - die Druckersuche steht nicht zur Verfügung. …“ Erkannte Drucker bleibt leer. Drucker mit ihrer Adresse anlegen (Reiter Manuell, z. B. ipp://192.168.1.50/ipp/print).
„Warnung: Port 9632 ist auf diesem Gerät schon belegt - läuft dort noch der PrintAgent einer früheren Installation? …“ Ein alter Print Agent belegt den Port; der Server druckt nicht. Den alten Dienst beenden (Mikroserver: systemctl disable --now printagent), dann docker restart tcmsoft.
„Warnung: Kein PrintAgent im Image - Drucken aus TCMSOFT steht nicht zur Verfügung“ Das Image ist unvollständig. Den TCMSOFT-Support informieren.
„Printer … added with …“ Welcher Treiber für einen Drucker gewählt wurde. Nur zur Information.
„Treiberpakete installiert: …“, „Eigene Druckertreiber eingebunden: …“, „Eigene Schriften eingebunden: …“ Eigene Dateien aus treiber/ bzw. schriften/ sind übernommen. Nichts.
„Treiberpaket … ist für einen anderen Prozessor gebaut und läuft auf diesem Gerät (…) nicht - übersprungen. …“ Falsche Prozessorfassung, z. B. ein i386-Paket auf einem ARM-Gerät. Beim Hersteller ein passendes Paket suchen oder eine PPD-Datei nach treiber/ legen.
„Treiberpaket … entfernt (liegt nicht mehr in treiber/). …“ Ein Paket wurde aus treiber/ gelöscht. Drucker damit drucken nicht mehr. Paket zurücklegen oder den Drucker entfernen und neu hinzufügen.
„Warnung: Der Drucker „…“ ist mit einem Treiber eingerichtet, der nicht installiert ist (…) - er druckt nicht, Aufträge bleiben hängen. …“ wie oben Pakete zurück nach treiber/ und docker restart tcmsoft, oder den Drucker neu hinzufügen.
„Warnung: Die Treiberdatei … braucht Programme, die nicht installiert sind (…) …“ Zur PPD fehlen Programmteile des Herstellers. Alle .deb-Pakete des Herstellers nach treiber/ legen und docker restart tcmsoft.
„Hinweis: treiber/ enthält Installationsprogramme (.sh, …), Archive oder .rpm-Pakete - diese werden nicht ausgeführt. …“ Diese Dateiarten werden nicht verwendet. .deb-Pakete des Herstellers verwenden, Archive entpacken.
„Warnung: Die Treiberpakete konnten nicht vollständig installiert werden - … Bitte diese Zeilen an den TCMSOFT-Support geben:“ Installation eigener Pakete gescheitert. Die folgenden Zeilen an den TCMSOFT-Support geben.
„Warnung: Die Treiberpakete haben Bestandteile von TCMSOFT entfernt oder ersetzt (…) …“ Ein Paket verträgt sich nicht mit TCMSOFT. Die zuletzt nach treiber/ gelegten Pakete löschen, den TCMSOFT-Support informieren.
„HoechsteAgentVersion '…' is not a version like 2026.10.201 - no update brake is sent to the print agents.“ (englisch) Der Wert von PrintAgent__HoechsteVersion in tcmsoft.env ist keine gültige Version. Die Notbremse wirkt nicht. Den Wert dreiteilig eintragen wie im Beispiel, siehe Updates der Agenten.

Beim Aufruf im Browser

Meldung Bedeutung Was tun
Seite „Schwerwiegender Fehler“: „Ein Applikationsfehler ist aufgetreten. Die Software ist nicht in der Lage zu starten. …“ Der Start der Sitzung ist gescheitert, z. B. weil die Betriebsstätte nicht gelesen werden konnte. http://<Server>:8085/health aufrufen und docker logs tcmsoft lesen.
„TCM-Bibliothek nicht verfügbar“: „Die Bibliothek konnte nicht geladen werden - meist fehlt die Internetverbindung des Servers. …“ Nur die TCM-Bibliothek fehlt; der Praxisbetrieb läuft. Internetverbindung des Servers zu data.tcmsoft.cloud prüfen.
Die Anmeldung „gelingt“, springt aber immer wieder zur Anmeldeseite zurück In tcmsoft.env steht Server__SichereCookies=true, TCMSOFT wird aber über http:// aufgerufen. HTTPS einrichten oder die Zeile wieder auskommentieren, dann docker rm -f tcmsoft.
Zertifikatswarnung des Browsers Der Arbeitsplatz vertraut dem HTTPS-Zertifikat nicht. Siehe Typische Supportfälle.

Unter Stammdaten › Agenten

Hier stehen die Prismamed Agents (Geräte, Labor, Scans). Die Seite gibt es ab TCMSOFTpro.

Status

Status Bedeutung
„Online“ Der Agent hat sich in den letzten 90 Sekunden gemeldet.
„Gestört“ Er meldet sich, aber seine letzte Meldung war ein Fehler. Der Text steht in der Spalte Letzte Meldung.
„Offline“ Länger als 90 Sekunden kein Kontakt.
„Noch nicht gekoppelt“ Der Agent ist angelegt, aber nicht gekoppelt.

„veraltet“ an der Version

„… · veraltet“ heißt: Der Agent hat eine ältere Version als die, die dieser TCMSOFT-Server erwartet. Ist die Notbremse Agent__HoechsteVersion gesetzt und niedriger als die mitgelieferte Version, gilt die Version der Notbremse als aktuell. Den Text sehen Sie, wenn Sie mit der Maus über die Version fahren oder die Zeile aufklappen.

Hinweis Bedeutung Was tun
„Aktuell ist …. Der Agent aktualisiert sich selbst - abends, beim nächsten Start oder per „Jetzt aktualisieren“ im Agenten.“ Normalfall; das Update kommt von selbst. Nichts. Bleibt es tagelang, siehe Updates der Agenten.
„Aktuell ist …. Dieser Agent aktualisiert sich nicht selbst. Bitte die aktuelle Fassung über „Agent herunterladen…“ (oben) laden, in den Ordner „Programme“ ziehen (den vorhandenen ersetzen) und dort starten …“ Mac-Agent ohne Selbst-Update. Wie beschrieben, im Benutzerkonto, mit dem am Mac gearbeitet wird.
„Aktuell ist …. Bei diesem Agenten ist das Selbst-Update abgeschaltet oder er wurde nicht mit dem Setup installiert. …“ Windows-Agent ohne Selbst-Update, z. B. Betrieb ohne Oberfläche mit PRISMAMED_SELBSTUPDATE=aus. Die neue Version von Hand mit dem Setup einspielen.
„Aktuell ist …. …“ mit einem Hinweis des Mac-Agenten Der Mac-Agent erklärt selbst, warum er sich nicht aktualisiert. Siehe die nächste Tabelle.

„Update-Hinweis“ an der Version

„… · Update-Hinweis“ heißt: Der Agent meldet etwas zu seinem Selbst-Update. Er arbeitet trotzdem normal weiter.

Hinweis Bedeutung Was tun
„Der Autostart des Agenten fehlt - nach der nächsten Anmeldung startet er nicht von selbst. Bitte am Arbeitsplatz das Setup erneut ausführen (…, im Windows-Konto, mit dem dort gearbeitet wird).“ Windows: die Autostart-Verknüpfung wurde gelöscht. Updates legen sie nicht wieder an, nur ein erneutes Setup. Setup im selben Windows-Konto erneut ausführen. Kopplung und Einstellungen bleiben.
„Hier kann sich der Prismamed Agent nicht selbst aktualisieren, weil dieses Benutzerkonto ihn nicht ändern darf. …“ Mac: Der Agent gehört einem anderen Benutzerkonto oder liegt schreibgeschützt. Geräte, Labor und Scans laufen weiter. Agent beenden, in diesem Konto erneut aus der DMG in „Programme“ ziehen (den vorhandenen ersetzen), dort starten. Ohne Administratorrechte in einen selbst angelegten Ordner „Applications“ im Benutzerordner.
„Dieser Prismamed Agent aktualisiert sich nicht selbst. Bitte die aktuelle Fassung für den Mac über Stammdaten › Agenten › „Agent herunterladen…“ laden, …“ Mac: Selbst-Update aus. Wie beschrieben.
„Der Autostart des Prismamed Agent konnte nicht eingerichtet werden - …“ Mac: Der Agent konnte seinen Eintrag für den Autostart nicht anlegen. Den Agenten einmal über den Ordner „Programme“ starten; hilft das nicht, das Protokoll an den Support senden.
ein Text aus der Tabelle „Update-Hinweise beider Agenten“ Das Selbst-Update hat ein Problem. Siehe unten.

Am Arbeitsplatz: Prismamed Agent

Die Statuszeile steht oben im Fenster des Agenten und als erste Zeile im Menü des Agenten.

Meldung Bedeutung Was tun
„Nicht gekoppelt“ Der Agent hat keine Kopplung. Unter Stammdaten › Agenten mit Neu einen Agenten anlegen oder beim vorhandenen mit dem Schlüsselsymbol (Kopplungscode erzeugen) einen Code holen. Server-Adresse und Code im Fenster des Agenten unter Mit TCMSOFT koppeln eintragen, Koppeln.
„Keine Verbindung: Keine Verbindung zum Server: …. Prüfen Sie Netzwerk und Server-Adresse.“ Netzwerk, falsche Server-Adresse oder ein HTTPS-Zertifikat, dem der Rechner nicht vertraut (dann steht der Fehler von .NET im Text). Siehe Typische Supportfälle.
„Der Server hat nicht rechtzeitig geantwortet. Ist TCMSOFT erreichbar?“ Keine Antwort binnen 60 Sekunden. Prüfen, ob TCMSOFT läuft (/health).
„Der Agent ist nicht (mehr) gekoppelt. Koppeln Sie ihn in TCMSOFT unter Stammdaten / Agenten erneut.“ Der Agent wurde in TCMSOFT entfernt oder deaktiviert, oder sein Schlüssel ist ungültig. Unter Stammdaten › Agenten wieder aktivieren oder neu koppeln.
„Der Kopplungscode ist unbekannt oder abgelaufen. Erzeugen Sie in TCMSOFT unter Stammdaten / Agenten einen neuen Code - er gilt 15 Minuten.“ Code älter als 15 Minuten, schon benutzt, oder der Agent ist nicht aktiv. Neuen Code erzeugen.
„„…“ ist keine gültige Server-Adresse. Sie muss mit http:// oder https:// beginnen.“ Tippfehler in der Adresse. Die Adresse eintragen, unter der TCMSOFT im Browser läuft.
„Verbunden - Problem mit einem Ordner“ Ein überwachter Ordner ist nicht erreichbar. Im Fenster unter Überwachte Ordner steht, welcher.
„Ordner nicht gefunden - existiert er, und hat der Agent Zugriff?“ Pfad falsch, Laufwerk nicht verbunden, Rechte fehlen. Am Mac zusätzlich: „Am Mac: Systemeinstellungen › Datenschutz & Sicherheit › Dateien und Ordner …“ Pfad und Rechte prüfen; am Mac den Ordner für den „Prismamed Agent“ erlauben.
„… wartet: …“ Eine Datei konnte nicht übertragen werden. Der Agent versucht es mit wachsendem Abstand bis höchstens 10 Minuten erneut. Den Grund im Text bzw. im Protokoll lesen.
„„…“ (…) kam nicht rechtzeitig bei TCMSOFT an - …“ Leitung zu langsam oder TCMSOFT antwortet nicht. Prüfen, ob TCMSOFT läuft und das Netzwerk des Arbeitsplatzes schnell genug ist.
„Im Ordner liegen Dateien, die TCMSOFT nicht annimmt (nur PDF, JPEG und PNG): …“ Der Scanner speichert z. B. TIFF. Scanner auf PDF umstellen, die Dateien aus dem Ordner nehmen.
„Der Exportordner „…“ wurde auf diesem Rechner nicht gefunden.“ Der GDT-Exportpfad stimmt nicht. Unter Stammdaten › Dokumentationstypen die GDT-Verbindung prüfen.
„Das Geräteprogramm „…“ wurde nicht gefunden. Die GDT-Datei wurde trotzdem geschrieben.“ Der Programmpfad stimmt nicht. Pfad korrigieren (am Mac das .app-Programm eintragen).
„Diese Agent-Version kennt die Auftragsart „…“ nicht. Bitte den Agenten aktualisieren.“ Der Agent ist zu alt. Im Agenten Jetzt aktualisieren (Neustart, ca. 10 Sekunden).
Am Mac „Der Prismamed Agent läuft bereits – sein Symbol steht oben rechts in der Menüleiste.“ Zweiter Start. Unter Windows endet ein zweiter Start ohne sichtbare Meldung. Das vorhandene Symbol verwenden.
„Bitte ziehen Sie „Prismamed Agent“ in den Ordner „Programme“ …“ (Mac) Gestartet direkt aus der heruntergeladenen Datei. In „Programme“ ziehen und dort starten.
Fenster „Prismamed Agent - Scan nicht übernommen“ Die Scan-Übergabe ist gescheitert (nicht gekoppelt, keine Pro-Edition, falsches Format). Den Text im Fenster befolgen.
Menüzeile „Update gerade nicht möglich - der Agent arbeitet normal“ Das Selbst-Update hat ein Problem. Den vollständigen Text zeigt TCMSOFT als „Update-Hinweis“; sonst im Protokoll.
Menüzeile „Autostart fehlt - Setup aus TCMSOFT (Stammdaten › Agenten) erneut ausführen“ wie oben „Der Autostart des Agenten fehlt …“ Setup erneut ausführen.

Unter Stammdaten › Drucker

Nach „Agent suchen“

Agent suchen sucht den Print Agent des Rechners, an dem Sie gerade sitzen.

Meldung Bedeutung Was tun
„Print Agent verbunden“ Gekoppelt und verbunden. Nichts.
„Print Agent gekoppelt – noch nicht verbunden“: „… beim ersten Mal liest er erst alle Drucker ein (bis zu einer Minute). …“ Eben gekoppelt. Bis zu einer Minute warten. Am Mac die Frage nach dem lokalen Netzwerk mit „Erlauben“ beantworten.
„Print Agent nicht verbunden“: „Der Print Agent dieses Rechners wurde gefunden, verbindet sich aber nicht. Meist ist er noch mit einer früheren Adresse dieses Servers gekoppelt …“ Alte Kopplung (geänderte Adresse oder Port) oder Zertifikat. Am Agenten Kopplung „…“ entfernen…, dann erneut Agent suchen. Steht am Agenten „SSL“ oder „Zertifikat“, siehe Typische Supportfälle.
„Kein Print Agent gefunden“ bzw. „Kein Print Agent auf diesem Rechner“ (dann mit „Verbunden ist nur der Print Agent auf dem Server.“) Der Browser hat keinen Print Agent erreicht. Davor steht, was der Browser festgestellt hat (siehe unten). Siehe Typische Supportfälle.
„Print Agent nicht gekoppelt“ Der Agent hat die Kopplung abgelehnt; der Grund steht in der Meldung (siehe unten). Je nach Grund.
„Der Print Agent auf diesem Rechner wurde gefunden, ließ sich aber nicht koppeln. Bitte erneut „Agent suchen“; hilft das nicht, den Support informieren.“ Unerwarteter Fehler beim Koppeln. Erneut versuchen, sonst den TCMSOFT-Support informieren.

Was der Browser festgestellt hat (Anfang der Meldung „Kein Print Agent gefunden“):

Danach folgt ein Hinweis: Wird TCMSOFT über http:// aufgerufen, „Chrome und Edge lassen die Suche nach dem Print Agent nur zu, wenn diese Seite über HTTPS aufgerufen wird – bitte die HTTPS-Adresse verwenden.“ Sonst „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).“

Gründe hinter „Print Agent nicht gekoppelt“:

Karte „Agent“

Anzeige Bedeutung Was tun
„Online“ verbunden –
„Offline seit …“ Seit diesem Zeitpunkt nicht verbunden. Siehe Typische Supportfälle.
„Nie verbunden“ Registriert, aber nie verbunden. Kopplung am Arbeitsplatz wiederholen.
Version „… – aktualisiert sich selbst“ / „… – aktualisiert sich nicht selbst“ / „Version unbekannt“ Stand des Selbst-Updates des Agenten. Bei „nicht selbst“ steht darunter ein Hinweis.
Warnkarte „Der Agent ist nicht verbunden. Druckerverwaltung ist verfügbar sobald der Agent online ist.“ Der gewählte Agent ist nicht verbunden. Die Karte nennt die üblichen Gründe. Siehe Typische Supportfälle.

Gelber Hinweis unter der Version (vom Print Agent gemeldet):

Hinweis Was tun
„Der Autostart des Print Agents fehlt - nach der nächsten Anmeldung startet er nicht von selbst. Bitte am Arbeitsplatz das Setup erneut ausführen (…, im Windows-Konto, mit dem dort gearbeitet wird).“ Setup im selben Windows-Konto erneut ausführen.
„Diese Installation aktualisiert sich nicht selbst. Bitte einmalig das aktuelle Setup des Prismamed Print Agent ausführen - danach kommen Updates automatisch. Download: …“ Windows: das Setup ausführen.
„Hier kann sich der Print Agent nicht selbst aktualisieren, weil dieses Benutzerkonto ihn nicht ändern darf. …“ Mac: im Arbeitskonto erneut aus der DMG in „Programme“ ziehen (den vorhandenen ersetzen) und dort starten. Gedruckt wird weiterhin.
„Dieser Print Agent aktualisiert sich nicht selbst. Bitte die aktuelle Fassung für den Mac laden (…), in den Ordner „Programme“ ziehen und von dort starten …“ Wie beschrieben.
„Der Autostart des Print Agents konnte nicht eingerichtet werden - …“ Mac: den Print Agent einmal über den Ordner „Programme“ starten; hilft das nicht, das Protokoll an den Support senden.
ein Text aus der Tabelle „Update-Hinweise beider Agenten“ Siehe unten.

Druckaufträge

Diese Texte erscheinen im Druckfenster und im Reiter Druck-Warteschlange. Status eines Auftrags: „Wartet“, „An Agent übergeben“, „Wird gedruckt“, „An Drucker übergeben“, „Fehlgeschlagen“.

Meldung Bedeutung Was tun
„Der Print Agent wird gerade aktualisiert und ist in wenigen Sekunden wieder bereit. Bitte das Dokument dann noch einmal drucken.“ Der Auftrag kam genau während des Selbst-Updates. Erneut drucken.
„Am Rechner „…“ wartet noch ein früherer Auftrag an „…“ auf eine Eingabe (Dateiname, PIN oder Faxnummer). …“ Ein Druckertreiber wartet am Agent-Rechner auf eine Eingabe. Dort das Fenster beantworten; ist keins offen, den Print Agent beenden und über das Startmenü neu starten.
„Windows hat den Auftrag für … nicht angenommen. …“ Die Windows-Druckwarteschlange hat abgelehnt. In den Windows-Einstellungen unter „Drucker und Scanner“ prüfen, ob der Drucker eingeschaltet und bereit ist.
„Der Drucker „…“ ist auf dem Rechner mit dem Print Agent nicht erreichbar. …“, „Auf dem Rechner mit dem Print Agent ist kein Standarddrucker eingerichtet. …“ Drucker fehlt am Agent-Rechner. Drucker im System des Agent-Rechners einrichten oder einen anderen wählen.
„Das Dokument war zu aufwendig, um es rechtzeitig für den Drucker aufzubereiten. …“, „Für dieses Dokument reichte der Arbeitsspeicher nicht. …“ Das Aufbereiten am Agent-Rechner scheiterte. „Als PDF laden“ und von Hand drucken; Rechner neu starten.
„Das Dokument konnte nicht gedruckt werden. … Einzelheiten stehen im Log des Print Agents.“ Unerwarteter Fehler. Protokoll des Print Agent lesen.
„Der Print Agent hat sich nicht zurückgemeldet. Prüfen Sie am Drucker, ob das Dokument gedruckt wurde, bevor Sie erneut drucken.“ Kein Ergebnis vom Agenten. Am Drucker nachsehen, dann ggf. erneut drucken.
„Der Print Agent „…“ ist nicht verbunden. …“ Der gewählte Agent ist offline. Siehe Typische Supportfälle.
„Es ist kein Print Agent eingerichtet, oder es sind mehrere eingerichtet und keiner ist gewählt. …“ Kein Agent gewählt. Im Druckfenster einen Agenten wählen bzw. einen einrichten.

Der Druckerzustand erscheint als „Bereit“, „Druckt“, „Offline“, „Papier fehlt“, „Papierstau“, „Toner fast leer“, „Toner leer“, „Klappe offen“, „Angehalten“, „Störung“, „Energiesparmodus“, „Wird vorbereitet“ oder „Unbekannt“. Einen Zustand, den TCMSOFT nicht kennt, zeigt es im Wortlaut des Betriebssystems.

Am Arbeitsplatz: Print Agent

Meldung Bedeutung Was tun
„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. …“ Je PC läuft nur ein Print Agent. Nichts. Meldet sich der andere Benutzer ab, den Print Agent über das Startmenü neu starten.
„Der Prismamed Print Agent läuft bereits — siehe Druckersymbol im Infobereich der Taskleiste.“, am Mac „Der Prismamed Print Agent läuft bereits – sein Symbol steht oben rechts in der Menüleiste.“ Zweiter Start. Das vorhandene Symbol verwenden.
„Der Prismamed Print Agent kann nicht starten, weil Anschluss 9632 an diesem PC schon belegt oder von Windows gesperrt ist. …“ (am Mac „… auf diesem Mac schon belegt ist. …“) Port 9632 ist belegt, meist durch den Print Agent eines anderen Benutzerkontos. Zeigt TCMSOFT keinen verbundenen Print Agent, den Rechner neu starten. Sonst prüfen lassen, welches Programm den Port belegt.
„Bitte ziehen Sie „Prismamed Print Agent“ in den Ordner „Programme“ …“ (Mac) Gestartet direkt aus der heruntergeladenen Datei. In „Programme“ ziehen und dort starten.
Menü „Noch mit keinem TCMSOFT gekoppelt - „Koppeln …“ wählen, Code aus Stammdaten › Drucker › „Arbeitsplatz koppeln““ (ältere Agents unter Windows: „Kein Server gekoppelt“) Keine Kopplung. Per Code koppeln (Koppeln …) oder am selben Rechner Agent suchen.
Menü „✔ … – verbunden seit …“ verbunden –
Menüzeile, die mit „– verbindet“ endet Verbindungsaufbau; neuer Versuch nach 5 Sekunden bis höchstens 1 Minute. Abwarten.
Menü „✖ … – getrennt: …“ Getrennt; dahinter der Grund. Grund lesen; siehe die beiden Mac-Hinweise und Typische Supportfälle.
Menü „⚠ … – vom Server abgelehnt, bitte neu koppeln“ Der Server kennt diese Kopplung nicht mehr. Kopplung „…“ entfernen…, dann per Code (Koppeln …) oder mit Agent suchen neu koppeln.
Menü „⚠ … – verbunden, am Server aber nicht angemeldet (wird wiederholt)“ Die Anmeldung am Server ist gescheitert; der Agent wiederholt sie. Abwarten; bleibt es, das Protokoll lesen.
Mac-Menü „TCMSOFT nicht erreichbar: Ist der Mac im Praxisnetz (nicht im Gäste-WLAN) und der Server an? Sonst unter Systemeinstellungen › Datenschutz & Sicherheit › Lokales Netzwerk „Prismamed Print Agent“ einschalten“ Fehler „No route to host“. Netz prüfen, die Freigabe „Lokales Netzwerk“ einschalten.
Mac-Menü „Dieser Mac vertraut dem Zertifikat von TCMSOFT nicht - im Schlüsselbund „Immer vertrauen“ einstellen (IT-Betreuung)“ Zertifikatsfehler. Siehe Typische Supportfälle.
Menü „Update gerade nicht möglich - der Agent druckt normal“ Das Selbst-Update hat ein Problem. Den vollständigen Text zeigt TCMSOFT unter Stammdaten › Drucker als Hinweis.
Menü „Aktualisiert sich nicht selbst - Setup aus TCMSOFT (Stammdaten › Drucker) ausführen“ (Windows), „Aktualisiert sich nicht selbst - Hinweis in TCMSOFT unter Stammdaten › Drucker“ (Mac) Selbst-Update aus. Setup ausführen bzw. den Hinweis befolgen.
Menü „Autostart fehlt - Setup aus TCMSOFT (Stammdaten › Drucker) erneut ausführen“ Windows: Autostart-Verknüpfung gelöscht. Setup im selben Konto erneut ausführen.

Update-Hinweise beider Agenten

Prismamed Agent und Print Agent verwenden dasselbe Selbst-Update und dieselben Texte. TCMSOFT zeigt sie unter Stammdaten › Agenten („Update-Hinweis“) bzw. Stammdaten › Drucker (gelber Hinweis). Am Mac steht „diesem Mac“ statt „diesem PC“.

Hinweis Bedeutung Was tun
„Neue Versionen konnten nicht abgefragt oder geladen werden - downloads.tcmsoft.de ist nicht erreichbar. Der Agent arbeitet normal weiter und versucht es später erneut.“ Der Arbeitsplatz erreicht den Download-Server nicht. Ist es vorübergehend, nichts. Bleibt es, Firewall bzw. Proxy für https://downloads.tcmsoft.de (Port 443) freigeben. Unter Windows nutzt das Update die Proxy-Einstellungen von Windows.
„Die Update-Liste ließ sich gerade nicht bestätigen - vermutlich wird eine neue Version bereitgestellt. Der Agent arbeitet normal weiter und prüft in einer halben Stunde erneut.“ Erster Signaturfehler, meist während der Hersteller hochlädt. Nichts.
„Die Signatur der Update-Liste ist ungültig - sie stammt nicht vom Hersteller oder wurde unterwegs verändert. … Bleibt diese Meldung, bitte den Support informieren.“ Wiederholter Signaturfehler; der Agent installiert nichts. Den TCMSOFT-Support informieren.
„Die Signatur der Update-Liste (….sig) fehlt auf dem Update-Server - …“, „Die Update-Liste ist nicht signiert - …“, „Der Update-Server liefert eine ältere Update-Liste (vom …) als zuletzt (vom …) - sie wird nicht verwendet.“, „Für das Update-Paket … fehlt die SHA256-Prüfsumme.“, „In dieser Version ist kein Prüfschlüssel für Updates hinterlegt - …“ Problem auf dem Download-Server oder im Paket. Den TCMSOFT-Support informieren.
„Das Update kam beschädigt an und wird beim nächsten Versuch neu geladen.“ Download fehlerhaft. Nichts.
„Das Update konnte auf diesem PC nicht gespeichert werden (Speicherplatz oder Zugriffsrechte). …“ Kein Platz oder keine Schreibrechte im Benutzerprofil. Speicherplatz schaffen, Rechte prüfen.
„Die Suche nach Updates ist fehlgeschlagen. Der Agent arbeitet normal weiter und versucht es später erneut; Einzelheiten stehen im Protokoll.“ Anderer Fehler. Protokoll lesen; bleibt es, den Support informieren.
„Das Update auf Version … ließ sich zuletzt nicht einspielen. Der Agent arbeitet mit Version … weiter und versucht es ab … Uhr erneut; „Jetzt aktualisieren“ versucht es sofort. …“ Das Einspielen scheiterte; automatisch erst nach 24 Stunden wieder. Jetzt aktualisieren (Neustart, ca. 10 Sekunden) im Menü des Agenten. Bleibt es, Protokoll an den Support.
„Das Update auf Version … ließ sich nicht starten. …“, „Das Update auf Version … ließ sich nicht einspielen; der Agent läuft mit Version … weiter …“ wie oben wie oben
„Diese Installation aktualisiert sich nicht selbst. Bitte einmalig das aktuelle Setup des … ausführen - danach kommen Updates automatisch.“ Nicht mit dem Setup installiert oder Selbst-Update abgeschaltet. Setup ausführen.

Wie Updates der Agenten ablaufen und wie man sie bremst, steht unter Updates der Agenten.

Erstellt mit PrismaDocs | Autoren: Prismamed