Datenordner und tcmsoft.env

Alles, was eine Praxis ausmacht, liegt in einem Ordner auf dem Gerät: Datenbank, Schlüssel, Einstellungen, Druckerkonfiguration. Der Container tcmsoft selbst enthält keine Daten. Ein Update tauscht nur den Container aus, der Datenordner bleibt. Die Einstellungen des Containers stehen in der Datei tcmsoft.env in diesem Ordner.

Diese Seite erklärt die Unterordner, alle Einstellungen in tcmsoft.env und wie Sie eine geänderte Einstellung wirksam machen.

Der Datenordner

Den Pfad legen Sie bei der Einrichtung fest (TCMSOFT einrichten), z. B. /volume1/docker/tcmsoft auf einer Synology oder /var/lib/tcmsoft auf dem Mikroserver. Im Container tcmsoft heißt derselbe Ordner /data; der Update-Dienst sieht ihn unter dem Pfad des Geräts. Im Folgenden steht <Datenordner> für den Pfad auf dem Gerät.

Beim ersten Start legt der Update-Dienst tcmsoft.env und updater/ an. Die Ordner mongodb/, keys/, cups/, treiber/, schriften/, printagent/, bibliothek/, pharmindex/ und tmp/ legt TCMSOFT bei jedem Start an, falls sie fehlen. vor-update/ legt der Update-Dienst erst während eines Updates an.

Unterordner und Dateien

Wie Sie die Datenbank und die übrigen Dateien sichern, steht unter Datensicherung und Umzug.

Was Sie im Datenordner selbst tun

• tcmsoft.env bearbeiten – siehe unten.
• Eigene Druckertreiber nach treiber/ legen: die PPD-Datei des Herstellers (.ppd oder .ppd.gz) oder seine .deb-Pakete. Danach docker restart tcmsoft und den Drucker in TCMSOFT neu hinzufügen. Im Protokoll (docker logs tcmsoft) steht dann „Eigene Druckertreiber eingebunden: …“ bzw. „Treiberpakete installiert: …“. .deb-Pakete müssen liegen bleiben, solange ein Drucker sie nutzt: TCMSOFT installiert sie bei jedem Start neu und entfernt ein gelöschtes Paket beim nächsten Start.
• Eigene Schriften nach schriften/ legen und docker restart tcmsoft ausführen. Im Protokoll steht dann „Eigene Schriften eingebunden: … Datei(en) aus schriften/“. Nur Schriften verwenden, deren Lizenz den Einsatz auf dem Server erlaubt.

Alles andere ändern Sie nicht von Hand:

• mongodb/ nie im laufenden Betrieb kopieren oder verändern.
• keys/mongo-passwort nie ersetzen. Passt die Datei nicht zur Datenbank, startet TCMSOFT nicht und meldet im Protokoll: „Die Anmeldung an der Datenbank schlägt fehl: das Passwort in /data/keys/mongo-passwort passt nicht zum Konto in der Datenbank. …“
• Den Inhalt von keys/ nicht weitergeben und nicht in Tickets oder E-Mails kopieren. Er öffnet den Zugang zur Datenbank und zu den Anmeldungen.
• vor-update/ nicht löschen, während ein Update läuft.
• Besitzer und Rechte nicht ändern. TCMSOFT läuft im Container als eigener Benutzer tcmsoft (UID 1500), die Datenbank als Benutzer mongodb; TCMSOFT setzt die Besitzer beim Start selbst. Den Ordner updater/ stellt der Update-Dienst auf volle Schreibrechte (777), weil TCMSOFT dort Anforderungen ablegt.

Der Ordner updater/

Über diesen Ordner sprechen TCMSOFT und der Update-Dienst miteinander.

Welche Version der Update-Dienst hat:

grep UpdaterVersion <Datenordner>/updater/status.json

Mehr zu Updates unter Updates von TCMSOFT, zu den Protokollen unter Protokolle und Diagnose.

tcmsoft.env

Wozu: In tcmsoft.env stehen die Einstellungen des Containers tcmsoft. Der Update-Dienst übergibt die Datei beim Anlegen von TCMSOFT an Docker (--env-file <Datenordner>/tcmsoft.env).

