Notez que vous consultez la documentation Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

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 un seul nœud complètement 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 initial de Looker.

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.
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.
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).
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.
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.
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 de base trouvera le fichier JAR de la dépendance tant qu'il se trouve dans le répertoire ./looker avec le fichier JAR de base.

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 cela 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 expire au bout de six minutes avec le message "Délai expiré en attente du 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 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')
```
L'arrêt et le redémarrage du processus Looker pendant que les mises à jour de la base de données interne sont en cours peuvent l'endommager. Dans ce cas, restaurez Looker à partir d'une sauvegarde existante, puis effectuez à nouveau la mise à jour.
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.