Ten en cuenta que estás viendo la documentación de Looker. Para obtener documentación de Looker Studio, visita https://support.google.com/looker-studio.

Se usó la API de Cloud Translation para traducir esta página.

Instala la aplicación de Looker

En esta página, se describe cómo instalar la aplicación de Looker para una implementación alojada por el cliente.

El alojamiento de la aplicación de Looker es independiente de dónde se encuentren tus datos, ya que estos siempre permanecen en la base de datos y no se copian en la instancia de Looker.

Especificaciones de la Deployment

Si vas a ejecutar Looker en una red que no se conecta a Internet, es posible que debas configurar un servidor proxy para comunicarte con el servidor de licencias de Looker o usar servicios web sin servidor que solo realicen llamadas web, como BigQuery.

Instala la aplicación de Looker en una máquina dedicada que cumpla con los siguientes requisitos mínimos:

CPU de 1.2 GHz (Looker recomienda dos o más núcleos)
8 GB de RAM libre
10 GB de espacio libre en el disco
2 GB de espacio para archivos de intercambio
Linux. Usamos Ubuntu Linux (versiones LTS) para nuestro hosting interno de Looker y lo recomendamos a los clientes que no tienen una preferencia de Linux. Sin embargo, admitimos Looker en las versiones de actualización de todas las distribuciones principales de Linux empresariales, incluidas Red Hat, CentOS y Amazon Linux. Looker solo es compatible con versiones de Linux con conjuntos de instrucciones x64.
Java OpenJDK 11.0.12 o HotSpot 1.8 actualización 161 o posterior. Looker usa OpenJDK (versión 11) para mejorar el rendimiento y el uso de la memoria. Looker recomienda el JDK, en lugar del JRE, para aprovechar las herramientas adicionales de solución de problemas. Además, Looker recomienda que realices la transición a las nuevas actualizaciones de Java a medida que se lanzan. En este momento, no se admiten otras versiones de Java, Oracle JDK y OpenJDK.

Nota: Te recomendamos que inicies Looker con la marca JVM -Dnashorn.args=--optimistic-types=false cuando ejecutes Looker en JDK11.
libssl y libcrypt.so deben estar presentes en el sistema.
Debes permitir el tráfico entrante a tu instancia de Looker a través del puerto TCP 9999.
Si los usuarios requieren acceso a la API, debes permitir el tráfico entrante a tu instancia de Looker a través del puerto TCP 19999.
Si Looker se conecta a AWS Redshift desde una red privada de VPC de AWS, debes configurar la MTU en 1500. Para obtener más información sobre este parámetro de configuración, consulta la sección Configura la MTU de una instancia de este artículo de Amazon Web Services. Si Looker detecta que el parámetro de configuración de MTU es superior a 1,500 durante una prueba de conexión de base de datos, muestra el siguiente error:
```
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.
```
La siguiente configuración de keepalive de TCP Para que se conserven después de un reinicio, deben configurarse en /etc/sysctl.conf o en un archivo del directorio /etc/sysctl.d:
```
net.ipv4.tcp_keepalive_time=200
net.ipv4.tcp_keepalive_intvl=200
net.ipv4.tcp_keepalive_probes=5
```
Un usuario llamado looker en el grupo llamado looker para ejecutar la aplicación de Looker.
Un ulimit para el usuario looker de 4096 o una versión posterior Para hacerlo, agrega las siguientes líneas a /etc/security/limits.conf:
```
looker     soft     nofile     4096
looker     hard     nofile     4096
```
Sincronización de hora a través de NTP o un equivalente
La carpeta /tmp no se debe activar con la opción noexec.
El directorio principal looker no debe activarse en un volumen NFS.
Se recomienda configurar la zona horaria del servidor en UTC, pero no es obligatorio.
Se requiere Git 2.39.1 o una versión posterior para Looker 23.6 y versiones posteriores.
Aunque no es obligatorio, Netcat puede ser útil para solucionar problemas de conectividad de red. Para instalar Netcat en, por ejemplo, un servidor basado en Ubuntu, un comando común es el siguiente:
```
sudo apt-get install netcat
```
Si es necesario, puedes configurar un servidor proxy para manejar las solicitudes HTTP(S) que Looker debe poder hacer para “core” en localhost. Para comunicarte con el servidor proxy local de Looker, debes agregar algunos argumentos especiales en lookerstart.cfg: agrega http.nonProxyHosts=localhost para habilitar el acceso al localhost de Looker sin pasar por el proxy.

Para evitar conflictos de mantenimiento y recursos, no debes usar el servidor de Looker para alojar otras aplicaciones.

Habilitar ntpd o chronyd

