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

Vous serez informé des nouvelles versions de Looker dès qu'elles seront disponibles. Nous vous recommandons de mettre régulièrement à jour Looker pour vous tenir informé des corrections de bugs et des nouvelles fonctionnalités.

Si vous disposez d'un cluster d'instances Looker, vous devez mettre à jour complètement un nœud avant de mettre à jour les autres instances.

Ce processus de mise à jour suppose que votre instance Looker inclut le script de démarrage, qui aurait dû être installé lors du processus d'installation initiale de Looker.

  1. Téléchargez la version la plus récente 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 de l'interface système, en tant qu'utilisateur looker:

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

    Si vous mettez à jour un cluster Looker, répétez ce processus 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 la 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 en trouverez un à l'adresse suivante: 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 alors que la base de données interne est encore en cours de mise à jour, le processus de démonétisation expire dans six minutes et le message suivant s'affiche : "Le délai d'attente a expiré pour le démarrage de Looker".

    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 que Looker démarre. 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 peut corrompre la base de données interne. Dans ce cas, 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 avant de démarrer Looker sur les autres nœuds.