Voraussetzungen

Diese Seite fasst zusammen, was vor der Einrichtung vorhanden sein muss. Prüfen Sie die Punkte vor dem ersten Termin in der Praxis. Am wichtigsten ist der Prozessor des Servers: Er entscheidet, ob ein Gerät überhaupt geeignet ist. Wie die Bausteine zusammenspielen, steht unter Aufbau von TCMSOFT.

Checkliste

Server

Geeignete Geräte

Für alle Geräte gilt:

• Sie brauchen SSH-Zugang mit Administratorrechten. Auf einer Synology arbeiten Sie nach der Anmeldung mit sudo -i.
• Der Docker-Socket muss unter /var/run/docker.sock liegen. Der Update-Dienst bindet genau diesen Pfad ein und gibt ihn bei seinem Selbst-Update weiter.
• Auf dem Mikroserver laufen die Dienste der bisherigen Installation (tcmsoft, printagent, mongod). Sie belegen dieselben Ports und müssen vorher aus, siehe TCMSOFT einrichten.

Prozessor

Wozu: TCMSOFT bringt die Datenbank MongoDB 8.3 mit. Sie läuft auf x64 nur mit der Befehlssatzerweiterung AVX und auf ARM64 erst ab ARMv8.2.

Auf einem Gerät ohne AVX startet TCMSOFT nicht. Im Protokoll (docker logs tcmsoft) steht dann „Dieser Prozessor unterstützt kein AVX - MongoDB 8.3 läuft auf diesem Gerät nicht. …“.

So prüfen Sie den Prozessor per SSH auf dem Gerät:

uname -m

x86_64 bedeutet x64, aarch64 bedeutet ARM64. Danach richtet sich, welche Datei des Update-Dienstes Sie bei der Einrichtung laden (tcmsoft-updater-x64.tar bzw. tcmsoft-updater-arm64.tar). Die Pakete für TCMSOFT wählt der Update-Dienst danach selbst passend zum Gerät.

grep -qw avx /proc/cpuinfo && echo "AVX vorhanden" || echo "kein AVX"

• Erfolg: „AVX vorhanden“.
• Bei „kein AVX“ ist das Gerät für TCMSOFT zu alt. Sie brauchen ein anderes Gerät.
• Auf ARM64-Geräten entfällt diese Prüfung. Ob der Prozessor ARMv8.2 erfüllt, steht im Datenblatt des Herstellers.

Hinweis: TCMSOFT lässt sich für ARM64 bauen, und der Update-Dienst wählt die Architektur selbst. Welche ARM-Geräte erprobt sind und ob die arm64-Pakete für die aktuelle Version bereitstehen, steht nicht fest: nicht getestet – vor dem Einsatz beim TCMSOFT-Support nachfragen. Die Prüfung unter „Internetzugang“ zeigt, ob ein Paket bereitliegt.

Arbeitsspeicher

Mindestens 4 GB. Empfängt die Praxis DICOM-Bilder, planen Sie mehr ein. Einen festen Wert dafür gibt es nicht.

Speicherplatz

Rechnen Sie mit mindestens 15 GB freiem Platz. Dazu kommen die Bilder und Dokumente der Praxis und der Platz für die Sicherung während eines Updates.

Sicherung vor einem Update: Der Update-Dienst kopiert den Datenbankordner vor jedem Update nach vor-update/. Vorher prüft er mit einer kleinen Probedatei, ob das Dateisystem Dateien ohne Kopie klonen kann (Reflink). Das kann Btrfs (Standard bei Synology), XFS nur, wenn es mit Reflink-Unterstützung angelegt ist. Dann kostet die Sicherung keinen zusätzlichen Platz. Sonst muss mindestens so viel frei sein: Größe der Datenbank plus 10 % plus 2 GB Reserve. Fehlt der Platz, verschiebt der Dienst das Update und meldet „Update auf Version … verschoben“. Er versucht es dann jede Nacht erneut.

So prüfen Sie den Platz per SSH:

df -h <Datenordner>

Bei einer bestehenden Installation zeigt dieser Befehl die Größe der Datenbank:

du -sh <Datenordner>/mongodb

Datenordner

Der Datenordner muss lokal auf dem Gerät liegen und beschreibbar sein. Nicht geeignet ist ein schreibgeschützter Ordner oder ein Ordner, der per NFS oder SMB mit root_squash eingebunden ist. TCMSOFT bricht dann beim Start ab und meldet „Der Datenordner /data ist nicht beschreibbar. Bitte den eingebundenen Ordner prüfen (Schreibrechte; kein schreibgeschützter oder per NFS/SMB mit root_squash eingebundener Ordner).“

Übliche Pfade: /volume1/docker/tcmsoft (Synology), /mnt/data/docker/tcmsoft (UGREEN), /var/lib/tcmsoft (Mikroserver). Einzelheiten unter Datenordner und tcmsoft.env.

Netz

Feste Adresse des Servers

