Protokolle und Diagnose

Diese Seite zeigt, wo TCMSOFT, der Update-Dienst und die Agenten mitschreiben, was sie tun, und wie Sie den Zustand prüfen. Sie brauchen sie, bevor Sie einen Fehler beheben oder an den TCMSOFT-Support weitergeben. Was eine einzelne Meldung bedeutet, steht unter Meldungen und ihre Bedeutung. Schrittfolgen für häufige Fehler stehen unter Typische Supportfälle.

In den Befehlen steht <Datenordner> für den Ordner auf dem Server, den Sie bei der Einrichtung angelegt haben,

26. 2. /volume1/docker/tcmsoft (Synology) oder /var/lib/tcmsoft (Mikroserver). <Server> steht für die Adresse des Servers im Praxisnetz.

Welche Quelle wofür

Auf dem Server

Zugang

Alle Befehle auf dieser Seite laufen per SSH auf der NAS bzw. dem Server. Auf einer Synology melden Sie sich als Administrator an und wechseln vorher mit sudo -i zum Benutzer root.

Woran Sie den Erfolg erkennen: docker ps -a listet die Container. Meldet der Befehl einen Fehler beim Zugriff auf Docker, prüfen Sie, ob Sie mit sudo -i zu root gewechselt haben.

Zustand der Container

docker ps -a

Im Normalbetrieb gibt es die ersten beiden Container; die anderen beiden gibt es nur vorübergehend:

Ob TCMSOFT „gesund“ ist (Anwendung und Datenbank antworten):

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

• starting: TCMSOFT startet noch. Docker lässt dafür 10 Minuten Startphase.
• healthy: alles in Ordnung.
• unhealthy: die Gesundheitsprüfung schlug dreimal hintereinander fehl. Dann docker logs tcmsoft lesen.

Wie oft Docker den Container schon neu gestartet hat:

docker inspect --format '{{.RestartCount}}' tcmsoft

Genau diese beiden Werte wertet auch der Update-Dienst aus. Ab 3 Neustarts gilt eine neue Version als abgestürzt.

Welche Versionen als Image auf dem Server liegen:

docker image ls tcmsoft
docker image ls tcmsoft-updater

Der Update-Dienst behält die laufende und die vorige Version von TCMSOFT. Ältere entfernt er nach einem gelungenen Update selbst. Löschen Sie Images nicht von Hand (siehe Typische Supportfälle).

Protokoll des Update-Dienstes

docker logs --tail 200 tcmsoft-updater

Mit -f statt --tail 200 läuft die Anzeige mit; beenden mit Strg+C.

Jede Zeile beginnt mit [updater], Datum und Uhrzeit. Typische Zeilen:

Jedes Ergebnis, das in der Glocke erscheint, steht hier auch als Zeile „Titel: Text“, z. B. „Update auf Version …: TCMSOFT wurde auf Version … aktualisiert.“ Fehler beim Start des Dienstes stehen als letzte Zeile vor dem Neustart; Docker startet den Dienst nach 30 Sekunden neu. Die Bedeutung dieser Zeilen steht unter Meldungen und ihre Bedeutung.

Docker begrenzt das Protokoll eines Containers, den der Update-Dienst selbst anlegt, auf 5 Dateien zu je 20 MB. Das gilt nur, wenn Docker Protokolle als Datei führt (Protokolltreiber json-file oder local). Der von Hand angelegte erste tcmsoft-updater hat diese Begrenzung nicht. Sie kommt erst mit seinem ersten Selbst-Update.

Protokoll von TCMSOFT

docker logs --tail 300 tcmsoft

Darin stehen mehrere Arten von Zeilen:

• Zeilen mit [tcmsoft], Datum und Uhrzeit stammen vom Startskript des Containers: Datenbank, Druckersuche, Drucksystem, eigene Treiber und Schriften, Start und Neustarts der Anwendung.
• Die übrigen Zeilen stammen von TCMSOFT selbst und vom Print Agent des Servers.
• Dazu kommen Meldungen der Datenbank MongoDB (als JSON-Zeilen, z. B. Abfragen, die länger als eine Sekunde dauern) und Fehlermeldungen des Drucksystems (CUPS).

Ein normaler Start sieht so aus (Auszug, in dieser Reihenfolge):

