LoclixDocs
Web application firewallTunnel

Aggiornamenti del connettore

Mantieni aggiornato il connettore e scegli quando aggiornarlo.

Gli aggiornamenti automatici sono abilitati per impostazione predefinita. Ogni connettore ha una propria preferenza, anche quando più connettori vengono eseguiti sullo stesso server.

Installazioni esistenti

I connettori installati prima della versione 0.17.2 richiedono l’installazione del programma di aggiornamento una sola volta:

  1. Apri Install connector accanto alla mappa delle connessioni.
  2. Copia il comando di installazione.
  3. Eseguilo sul server.

I token e le associazioni dei servizi vengono conservati. Durante l’installazione, il connettore si ricollega brevemente.

Preferenza di aggiornamento automatico

  1. Apri Tunnels nell’account.
  2. Apri Edit tunnel del connettore.
  3. Deseleziona Update connector automatically per disabilitare gli aggiornamenti.
  4. Seleziona Save changes.

Seleziona di nuovo l’opzione per abilitare gli aggiornamenti. La preferenza si applica a tutte le repliche del connettore e non modifica la credenziale.

Frequenza degli aggiornamenti

Il programma controlla gli aggiornamenti due minuti dopo l’avvio, poi cinque minuti dopo ogni controllo completato, con un ritardo casuale fino a 60 secondi.

Un aggiornamento riavvia brevemente il connettore interessato se è in esecuzione. Le richieste attive possono fallire durante il riavvio. Un connettore arrestato rimane arrestato.

Per eseguire subito un controllo, sostituisci gli ID seguenti ed esegui:

sudo systemctl start loclix-connector-update@ACCOUNT-ID.TUNNEL-ID.service

Questo comando rispetta sia la preferenza della dashboard sia la disabilitazione locale.

Verifica della versione

Gli aggiornamenti richiedono HTTPS con verifica del certificato e una firma valida dell’editore. Prima dell’installazione vengono verificati versione, architettura, binario e avvisi di licenza. Se la verifica o il controllo degli aggiornamenti fallisce, viene mantenuta la versione installata.

Il programma di installazione iniziale proviene dall’host della dashboard. Controlla il comando di installazione e usa l’indirizzo HTTPS di quell’host.

Errori di avvio

Se il servizio aggiornato non supera il controllo iniziale di avvio di tre secondi, il programma ripristina il binario precedente e prova a riavviarlo. Controlla il servizio locale dopo un aggiornamento: questo controllo verifica solo che il processo del connettore sia partito.

Una versione non riuscita viene registrata in .rejected-release sotto /var/lib/loclix-connector/ACCOUNT-ID.TUNNEL-ID/. Dopo aver risolto un problema locale di avvio, rimuovi quel file per riprovare la versione. Una versione successiva con un hash del binario diverso può essere installata automaticamente.

Controllo locale

Imposta "auto_update_disabled": true nel connector.json locale per disabilitare gli aggiornamenti indipendentemente dalla dashboard. Rimuovi l’impostazione o usa false prima di riabilitarli. La dashboard non può sovrascrivere questa impostazione locale.

Controlla il timer e i log degli aggiornamenti con:

systemctl status loclix-connector-update@ACCOUNT-ID.TUNNEL-ID.timer
journalctl -u loclix-connector-update@ACCOUNT-ID.TUNNEL-ID.service

La configurazione si trova in /etc/loclix-connector/ACCOUNT-ID.TUNNEL-ID/. L’eseguibile e gli avvisi di licenza di ogni connettore si trovano in /var/lib/loclix-connector/ACCOUNT-ID.TUNNEL-ID/.

In questa pagina