Servermanagement

Das Servermanagement ist ein versteckter Bereich von TCMSOFT für den TCMSOFT-Support und öffnet sich nur mit dem Support-Konto. Dort stellen Sie die Edition der Praxis ein (nur TCMSOFT), lesen das Programmprotokoll, starten die Datenübernahme und richten im Notfall die Datenbank neu ein. Für die Arbeit der Praxis ist es nicht gedacht und erscheint deshalb nicht im Menü.

Diese Seite gilt für TCMSOFT 2026.10.9.1.

Achtung: Datenbank neu initialisieren, Demodaten installieren und die Datenübernahme löschen alle Daten der Praxis, ohne vorher zu sichern. Arbeiten Sie hier nur mit ausdrücklichem Einverständnis der Praxis und nach einer Sicherung.

Die Zugangsdaten des Support-Kontos erhalten Sie beim TCMSOFT-Support. Geben Sie sie nie an die Praxis oder Dritte weiter und notieren Sie sie nicht in der Praxis. Einen eigenen Code für das Servermanagement gibt es nicht mehr.

Aufrufen

1. Melden Sie sich in TCMSOFT mit dem Support-Konto an.

2. Rufen Sie im selben Browser die Adresse von TCMSOFT mit /servermanagement am Ende auf (ohne HTTPS z. B. http://<Server-Adresse>:8085/servermanagement). Einen Menüpunkt dafür gibt es nicht.

   https://<Adresse von TCMSOFT>/servermanagement
   

Erfolg: Die Seite zeigt die Reiter System, Logs und Datenübernahme.

Wenn nicht:

• Es erscheint die Karte „Nur für den TCMSOFT-Support“ mit „Das Servermanagement nutzt nur der TCMSOFT-Support mit seinem Support-Konto …“: Sie sind mit einem anderen Konto angemeldet. Melden Sie sich ab und mit dem Support-Konto an.
• Statt der Seite erscheint die Anmeldung: Sie sind nicht angemeldet. Melden Sie sich mit dem Support-Konto an; danach öffnet sich das Servermanagement von selbst.
• Die Anmeldung mit dem Support-Konto scheitert mit derselben Meldung wie bei einem falschen Passwort: Meist hat die Praxis den Supportzugriff gesperrt. Sie gibt ihn unter Stammdaten › Betriebsstätte, Karte Support, frei, siehe Support-Konto und Supportzugriff.

Wieder hinaus: Die Seite hat keine Navigationsleiste. Rufen Sie die Adresse /dashboard auf oder gehen Sie im Browser zurück. Unter der Karte „Nur für den TCMSOFT-Support“ steht dafür der Knopf Zurück zu TCMSOFT.

Edition an der Versionsnummer erkennen (oben in der Navigationsleiste unter „TCMSOFT“):

In Salvia Software steht dort „Salvia“; die Zusätze sind dieselben und stehen für Salvia Single, Salvia Single Unlimited und Salvia Pro.

Wer das Servermanagement nutzen kann

• Nur das Support-Konto. Alle anderen Konten, auch Ärzte mit allen Rechten, sehen die Karte „Nur für den TCMSOFT-Support“. Ein Recht unter Stammdaten › Rollen gibt es dafür nicht.
• Hat die Praxis den Supportzugriff gesperrt, ist das Servermanagement nicht erreichbar, bis sie ihn freigibt. TCMSOFT prüft das vor jeder Aktion und nach jeder Rückfrage erneut. Sperrt die Praxis, während die Seite offen ist, bricht die Aktion mit „Nur für den TCMSOFT-Support“ – „Die Praxis hat den Support-Zugriff gesperrt. …“ ab.
• Auch Installateure brauchen für das Servermanagement das Support-Konto. Das Programmprotokoll lesen sie ohne Support-Konto per SSH auf dem Server, siehe Reiter „Logs“.

Diese Aktionen stehen im Programmprotokoll: Neu initialisieren, Demodaten, Edition, Neustart und Ausschalten hinterlassen je eine Warnung mit dem Namen des Kontos, also „Prismamed Support“. Welche Person gehandelt hat, zeigt das Protokoll nicht.

Reiter „System“

Der Reiter hat die Karten Datenbank, Edition (in Salvia Software davor die Karte Produkt) und Systeminformation. Läuft TCMSOFT direkt auf einem Linux-Server statt im Container, kommt die Karte System dazu. Eine Karte für die Praxisart gibt es nicht: Sie folgt dem Produkt, siehe Produkt und Praxisart.

Karte „Datenbank“

Wozu: Die Karte setzt die Datenbank dieser Praxis auf den Zustand einer Neuinstallation zurück.

Rückfrage: „Datenbank wirklich initialisieren?“ bzw. „Demodaten installieren?“, beide mit dem Hinweis „Das löscht sämtliche Daten dieser Praxis, auch alle Anmeldekonten …“. Lesen Sie die Überschrift, bevor Sie bestätigen.

Vorher:

1. Klären Sie mit der Praxis, dass sie die Daten in dieser Installation wirklich verwerfen will.
2. Legen Sie eine Sicherung an: Stammdaten › Backup, Download Backup. Siehe Datensicherung und Umzug.
3. Prüfen Sie, als welches Produkt die Datenbank neu entsteht: docker exec tcmsoft printenv Produkt, siehe „Welches Produkt danach gilt“.

Vor einer Datenübernahme müssen Sie nicht neu initialisieren. Die Übernahme leert die Datenbank selbst.

Was gelöscht wird: alle Collections der Datenbank patient. Dazu gehören Patienten, Akten mit Dateien, Rechnungen, Termine, Stammdaten, alle Anmeldekonten, das Änderungsprotokoll, das Programmprotokoll (Reiter Logs), die Nachrichten der Glocke, gekoppelte Prismamed Agents und Mobilgeräte und frühere Datenübernahmen. Wollen Sie einen Fehler untersuchen, lesen Sie das Protokoll vorher.

Was neu angelegt wird: Rollen, das Support-Konto (aktiv), ein leeres E-Mail-Konto „Email“, eine Rechnungsvorlage, der Platzhalter-Arzt „Dr. Hans Muster“, die Platzhalter-Praxis „Praxis Dr. Muster“, die Termingruppe „Standard“, Dokumentationstypen, Vertragsarten, der Behandlungsvertrag, ICD- und GOÄ-Katalog und Krankenkassen. In einer Praxis verwenden Sie immer Datenbank neu initialisieren, nie die Demodaten – sie bringen erfundene Patienten mit.

Welches Produkt danach gilt: Steht in tcmsoft.env die Zeile Produkt=Salvia oder Produkt=TCMSOFT, legt TCMSOFT die neue Datenbank gleich als dieses Produkt an. Ohne die Zeile bleibt das bisherige Produkt. Es zählt die Zeile, mit der der Container angelegt wurde (siehe „Vorher“, Schritt 3).

• TCMSOFT: Die Praxis ist danach eine ärztliche Praxis (GOÄ).
• Salvia Software: TCMSOFT richtet gleich danach die Heilpraktiker-Praxis ein, ohne Neustart: Vorlage „GebüH Rechnung“, Katalog „GebüH“, „Hans Muster“ und „Naturheilpraxis Muster“, „Bescheinigung“ und „Arzneimittelempfehlung“, Muster-Behandlungsvertrag, leere E-Mail-Adresse der Betriebsstätte. Einzelheiten unter Produkt und Praxisart.

Nach der Praxisart wird in keinem der beiden Produkte gefragt.

Zum anderen Produkt wechseln (nur, wenn die Daten verloren gehen dürfen): So kommt eine Arztpraxis zurück, die versehentlich als Salvia Software eingerichtet wurde. Auf demselben Weg wird eine TCMSOFT-Installation, in der schon etwas erfasst ist, zu Salvia Software.

1. In <Datenordner>/tcmsoft.env die Zeile auf Produkt=TCMSOFT (zurück zu TCMSOFT) bzw. Produkt=Salvia ändern.
2. Den Container neu anlegen lassen (docker rm -f tcmsoft, der Update-Dienst legt ihn neu an), siehe Einstellungen wirksam machen. Das Produkt ändert sich dadurch noch nicht.
3. Hier Datenbank neu initialisieren, mit Einverständnis der Praxis und nach einer Sicherung (siehe „Vorher“).

Wechselt das Produkt dabei, zeigen die Anmeldeseite und die Mails der Anmeldung sofort Name und Bildmarke des neuen Produkts. Andere geöffnete Fenster zeigen es nach dem Neuladen (F5).

Erfolg:

• Datenbank neu initialisieren: „Initialisierung der Datenbank erfolgreich abgeschlossen.“
• Demodaten installieren: „Demodaten installiert“ – „Die Datenbank ist neu eingerichtet und enthält erfundene Beispielpatienten.“
• Im Programmprotokoll steht zuerst „Servermanagement: Datenbank neu initialisiert von …“ bzw. „Servermanagement: Demodaten installiert von …“ mit dem Namen des Kontos. In Salvia Software folgen unter anderem „Praxisart von Arzt auf Heilpraktiker gestellt von …“ und zuletzt „Datenbank neu angelegt als Salvia Software (Heilpraktiker-Praxis).“
• In Salvia Software sind „Bescheinigung“, „Arzneimittelempfehlung“, der Katalog „GebüH“ und die übrige Einrichtung sofort da, ohne Neustart.

Fehler: „Fehler beim Initialisieren der Datenbank.“ bzw. „Fehler beim Installieren der Demodaten.“ mit dem Grund. Lesen Sie das Protokoll, siehe Reiter „Logs“.

In Salvia Software kann nach dem Leeren die Einrichtung der Heilpraktiker-Praxis scheitern. Dann erscheint statt der Erfolgsmeldung „Die Datenbank ist neu angelegt, die Heilpraktiker-Praxis von Salvia Software ließ sich aber nicht einrichten. Führen Sie „Datenbank neu initialisieren“ bzw. „Demodaten installieren“ noch einmal aus.“ mit dem Grund. Die Daten sind dann schon gelöscht, der zweite Lauf verliert also nichts weiter. Scheitert auch er, geben Sie docker logs tcmsoft an den TCMSOFT-Support.

Gesperrt während einer Datenübernahme. Dann erscheint „Datenübernahme läuft“ – „Während der Übernahme aus dem bisherigen TCMSOFT lässt sich die Datenbank nicht neu herstellen. …“.

Danach:

1. Edition neu setzen. Die Edition steht wieder auf TCMSOFTsingle (in Salvia Software auf Salvia Single), die Karte Edition zeigt das sofort. Stellen Sie die gekaufte Edition ein, siehe Karte „Edition“.
2. Erstes Konto: Die Anmeldeseite zeigt wieder „Noch kein Konto eingerichtet“ mit Zur Ersteinrichtung. Oder Sie legen das Konto mit dem Support-Konto unter Stammdaten › Leistungserbringer, Karte Login, an. Siehe Ersteinrichtung der Praxis.
3. Neu koppeln: Prismamed Agents und Mobilgeräte neu koppeln. Ob auch die Print Agents neu gekoppelt werden müssen, ist nicht geprüft. Kontrollieren Sie Stammdaten › Drucker.
4. Patienten-Codes: Das Geheimnis für die Patienten-Codes der Handy-App entsteht beim nächsten Start von TCMSOFT neu. Schon gedruckte Patienten-Codes passen danach nicht mehr.
5. Supportzugriff: Das Support-Konto ist aktiv. Bitten Sie die Praxis, den Supportzugriff zu sperren, siehe Support-Konto und Supportzugriff.

Karte „Edition“

Nur in TCMSOFT. In Salvia Software steht an ihrer Stelle die Karte „Produkt“.

Wozu: Hier stufen Sie die Praxis hoch oder herab, zum Beispiel nach einem Kauf oder einer Kündigung. Einen Lizenzschlüssel gibt es nicht. Die Edition ist eine Einstellung der Installation und lässt sich nur hier ändern; auch Backup wiederherstellen ändert sie nicht. Nach einem Umzug per Sicherung stellen Sie hier die bisherige Edition ein (siehe Datensicherung und Umzug).

Die drei Editionen: TCMSOFTsingle, TCMSOFTsingle Unlimited und TCMSOFTpro. Eine höhere Edition enthält alle Funktionen der niedrigeren.

In TCMSOFTsingle lassen sich höchstens 200 Patienten anlegen. Gesperrte Patienten zählen nicht mit. Eigene Formulare gibt es in jeder Edition: in TCMSOFTsingle bis zu 3, in TCMSOFTsingle Unlimited bis zu 6 (gezählt werden alle nicht gelöschten Formulare, auch abgeschaltete). Was die Praxis selbst sieht, beschreibt das Benutzerhandbuch unter „Erste Schritte › Editionen“.

In Salvia Software heißen die Editionen Salvia Single, Salvia Single Unlimited und Salvia Pro, mit denselben Funktionen und Grenzen. Auswahl, Rückfrage und Meldungen nennen dort diese Namen.

So ändern Sie die Edition:

1. Unter Aktuelle Edition steht die heutige Edition.
2. Wählen Sie unter Neue Edition die gewünschte Edition.
3. Klicken Sie auf Edition ändern. Der Knopf ist grau, solange beide Editionen gleich sind.
4. Lesen Sie die Rückfrage „Edition auf … ändern?“. Sie nennt, was dazukommt („Neu verfügbar: …“) und was wegfällt („Nicht mehr verfügbar: … Vorhandene Daten bleiben erhalten und lesbar, neu anlegen lässt sich dort nichts mehr.“). Hat die Praxis 200 oder mehr Patienten bzw. mindestens so viele eigene Formulare, wie die neue Edition erlaubt, steht auch das darin („… die vorhandenen bleiben nutzbar“).
5. Bestätigen Sie.

Erfolg:

• Die Meldung „Edition geändert“ – „Die Praxis läuft jetzt als …. Andere geöffnete TCMSOFT-Fenster bitte neu laden (F5).“ erscheint.
• Zurück in TCMSOFT (Adresse /dashboard) zeigt die Versionsnummer oben in der Navigationsleiste unter „TCMSOFT“ die neue Endung.
• Im Programmprotokoll steht die Warnung „Servermanagement: Edition von … auf … geändert von …“ mit dem Namen des Kontos.

Die Änderung gilt sofort in diesem Fenster. Andere geöffnete Fenster zeigen Menü und Funktionen erst nach dem Neuladen (F5) richtig.

Wenn nicht:

• Statt der Auswahl steht „Die Betriebsstätte konnte nicht gelesen werden - die Edition lässt sich erst nach der Ersteinrichtung ändern.“: TCMSOFT hat noch keine Betriebsstätte. Erst einrichten, dann die Edition setzen.
• „Fehler beim Ändern der Edition.“ mit dem Grund: Protokoll lesen.
• Während einer Datenübernahme ist der Wechsel gesperrt („Datenübernahme läuft“).

Beim Herabstufen: Daten bleiben erhalten und lesbar. Seiten der weggefallenen Funktionen verschwinden aus dem Menü; ruft jemand sie direkt auf, erklärt ein Hinweis die Edition. Vorhandene Konten löscht TCMSOFT nicht. Nach dem Stand des Programmcodes sperrt das Herabstufen auch keine Anmeldung, es blendet nur die Verwaltungsseiten aus (nicht getestet). Gekoppelte Handys werden ohne passende Edition abgewiesen.

Sonderfälle:

• Eine Datenübernahme setzt immer TCMSOFTpro.
• Datenbank neu initialisieren und Demodaten installieren setzen auf TCMSOFTsingle zurück.

Karte „Produkt“

Nur in Salvia Software, vor der Karte Edition.

Wozu: Die Karte zeigt, welches Produkt diese Installation ist: „Salvia Software“ mit dem Zusatz „Heilpraktiker-Praxis“. Einstellen lässt sich hier nichts: Salvia Software ist immer eine Heilpraktiker-Praxis mit Abrechnung nach GebüH, die Praxisart lässt sich deshalb nicht ändern. Die Edition stellen Sie wie in TCMSOFT in der Karte „Edition“ ein.

Festgelegt wird das Produkt bei der Einrichtung, mit der Zeile Produkt=Salvia in tcmsoft.env vor dem ersten Start. In TCMSOFT gibt es die Karte nicht; dort ist die Praxis immer eine ärztliche Praxis. Wie das Produkt entsteht, was Salvia Software dabei einrichtet und was zu tun ist, wenn die Zeile vergessen wurde, steht unter Produkt und Praxisart.

Wurde eine Arztpraxis versehentlich als Salvia Software eingerichtet, führt der Rückweg über die Zeile Produkt=TCMSOFT und Datenbank neu initialisieren. Das löscht alle Daten, siehe „Zum anderen Produkt wechseln“ unter Karte „Datenbank“.

Karte „Systeminformation“

Die Karte zeigt Betriebssystem, Arbeitsspeicher und Festplatten. Im Container sieht TCMSOFT den Rechner aus dem Container heraus. Die Angaben sind deshalb nur ein grober Anhalt (nicht getestet). Den freien Platz des Datenordners prüfen Sie zuverlässig auf dem Server:

df -h <Datenordner>

Karte „System“

Die Karte gibt es nur, wenn TCMSOFT direkt auf einem Linux-Server läuft. Im Container fehlt sie, denn TCMSOFT läuft dort als eigener, eingeschränkter Benutzer und darf den Server weder neu starten noch ausschalten.

Die Knöpfe Neustart und Ausschalten rufen shutdown -r now bzw. shutdown -h now mit sudo auf. Beide fragen vorher nach („Server neu starten?“ bzw. „Server ausschalten?“) und hinterlassen eine Warnung im Programmprotokoll. Nach Ausschalten läuft der Server erst wieder, wenn ihn jemand vor Ort einschaltet. Darf TCMSOFT shutdown nicht ohne Passwort aufrufen, erscheint „Befehl konnte nicht ausgeführt werden.“ mit dem Hinweis „Der Server ließ sich nicht neu starten. …“ bzw. „… nicht ausschalten. …“, und der Server läuft weiter.

Im Container und wenn der Befehl scheitert:

• TCMSOFT neu starten, per SSH auf dem Server:

  docker restart tcmsoft
  

• Den Server selbst starten Sie über die Verwaltung der NAS bzw. des Servers neu oder schalten ihn dort aus.

Reiter „Logs“

Wozu: Der Reiter zeigt das Programmprotokoll von TCMSOFT, etwa bei Fehlern der Datenübernahme. Deren Meldungen verweisen auf „Server / Logs“.

Was Sie sehen: die Einträge der letzten 30 Tage mit Datum, Uhrzeit, Level und Meldung, 100 je Seite. Oben rechts steht ein Suchfeld. Die Liste wird beim Öffnen der Seite geladen. Für neue Einträge laden Sie die Seite neu (F5).

Das Protokoll steht in der Datenbank der Praxis (patient). TCMSOFT löscht Einträge nach 90 Tagen, Debug-Einträge nach 7 Tagen. Datenbank neu initialisieren, Demodaten installieren und die Datenübernahme löschen es mit, Backup wiederherstellen ersetzt es durch den Stand der Sicherung. TCMSOFT bis 2026.10.7.1 schrieb es in die Datenbank tcmsoft; diese alten Einträge zeigt der Reiter nicht.

Auf dem Server: TCMSOFT schreibt jeden Eintrag zusätzlich auf die Konsole. Dort stehen auch Einträge, die beim Leeren der Datenbank verloren gingen, bis der Container neu angelegt wird (bei jedem Update). Lesen Sie das Protokoll per SSH auf dem Server:

docker logs tcmsoft

Weitere Protokolle und ihre Fundorte stehen unter Protokolle und Diagnose.

Reiter „Datenübernahme“

Hier übernehmen Sie die Daten aus dem bisherigen TCMSOFT. Wie die ganze Seite funktioniert der Reiter nur mit dem Support-Konto. Ablauf, Voraussetzungen und Fehler beschreibt die Seite Datenübernahme aus dem bisherigen TCMSOFT.

In Salvia Software ist die Datenübernahme gesperrt. Der Reiter zeigt dort nur die Karte „Keine Datenübernahme in Salvia Software“.

Datenverlust im Überblick

Eine Sicherung spielen Sie unter Stammdaten › Backup mit Backup wiederherstellen zurück, siehe Datensicherung und Umzug.