• „MongoDB wird gestartet (Daten in …)“
• „MongoDB läuft (nur lokal, mit Anmeldung)“
• „CUPS und PrintAgent gestartet“
• „TCMSOFT … wird gestartet (erreichbar über Port …)“
• bei großen Datenbeständen mehrmals „TCMSOFT startet noch (… s) - bei großen Datenbeständen dauert das Anpassen der Datenbank einige Minuten“
• „TCMSOFT läuft“

Produkt beim Start: Ob die Installation TCMSOFT oder Salvia Software ist, entscheidet der Start. Was er entschieden hat, steht in den Zeilen der Anwendung, nicht in den [tcmsoft]-Zeilen. Eine neue Installation mit Produkt=Salvia in tcmsoft.env zeigt beim ersten Start nacheinander:

• „Neue Installation als Salvia eingerichtet (Parameter Produkt in tcmsoft.env).“
• „Praxisart von Arzt auf Heilpraktiker gestellt von unbekannt: … angepasst.“

Eine TCMSOFT-Installation ohne die Zeile Produkt schreibt dazu nichts. Gezielt suchen:

docker logs tcmsoft 2>&1 | grep -E 'Produkt|Salvia|Praxisart'

Auch bei Salvia Software heißen Container, Datenordner und tcmsoft.env „tcmsoft“, und die übrigen Zeilen sprechen von TCMSOFT. Alle Einträge zum Produkt, ihre Bedeutung und was zu tun ist: Meldungen und ihre Bedeutung, Hintergrund und Rückweg unter Produkt und Praxisart.

Welchen Treiber der Print Agent des Servers für einen Drucker gewählt hat, steht in den Zeilen „Printer … added with …“. Kopplungsversuche des Prismamed Agent stehen hier als „Kopplung fehlgeschlagen von …“ und „Agent-Schnittstelle: ungültiger Schlüssel von …“, jeweils mit der IP-Adresse des Arbeitsplatzes.

Der Ordner updater/ im Datenordner

TCMSOFT und der Update-Dienst verständigen sich nur über Dateien in <Datenordner>/updater/. Im TCMSOFT-Container heißt derselbe Ordner /data/updater.

status.json lesen

cat <Datenordner>/updater/status.json

Die Datei ist lesbar formatiert, Umlaute stehen im Klartext.

Im Leerlauf schreibt der Dienst die Datei mindestens einmal pro Minute. Ist Stand älter als 5 Minuten und steht LaeuftGerade auf false, läuft er nicht. Die Backup-Seite zeigt dann „Der Update-Dienst meldet sich nicht …“. Während eines langen Schritts (z. B. eines Downloads) schreibt der Dienst die Datei nur beim Wechsel des Schritts. Dann kann dieselbe Warnung neben dem laufenden Schritt erscheinen, obwohl er arbeitet (aus dem Code abgeleitet, nicht getestet).

Nur die Version des Update-Dienstes:

grep UpdaterVersion <Datenordner>/updater/status.json

vorgang.json lesen

Die Datei gibt es nur, solange ein Update läuft oder unterbrochen wurde. Sie enthält Von, Nach, Changelog, Beginn und Phase als Zahl:

Löschen Sie vorgang.json nie von Hand. Ohne sie weiß der Dienst nach einem Neustart nicht mehr, dass er zurückrollen muss.

Gesundheitsprüfung im Browser

Rufen Sie im Browser auf:

http://<Server>:8085/health

Auf dem Mikroserver lauscht TCMSOFT nur auf 127.0.0.1:5000. Dort prüfen Sie per SSH mit curl http://127.0.0.1:5000/health.

Haben Sie den Port in tcmsoft.env geändert, verwenden Sie den neuen Port.

Programmprotokoll in TCMSOFT

TCMSOFT schreibt sein Programmprotokoll zusätzlich in die Datenbank der Praxis (patient) und löscht dort Einträge nach 90 Tagen, Debug-Einträge nach 7 Tagen. Angezeigt wird es im Reiter Logs des versteckten Servermanagements, das sich nur mit dem Support-Konto öffnet (siehe Servermanagement). Ohne Support-Konto lesen Sie das Protokoll mit docker logs tcmsoft.

Datenbank neu initialisieren, Demodaten installieren und die Datenübernahme löschen das Programmprotokoll mit, Backup wiederherstellen ersetzt es durch den Stand der Sicherung. Frühere Einträge stehen dann nur noch in docker logs tcmsoft, und dort nur, bis der Container neu angelegt wird (bei jedem Update).

