Updates der Agenten

Der Prismamed Agent (Geräte, Labor, Scans) und der Prismamed Print Agent aktualisieren sich an den Arbeitsplätzen selbst, unter Windows und am Mac. Beide nutzen dafür denselben Mechanismus (Velopack mit signierten Update-Listen). Diese Seite beschreibt, woher die Updates kommen, wann sie eingespielt werden, woran man den Stand erkennt und wie man Updates für eine Praxis anhält.

Der Print Agent im TCMSOFT-Container aktualisiert sich nicht selbst. Er kommt mit jedem Update von TCMSOFT neu, siehe Updates von TCMSOFT.

Woher die Updates kommen

Jeder Agent hat je Plattform einen eigenen Update-Kanal auf downloads.tcmsoft.de. Der Kanal richtet sich nach dem Prozessor, für den das laufende Programm gebaut ist. Ein Intel-Agent, der unter Rosetta auf einem Mac mit Apple-Chip läuft, bleibt also auf dem Intel-Kanal.

• In jedem Update-Ordner liegt die Update-Liste releases.<Kanal>.json mit ihrer Signatur releases.<Kanal>.json.sig.
• Die Download-Ordner zeigen keine Verzeichnisliste. Geben Sie deshalb immer die Datei selbst weiter, nie den Ordner.
• Aktuelle Versionen: Prismamed Agent 2026.11.201, Print Agent 2026.10.10.1 (im Feed und in TCMSOFT als 2026.10.1001).

Signatur: Die Update-Liste ist mit dem Schlüssel des Herstellers signiert. Ein Agent spielt nur Updates ein, wenn die Signatur stimmt, jedes Paket eine SHA256-Prüfsumme hat und das Paket zu ihm selbst gehört. Eine Liste, die älter ist als die zuletzt angenommene, lehnt er ab.

Was der Arbeitsplatz braucht

• Netz: Der Arbeitsplatz erreicht https://downloads.tcmsoft.de über Port 443. Geben Sie diese Adresse in Firewall bzw. Proxy frei.
• Proxy: Unter Windows nutzt das Selbst-Update die Proxy-Einstellungen von Windows. Am Mac ist das nicht dokumentiert und nicht getestet – vor dem Einsatz hinter einem Proxy beim TCMSOFT-Support nachfragen.
• Windows: Der Agent ist mit dem Setup installiert, im Windows-Konto, mit dem gearbeitet wird. Die Verknüpfung im Autostart ist vorhanden.
• Mac: Das Benutzerkonto darf das Programm ändern. Das ist der Fall, wenn dieses Konto es selbst nach „Programme“ (oder in einen eigenen Ordner ~/Applications) gezogen hat. Ein anderes Konto, auch ein Administrator, darf es nicht.
• Speicherplatz im Benutzerprofil für das geladene Paket.

Ist downloads.tcmsoft.de gesperrt, arbeitet der Agent normal weiter. Er bekommt nur keine Updates, und in TCMSOFT erscheint ein Hinweis (siehe unten).

Wann geprüft und geladen wird

• Die erste Prüfung kommt zufällig 5 bis 60 Minuten nach dem Start. So laden nicht alle Rechner der Praxis gleichzeitig.
• Danach prüft der Agent alle 6 Stunden (plus bis zu 30 Minuten), nach einem Fehler nach 30 bis 40 Minuten.
• Eine neue Version lädt er still im Hintergrund. Das Laden darf höchstens 45 Minuten dauern.

Wann eingespielt wird

Eine geladene Version spielt der Agent ein:

• beim nächsten Start des Agenten, bevor er mit der Arbeit beginnt,
• abends und nachts zwischen 20 und 6 Uhr, wenn er 15 Minuten lang nichts zu tun hatte,
• sofort über Jetzt aktualisieren (Neustart, ca. 10 Sekunden) im Menü des Agenten.

Nie mitten in der Arbeit. Läuft gerade eine Datei, ein Auftrag oder ein Druckauftrag, wartet das Update. Wurde Jetzt aktualisieren (Neustart, ca. 10 Sekunden) gewählt, steht im Menü so lange „Update wartet auf den laufenden Auftrag“ bzw. beim Print Agent „Update wartet auf den laufenden Druckauftrag“.

Was in den Sekunden des Einspielens geschieht:

Das Einspielen dauert etwa 10 Sekunden. Velopack ersetzt das Programm und startet den Agenten neu, am Mac das Programm an Ort und Stelle. Hängt das Beenden, beendet sich der Agent nach 30 Sekunden hart. Nach dem Neustart prüft er, ob die erwartete Version läuft, und meldet „Aktualisiert auf Version …“.

„Jetzt aktualisieren“ und „Nach Updates suchen“

Beide Punkte stehen im Menü des Agenten (Windows: Rechtsklick auf das Symbol im Infobereich; Mac: Klick auf das Symbol in der Menüleiste). Sie erscheinen nur, wenn sich der Agent selbst aktualisiert.