Aufbau: Jede Einstellung steht auf einer eigenen Zeile in der Form NAME=Wert. Zeilen, die mit # beginnen, sind Kommentare und wirken nicht. Eine Einstellung „einschalten“ heißt also: das # am Zeilenanfang entfernen.

So legt der Update-Dienst die Datei an

Fehlt tcmsoft.env, legt der Update-Dienst sie mit diesem Inhalt an. Eine vorhandene Datei überschreibt er nie. Der Inhalt zum Kopieren, Zeichen für Zeichen wie im Update-Dienst:

# Einstellungen des TCMSOFT-Containers - der Updater legt TCMSOFT mit diesen Werten an.
# Nach einer Änderung den Container entfernen (docker rm -f tcmsoft); der Updater legt ihn mit derselben Version neu an.

# Web-Port (auf Synology sind 5000/5001 vom System belegt). Mikroserver hinter Caddy: http://127.0.0.1:5000
ASPNETCORE_URLS=http://+:8085

# Erst einschalten, wenn TCMSOFT über HTTPS aufgerufen wird (Reverse-Proxy der NAS, Caddy):
# Server__SichereCookies=true

# Nur einschalten, wenn die Datenbank auf einem Linux-Kernel ab 6.19 nicht startet (z. B. Ubuntu 26.04 mit Kernel 7.0;
# im Protokoll „MongoDB cannot start: Linux kernel versions 6.19 and newer …“). Notlösung, MongoDB läuft dann etwas langsamer.
# GLIBC_TUNABLES=glibc.pthread.rseq=1

Die letzten drei Zeilen legt erst ein Update-Dienst nach Version 2026.10.7.1 an. In einer älteren Datei die Zeile bei Bedarf von Hand ergänzen.

Auf dem Mikroserver entsteht die Datei bei der Einrichtung vorab mit den zwei Zeilen ASPNETCORE_URLS=http://127.0.0.1:5000 und Server__SichereCookies=true, dazu auskommentiert # GLIBC_TUNABLES=glibc.pthread.rseq=1 (siehe unten); für Salvia Software kommt Produkt=Salvia dazu.

Die Datei selbst anlegen

Wozu: Für Salvia Software muss die Zeile Produkt=Salvia schon beim ersten Start in tcmsoft.env stehen. Sie legen die Datei deshalb vor dem ersten Start des Update-Dienstes selbst an.

Die Datei muss vollständig sein. Der Update-Dienst übernimmt eine vorhandene Datei unverändert und ergänzt nichts. Fehlt die Zeile ASPNETCORE_URLS=http://+:8085, gilt der Standard des Images, Port 8080 statt 8085. Auch die kommentierten Zeilen (Server__SichereCookies, GLIBC_TUNABLES) gehören hinein, damit sie sich später einfach einschalten lassen. Übernehmen Sie deshalb den ganzen Standardinhalt von oben und hängen Sie Ihre Zeilen an.

Als ein Befehl für Salvia Software, Beispiel Synology (in der ersten Zeile Ihren Datenordner einsetzen; den ganzen Block von cat bis EOF auf einmal einfügen):

cat > /volume1/docker/tcmsoft/tcmsoft.env <<'EOF'
# Einstellungen des TCMSOFT-Containers - der Updater legt TCMSOFT mit diesen Werten an.
# Nach einer Änderung den Container entfernen (docker rm -f tcmsoft); der Updater legt ihn mit derselben Version neu an.

# Web-Port (auf Synology sind 5000/5001 vom System belegt). Mikroserver hinter Caddy: http://127.0.0.1:5000
ASPNETCORE_URLS=http://+:8085

# Erst einschalten, wenn TCMSOFT über HTTPS aufgerufen wird (Reverse-Proxy der NAS, Caddy):
# Server__SichereCookies=true

# Nur einschalten, wenn die Datenbank auf einem Linux-Kernel ab 6.19 nicht startet (z. B. Ubuntu 26.04 mit Kernel 7.0;
# im Protokoll „MongoDB cannot start: Linux kernel versions 6.19 and newer …“). Notlösung, MongoDB läuft dann etwas langsamer.
# GLIBC_TUNABLES=glibc.pthread.rseq=1