Geben Sie dem Server eine feste IP-Adresse oder einen festen Namen im Praxisnetz. Diese Adresse tragen mehrere Stellen ein: die Arbeitsplätze im Browser, die Prismamed Agents, die Handys unter Adresse für Handys und die DICOM-Geräte. Auch die Kopplung der Print Agents hängt an ihr. Ändert sich die Adresse oder der Port später, müssen alle diese Stellen angepasst und die Print Agents neu gekoppelt werden.

Freie Ports auf dem Server

TCMSOFT läuft im Host-Netz und teilt sich die Ports mit dem Gerät. Diese Ports müssen auf dem Gerät frei sein:

Auf einer Synology belegt das System die Ports 5000 und 5001. Deshalb nutzt TCMSOFT standardmäßig 8085. Belegte Ports meldet TCMSOFT beim Start im Protokoll, mit Handlungshinweis. Wie Sie tcmsoft.env ändern und die Änderung wirksam machen, steht unter Datenordner und tcmsoft.env.

Firewall im Praxisnetz

Läuft auf dem Server eine Firewall, müssen aus dem Praxisnetz erreichbar sein:

• der Web-Port 8085 bzw. der HTTPS-Port des Reverse-Proxys,
• Port 11112, falls DICOM-Geräte Bilder senden.

Für die automatische Druckersuche müssen Drucker und Server im selben Netz liegen, denn sie arbeitet mit Bonjour-Meldungen (mDNS, UDP 5353, Multicast). Alle Ports und Verbindungen stehen unter Aufbau von TCMSOFT.

Internetzugang

Der Server braucht ausgehenden Zugang über HTTPS (Port 443) zu:

• downloads.tcmsoft.de: Updates von TCMSOFT und vom Update-Dienst
• data.tcmsoft.cloud: TCM-Bibliothek
• verwaltung.tcmsoft.cloud: Drucklayouts und Laborparameter-Katalog
• pharmindex.tcmsoft.cloud: Arzneimittel-Suchindex und Angaben zu Arzneimitteln
• webservice.padline.de: Zertifikat der PAD-Abrechnungsstelle zum Verschlüsseln der PAD-Datei, falls genutzt
• <Domainname>.arzttermin-buchen.de: Online-Termine, falls eingerichtet
• die Adresse aus der Karte Billsphere (Stammdaten › Betriebsstätte): Abgleich der Patienten, falls eingerichtet

Dazu kommt der SMTP-Server des E-Mail-Kontos der Praxis.

Die Arbeitsplätze brauchen Zugang zu downloads.tcmsoft.de (Port 443) für die Updates der Agenten und zu pharmindex.tcmsoft.cloud für die Symbole in der Arzneimittelliste.

So prüfen Sie den Zugang per SSH auf dem Server. Für <Arch> setzen Sie x64 oder arm64 ein:

curl -sS -o /dev/null -w "%{http_code}\n" https://downloads.tcmsoft.de/docker/tcmsoft-<Arch>.json

• Erfolg: 200.
• Bei 404 gibt es für diese Architektur kein Paket. Fragen Sie beim TCMSOFT-Support nach.
• Bei 000 und einer Fehlermeldung erreicht der Server downloads.tcmsoft.de nicht. Prüfen Sie Internetzugang, DNS und Firewall.

Hinweis: Einen Betrieb des Servers hinter einem HTTP-Proxy beschreibt TCMSOFT nicht. Der Update-Dienst gibt bei seinem Selbst-Update nur seine eigenen Einstellungen weiter, Proxy-Einstellungen gehören nicht dazu. Nicht getestet – vor dem Einsatz beim TCMSOFT-Support nachfragen.

Ohne Internet lässt sich TCMSOFT auch vom USB-Stick einrichten, siehe TCMSOFT einrichten. Updates holt der Update-Dienst erst, wenn der Server ins Internet kommt. Auch die TCM-Bibliothek lädt TCMSOFT aus dem Internet (data.tcmsoft.cloud).

HTTPS

HTTPS ist empfohlen. Für Agent suchen (Kopplung eines Print Agent über den Browser) ist es nötig: Chrome und Edge erlauben das nur, wenn TCMSOFT über HTTPS aufgerufen wird. Nur am Rechner, auf dem TCMSOFT selbst läuft, genügt http://localhost. Die Kopplung per Code (Stammdaten › Drucker › Arbeitsplatz koppeln) geht auch über http://.

• TCMSOFT selbst spricht nur HTTP. HTTPS übernimmt der Reverse-Proxy der NAS, auf dem Mikroserver Caddy.
• Der Reverse-Proxy muss WebSocket-Verbindungen durchlassen. Sonst arbeitet TCMSOFT spürbar langsamer.
• Das Zertifikat muss für genau die Adresse gelten, unter der die Arbeitsplätze TCMSOFT öffnen. Windows und macOS müssen ihm vertrauen. Zeigt der Browser eine Zertifikatswarnung, verbindet sich auch ein Print Agent nicht, der mit dieser https://-Adresse gekoppelt ist.
• Auf dem Mikroserver steht Caddy vor TCMSOFT. Ob die vorhandene Caddy-Konfiguration HTTPS ausliefert, prüfen Sie vor der Umstellung.
• Die Zeile Server__SichereCookies=true in tcmsoft.env schalten Sie erst ein, wenn HTTPS läuft. Sonst springt die Anmeldung immer wieder zur Anmeldeseite zurück.

