Beachten Sie, dass Sie sich gerade die Looker-Dokumentation ansehen. Die Looker Studio-Dokumentation finden Sie unter https://support.google.com/looker-studio.

Diese Seite wurde von der Cloud Translation API übersetzt.

Vom Kunden gehostete Installation der Rendering-Software

Looker benötigt eine Rendering-Software namens Chromium, um Daten in bildbasierten Formaten – HTML-, PNG- oder PDF-Dateien – zu senden oder herunterzuladen und um Funktionen wie Papierformat und Tabellen maximieren zu verwenden. Auf dieser Seite wird beschrieben, wie Sie Rendering-Software auf einer vom Kunden gehosteten Looker-Instanz installieren.

Chromium ist für von Looker gehostete Instanzen bereits installiert.

Beim Chromium-Rendering wird gewartet, bis alle von der Seite angeforderten Ressourcen abgeschlossen sind, bevor das Ergebnis „Fertig“ gesendet wird. Signal, das Looker auffordert, den gerenderten Inhalt zu erstellen. Aufgrund der Anzahl und Häufigkeit dieser Ressourcenanfragen können einige Netzwerke die Anfragen fälschlicherweise als schädlich markieren, wodurch sie verworfen werden, wodurch sich Ihre gerenderten Jobs verzögern.

Das Chromium-Projekt ist ein Open-Source-Projekt, das von Google gestartet wurde, um nicht-proprietäre Komponenten von Google Chrome zur Verfügung zu stellen.

Installationsanforderungen und Voraussetzungen für Chromium

Looker unterstützt Release-Versionen aller gängigen Enterprise-Linux-Distributionen, darunter Ubuntu, Debian, RedHat, CentOS und Amazon Linux. Auf dieser Seite finden Sie eine Anleitung zur Installation von Chromium unter Ubuntu, Debian und RedHat/CentOS/Amazon Linux.

Chromium muss in einem ausführbaren Pfad auf dem Computer installiert werden, auf dem die Looker-Instanz gehostet wird. Die Looker-Anwendung muss entweder über den Befehl chromium oder über einen benutzerdefinierten Pfad auf Chromium zugreifen, der mit der Umgebungsvariablen CHROMIUM_PATH festgelegt ist.

Wenn Sie Chromium auf einer Looker-Instanz ausführen möchten, ist Chromium 86 oder höher erforderlich. Looker empfiehlt jedoch, speziell Chromium 102.x zu verwenden. Wenn Ihre Looker-Instanz auf Debian installiert ist, benötigt Chromium Debian 9 (Stretch) oder höher.

Wenn Sie Chromium in einer clusterbasierten Looker-Installation installieren, muss die Chromium-Version auf jedem Knoten identisch sein. Selbst geringfügige Unterschiede, z. B. unterschiedliche Build-Nummern, können die Rendering-Funktionen von Looker beeinträchtigen.

Wenn Ihre Daten Zeichen enthalten, die nicht dem lateinischen Alphabet angehören, installieren Sie zusätzlich zu Chromium das Google Noto Fonts-Paket (mehrere GB groß). Führen Sie die folgenden Befehle in der Befehlszeile aus, um dieses Schriftartpaket zu installieren:

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

Wenn der Vorgang erfolgreich war, gehen Sie so vor:

cd $HOME
rm -rf /tmp/fonts

Chromium unter Ubuntu installieren

Die Looker-Anwendung muss entweder über den Befehl chromium oder über einen benutzerdefinierten Pfad, der in der Umgebungsvariable CHROMIUM_PATH festgelegt ist, auf Chromium zugreifen. Bei Ubuntu-Installationen müssen Sie den Chromium-Webbrowser installieren und dann einen Alias festlegen, damit die Looker-Anwendung die Installation finden kann.

Looker empfiehlt, den Befehl sudo zu verwenden, wenn Sie Schritte ausführen, für die erhöhte Berechtigungen erforderlich sind. Installieren Sie Chromium nicht, wenn Sie als Root-Nutzer angemeldet sind. Wenn Sie Chromium installieren, während Sie als Root-Nutzer angemeldet sind, kann Looker möglicherweise kein PDF- oder PNG-Rendering ausführen.