Die Zeile darüber zeigt den Stand, z. B.:

• „Suche nach Updates …“
• „Update 2026.10.701 wird geladen …“
• „Update 2026.10.701 ist bereit“
• „Aktualisiert auf Version 2026.10.701“
• „Aktuell: Version 2026.10.701“
• „Update gerade nicht möglich - der Agent arbeitet normal“ (Print Agent: „… - der Agent druckt normal“)
• unter Windows bei fehlender Autostart-Verknüpfung: „Autostart fehlt - Setup aus TCMSOFT (Stammdaten › Agenten) erneut ausführen“ (Print Agent: „… (Stammdaten › Drucker) …“)

Die ausführliche Meldung steht im Protokoll des Agenten und in TCMSOFT.

Den Stand in TCMSOFT prüfen

Prismamed Agent: Stammdaten › Agenten

In der Spalte Version:

Beim Daraufzeigen erscheint der Text. Klappen Sie die Zeile auf, steht er in einer gelben Karte. Bei „veraltet“ lautet er je nach Fall:

• „Aktuell ist 2026.10.701. Der Agent aktualisiert sich selbst - abends, beim nächsten Start oder per „Jetzt aktualisieren“ im Agenten.“ – Nichts zu tun; sofort geht es mit Jetzt aktualisieren (Neustart, ca. 10 Sekunden) im Menü des Agenten.
• „Aktuell ist 2026.10.701. Bei diesem Agenten ist das Selbst-Update abgeschaltet oder er wurde nicht mit dem Setup installiert. …“ – Neue Version mit dem Setup einspielen.
• Am Mac: „Aktuell ist 2026.10.701. 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 - danach kommen Updates von selbst.“

Nach einem Update von TCMSOFT, das eine neuere Agent-Version mitbringt, stehen die Agenten bis zum abendlichen Einspielen als „veraltet“ da. Das ist normal. Bleibt „veraltet“ länger als einen Tag stehen, obwohl sich der Agent selbst aktualisiert, den TCMSOFT-Support informieren.

Print Agent: Stammdaten › Drucker

In der Karte Agent steht bei Version „2026.10.701 – aktualisiert sich selbst“ oder „… – aktualisiert sich nicht selbst“. Ist am Arbeitsplatz etwas zu tun, steht darunter ein gelber Hinweis. Eine Anzeige „veraltet“ gibt es beim Print Agent nicht.

Die Hinweise und was zu tun ist

Wenn das Einspielen scheitert

• Scheitert das Einspielen einer Version, versucht der Agent dieselbe Version erst nach 24 Stunden automatisch wieder, auch nicht bei jedem Start. Jetzt aktualisieren (Neustart, ca. 10 Sekunden) versucht es sofort.
• Startwächter: Scheitert eine Version zweimal beim Start (sie läuft keine 3 Minuten und wurde nicht normal beendet), holt der dritte Start zuerst eine neuere Version aus dem Update-Ordner, bevor der Agent loslegt.
• Ein Agent geht nie auf eine ältere Version zurück. Eine fehlerhafte Version wird mit einer neueren korrigierten Version ersetzt.

Notbremse: Updates in einer Praxis anhalten

Wozu: Macht eine neue Agent-Version in einer Praxis Probleme, hält die Notbremse alle Agenten dieser Praxis auf einer Höchstversion. Sie wirkt nur für den TCMSOFT-Server, an dem sie eingestellt ist.

Die Version schreiben Sie in der dreiteiligen Form, z. B. 2026.10.701. Beim Print Agent wird auch die vierteilige Form (2026.10.7.1) angenommen. In der Konfiguration von TCMSOFT heißen die Einstellungen Agent:HoechsteVersion und PrintAgent:HoechsteVersion; als Umgebungsvariable und in tcmsoft.env steht __ statt :.

Notbremse setzen (Docker)

1. Öffnen Sie tcmsoft.env im Datenordner, z. B. per SSH. Fügen Sie die Zeile(n) hinzu, etwa:

   Agent__HoechsteVersion=2026.10.701
   PrintAgent__HoechsteVersion=2026.10.701
   

2. Stellen Sie fest, welche Version des Update-Dienstes läuft:

   grep UpdaterVersion <Datenordner>/updater/status.json
   

   Die Zeile zeigt z. B. "UpdaterVersion": "2026.10.7.1".

3. Lassen Sie den TCMSOFT-Container mit der neuen Einstellung neu anlegen.

   • Update-Dienst 2026.10.7.1 oder neuer:

     docker rm -f tcmsoft
     

     Der Update-Dienst legt den Container spätestens nach 10 Minuten mit derselben Version und der neuen Einstellung wieder an.

   • Älterer Update-Dienst: Erst in TCMSOFT unter Stammdaten › Backup, Karte Programmversion und Updates, auf Jetzt prüfen klicken. Liegt eine neue Version bereit, Jetzt aktualisieren wählen. Das Update sichert vorher die Datenbank und übernimmt die Einstellung. Sonst docker rm -f tcmsoft ausführen. Ohne diese Prüfung könnte docker rm -f tcmsoft bei einem älteren Update-Dienst eine neue Version sofort ohne Sicherung einspielen.

