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

Pour accéder aux dernières corrections de bugs et 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 rollback vers 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 par un. Ce processus suppose également que votre instance inclut le script de démarrage installé lors de la configuration initiale.

  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 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 ce processus afin 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. Avant de mettre à jour Looker, vérifiez également que les paramètres de votre serveur MySQL et le classement par défaut de la base de données backend sont définis sur utf8mb4_general_ci. Sinon, des erreurs d'incohérence de classement peuvent s'afficher après la mise à jour.

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

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

    Si vous préférez utiliser un script de démarrage fourni par Looker, vous en trouverez 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 encore 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 dépassé 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 que la mise à jour se termine 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 les mises à 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.

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