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

Pour accéder aux derniers correctifs de bugs 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 retour à une version antérieure peut entraîner de graves problèmes. Au lieu de cela, restaurez toujours à partir d'une sauvegarde si vous devez revenir en arrière. Si vous exploitez 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 depuis le 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 à condition 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 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 toujours en cours de mise à jour, le processus de démonisation expirera au bout de six minutes et le message "Délai d'attente pour le démarrage de Looker dépassé" s'affichera.

    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 soit terminée 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')

    Si vous arrêtez et redémarrez le processus Looker pendant la mise à jour de la base de données interne, vous risquez de corrompre cette base de données. 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 processus de mise à jour du premier nœud soit terminé avant de démarrer Looker sur les autres nœuds.