HandyCafe Docs
owner it-admin

Aggiornamenti dei client

I PC client ricevono le nuove versioni di HandyCafe dal tuo server attraverso la rete locale. Non scaricano mai gli aggiornamenti da internet in autonomia. Nella maggior parte dei casi tutto avviene da solo. Quando devi installare una build specifica su uno o più computer, puoi inviare il pacchetto manualmente dalla pagina Computer.

Su Windows un servizio in background installa l'aggiornamento e mantiene il client in esecuzione. Riavvia inoltre il client se un cliente lo chiude o ne termina il processo.


Aggiornamenti automatici

Il server controlla il catalogo degli aggiornamenti di HandyCafe ogni cinque minuti. Lo controlla anche quando il cloud HandyCafe annuncia una nuova release. Il catalogo letto corrisponde al canale di rilascio del server: un server beta segue le release beta e un server stabile segue le release stabili.

Quando viene pubblicata una versione più recente del client:

  1. Un computer connesso comunica al server la propria versione del client nell'ambito dei normali aggiornamenti di stato.
  2. Se su quel computer non è in corso una sessione e la sua versione è precedente a quella pubblicata, il server scarica il pacchetto per il sistema operativo di quel computer. Il download avviene una sola volta e il pacchetto resta in cache sul server.
  3. Il server propone l'aggiornamento al computer, che scarica il pacchetto dal server attraverso la rete locale e ne verifica la somma di controllo SHA-256.
  4. Il client installa l'aggiornamento e si riavvia.

A un computer con una sessione in corso non viene mai proposto un aggiornamento. Il client rifiuta la proposta anche se nel frattempo è iniziata una sessione. L'aggiornamento attende che il computer torni libero.

A ciascun computer una determinata versione viene proposta al massimo una volta ogni cinque minuti. Un computer che ha perso la proposta la riceve di nuovo a un controllo successivo.

Per vedere la versione del client pubblicata più di recente, apri Impostazioni, poi Informazioni. La riga Client sotto Versione mostra l'ultima versione pubblicata. Riporta Catalogo non disponibile quando il server non riesce a raggiungere il catalogo degli aggiornamenti.


Inviare un aggiornamento manualmente

Usa un aggiornamento manuale per installare un pacchetto specifico che hai sul disco. Il server verifica il pacchetto e ti mostra cosa ha trovato prima di inviare qualsiasi cosa.

Dove si trova

Nella pagina Computer:

  • Un solo computer. Fai clic sulla scheda del computer per aprire il pannello dei dettagli. In Azioni remote, fai clic su Aggiorna client.
  • Più computer. Selezionali, poi fai clic su Aggiorna client nella barra dei comandi sotto la barra dei filtri. Il pulsante è disponibile solo quando tutti i computer selezionati sono connessi.
  • Lo stesso comando Aggiorna client si trova anche nel menu delle azioni della scheda del computer.

Pacchetti accettati

Piattaforma Pacchetto
Windows Il programma di installazione (.exe). Accanto deve trovarsi il file di firma .sig corrispondente.
Linux .AppImage
macOS .app.tar.gz

I file .msi, .deb e .dmg non sono accettati, perché il client non può installarli in modo silenzioso.

Non sono accettati nemmeno i pacchetti del server e il setup completo (HandyCafe_Genesis_Pro_Setup_..., HandyCafe_Genesis_Setup_...). Su Windows scegli HandyCafe-Client_<version>_update-setup.exe e il relativo file .sig.

Il pacchetto può arrivare a 500 MB.

Windows installa solo pacchetti firmati. Metti il file di firma, con lo stesso nome più .sig, nella stessa cartella del programma di installazione. Ad esempio, HandyCafe Client_5.1.0_x64-setup.exe.sig va accanto a HandyCafe Client_5.1.0_x64-setup.exe. Senza questo file l'invio viene bloccato prima che qualsiasi computer inizi il download.

Cosa mostra la schermata di conferma

Dopo che hai scelto un file, il server lo legge e ne calcola l'hash. La finestra Aggiornamento client mostra quindi:

Campo Significato
Nome file Il pacchetto che hai scelto.
Somma di controllo (SHA-256) L'impronta del pacchetto. Il computer confronta il download con questo valore.
Versione Ricavata dal nome del file. Appare come Sconosciuta quando il nome non contiene una versione, cosa normale per i pacchetti macOS.
Dimensione La dimensione del pacchetto.
Versione installata La versione del client attualmente presente sul computer (singolo computer).

Per più computer, una tabella elenca per ciascuno il Computer, la versione Installata e lo Stato:

Stato Significato
Pronto Riceverà l'aggiornamento.
Già aggiornato Riceverà il pacchetto, che però non è più recente di quello installato.
In sessione Saltato. Su questo computer è in corso una sessione.
Offline Saltato. Il computer non è connesso.
Usa (piattaforma) Saltato. Il pacchetto è per un altro sistema operativo.

I computer che verranno saltati sono elencati per primi. Un riepilogo indica quanti computer verranno aggiornati e quanti saltati.