Auf dem System müssen Schriftarten installiert sein, damit Chromium gestartet werden kann. Sie können Schriftarten über die Befehlszeile installieren. Mit diesem Befehl werden beispielsweise die Standardschriftarten unter Ubuntu 16.04 LTS installiert:
```
apt-get install fonts-freefont-otf
```
Führen Sie folgenden Befehl aus, um Chromium zu installieren:
```
apt-get update && apt-get install -y chromium-browser
```
Sie müssen entweder einen Alias für chromium-browser als chromium erstellen oder die Umgebungsvariable CHROMIUM_PATH exportieren. Fügen Sie Folgendes in die Datei ~/.bashrc ein, um chromium-browser als Alias für chromium festzulegen:
```
alias chromium='chromium-browser'
```
Um Looker dieses Alias bekannt zu machen, führen Sie den folgenden Befehl in der Befehlszeile aus:
```
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
```
Nachdem Sie eine der optionalen Umgebungsvariablen festgelegt haben, starten Sie die Looker-Anwendung neu, damit sie wirksam werden. Möglicherweise müssen Sie auch alle geöffneten Terminalsitzungen neu starten oder source ~/.bash_profile ausführen, damit das Terminal die neue Konfiguration liest.

Nach der Installation von Chromium sollten Sie eine gültige Antwort von chromium --version erhalten, wenn Sie die Umgebungsvariable CHROMIUM_PATH nicht festgelegt haben, oder $CHROMIUM_PATH --version, wenn Sie die Umgebungsvariable CHROMIUM_PATH festgelegt haben.

Chromium unter Debian installieren

Looker empfiehlt, den Befehl sudo zu verwenden, wenn Sie Schritte ausführen, für die erhöhte Berechtigungen erforderlich sind. Installieren Sie Chromium nicht, wenn Sie als Root-Nutzer angemeldet sind. Wenn Sie Chromium installieren, während Sie als Root-Nutzer angemeldet sind, kann Looker möglicherweise kein PDF- oder PNG-Rendering ausführen.

Für Chromium ist Debian 9 (Stretch) oder höher erforderlich.

Wenn für Ihre Looker-Instanz Docker mit einer einfachen Debian-Installation verwendet wird, installieren Sie procps und achten Sie darauf, dass Sie nicht als Root-Nutzer ausgeführt werden.

Auf dem System müssen Schriftarten installiert sein, damit Chromium gestartet werden kann. Sie können Schriftarten über die Befehlszeile installieren. Führen Sie dazu Folgendes aus:
```
apt-get install fonts-freefont-otf
```
Führen Sie folgenden Befehl aus, um Chromium zu installieren:
```
apt-get update && apt-get install -y chromium
```
Nachdem Sie eine der optionalen Umgebungsvariablen festgelegt haben, starten Sie die Looker-Anwendung neu, damit sie wirksam werden. Möglicherweise müssen Sie auch alle geöffneten Terminalsitzungen neu starten oder source ~/.bash_profile ausführen, damit das Terminal die neue Konfiguration liest.

Nach der Installation von Chromium sollten Sie eine gültige Antwort von chromium --version erhalten, wenn Sie die Umgebungsvariable CHROMIUM_PATH nicht festgelegt haben, oder von $CHROMIUM_PATH --version, wenn Sie die Umgebungsvariable CHROMIUM_PATH festgelegt haben.

Optionale Chromium-Umgebungsvariablen

CHROMIUM_PATH: Pfad zum Chromium-Binärprogramm. Der Standardwert ist chromium.
CHROMIUM_PID_DIR: Pfad, in dem die Bibliothek Chromium PID-Dateien speichern kann. Der Standardwert im Arbeitsverzeichnis der Looker-Anwendung ist chromium_pid_files.
CHROMIUM_PORT_RANGE_START und CHROMIUM_PORT_RANGE_END: Die Chromium-Anwendung benötigt eine Reihe von Ports, um zwischen Prozessen auf dem lokalen Computer zu kommunizieren. Der Standardbereich liegt zwischen 40.000 und 40.500. Sie können ihn jedoch überschreiben, indem Sie diese beiden Umgebungsvariablen festlegen. Nicht verwendete Ports werden zufällig aus dem Bereich ausgewählt und nur für die Dauer eines einzelnen Renderings genutzt.
DISABLE_EXTERNAL_RENDER_ACCESS: Administratoren von vom Kunden gehosteten Looker-Instanzen oder ‑Servern, die keinen externen oder blockierten Internetzugriff haben, sollten DISABLE_EXTERNAL_RENDER_ACCESS=true festlegen. Normalerweise wartet der Chromium-Renderer darauf, dass alle von der Seite angeforderten Ressourcen abgeschlossen sind, bevor der Renderer den Status „Fertig“ sendet. das Looker zur Erstellung des Inhalts auffordert. Einige dieser Anfragen werden möglicherweise aufgrund fehlender Verbindung verworfen, was zu Zeitüberschreitungen oder sehr langen Renderzeiten führt. Wenn Sie diese Umgebungsvariable auf true festlegen, kann der Renderer nicht warten, bis alle Anfragen abgeschlossen sind. Einige Kartenvisualisierungen und einige benutzerdefinierte Visualisierungen, die über den Looker Marketplace installiert werden, erfordern möglicherweise einen Internetzugriff.