Cette page explique comment installer l'application Looker pour un déploiement hébergé par un client.
L'hébergement de l'application Looker est indépendant de l'emplacement de vos données. Les données restent toujours dans la base de données et ne sont pas copiées dans l'instance Looker.
Spécifications du déploiement
Si vous comptez exécuter Looker sur un réseau qui ne se connecte pas à Internet, vous devrez peut-être configurer un serveur proxy pour communiquer avec le serveur de licences Looker ou utiliser des services Web sans serveur qui n'effectuent que des appels Web, tels que BigQuery.
Installez l'application Looker sur une machine dédiée qui répond aux exigences minimales suivantes:
- Processeur de 1,2 GHz ; Looker recommande deux cœurs ou plus.
- 8 Go de RAM libre.
- 10 Go d'espace disque libre.
- 2 Go d'espace de fichiers d'échange.
- Linux. Nous utilisons Ubuntu Linux (versions LTS) pour notre hébergement Looker interne, et nous le recommandons aux clients qui n'ont pas de préférences Linux. Toutefois, nous prenons en charge Looker sur les versions de toutes les principales distributions d'entreprise Linux, y compris RedHat, CentOS et Amazon Linux. Looker n'est compatible qu'avec les versions Linux avec des ensembles d'instructions x64.
Java OpenJDK 11.0.12+, OpenJDK 8.0.181+ ou HotSpot 1.8 mise à jour 161+. Looker utilise OpenJDK (version 11) pour améliorer les performances et l'utilisation de la mémoire. Looker recommande d'utiliser le JDK plutôt que le JRE pour profiter des outils de dépannage supplémentaires. De plus, Looker vous recommande de passer aux nouvelles mises à jour Java au fur et à mesure de leur publication. Les autres versions de Java, du JDK Oracle et d'OpenJDK ne sont pas compatibles pour le moment.
libssletlibcrypt.sodoivent être présents sur le système.Vous devez autoriser le trafic entrant vers votre instance Looker via le port TCP
9999.Si les utilisateurs ont besoin d'un accès à l'API, vous devez autoriser le trafic entrant vers votre instance Looker via le port TCP
19999.Si Looker se connecte à AWS Redshift depuis un réseau privé AWS VCP, vous devez définir la MTU sur 1 500. Pour en savoir plus sur ce paramètre, consultez la section Configurer la MTU d'une instance de cet article Amazon Web Services. Si Looker détecte que le paramètre de MTU est supérieur à 1 500 lors d'un test de connexion à la base de données, il affiche l'erreur suivante:
MTU of network interface eth0 is too large (> 1500). If Looker instance and Redshift cluster are within the same VPC, this warning can be ignored.Les paramètres keepalive TCP suivants. Pour conserver les données lors d'un redémarrage, vous devez les définir dans
/etc/sysctl.confou dans un fichier du répertoire/etc/sysctl.d:net.ipv4.tcp_keepalive_time=200 net.ipv4.tcp_keepalive_intvl=200 net.ipv4.tcp_keepalive_probes=5Un utilisateur nommé
lookerdans le groupelookerpour exécuter l'application Looker.Limite ulimit pour l'utilisateur
lookerde4096ou plus. Pour ce faire, ajoutez les lignes suivantes à/etc/security/limits.conf:looker soft nofile 4096 looker hard nofile 4096Synchronisation de l'heure via NTP ou équivalent.
Le dossier
/tmpne doit pas être installé avec l'option noexec.Le répertoire d'accueil
lookerne doit pas être installé sur un volume NFS.Il est recommandé, mais pas obligatoire, de définir le fuseau horaire du serveur sur UTC.
Git 2.39.1 ou version ultérieure est requis pour Looker 23.6 et versions ultérieures.
Bien que cela ne soit pas obligatoire, Netcat peut être utile pour résoudre les problèmes de connectivité réseau. Pour installer Netcat sur un serveur basé sur Ubuntu, par exemple, vous pouvez exécuter la commande suivante:
sudo apt-get install netcatSi nécessaire, vous pouvez configurer un serveur proxy pour gérer les requêtes HTTP(S) que Looker doit pouvoir envoyer à "core" sur localhost. Pour communiquer avec le serveur proxy local de Looker, vous devez ajouter des arguments spéciaux dans
lookerstart.cfg: ajoutezhttp.nonProxyHosts=localhostpour permettre l'accès à l'hôte local de Looker sans passer par le proxy.
Pour éviter les conflits de maintenance et de ressources, n'utilisez pas le serveur Looker pour héberger d'autres applications.
Activer ntpd ou chronyd
NTP est l'abréviation de Network Time Protocol. Elle permet à l'horloge système de votre hôte de toujours maintenir l'heure correcte dont Looker a besoin pour fonctionner correctement. Looker ne nécessite pas l'utilisation d'un logiciel de synchronisation des heures tant que les heures sont synchronisées. L'exécution d'un serveur NTP n'est pas nécessaire. Seul le client NTP est nécessaire. Vous pouvez remplacer "NTP" par "chronyd".
Consultez la documentation de votre fournisseur d'OS pour en savoir plus sur l'activation de ntpd ou de chronyd.
Créer une clé de chiffrement
Looker utilise le chiffrement AES-256 Galois/Counter Mode (GCM) pour chiffrer les données sensibles stockées en interne, y compris:
- Sauvegardes de la base de données interne de Looker
- Informations sur les connexions aux bases de données et aux services
- Informations d'authentification de l'utilisateur
- Valeurs des attributs utilisateur
- Données client mises en cache ou préparées pour la livraison
Pour obtenir la liste détaillée des données chiffrées par Looker, ouvrez une demande d'assistance.
Les données sont chiffrées à l'aide d'une clé de données unique et contiennent une enveloppe de chiffrement signée et avec gestion des versions pour garantir la vérification. Ce mode nécessite l'utilisation d'une clé principale client (CMK) externe. La clé CMK sert à extraire, chiffrer et déchiffrer la clé de chiffrement de clé (KEK, Key Encryption Key), qui permet à son tour de dériver, de chiffrer et de déchiffrer des clés de données.
Le chiffrement est utilisé uniquement pour la base de données et le cache internes de Looker. Les bases de données des clients ne sont en aucun cas affectées par le chiffrement de Looker. De plus, seules les données statiques (données stockées sur disque) sont chiffrées de cette manière.
Les installations hébergées par le client peuvent utiliser leurs propres comptes KMS AWS ou leurs propres systèmes de gestion de clés personnalisés. Toutes les clés de données et la clé KEK sont chiffrées et utilisées en interne sur l'installation de Looker hébergée par le client. Si vous n'utilisez pas AWS KMS, vous devez conserver la clé CMK externe dans un emplacement sûr et permanent. La perte de la clé CMK après le chiffrement de la base de données interne peut entraîner la perte de votre instance.
Si vous utilisez AWS KMS
Si vous utilisez AWS KMS, créez une clé CMK à l'aide d'AWS Management Console ou de l'API.
Une fois la clé CMK créée, Looker vous recommande de créer un rôle IAM unique pour celle-ci et de l'associer à votre instance Looker.
Voici un exemple de rôle IAM contenant les autorisations minimales requises pour votre clé CMK:
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": "kms:GenerateRandom",
"Resource": "*"
},
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:Encrypt",
"kms:Generate*",
],
"Resource": "arn:aws:kms:*:*:key/*"
}
]
}
Après avoir créé votre clé CMK et votre nouveau rôle IAM, définissez la variable d'environnement AWS_REGION sur votre région AWS et la variable d'environnement LKR_AWS_CMK sur l'alias de votre clé CMK:
export AWS_REGION=<AWS_region>
export LKR_AWS_CMK=alias/<CMK_alias>
Vous pouvez également définir la variable d'environnement LKR_AWS_CMK_EC pour définir un contexte de chiffrement AWS personnalisé. Si vous ne définissez pas cette variable d'environnement, Looker utilise le contexte de chiffrement par défaut, à savoir la chaîne Looker_Encryption_Context.
export LKR_AWS_CMK_EC=<My_Encryption_Context>
Si vous n'utilisez pas AWS KMS
Si vous n'utilisez pas AWS KMS, générez une clé CMK Base64 de 32 octets. Vous pouvez stocker la clé CMK dans une variable d'environnement ou dans un fichier:
Pour générer la clé CMK et la stocker dans une variable d'environnement, utilisez la commande suivante:
openssl rand -base64 32Après avoir généré la clé CMK, copiez-la et utilisez la commande suivante pour la stocker dans la variable d'environnement
LKR_MASTER_KEY_ENV(où<CMK_value>est la clé CMK générée à l'aide de la commande précédente):export LKR_MASTER_KEY_ENV=<CMK_value>Pour générer et stocker la clé CMK dans un fichier, vous pouvez utiliser la commande suivante (où
<path_to_key_file>est le chemin d'accès et le nom de fichier pour le stockage de la clé CMK):openssl rand -base64 32 > <path_to_key_file>Après avoir généré le fichier CMK, définissez les autorisations de fichier de clé en lecture seule pour l'utilisateur actuel:
chmod 0400 <path_to_key_file>
Une fois la clé CMK générée, veillez à la stocker dans un endroit sûr et permanent avant de continuer. La perte de la clé CMK après le chiffrement de la base de données interne peut entraîner la perte de votre instance.
Une fois que vous avez généré et stocké votre clé CMK, définissez la variable d'environnement LKR_MASTER_KEY_ENV:
Si vous stockez votre CMK dans une variable d'environnement, définissez la variable d'environnement
LKR_MASTER_KEY_ENVsur la valeur de la CMK:export LKR_MASTER_KEY_ENV=<CMK_value>Si vous stockez votre CMK dans un fichier, définissez la variable d'environnement
LKR_MASTER_KEY_FILEsur le chemin du fichier CMK:export LKR_MASTER_KEY_FILE=<path_to_key_file>
Une fois la clé CMK générée, veillez à la stocker dans un endroit sûr et permanent avant de continuer. La perte de la clé CMK après le chiffrement de la base de données interne peut entraîner la perte de votre instance.
Installer l'application Looker
Créer le groupe
looker.sudo groupadd lookerCréez l'utilisateur
lookeret son répertoire d'accueil.sudo useradd -m -g looker lookerPassez à l'utilisateur
looker. N'exécutez pas Looker en tant que racine.sudo su - lookerCréez un sous-répertoire
lookerdans le répertoire d'accueil.mkdir ~/lookerAccédez au sous-répertoire
looker.cd ~/lookerVérifiez que vous êtes dans le bon répertoire.
pwdSi vos répertoires d'utilisateurs se trouvent sous
/home, le résultat de cette commande doit être/home/looker/looker.Téléchargez les fichiers Looker JAR souhaités en utilisant l'une des méthodes décrites sur la page de documentation Télécharger les fichiers JAR Looker. Assurez-vous que les deux fichiers JAR ont la même version. L'utilisation de versions différentes du fichier JAR principal et des fichiers JAR de dépendance peut provoquer une instabilité dans votre installation de Looker.
Téléchargez le dernier script de démarrage dans le dépôt GitHub looker-open-source. Si vous souhaitez que Looker s'exécute au démarrage du système, vous pouvez télécharger le script Looker_init et utiliser les options de script
systemdetinit.Déplacez le script de démarrage (nommé
looker) et les fichiers JAR Looker (nomméslooker-x.x.x.jaretlooker-dependencies-x.x.x.jar, oùx.x.xest le numéro de version) vers le nouveau répertoire~/looker.Renommez
looker-x.x.x.jarenlooker.jaretlooker-dependencies-x.x.x.jarenlooker-dependencies.jar.Le script de démarrage détermine automatiquement la quantité de mémoire Java à allouer à Looker. Si vous souhaitez personnaliser cette valeur manuellement, consultez la page Paramètres de mémoire recommandés Java pour en savoir plus.
Rendez le script de démarrage Looker exécutable (définissez les autorisations sur
0750).chmod 0750 lookerDémarrez le processus Looker à partir du shell en tant qu'utilisateur
looker../looker startPour obtenir de l'aide sur l'indicateur de démarrage, utilisez:
java -jar looker.jar --helpPour obtenir de l'aide sur la commande de démarrage, utilisez la commande suivante:
java -jar looker.jar helpOuvrez un navigateur dans
https://hostname:9999, oùhostnameest le nom DNS de l'hôte qui exécute Looker.Vous devez utiliser
httpsdans l'URL, afin de créer un avertissement de sécurité que vous devrez ignorer. Cet avertissement persiste jusqu'à ce qu'un certificat SSL valide soit installé sur le serveur.Saisissez la clé de licence obtenue auprès de votre analyste Looker.
Pour créer votre premier compte, saisissez un nom, une adresse e-mail et un mot de passe.
Créer un enregistrement DNS
Ajoutez un enregistrement DNS looker.[yourdomain].com pour le serveur. Cette étape est facultative, mais recommandée.
Déployer Looker automatiquement
Looker peut être déployé à l'aide d'un outil de gestion de la configuration comme Ansible ou Chef. Un exemple de rôle Ansible pour le déploiement automatisé est disponible sur la page de documentation Outils de gestion de la configuration.
Réglage de l'hyperviseur
Looker s'exécute comme une machine virtuelle Java. Si votre instance Looker se trouve sur un invité VMware, vous devrez peut-être ajuster les performances. Consultez le guide des bonnes pratiques Java pour VMware.
Sur d'autres plates-formes de virtualisation, réserver la mémoire de l'hôte Looker à l'hyperviseur peut améliorer les performances. Ce paramètre n'est pas contrôlable sur Amazon EC2. Toutefois, pour les autres fournisseurs, nous vous invitons à consulter leur documentation pour en savoir plus.
Configurer une base de données backend MySQL facultative
Par défaut, Looker utilise une base de données en mémoire HyperSQL pour stocker sa configuration, ses utilisateurs et d'autres données. Vous pouvez cependant utiliser une base de données MySQL externe pour stocker les informations internes de Looker. Consultez la page de documentation Migrer vers MySQL pour en savoir plus sur la configuration et le réglage d'une base de données backend MySQL.
Étapes suivantes
Après avoir installé Looker, vous pouvez configurer les options de démarrage de Looker.