Mettre à jour une instance Looker hébergée par le client

Pour accéder aux derniers correctifs et aux nouvelles fonctionnalités, mettez à jour votre instance Looker hébergée par le client en suivant ces étapes manuelles.

Avant de continuer, sachez que le rétablissement d'une version antérieure peut entraîner de graves problèmes. Au lieu de cela, effectuez toujours une restauration à partir d'une sauvegarde si vous devez revenir en arrière. Si vous utilisez un cluster Looker, mettez à jour chaque nœud complètement, un à la fois. Ce processus suppose également que votre instance inclut le script de démarrage installé lors de la configuration initiale.

  1. Téléchargez la dernière version des fichiers JAR Looker, comme décrit sur la page de documentation Télécharger les fichiers JAR Looker.

  2. Arrêtez le processus Looker à partir du shell, en tant qu'utilisateur looker :

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

    Si vous mettez à jour un cluster Looker, répétez cette procédure pour que Looker soit arrêté sur chaque nœud.

  3. Sauvegardez l'intégralité de votre répertoire Looker, y compris les répertoires masqués (pour en savoir plus, consultez la page de documentation Restaurer des sauvegardes).

  4. Si vous avez migré la base de données en mémoire par défaut de Looker vers une base de données MySQL externe ou si vous mettez à jour un cluster Looker, sauvegardez la base de données MySQL.

  5. Renommez looker-x.x.x.jar en looker.jar et looker-dependencies-x.x.x.jar en looker-dependencies.jar. Copiez looker.jar et looker-dependencies.jar dans le répertoire du serveur (/home/looker/looker/looker.jar). Les deux fichiers doivent se trouver dans le même répertoire.

  6. Démarrez le processus Looker à partir du shell en tant qu'utilisateur looker :

    Si vous mettez à jour un cluster Looker, démarrez le processus Looker sur un seul nœud. Ne démarrez pas Looker sur les autres nœuds tant que le premier nœud n'a pas terminé le processus de mise à jour.

    ./looker start

    Vous pouvez également utiliser la commande java -jar pour démarrer Looker. Le fichier JAR principal trouvera le fichier JAR de dépendance tant qu'il se trouve dans le répertoire ./looker avec le fichier JAR principal.

    De plus, si vous préférez utiliser un script de démarrage fourni par Looker, vous pouvez en trouver un à l'adresse https://github.com/looker/customer-scripts.

    Lorsque vous mettez à jour votre version de Looker, Looker doit également mettre à jour sa base de données interne. La mise à jour de la base de données prend généralement moins de cinq minutes, mais elle peut parfois prendre plus de temps que le processus de démarrage de Looker. Si vous essayez de démarrer Looker pendant que la base de données interne est toujours en cours de mise à jour, le processus de démonisation expirera au bout de six minutes avec le message "Timed out waiting for Looker to start" (Délai d'attente avant le démarrage de Looker dépassé).

    Lors d'une mise à jour, les migrations requises peuvent prendre jusqu'à une heure, en particulier si vous ignorez plusieurs versions. Si vous recevez ce message d'erreur, attendez la fin de la mise à jour et le démarrage de Looker. Vous pouvez vérifier si le processus de mise à jour est toujours en cours d'exécution à l'aide de la commande suivante :

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

    L'arrêt et le redémarrage du processus Looker pendant la mise à jour de la base de données interne peuvent corrompre cette dernière. Si cela se produit, restaurez Looker à partir d'une sauvegarde existante et effectuez à nouveau la mise à jour.

  7. Si vous mettez à jour un cluster Looker, attendez que le premier nœud ait terminé le processus de mise à jour avant de démarrer Looker sur les autres nœuds.