Woran Sie den Erfolg erkennen:

• Der Container hat die Einstellung:

  docker exec tcmsoft printenv Agent__HoechsteVersion PrintAgent__HoechsteVersion
  

• Die Agenten übernehmen die Notbremse beim nächsten Kontakt mit TCMSOFT. In ihrem Protokoll steht dann „Notbremse: Updates höchstens bis Version …“. Verwirft ein Agent dabei ein schon geladenes neueres Update, steht dort zusätzlich „Update … wurde zurückgezogen oder ist gesperrt - es wird nicht eingespielt.“

• Unter Stammdaten › Agenten gilt die Höchstversion als aktuell. Ein Agent auf dieser Version steht nicht mehr als „veraltet“ da.

Was die Notbremse tut und was nicht:

• Die Agenten spielen nichts Neueres ein und verwerfen ein schon geladenes neueres Update.
• Sie gilt, bis TCMSOFT sie aufhebt, auch nach Tagen ohne Kontakt.
• Sie spielt keine ältere Version zurück. Agenten, die die neuere Version schon eingespielt haben, behalten sie.
• Ein Arbeitsplatz, der beim Setzen ausgeschaltet ist, erfährt die Notbremse erst beim nächsten Kontakt. Ein schon geladenes neueres Update kann er vorher beim Start noch einspielen. Bei einer fehlerhaften Version deshalb zusätzlich den TCMSOFT-Support bitten, sie zurückzuziehen (nächster Abschnitt).

Notbremse aufheben

1. Die Zeile(n) aus tcmsoft.env entfernen.
2. Den Container auf demselben Weg neu anlegen lassen wie beim Setzen (Schritt 2 und 3 oben).

Danach folgen die Agenten wieder den Updates. Im Protokoll der Agenten steht „Notbremse für Updates aufgehoben.“

Zurückziehen einer Version

Eine fehlerhafte Agent-Version zieht der Hersteller für alle Praxen zurück. Das macht nur TCMSOFT selbst (für das TCMSOFT-Team: interner Teil „Zurückziehen und Notbremse“).

Was das in der Praxis bewirkt:

• Ein Agent spielt eine geladene Version nur ein, solange sie in der zuletzt gültig gelesenen Update-Liste steht. Vor dem abendlichen Einspielen liest er die Liste neu, wenn sie älter als 30 Minuten ist.
• Eine zurückgezogene Version verwirft er. Im Protokoll des Agenten steht dann „Update … wurde zurückgezogen oder ist gesperrt - es wird nicht eingespielt.“
• Agenten, die die Version schon eingespielt haben, behalten sie bis zur nächsten neueren Version.
• Der Download in TCMSOFT (Agent herunterladen…, Print Agent herunterladen) bietet danach wieder die Vorversion an.

Notbremse und Zurückziehen ergänzen sich: Die Notbremse wirkt in einer Praxis, sobald sich die Agenten bei TCMSOFT melden; das Zurückziehen erreicht auch Arbeitsplätze, die beim Setzen der Notbremse ausgeschaltet waren.

Selbst-Update abschalten

Für Sonderfälle lässt sich das Selbst-Update mit der Umgebungsvariable PRISMAMED_SELBSTUPDATE=aus abschalten. Sie gilt für beide Agenten.

• Nötig ist das beim Prismamed Agent, wenn er ohne Anmeldung läuft (--headless als Dienst oder über die Aufgabenplanung). Sonst startet Velopack ihn nach einem Update an Dienst bzw. Aufgabenplanung vorbei neu. Einzelheiten unter Prismamed Agent.
• Neue Versionen spielen Sie dann von Hand mit dem Setup ein.
• TCMSOFT zeigt das an: beim Print Agent unter Stammdaten › Drucker als „… – aktualisiert sich nicht selbst“, beim Prismamed Agent unter Stammdaten › Agenten als „veraltet“, sobald es eine neuere Version gibt.
• Am Mac schaltet der Agent das Selbst-Update selbst ab, wenn sein Programm für das Benutzerkonto schreibgeschützt ist. Er meldet das als Hinweis.

Protokoll

Alle Meldungen des Selbst-Updates stehen im Protokoll des jeweiligen Agenten. Zeilen von Velopack beginnen mit „Velopack: “. Den Ordner öffnet der Menüpunkt Protokoll öffnen.

Siehe auch

• Prismamed Agent
• Print Agent
• Datenordner und tcmsoft.env
• Updates von TCMSOFT
• Meldungen und ihre Bedeutung