Aggiornamento di un'istanza di Looker

Sconsigliamo vivamente di utilizzare queste istruzioni per eseguire il rollback a una versione precedente di Looker. Questo può causare seri problemi noiosi e difficili da recuperare. Se hai bisogno di tornare a una versione precedente di Looker, ti consigliamo invece di ripristinare un backup.

Riceverai una notifica quando saranno disponibili nuove versioni di Looker. Consigliamo di aggiornare regolarmente Looker per mantenerti aggiornato con correzioni di bug e nuove funzionalità.

Se hai un cluster di istanze Looker, devi aggiornare completamente un singolo nodo prima di aggiornare le altre istanze.

Questo processo di aggiornamento presuppone che l'istanza di Looker includa lo script di avvio, che dovrebbe essere stato installato come parte del processo di installazione iniziale di Looker.

1. Scarica la versione più recente dei file JAR di Looker come descritto nella pagina della documentazione relativa al download dei file JAR di Looker.

2. Interrompi il processo Looker dalla shell, come utente looker:

   sudo su - looker
   cd /home/looker/looker
   ./looker stop
   

   Se stai aggiornando un cluster Looker, ripeti la procedura descritta sopra per arrestare Looker su ogni nodo.

3. Esegui il backup dell'intera directory di Looker, incluse le directory nascoste (per ulteriori dettagli, consulta la pagina della documentazione Ripristino dei backup).

4. Se hai eseguito la migrazione del database in memoria predefinito di Looker a un database MySQL esterno o se stai aggiornando un cluster Looker, esegui il backup del database MySQL.

5. Rinomina looker-x.x.x.jar in looker.jar e looker-dependencies-x.x.x.jar in looker-dependencies.jar. Copia looker.jar e looker-dependencies.jar nella directory del server (/home/looker/looker/looker.jar). Entrambi i file devono trovarsi nella stessa directory.

6. Avvia il processo di Looker dalla shell come utente looker:

   Se stai aggiornando un cluster Looker, avvia il processo di Looker su un solo nodo. Non avviare Looker sugli altri nodi finché il primo nodo non ha completato il processo di aggiornamento.

   ./looker start
   

   Puoi anche utilizzare il comando java -jar per avviare Looker. La JAR principale troverà la JAR delle dipendenze purché sia presente nella directory ./looker insieme alla JAR principale.

   Inoltre, se preferisci utilizzare uno script di avvio fornito da Looker, puoi trovarlo all'indirizzo: https://github.com/looker/customer-scripts.

   Quando aggiorni la versione di Looker, anche Looker deve aggiornare il proprio database interno. In genere, l'aggiornamento del database richiede meno di cinque minuti, ma a volte può essere necessario più tempo del processo di avvio di Looker. Se provi ad avviare Looker mentre il database interno è ancora in fase di aggiornamento, il processo di daemonizzazione scadrà tra sei minuti con il messaggio "Timeout in attesa dell'avvio di Looker".

   Durante un aggiornamento, le migrazioni richieste possono richiedere fino a un'ora, soprattutto se salti diverse release. Se ricevi questo messaggio di errore, attendi il completamento dell'aggiornamento e l'avvio di Looker. Puoi confermare se il processo di aggiornamento è ancora in esecuzione utilizzando il comando:

   ps -f $(pgrep -f -- '-jar looker.jar')
   

   L'arresto e il riavvio del processo di Looker mentre gli aggiornamenti del database interno sono in corso possono danneggiare il database interno. In questo caso, ripristina Looker da un backup esistente ed esegui di nuovo l'aggiornamento.

7. Se stai aggiornando un cluster Looker, attendi che il primo nodo completi il processo di aggiornamento prima di avviarlo sugli altri.