Un pacchetto non adatto ad alcuni computer non blocca gli altri. In un locale con computer Windows e Linux, un pacchetto Windows salta semplicemente quelli Linux.

Passo dopo passo

  1. Nella pagina Computer, apri il pannello dei dettagli del computer oppure seleziona più computer.
  2. Fai clic su Aggiorna client.
  3. Scegli il file del pacchetto. Annulla la selezione del file per fermarti senza inviare nulla.
  4. Attendi che termini Verifica del pacchetto in corso.
  5. Controlla nome del file, versione ed elenco delle destinazioni.
  6. Fai clic su Invia aggiornamento per un solo computer. Per più computer il pulsante riporta Invia a seguito dal numero di computer.

Al momento dell'invio il server ricontrolla ogni destinazione. Un computer su cui è iniziata una sessione dopo la comparsa della schermata di conferma viene saltato.

Dopo l'invio, un messaggio conferma quanti computer hanno ricevuto l'aggiornamento. Ogni computer scarica e installa il pacchetto, quindi si riavvia.


Il servizio di aggiornamento di Windows

Su Windows il client installa un servizio chiamato HandyCafe Client Updater. Viene eseguito come SYSTEM e parte automaticamente con Windows.

Il servizio ha due compiti.

Installare gli aggiornamenti

Il client scarica e verifica il pacchetto, poi passa il programma di installazione al servizio e si chiude. Il servizio controlla la firma della release prima di installare qualsiasi cosa e rifiuta un pacchetto non firmato o firmato in modo errato. Al termine dell'installazione avvia il nuovo client.

Mantenere il client in esecuzione

Mentre un utente è connesso a Windows, il servizio verifica circa una volta al secondo che il client sia in esecuzione. Se il client non c'è più, il servizio lo riavvia nella sessione dell'utente connesso con i normali diritti di quell'utente. Un cliente con un account Windows standard non può fermare un servizio SYSTEM. Chiudere contemporaneamente il client e il suo processo di controllo non lascia quindi il computer sbloccato.

Un client che va in crash subito dopo l'avvio non viene riavviato a ciclo continuo. Un client che si chiude entro 15 secondi dall'avvio conta come avvio non riuscito. L'attesa prima del tentativo successivo cresce a ogni avvio non riuscito consecutivo: 1, 2, 5, 10 e poi 30 secondi. Un'esecuzione che dura almeno 30 secondi azzera il conteggio.

Il servizio non riavvia il client dopo un'uscita autorizzata:

  • Un'uscita da amministratore sul client
  • Chiudi client inviato dal server
  • La disinstallazione del client

In questi casi il client chiede al servizio di sospendersi prima di chiudersi. La supervisione riprende quando il client viene riavviato e anche al successivo accesso a Windows. Se il client è ancora in esecuzione 10 secondi dopo una richiesta di questo tipo, l'uscita viene considerata annullata e la supervisione riprende. Questo copre, ad esempio, una disinstallazione annullata alla richiesta di autorizzazione di Windows.

Durante l'installazione di un aggiornamento, il servizio lascia al processo di aggiornamento l'arresto e l'avvio del client.


Permessi

L'invio manuale di un aggiornamento richiede il permesso Trasferimento file. Impostalo in Impostazioni, poi Personale, poi Ruoli e permessi. Vedi Ruoli e Permessi Cassiere.

Gli aggiornamenti automatici non richiedono permessi. Vengono eseguiti in background ogni volta che il server è in funzione.


Risoluzione dei problemi e note

Un computer non si aggiorna mai automaticamente. Le proposte automatiche vanno solo ai computer connessi senza una sessione in corso. Un computer sempre occupato riceve l'aggiornamento la prima volta che si libera. Verifica in Impostazioni, poi Informazioni, che il server riesca a raggiungere il catalogo degli aggiornamenti.

"Windows installa solo un pacchetto firmato." Il file .sig manca o è vuoto. Copia nella stessa cartella il file di firma fornito con il programma di installazione, poi scegli di nuovo il programma di installazione.

"Questo pacchetto è creato per ... Questo computer usa ...". Il pacchetto è per un altro sistema operativo. Scegli il pacchetto corrispondente.

"Su questo computer c'è una sessione attiva." Gli aggiornamenti vengono inviati solo mentre il computer è in attesa nella schermata di blocco. Termina prima la sessione oppure invia l'aggiornamento più tardi.

"La versione di questo pacchetto non è più recente di quella installata." È un avviso, non un blocco. Inviandolo si reinstalla la stessa build o una più vecchia.

"Nessuno di questi computer può ricevere questo pacchetto in questo momento." Tutti i computer selezionati sono offline, in sessione o su un'altra piattaforma.

Su un computer Windows il client continua a ricomparire dopo che lo chiudo. È il servizio di aggiornamento che fa il suo lavoro. Usa l'uscita da amministratore sul client oppure Chiudi client dal server. Entrambe sono considerate autorizzate e il servizio si sospende.