NTP significa protocolo NTP. Permite que el reloj del sistema del host siempre mantenga la hora correcta, que Looker necesita para funcionar correctamente. Looker no requiere que se use ningún software de sincronización de hora en particular, siempre y cuando los horarios permanezcan sincronizados. No es necesario ejecutar un servidor NTP; solo se necesita el cliente NTP. Puedes sustituir chronyd por NTP.

Consulta la documentación del proveedor del SO para obtener información sobre cómo habilitar ntpd o chronyd.

Crea una clave de encriptación

Looker usa la encriptación AES-256 Galois/Counter Mode (GCM) para encriptar los datos sensibles que se almacenan de forma interna, incluidos los siguientes:

Copias de seguridad de la base de datos interna de Looker
Información de conexión de la base de datos y el servicio
Información de autenticación del usuario
Valores de atributos del usuario
Datos del cliente almacenados en caché o listos para la entrega

Para obtener una lista detallada de los datos que encripta Looker, abre una solicitud de asistencia.

Los datos se encriptan con una clave de datos única y contienen un sobre de encriptación firmado y con versión para garantizar la verificación. Este modo requiere el uso de una clave principal de cliente (CMK) externa. La CMK se usa para derivar, encriptar y desencriptar la clave de encriptación de claves (KEK), que a su vez se usa para derivar, encriptar y desencriptar claves de datos.

La encriptación se usa solo para la base de datos y la caché interna de Looker. Las bases de datos de los clientes no se ven afectadas por la encriptación de Looker de ninguna manera. Además, solo los datos estáticos (datos almacenados en el disco) se encriptan de esta manera.

Las instalaciones alojadas por el cliente pueden usar sus propias cuentas de AWS KMS o sus propios sistemas de administración de claves personalizados. Todas las claves de datos y la KEK se encriptan y se usan de forma interna en la instalación de Looker alojada por el cliente. Si no usas AWS KMS, la CMK externa debe mantenerse en una ubicación segura y permanente. Perder la CMK después de encriptar la base de datos interna puede provocar la pérdida de tu instancia.

Si usas AWS KMS

Si usas AWS KMS, crea una CMK con la consola de administración de AWS o la API.

Después de crear la CMK, Looker te recomienda crear un nuevo rol de IAM que sea único para tu CMK y vincularlo a tu instancia de Looker.

