Aggiornamento di un'istanza Looker ospitata dal cliente

Per accedere alle correzioni di bug e alle nuove funzionalità più recenti, aggiorna l'istanza di Looker ospitata dal cliente seguendo questi passaggi manuali.

Prima di procedere, tieni presente che il rollback a una versione precedente può causare gravi problemi. Se devi ripristinare i dati, esegui sempre il ripristino da un backup. Se gestisci un cluster di Looker, aggiorna completamente ogni nodo, uno alla volta. Questo processo presuppone inoltre che l'istanza includa lo script di avvio installato durante la configurazione iniziale.

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

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

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

   Se stai aggiornando un cluster Looker, ripeti questa procedura in modo che Looker venga arrestato su ogni nodo.

3. Esegui il backup dell'intera directory di Looker, incluse le directory nascoste (per maggiori 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. Prima di aggiornare Looker, verifica anche che i parametri del server MySQL e la regola di confronto predefinita del database di backend siano impostati su utf8mb4_general_ci. In caso contrario, dopo l'aggiornamento potresti visualizzare errori di mancata corrispondenza della regole di confronto.

6. 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.

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

   Se stai aggiornando un cluster di 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. Il file JAR principale troverà il file JAR di dipendenza, purché si trovi nella directory ./looker insieme al file JAR principale.

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

   Quando aggiorni la versione di Looker, Looker deve aggiornare anche il suo database interno. L'aggiornamento del database richiede in genere meno di cinque minuti, ma a volte può richiedere più tempo del processo di avvio di Looker. Se provi ad avviare Looker mentre il database interno è ancora in fase di aggiornamento, il processo daemon scadrà dopo sei minuti con il messaggio "Timed out waiting for Looker to start" (Timeout durante l'attesa dell'avvio di Looker).

   Durante un aggiornamento, le migrazioni richieste possono richiedere fino a un'ora, soprattutto se stai saltando diverse release. Se ricevi questo messaggio di errore, attendi il completamento dell'aggiornamento e l'avvio di Looker. Puoi verificare 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 durante l'aggiornamento del database interno possono danneggiare il database interno. In questo caso, ripristina Looker da un backup esistente ed esegui nuovamente l'aggiornamento.

8. Se stai aggiornando un cluster Looker, attendi che il primo nodo abbia completato il processo di aggiornamento prima di avviare Looker sugli altri nodi.