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

Installation du logiciel de rendu hébergée par le client

Looker nécessite un logiciel de rendu appelé Chromium pour envoyer ou télécharger des données dans des formats d'image (fichiers HTML et PNG ou PDF), et pour utiliser des fonctionnalités comme la taille du papier et les tableaux Développer. Cette page explique comment installer un logiciel de rendu sur une instance de Looker hébergée par le client.

Chromium est déjà installé pour les instances hébergées par Looker.

Le rendu Chromium attend que toutes les ressources demandées par la page soient terminées avant d'envoyer le signal "terminé" qui invite Looker à produire le contenu affiché. En raison du nombre et de la fréquence de ces demandes de ressources, certains réseaux peuvent les signaler à tort comme étant malveillantes, ce qui peut entraîner leur abandon, ce qui retarde les tâches affichées.

Le projet Chromium est un projet Open Source lancé par Google pour partager les éléments non propriétaires de Google Chrome.

Exigences et conditions préalables à l'installation de Chromium

Looker est compatible avec les versions de toutes les principales distributions Linux d'entreprise, y compris Ubuntu, Debian, RedHat, CentOS et Amazon Linux. Cette page explique comment installer Chromium sur Ubuntu, Debian et RedHat/CentOS/Amazon Linux.

Chromium doit être installé dans un chemin exécutable sur la machine qui héberge l'instance Looker. L'application Looker doit accéder à Chromium à l'aide de la commande chromium ou via un chemin personnalisé défini avec la variable d'environnement CHROMIUM_PATH.

Pour exécuter Chromium sur une instance Looker, vous devez utiliser Chromium 86 ou une version ultérieure, mais Looker recommande d'utiliser spécifiquement Chromium 97.x. Si votre instance Looker est installée sur Debian, Chromium nécessite Debian 9 (stretch) ou une version ultérieure.

Si vous installez Chromium sur une installation Looker en cluster, la version de Chromium sur chaque nœud doit être entièrement identique. Même les différences mineures, telles que les différents numéros de build, peuvent interférer avec les fonctionnalités de rendu de Looker.

Si vos données contiennent des caractères qui n'existent pas en anglais, installez le package Google Noto Fonts (d'une taille de plusieurs Go) en plus de Chromium. Pour installer ce package de polices, exécutez les commandes suivantes dans la ligne de commande:

mkdir -p /tmp/fonts
cd /tmp/fonts
curl -O https://noto-website-2.storage.googleapis.com/pkgs/Noto-unhinted.zip
unzip Noto-unhinted.zip
mkdir -p /usr/share/fonts/opentype/noto
cp *.otf *.otc /usr/share/fonts/opentype/noto   # Ignore any *.otc not found errors
mkdir -p /usr/share/fonts/truetype/noto
cp *.ttf /usr/share/fonts/truetype/noto
chmod a+r -R /usr/share/fonts/*/noto
fc-cache -f -v

Si l'opération réussit:

cd $HOME
rm -rf /tmp/fonts

Installer Chromium sur Ubuntu

L'application Looker doit accéder à Chromium à l'aide de la commande chromium ou via un chemin personnalisé défini avec la variable d'environnement CHROMIUM_PATH. Pour les installations Ubuntu, vous devez installer le navigateur Web Chromium, puis définir un alias afin que l'application Looker puisse trouver l'installation.

Looker recommande d'utiliser la commande sudo lorsque vous effectuez les étapes qui nécessitent des autorisations élevées. N'installez pas Chromium lorsque vous êtes connecté en tant qu'utilisateur racine. Si vous installez Chromium en étant connecté en tant qu'utilisateur racine, Looker risque de ne pas pouvoir exécuter le rendu PDF ou PNG.

Les polices doivent être installées sur le système pour que Chromium démarre. Vous pouvez installer des polices à l'aide de l'interface de ligne de commande. Par exemple, cette commande installe les polices par défaut sur Ubuntu 16.04 LTS:
```
apt-get install fonts-freefont-otf
```
Pour installer Chromium, exécutez la commande suivante:
```
apt-get update && apt-get install -y chromium-browser
```
Vous devez utiliser l'alias chromium-browser ou chromium pour exporter la variable d'environnement CHROMIUM_PATH. Pour définir chromium-browser comme chromium, placez le code suivant dans le fichier ~/.bashrc:
```
alias chromium='chromium-browser'
```
Pour que cet alias soit connu de Looker, exécutez la commande suivante dans la ligne de commande:
```
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
```
Après avoir défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour qu'elle soit prise en compte. Vous devrez peut-être redémarrer les sessions de terminal ouvertes, ou exécuter source ~/.bash_profile pour que le terminal lise la nouvelle configuration.

Après avoir installé Chromium, vous devriez obtenir une réponse valide de chromium --version si vous n'avez pas défini la variable d'environnement CHROMIUM_PATH ou $CHROMIUM_PATH --version si vous avez défini la variable d'environnement CHROMIUM_PATH.

Installer Chromium sur Debian

Looker recommande d'utiliser la commande sudo lorsque vous effectuez les étapes qui nécessitent des autorisations élevées. N'installez pas Chromium lorsque vous êtes connecté en tant qu'utilisateur racine. Si vous installez Chromium en étant connecté en tant qu'utilisateur racine, Looker risque de ne pas pouvoir exécuter le rendu PDF ou PNG.

Chromium nécessite Debian 9 (stretch) ou version ultérieure.

Si votre instance Looker utilise Docker avec une installation Debian simple, installez les procps et assurez-vous de ne pas être en cours d'exécution à la racine.

Les polices doivent être installées sur le système pour que Chromium démarre. Pour installer des polices à l'aide de l'interface de ligne de commande, exécutez la commande suivante:
```
apt-get install fonts-freefont-otf
```
Pour installer Chromium, exécutez la commande suivante:
```
apt-get update && apt-get install -y chromium
```
Après avoir défini l'une des variables d'environnement facultatives, redémarrez l'application Looker pour qu'elle soit prise en compte. Vous devrez peut-être redémarrer les sessions de terminal ouvertes, ou exécuter source ~/.bash_profile pour que le terminal lise la nouvelle configuration.

Variables d'environnement Chromium facultatives

CHROMIUM_PATH: chemin d'accès au binaire Chromium, défini par défaut sur chromium.
CHROMIUM_PID_DIR : chemin d'accès à la bibliothèque où les fichiers PID Chromium peuvent être stockés (valeur par défaut : chromium_pid_files dans le répertoire de travail de l'application Looker).
CHROMIUM_PORT_RANGE_START et CHROMIUM_PORT_RANGE_END: l'application Chromium a besoin d'une plage de ports pour communiquer entre les processus sur la machine locale. La plage par défaut est comprise entre 40000 et 40500. Vous pouvez la remplacer en définissant ces deux variables d'environnement. Les ports inutilisés sont sélectionnés au hasard dans la plage et ne sont utilisés que pendant la durée d'un seul rendu.
DISABLE_EXTERNAL_RENDER_ACCESS: les administrateurs d'instances ou de serveurs Looker hébergés par le client qui ne disposent d'aucun accès Internet externe ou bloqué doivent définir DISABLE_EXTERNAL_RENDER_ACCESS=true. En règle générale, le moteur de rendu Chromium attend que toutes les ressources demandées par la page soient terminées avant d'envoyer le signal "terminé" qui invite Looker à produire le contenu. Certaines de ces requêtes peuvent être ignorées en raison d'un manque de connexion, ce qui entraîne des délais d'inactivité ou des délais d'affichage très longs. Définir cette variable d'environnement sur true empêche le moteur de rendu d'attendre la fin de toutes les requêtes. Certaines visualisations de carte et certaines visualisations personnalisées installées à partir de Looker Marketplace peuvent nécessiter un accès à Internet.