HandyCafe Docs
owner it-admin

Client-Updates

Client-PCs erhalten neue HandyCafe-Versionen von Ihrem eigenen Server über das lokale Netzwerk. Sie laden Updates nie selbst aus dem Internet. Meistens geschieht das von allein. Wenn Sie einen bestimmten Build auf einem oder mehreren Computern installieren müssen, können Sie das Paket auf der Seite Computer von Hand verteilen.

Unter Windows installiert ein Hintergrunddienst das Update und hält den Client am Laufen. Er startet den Client auch wieder, wenn ein Kunde ihn schließt oder den Prozess abschießt.


Automatische Updates

Der Server prüft alle fünf Minuten den HandyCafe-Updatekatalog. Außerdem prüft er, sobald die HandyCafe Cloud eine neue Version ankündigt. Der Katalog, den er liest, entspricht dem eigenen Release-Kanal des Servers: Ein Beta-Server folgt den Beta-Versionen, ein stabiler Server den stabilen Versionen.

Wenn eine neuere Client-Version veröffentlicht wird:

  1. Ein verbundener Computer meldet dem Server seine Client-Version als Teil seiner regelmäßigen Statusmeldungen.
  2. Läuft auf diesem Computer keine Sitzung und ist seine Version älter als die veröffentlichte, lädt der Server das Paket für das Betriebssystem dieses Computers herunter. Der Download erfolgt einmal und wird auf dem Server zwischengespeichert.
  3. Der Server bietet dem Computer das Update an. Der Computer lädt das Paket über das lokale Netzwerk vom Server herunter und prüft dessen SHA-256-Prüfsumme.
  4. Der Client installiert das Update und startet sich neu.

Einem Computer mit laufender Sitzung wird nie ein Update angeboten. Der Client lehnt ein Angebot auch ab, wenn inzwischen eine Sitzung begonnen hat. Das Update wartet, bis der Computer wieder frei ist.

Jedem Computer wird eine bestimmte Version höchstens alle fünf Minuten einmal angeboten. Ein Computer, der das Angebot verpasst hat, erhält es bei einer späteren Prüfung erneut.

Die neueste veröffentlichte Client-Version sehen Sie unter Einstellungen und dann Über. Die Zeile Client unter Version zeigt die zuletzt veröffentlichte Version. Kann der Server den Updatekatalog nicht erreichen, steht dort Katalog nicht verfügbar.


Ein Update von Hand verteilen

Mit einem manuellen Update installieren Sie ein bestimmtes Paket, das Sie auf der Festplatte haben. Der Server prüft das Paket und zeigt Ihnen das Ergebnis, bevor irgendetwas gesendet wird.

Wo Sie die Funktion finden

Auf der Seite Computer:

  • Ein Computer. Klicken Sie auf die Computerkarte, um das Detailpanel zu öffnen. Klicken Sie unter Remote-Aktionen auf Client aktualisieren.
  • Mehrere Computer. Wählen Sie sie aus und klicken Sie dann in der Befehlsleiste unter der Filterleiste auf Client aktualisieren. Die Schaltfläche ist nur verfügbar, wenn alle ausgewählten Computer verbunden sind.
  • Derselbe Befehl Client aktualisieren steht auch im Aktionsmenü der Computerkarte.

Zulässige Pakete

Plattform Paket
Windows Das Setup-Installationsprogramm (.exe). Daneben muss eine passende Signaturdatei .sig liegen.
Linux .AppImage
macOS .app.tar.gz

.msi-, .deb- und .dmg-Dateien werden nicht angenommen. Der Client kann sie nicht ohne Rückfrage installieren.

Server-Pakete und das Komplett-Setup (HandyCafe_Genesis_Pro_Setup_..., HandyCafe_Genesis_Setup_...) werden ebenfalls nicht angenommen. Wählen Sie unter Windows HandyCafe-Client_<version>_update-setup.exe und die zugehörige .sig-Datei.

Das Paket darf bis zu 500 MB groß sein.

Windows installiert nur signierte Pakete. Legen Sie die Signaturdatei mit demselben Namen plus .sig in denselben Ordner wie das Installationsprogramm. Zum Beispiel gehört HandyCafe Client_5.1.0_x64-setup.exe.sig neben HandyCafe Client_5.1.0_x64-setup.exe. Fehlt sie, wird das Senden blockiert, bevor ein Computer mit dem Download beginnt.

Was der Bestätigungsbildschirm zeigt

Nachdem Sie eine Datei ausgewählt haben, liest der Server sie ein und berechnet ihren Hash. Der Dialog Client-Update zeigt dann:

Feld Bedeutung
Dateiname Das ausgewählte Paket.
Prüfsumme (SHA-256) Der Fingerabdruck des Pakets. Der Computer gleicht den Download damit ab.
Version Wird aus dem Dateinamen gelesen. Enthält der Name keine Version, steht hier unbekannt. Bei macOS-Paketen ist das normal.
Größe Die Paketgröße.
Installierte Version Die derzeit auf dem Computer installierte Client-Version (bei einem einzelnen Computer).

Bei mehreren Computern listet eine Tabelle jeden Computer mit seiner Version unter Installiert und seinem Status auf:

Status Bedeutung
Bereit Erhält das Update.
Bereits aktuell Erhält das Paket. Es ist nicht neuer als die installierte Version.
In Sitzung Wird übersprungen. Auf diesem Computer läuft eine Sitzung.
Offline Wird übersprungen. Der Computer ist nicht verbunden.
Läuft mit (Plattform) Wird übersprungen. Das Paket ist für ein anderes Betriebssystem.

Computer, die übersprungen werden, stehen ganz oben. Eine Zusammenfassung zeigt, wie viele Computer aktualisiert und wie viele übersprungen werden.