Einrichtung: Netzwerk und HTTPS.

Drucker

• Empfohlen ist das Drucken über die Arbeitsplätze: Drucker in Windows bzw. macOS mit dem Treiber des Herstellers einrichten, dort den Print Agent installieren und per Code koppeln (siehe Print Agent). Die folgenden Punkte gelten für den Print Agent im Container.
• Netzwerkdrucker findet TCMSOFT selbst, wenn am Drucker Bonjour bzw. AirPrint (mDNS) eingeschaltet ist und er im selben Netz wie der Server steht. Die Suche dauert bis zu 30 Sekunden.
• Drucker ohne Bonjour richten Sie mit ihrer Adresse ein, z. B. ipp://192.168.1.50/ipp/print oder socket://192.168.1.50:9100.
• Drucker, die nur an einem Arbeitsplatz eingerichtet sind, etwa per USB, erreicht TCMSOFT über den Print Agent dieses Arbeitsplatzes.
• Eigene Druckertreiber für 32-Bit-Intel (i386, so liefert Brother seine Linux-Treiber) laufen nur auf einem Server mit Intel- oder AMD-Prozessor.

Browser

Gearbeitet wird im Browser. Für die tägliche Arbeit muss an den Arbeitsplätzen nichts installiert werden.

• Eine verbindliche Liste unterstützter Browser gibt es nicht. Beschrieben sind Google Chrome und Microsoft Edge, und zwar für Agent suchen (Kopplung des Print Agent).
• Bei Agent suchen fragen Chrome und Edge beim ersten Mal nach dem Zugriff auf Geräte im lokalen Netzwerk. Wählen Sie Zulassen.
• In Safari ist Agent suchen noch nicht in jedem Fall geprüft. Klappt es dort nicht, nehmen Sie am Mac Chrome oder Edge.
• Andere Browser und Tablets: nicht getestet – vor dem Einsatz beim TCMSOFT-Support nachfragen.

Arbeitsplätze

Agenten brauchen Sie nur an Arbeitsplätzen, die Drucker, Messgeräte, Labordateien oder Scanner an TCMSOFT anbinden.

Zu Windows: Der Prismamed Agent ist in seinem Programm-Manifest für Windows 10 und 11 gekennzeichnet, beim Print Agent steht dazu nichts fest. Eine genauere Mindestversion ist für keinen der beiden festgelegt. Ältere Windows-Versionen und Windows auf ARM-Prozessoren sind nicht getestet. Für beide Agenten gibt es unter Windows nur eine x64-Fassung.

Weitere Punkte:

• Beide Agenten starten mit der Anmeldung des Benutzers. Den Print Agent als Windows-Dienst zu betreiben, wird nicht unterstützt.
• Am Mac fragt macOS nach dem Zugriff auf das lokale Netzwerk. Wählen Sie Erlauben, sonst erreicht der Agent TCMSOFT nicht.
• Ein Mac im Ruhezustand ist offline. Ein Mac, über den andere drucken, darf nicht schlafen.
• Für mehrere Benutzerkonten und Terminalserver gelten Grenzen. Sie stehen unter Prismamed Agent und Print Agent, jeweils im Abschnitt zu mehreren Benutzerkonten und Terminalservern.

Handys mit der Companion-App

• Android 8.0 oder neuer, iPhone mit iOS 16.4 oder neuer.
• Das Handy braucht eine Displaysperre.
• Das Handy ist im selben WLAN wie TCMSOFT und erreicht dort den Web-Port bzw. die HTTPS-Adresse.
• Die App heißt „TCMSOFT Companion“ (Anbieter Prismamed GmbH, kostenlos) und kommt aus dem App Store bzw. von Google Play.
• Die Companion-App gehört ab TCMSOFTsingle Unlimited dazu.

DICOM-Geräte

• DICOM gehört zu TCMSOFTpro.
• Das Gerät erreicht den Server auf Port 11112 (oder dem unter Stammdaten › DICOM eingestellten Port).
• Das Gerät hat einen eigenen AE-Title mit 1 bis 16 Zeichen. Ohne ihn liefert TCMSOFT keine Worklist.
• Ein einzelnes DICOM-Objekt darf standardmäßig bis zu 500 MB groß sein.
• Planen Sie auf dem Server mehr Arbeitsspeicher und Platz für die Bilder ein.

Einrichtung: DICOM-Geräte und Mobilgeräte.

Weiter

• Docker installieren
• TCMSOFT einrichten
• Netzwerk und HTTPS