A continuación, se muestra un ejemplo de un rol de IAM que contiene los permisos mínimos necesarios para tu 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/*"
        }
    ]
}

Después de crear la CMK y el nuevo rol de IAM, establece la variable de entorno AWS_REGION en tu región de AWS y la variable de entorno LKR_AWS_CMK en el alias de tu CMK:

export AWS_REGION=<AWS_region>
export LKR_AWS_CMK=alias/<CMK_alias>

De forma opcional, también puedes configurar la variable de entorno LKR_AWS_CMK_EC para establecer un contexto de encriptación de AWS personalizado. Si no configuras esta variable de entorno, Looker usará el contexto de encriptación predeterminado, la cadena Looker_Encryption_Context.

export LKR_AWS_CMK_EC=<My_Encryption_Context>

Si no usas AWS KMS

Si no usas AWS KMS, genera una CMK de 32 bytes en Base64. Puedes almacenar la CMK en una variable de entorno o en un archivo:

Para generar la CMK y almacenarla en una variable de entorno, puedes usar el siguiente comando:
```
openssl rand -base64 32
```
Después de generar la CMK, cópiala y usa el siguiente comando para almacenarla en la variable de entorno LKR_MASTER_KEY_ENV (donde <CMK_value> es la CMK que generaste con el comando anterior):
```
export LKR_MASTER_KEY_ENV=<CMK_value>
```
Para generar y almacenar la CMK en un archivo, puedes usar el siguiente comando (en el que <path_to_key_file> es la ruta de acceso y el nombre del archivo para almacenar la CMK):
```
openssl rand -base64 32 > <path_to_key_file>
```
Después de generar el archivo CMK, configura los permisos del archivo de claves en el modo de solo lectura del usuario actual:
```
chmod 0400 <path_to_key_file>
```

Después de generar una CMK, asegúrate de almacenarla en una ubicación segura y permanente antes de continuar. Perder la CMK después de encriptar la base de datos interna puede provocar la pérdida de tu instancia.

Una vez que hayas generado y almacenado tu CMK, configura la variable de entorno LKR_MASTER_KEY_ENV:

Si almacenas tu CMK en una variable de entorno, configura la variable de entorno LKR_MASTER_KEY_ENV en el valor de la CMK:
```
export LKR_MASTER_KEY_ENV=<CMK_value>
```
Si almacenas tu CMK en un archivo, configura la variable de entorno LKR_MASTER_KEY_FILE como la ruta de acceso al archivo CMK:
```
export LKR_MASTER_KEY_FILE=<path_to_key_file>
```

Después de generar una CMK, asegúrate de almacenarla en una ubicación segura y permanente antes de continuar. Perder la CMK después de encriptar la base de datos interna puede provocar la pérdida de tu instancia.

Instala la aplicación de Looker

Crear el grupo looker.
```
sudo groupadd looker
```
Crea el usuario looker y su directorio principal.
```
sudo useradd -m  -g looker  looker
```
Cambia al usuario looker. no ejecutes Looker como raíz.
```
sudo su - looker
```
Crea el subdirectorio looker en el directorio principal.
```
mkdir ~/looker
```
Cambia al subdirectorio looker.
```
cd ~/looker
```
Asegúrate de estar en el directorio correcto.
```
pwd
```
Si los directorios de usuarios se encuentran en /home, el resultado de este comando debería ser /home/looker/looker.
Descarga los archivos JAR de Looker elegidos a través de uno de los métodos de la página de documentación Descarga los archivos JAR de Looker. Asegúrate de que ambos archivos JAR tengan la misma versión. El uso de versiones diferentes de los archivos JAR principales y de dependencias puede causar inestabilidad en la instalación de Looker.
Descarga la secuencia de comandos de inicio más reciente en el repositorio de GitHub de looker-open-source. Si quieres que Looker se ejecute al inicio del sistema, puedes descargar la secuencia de comandoslooker_init y usar las opciones de secuencia de comandos systemd y init.
Mueve la secuencia de comandos de inicio (llamada looker) y los archivos JAR de Looker (llamados looker-x.x.x.jar y looker-dependencies-x.x.x.jar, en los que x.x.x es el número de versión) al nuevo directorio ~/looker.
Cambia el nombre de looker-x.x.x.jar a looker.jar y el de looker-dependencies-x.x.x.jar a looker-dependencies.jar.
La secuencia de comandos de inicio determina automáticamente cuánta memoria Java se debe asignar a Looker. Si deseas personalizar este valor de forma manual, consulta la página de documentación Configuración de memoria recomendada de Java para obtener más información.
Haz que la secuencia de comandos de inicio de Looker sea ejecutable (establece los permisos en 0750).
```
chmod 0750 looker
```
Inicia el proceso de Looker desde la shell como el usuario looker.

Nota: Si deseas crear una nueva instancia de Looker que cumpla con el estándar FIPS 140-2, incluye la opción de inicio --fips cuando inicies la instancia por primera vez. Esto pondrá la instancia nueva en modo que cumple con FIPS. Para obtener más información, consulta la página de documentación Habilita el cumplimiento de FIPS 140-2 de nivel 1.
```
./looker start
```
Para obtener ayuda sobre las marcas de inicio, usa lo siguiente:
```
java -jar looker.jar --help
```
O bien, para obtener ayuda con el comando de inicio, usa:
```
java -jar looker.jar help
```
Abre un navegador con https://hostname:9999, en el que hostname es el nombre de DNS del host que ejecuta Looker.

Debes usar https en la URL, lo que creará una advertencia de seguridad que deberás omitir. Esta advertencia persistirá hasta que se instale un certificado SSL válido en el servidor.
Ingresa la clave de licencia que obtuviste de tu analista de Looker.
Ingresa un nombre, un correo electrónico y una contraseña para crear tu primera cuenta.

Crea un registro DNS

Agrega un registro DNS looker.[yourdomain].com para el servidor. Este paso es opcional, pero se recomienda hacerlo.

Implementa Looker automáticamente

Looker se puede implementar con una herramienta de administración de configuración, como Ansible o Chef. Un ejemplo de rol de Ansible para la implementación automatizada está disponible en la página de documentación Herramientas de administración de configuración.

Ajuste del hipervisor

Looker se ejecuta como una máquina virtual de Java. Si tu instancia de Looker está en un invitado de VMware, es posible que debas realizar algunos ajustes de rendimiento. Consulta la guía de prácticas recomendadas para Java de VMware.

En otras plataformas de virtualización, es posible que se mejore el rendimiento si se reserva la memoria del host de Looker desde el hipervisor. Esto no se puede controlar en Amazon EC2. Sin embargo, para otros proveedores, debes consultar su documentación para obtener más información.

Configura una base de datos de backend de MySQL opcional

De forma predeterminada, Looker usa una base de datos en memoria HyperSQL para almacenar su configuración, usuarios y otros datos. Sin embargo, puedes usar una base de datos MySQL externa para almacenar la información interna de Looker. Consulta la página de documentación Migra a MySQL para obtener información sobre cómo configurar y ajustar una base de datos de backend de MySQL.

Próximos pasos

Después de instalar Looker, puedes configurar las opciones de inicio de Looker.