Ein Paket, das für einige Computer nicht passt, blockiert die anderen nicht. In einem Café mit Windows- und Linux-Computern überspringt ein Windows-Paket einfach die Linux-Rechner.

Schritt für Schritt

  1. Öffnen Sie auf der Seite Computer das Detailpanel des Computers oder wählen Sie mehrere Computer aus.
  2. Klicken Sie auf Client aktualisieren.
  3. Wählen Sie die Paketdatei aus. Brechen Sie die Dateiauswahl ab, wenn Sie aufhören möchten, ohne etwas zu senden.
  4. Warten Sie, bis Paket wird geprüft abgeschlossen ist.
  5. Prüfen Sie Dateiname, Version und Zielliste.
  6. Klicken Sie bei einem Computer auf Update senden. Bei mehreren Computern lautet die Schaltfläche An gefolgt von der Anzahl der Computer und senden.

Der Server prüft im Moment des Sendens jedes Ziel erneut. Ein Computer, auf dem nach dem Erscheinen des Bestätigungsbildschirms eine Sitzung begonnen hat, wird übersprungen.

Nach dem Senden bestätigt eine Meldung, wie viele Computer das Update erhalten haben. Jeder Computer lädt das Paket herunter, installiert es und startet sich dann neu.


Der Windows-Updater-Dienst

Unter Windows installiert der Client einen Dienst namens HandyCafe Client Updater. Er läuft als SYSTEM und startet automatisch mit Windows.

Der Dienst hat zwei Aufgaben.

Updates installieren

Der Client lädt das Paket herunter und prüft es. Dann übergibt er das Installationsprogramm an den Dienst und schließt sich. Der Dienst prüft die Release-Signatur, bevor er etwas installiert. Ein unsigniertes oder falsch signiertes Paket lehnt er ab. Nach der Installation startet er den neuen Client.

Den Client am Laufen halten

Solange ein Benutzer bei Windows angemeldet ist, prüft der Dienst etwa einmal pro Sekunde, ob der Client läuft. Ist der Client weg, startet der Dienst ihn in der Sitzung des angemeldeten Benutzers mit dessen normalen Rechten neu. Ein Kunde mit einem Windows-Standardkonto kann einen SYSTEM-Dienst nicht beenden. Wer den Client und seinen Wächterprozess gleichzeitig schließt, lässt den Computer daher trotzdem nicht entsperrt zurück.

Ein Client, der direkt nach dem Start abstürzt, wird nicht in einer Endlosschleife neu gestartet. Stirbt ein Client innerhalb von 15 Sekunden nach dem Start, gilt das als Fehlstart. Die Wartezeit bis zum nächsten Versuch wächst mit jedem weiteren Fehlstart in Folge: 1, 2, 5, 10 und dann 30 Sekunden. Läuft der Client 30 Sekunden durch, wird der Zähler zurückgesetzt.

Nach einem autorisierten Beenden startet der Dienst den Client nicht neu:

  • Admin-Beenden am Client
  • Client beenden vom Server aus
  • Deinstallation des Clients

In diesen Fällen weist der Client den Dienst vor dem Schließen an, sich zurückzuhalten. Die Überwachung setzt wieder ein, sobald der Client erneut gestartet wird. Sie setzt auch bei der nächsten Windows-Anmeldung wieder ein. Läuft der Client 10 Sekunden nach einer solchen Anweisung immer noch, gilt das Beenden als abgebrochen und die Überwachung setzt wieder ein. Das deckt zum Beispiel eine Deinstallation ab, die an der Windows-Berechtigungsabfrage abgebrochen wurde.

Während ein Update installiert wird, überlässt der Dienst das Beenden und Starten des Clients dem Updatevorgang.


Berechtigungen

Für das manuelle Verteilen eines Updates ist die Berechtigung Dateiübertragung erforderlich. Sie legen sie unter Einstellungen, dann Personal und dann Rollen & Berechtigungen fest. Siehe Kassiererrollen.

Automatische Updates benötigen keine Berechtigung. Sie laufen im Hintergrund, solange der Server läuft.


Fehlerbehebung und Hinweise

Ein Computer wird nie automatisch aktualisiert. Automatische Angebote gehen nur an verbundene Computer ohne Sitzung. Ein Computer, der ständig belegt ist, erhält das Update, sobald er das nächste Mal frei ist. Prüfen Sie unter Einstellungen und dann Über, ob der Server den Updatekatalog erreicht.

„Windows installiert nur ein signiertes Paket.“ Die .sig-Datei fehlt oder ist leer. Kopieren Sie die mit dem Installationsprogramm gelieferte Signaturdatei in denselben Ordner und wählen Sie das Installationsprogramm erneut aus.

„Dieses Paket ist für ... gebaut, dieser Computer läuft mit ...“. Das Paket ist für ein anderes Betriebssystem. Wählen Sie das passende Paket.

„Auf diesem Computer läuft eine Sitzung.“ Updates werden nur gesendet, während der Computer am Sperrbildschirm wartet. Beenden Sie zuerst die Sitzung. Sie können das Update auch später senden.

„Die Version in diesem Paket ist nicht neuer als die installierte.“ Das ist eine Warnung, keine Sperre. Beim Senden wird derselbe oder ein älterer Build erneut installiert.

„Keiner dieser Computer kann dieses Paket derzeit annehmen.“ Alle ausgewählten Computer sind offline, in einer Sitzung oder laufen auf einer anderen Plattform.

Der Client kommt auf einem Windows-Computer immer wieder, nachdem ich ihn geschlossen habe. Hier erledigt der Updater-Dienst seine Arbeit. Verwenden Sie das Admin-Beenden am Client oder Client beenden vom Server aus. Beides gilt als autorisiert und der Dienst hält sich zurück.