Aggiornamento di un'istanza Looker ospitata dal cliente

Riceverai una notifica relativa alle nuove release di Looker non appena saranno disponibili. Ti consigliamo di aggiornare regolarmente Looker per non perderti le correzioni di bug e le nuove funzionalità.

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

Questa procedura di aggiornamento presuppone che l'istanza di Looker includa lo script di avvio, che dovrebbe essere stato installato nell'ambito della procedura di installazione iniziale di Looker.

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

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

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

    Se stai aggiornando un cluster di Looker, ripeti questa procedura in modo che Looker venga interrotto 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-memory predefinito di Looker a un database MySQL esterno o se stai aggiornando un cluster di 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 di Looker, avvia il processo di Looker su un solo nodo. Non avviare Looker sugli altri nodi finché il primo non ha completato la procedura di aggiornamento.

    ./looker start

    Puoi anche utilizzare il comando java -jar per avviare Looker. Il file JAR principale troverà il file JAR delle dipendenze se si trova 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, anche il database interno di Looker deve essere aggiornato. L'aggiornamento del database di solito richiede 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 aggiornamento, il processo di creazione del demone scadrà dopo sei minuti con il messaggio "È scaduto il tempo di attesa per l'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 verificare se il processo di aggiornamento è ancora in esecuzione utilizzando il comando:

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

    L'interruzione 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 di nuovo l'aggiornamento.

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