Vom Kunden gehostete Installation der Rendering-Software

Looker benötigt die Rendering-Software Chromium, um Daten in bildbasierten Formaten wie HTML-, PNG- oder PDF-Dateien zu senden oder herunterzuladen und 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.

Beim Chromium-Rendering wird gewartet, bis alle von der Seite angeforderten Ressourcen fertig sind, bevor das Signal „fertig“ gesendet wird, das Looker auffordert, die gerenderten Inhalte zu erstellen. Aufgrund der Anzahl und Häufigkeit dieser Ressourcenanfragen können einige Netzwerke die Anfragen fälschlicherweise als schädlich kennzeichnen, wodurch sie abgelehnt werden. Das verzögert Ihre gerenderten Jobs.

Das Chromium-Projekt ist ein Open-Source-Projekt, das von Google ins Leben gerufen wurde, um die nicht proprietären Teile von Google Chrome freizugeben.

Hinweis

Bevor Sie Chromium installieren, sollten Sie sich mit den folgenden Themen vertraut machen:

Anforderungen und Voraussetzungen für die Installation von Chromium

Auf dieser Seite finden Sie eine Beispielanleitung zur Installation von Chromium, die unabhängig vom Distributionstyp ist. Sie können auch Chromium herunterladen und dann der restlichen Installationsanleitung auf dieser Seite folgen.

Zum Ausführen von Chromium in einer Looker-Instanz sind Chromium 97, Chromium 109 oder Chromium 114 erforderlich. Chromium muss auf dem Computer, auf dem die Looker-Instanz gehostet wird, in einem ausführbaren Pfad installiert sein. 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 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.

Wichtige Informationen zur Installation von Chromium auf bestimmten Distributionen

Looker unterstützt Release-Versionen aller gängigen Enterprise-Linux-Distributionen, einschließlich Ubuntu (LTS-Releases), Debian 9 und höher, RedHat Enterprise Linux (RHEL) 7 und höher, CentOS 7 und höher sowie Amazon Linux.

Bei Ubuntu-Installationen müssen Sie den Chromium-Webbrowser installieren und dann einen Alias festlegen, damit die Looker-Anwendung die Installation finden kann.

Für Debian-Installationen 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 angemeldet sind.

Schriftpakete installieren

Damit Chromium gestartet werden kann, muss ein Microsoft OpenType-Schriftpaket (OTF) auf dem System installiert sein. OTF-Pakete haben die Dateiendung .otf. Sie können ein beliebiges OTF-Paket herunterladen, z. B. dieses OTF-Paket von Google Fonts.

Wenn Ihre Daten Zeichen enthalten, die nicht dem lateinischen Alphabet angehören, müssen Sie auch das Google Noto Fonts-Paket installieren, das mehrere GB groß ist.

Führen Sie nach der Installation dieser Pakete die folgenden Befehle aus:

cd $HOME
rm -rf /tmp/fonts

Chromium installieren

  1. Führen Sie zum Installieren von Chromium den für Ihr System zutreffenden Installationsbefehl aus. Beispiel:

    apt-get update && apt-get install -y chromium-browser

  2. Sie müssen entweder einen Alias für chromium-browser als chromium erstellen oder die Umgebungsvariable CHROMIUM_PATH exportieren. Wenn Sie chromium-browser als Alias für chromium festlegen möchten, fügen Sie Folgendes in die Shell-Datei ein, die für Ihr System gilt. Beispiel:

    alias chromium='chromium-browser'

    Damit Looker diesen Alias kennt, führen Sie diesen Befehl in der Befehlszeile aus:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium

  3. Nachdem Sie eine der optionalen Umgebungsvariablen festgelegt haben, starten Sie die Looker-Anwendung neu, damit die Variablen wirksam werden. Möglicherweise müssen Sie auch alle geöffneten Terminalsitzungen neu starten oder die Shell-Datei ausführen, damit das Terminal die neue Konfiguration liest.

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

Optionale Chromium-Umgebungsvariablen

  • CHROMIUM_PATH: Pfad zur Chromium-Binärdatei, standardmäßig chromium.

  • CHROMIUM_PID_DIR: Pfad, unter dem die Bibliothek Chromium-PID-Dateien speichern kann. Standardmäßig ist das chromium_pid_files im Arbeitsverzeichnis der Looker-Anwendung.

  • 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 ist 40.000–40.500. Sie können diesen Standardwert jedoch überschreiben, indem Sie beide Umgebungsvariablen festlegen. Nicht verwendete Ports werden nach dem Zufallsprinzip aus dem Bereich ausgewählt und nur für die Dauer eines einzelnen Renderings verwendet.

  • 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, bis alle von der Seite angeforderten Ressourcen fertig sind, bevor er das Signal „Fertig“ sendet, das Looker auffordert, die Inhalte zu generieren. Einige dieser Anfragen werden möglicherweise aufgrund einer fehlenden Verbindung verworfen, was zu Zeitüberschreitungen oder sehr langen Renderingzeiten führt. Wenn Sie diese Umgebungsvariable auf true festlegen, wartet der Renderer nicht, bis alle Anfragen abgeschlossen sind. Für einige Kartenvisualisierungen und einige benutzerdefinierten Visualisierungen, die über den Looker Marketplace installiert werden, ist möglicherweise ein Internetzugriff erforderlich.