Bis TCMSOFT 2026.10.7.1 stand das Programmprotokoll in der Datenbank tcmsoft. Diese alten Einträge zeigt der Reiter Logs nicht, und TCMSOFT räumt sie dort nicht auf.

Datenbank-Konsole

Für den Support gibt es im Container eine Konsole, die sich selbst mit dem Datenbank-Passwort dieser Installation anmeldet:

docker exec -it tcmsoft tcmsoft-mongosh

• Die Praxisdaten und das Programmprotokoll liegen in der Datenbank patient, die Inhalte der Bibliothek in der Datenbank tcmsoft (dort auch das Programmprotokoll bis TCMSOFT 2026.10.7.1).
• Die Größen der Datenbanken zeigt der mongosh-Befehl show dbs.
• Beenden mit exit.

Die Konsole ist nur zum Lesen gedacht. Für Änderungen gibt es keine freigegebene Anleitung. Ändern Sie dort nichts ohne Absprache mit der TCMSOFT-Entwicklung. Lesen oder kopieren Sie nie die Datei keys/mongo-passwort.

An den Arbeitsplätzen

Beide Agenten haben im Menü den Eintrag Protokoll öffnen. Er öffnet immer den richtigen Ordner. Das ist der einfachste Weg. Unter Windows öffnet die rechte Maustaste auf das Symbol im Infobereich das Menü, am Mac ein Klick auf das Symbol in der Menüleiste.

Je Tag entsteht eine Datei. Es bleiben die letzten 30 Dateien.

Prismamed Agent

• Das Fenster des Agenten zeigt unten „Version … · Protokolle: …“ mit dem Pfad.
• Unter Windows öffnet ein Klick auf das Symbol das Fenster. Am Mac öffnen Sie es im Menü mit Einstellungen….
• Das Fenster hat ebenfalls Protokoll öffnen und Ordner jetzt prüfen.
• Die Scan-Übergabe (Aufruf durch die Scannersoftware) schreibt in dieselbe Datei.

Print Agent

• Unter Windows weicht der Print Agent auf einen Ordner je Benutzer aus, wenn er %ProgramData%\Prismamed\PrintAgent nicht verwenden kann. Protokoll öffnen im Menü zeigt immer den tatsächlich benutzten Ordner.
• Datenordner öffnen im selben Menü zeigt Kennung und Kopplung des Agenten.

Was in den Agent-Protokollen steht

• Verbindung zu TCMSOFT, Aufträge, Dateien, Druckaufträge und deren Fehler.
• Das Selbst-Update, z. B. „Update auf Version … wird eingespielt (Neustart).“ und nach dem Neustart „Aktualisiert auf Version … (…)“.
• Meldungen des Update-Programms Velopack mit dem Vorsatz „Velopack: “. Wo Velopack selbst zusätzlich protokolliert, ist nicht dokumentiert.
• Die Notbremse für Updates: „Notbremse: Updates höchstens bis Version …“ bzw. „Notbremse für Updates aufgehoben.“
• Ein zurückgezogenes Update: „Update … wurde zurückgezogen oder ist gesperrt - es wird nicht eingespielt.“

Geben Sie die Dateien agent.json (enthält den Schlüssel, mit dem sich der Prismamed Agent bei TCMSOFT ausweist) und pairings.json (Kopplung des Print Agent) nicht weiter. Für den Support genügen die Protokolle.

Im Browser

Der Browser am Arbeitsplatz ist oft das schnellste Prüfwerkzeug:

Für Mac-Fassungen heißen die Zeigerdateien aktuell-mac-arm64.txt und aktuell-mac-x64.txt.

In TCMSOFT selbst

Was der TCMSOFT-Support braucht

Sammeln Sie vor dem Anruf:

1. die Versionen: Installierte Version von der Backup-Seite und UpdaterVersion aus status.json,
2. die Ausgabe von docker ps -a,
3. die letzten Zeilen von docker logs tcmsoft und docker logs tcmsoft-updater,
4. bei einem gescheiterten Update die Datei aus <Datenordner>/updater/protokoll/,
5. bei einem Arbeitsplatzproblem das Agent-Protokoll des betreffenden Tages und den Text der Meldung.

Senden Sie nie den Ordner keys/, die Datei keys/mongo-passwort, agent.json oder pairings.json.