Produkt=Salvia
EOF

cat > … überschreibt eine vorhandene Datei. Den Befehl deshalb nur in einem neuen, leeren Datenordner ausführen. Den Ablauf im Zusammenhang beschreibt TCMSOFT einrichten im Abschnitt „Nur für Salvia Software: tcmsoft.env vorher anlegen“, für den Mikroserver dort im Abschnitt zum Mikroserver.

Einstellungen für den Installateur

Zur Notbremse: Ein ausgeschalteter Arbeitsplatz kann ein schon geladenes Update beim nächsten Start noch einspielen, bevor er die Bremse erfährt. Bei einer fehlerhaften Agent-Version deshalb zusätzlich den TCMSOFT-Support informieren.

Stellschrauben nur nach Rücksprache mit dem Support

Nicht eintragen

Diese Werte setzt das Image passend zum Aufbau des Containers. Eine Änderung bricht den Betrieb:

Mongo__Host, Mongo__Benutzer, Mongo__PasswortDatei, Bibliothek__Pfad, DataProtection__Pfad, Updater__Pfad, Pharmindex__Pfad, Server__HttpsRedirect, CUPS_SERVER, LANG, LC_ALL, TCMSOFT_VERSION.

Weitere Einträge nur auf Anweisung des TCMSOFT-Supports. Die Einstellungen des Update-Dienstes (TCMSOFT_DATEN, UPDATE_UHRZEIT und seine Zeitzone) gehören nicht in tcmsoft.env, sondern in seinen docker run (TCMSOFT einrichten).

Einstellungen wirksam machen

Wozu: Docker liest tcmsoft.env nur, wenn der Container angelegt wird. docker restart tcmsoft übernimmt eine Änderung deshalb nicht. Stattdessen entfernen Sie den Container; der Update-Dienst legt ihn mit derselben Version und den neuen Einstellungen wieder an. Daten, Anmeldungen und Drucker bleiben erhalten.

TCMSOFT ist dabei einige Minuten nicht erreichbar. Machen Sie das außerhalb der Sprechzeiten und bitten Sie die Praxis, vorher ihre Arbeit zu speichern.

1. Datei bearbeiten

Als Administrator (sudo -i), denn die Datei gehört dem Benutzer root. Aktuellen Inhalt anzeigen:

cat <Datenordner>/tcmsoft.env

Bearbeiten Sie die Datei mit einem Editor auf dem Gerät (z. B. vi) oder mit diesen Befehlen:

Server__SichereCookies einschalten (das # entfernen):

sed -i 's/^# *Server__SichereCookies=true/Server__SichereCookies=true/' <Datenordner>/tcmsoft.env

Server__SichereCookies wieder ausschalten (auskommentieren):

sed -i 's/^Server__SichereCookies=true/# Server__SichereCookies=true/' <Datenordner>/tcmsoft.env

Eine Zeile anfügen, z. B. einen anderen Datenbank-Port:

echo 'Mongo__Port=27018' >> <Datenordner>/tcmsoft.env

Jede Einstellung nur einmal eintragen: eine vorhandene Zeile ändern, statt eine zweite anzufügen. Danach den Inhalt noch einmal mit cat prüfen.

2. Version des Update-Dienstes prüfen

grep UpdaterVersion <Datenordner>/updater/status.json

Ab Version 2026.10.7.1 legt der Update-Dienst TCMSOFT nach docker rm -f tcmsoft mit der zuletzt gelaufenen Version neu an (Ausnahme: deren Image fehlt, siehe „Wenn das Image fehlt“ unten). Der Dienst aktualisiert sich nachts selbst und hat diese Version deshalb in der Regel schon. Zeigt die Zeile eine ältere Version, lesen Sie vorher den Abschnitt „Ältere Update-Dienste“ unten.

3. Container neu anlegen lassen

docker rm -f tcmsoft

Der Update-Dienst bemerkt den fehlenden Container und legt ihn neu an:

• mit dem Image der zuletzt gelaufenen Version (TcmsoftVersion in status.json), ohne Internet,
• nie mit einer neueren oder älteren Version und nie mit einem Image, das geladen, aber noch nicht eingespielt ist – neue Versionen kommen weiterhin nur über das nächtliche Update mit Sicherung,
• in der Regel nach wenigen Sekunden, spätestens nach 10 Minuten (so lange wartet der Dienst zwischen zwei Versuchen, einen fehlenden Container anzulegen).

Der Update-Dienst muss dafür laufen. Haben Sie ihn angehalten, zuerst docker start tcmsoft-updater.

Verfolgen:

docker logs -f tcmsoft-updater

Erfolg (Uhrzeiten weggelassen):

[updater] … TCMSOFT wird eingerichtet …
[updater] … TCMSOFT wird mit dem vorhandenen Image 2026.10.7.1 angelegt (zuletzt gelaufen: 2026.10.7.1) - neue Versionen kommen nur über das Update mit Sicherung.
[updater] … TCMSOFT 2026.10.7.1 wird gestartet …
[updater] … TCMSOFT 2026.10.7.1 neu angelegt: Der TCMSOFT-Container wurde mit Version 2026.10.7.1 neu angelegt (z. B. nach geänderten Einstellungen). Neue Versionen spielt der Update-Dienst wie gewohnt nachts oder über „Jetzt aktualisieren“ ein - mit Sicherung der Datenbank.

In TCMSOFT erscheint die Nachricht „TCMSOFT 2026.10.7.1 neu angelegt“. Ob eine Einstellung angekommen ist, zeigt z. B.:

docker exec tcmsoft printenv ASPNETCORE_URLS

Wenn TCMSOFT danach nicht startet

Meldung „TCMSOFT startet nicht“ (im Protokoll des Update-Dienstes und in den Nachrichten): „TCMSOFT … wurde neu angelegt, startet aber nicht. Meist liegt es an der letzten Änderung in tcmsoft.env im Datenordner (z. B. ein schon belegter Port; Einzelheiten: docker logs tcmsoft). …“

1. docker logs tcmsoft lesen. Typische Meldungen und ihre Abhilfe stehen unter TCMSOFT einrichten und Meldungen und ihre Bedeutung.
2. Die Änderung in tcmsoft.env korrigieren.
3. Erneut docker rm -f tcmsoft.

Wenn das Image fehlt

Fehlt das Image der zuletzt gelaufenen Version (z. B. von Hand gelöscht), lädt der Update-Dienst die aktuelle Version von downloads.tcmsoft.de und startet sie ohne die sonst übliche Sicherung der Datenbank – nie eine ältere und nie eine auf diesem Gerät gescheiterte. Er warnt dann sofort mit „TCMSOFT … neu geladen“.

• Löschen Sie deshalb keine TCMSOFT-Images von Hand (z. B. mit docker image rm oder docker image prune -a), vor allem nicht, solange der Container fehlt.
• Meldet der Dienst danach „TCMSOFT startet nicht“ mit dem Text „… wurde ohne Sicherung der Datenbank neu geladen und startet nicht. Bitte nichts weiter versuchen (den Container nicht erneut entfernen) und sofort den TCMSOFT-Support informieren …“: genau so handeln.

Ältere Update-Dienste (vor 2026.10.7.1)

Ein Update-Dienst vor Version 2026.10.7.1 konnte nach docker rm -f tcmsoft eine neuere Version sofort einrichten, ohne Sicherung und ohne Rückfall. Gehen Sie dort so vor:

1. In TCMSOFT unter Stammdaten › Backup in der Karte Programmversion und Updates auf Jetzt prüfen klicken.
2. Liegt eine neue Version bereit, stattdessen Jetzt aktualisieren wählen. Das Update sichert vorher die Datenbank und legt den Container mit der neuen Einstellung an. docker rm -f tcmsoft ist dann nicht nötig.
3. Sonst docker rm -f tcmsoft wie oben.

Ab 2026.10.7.1 schadet diese Prüfung nicht.

Nur neu starten

docker restart tcmsoft genügt, wenn sich an tcmsoft.env nichts geändert hat, z. B. nach neuen Dateien in treiber/ oder schriften/ oder nach dem Wiederherstellen einer Sicherung. Einen angehaltenen Container tcmsoft startet der Update-Dienst nicht von selbst; dafür docker start tcmsoft.