Vom Kunden gehostete Installation der Rendering-Software

Looker benötigt die Rendering-Software Chromium, um Daten in bildbasierten Formaten – HTML- und PNG- oder PDF-Dateien – zu senden oder herunterzuladen und Funktionen wie Papierformat und Tabellen erweitern zu verwenden. Auf dieser Seite wird beschrieben, wie Sie die Rendering-Software auf einer vom Kunden gehosteten Instanz von Looker 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 verworfen werden. Dies führt zu Verzögerungen bei den gerenderten Jobs.

Das Chromium-Projekt ist ein Open-Source-Projekt, das von Google gestartet wurde, um die nicht proprietären Teile von Google Chrome zu teilen.

Hinweis

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

Anforderungen und Voraussetzungen für die Chromium-Installation

Auf dieser Seite finden Sie Beispielanleitungen für die Installation von Chromium, die unabhängig vom Distributionstyp sind. Sie können Chromium auch herunterladen und dann die restlichen Installationsanweisungen auf dieser Seite befolgen.

Für die Ausführung von Chromium auf einer Looker-Instanz sind Chromium 97, Chromium 109 oder Chromium 114 erforderlich. Chromium muss in einem ausführbaren Pfad auf dem Computer installiert sein, 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 Umgebungsvariable CHROMIUM_PATH [festgelegt ist(#optional_chromium_environment_variables).

Wenn Sie Chromium auf einer gruppierten Looker-Installation installieren, muss die Chromium-Version auf jedem Knoten vollständig identisch sein. Auch geringfügige Unterschiede wie unterschiedliche Buildnummern können die Rendering-Funktionen von Looker beeinträchtigen.

Wichtige Informationen zur Installation von Chromium auf bestimmten Distributionen

Looker unterstützt Release-Versionen aller wichtigen Enterprise-Linux-Distributionen, einschließlich Ubuntu (LTS-Releases), Debian 9+, Red Hat Enterprise Linux (RHEL) 7+, CentOS 7+ und 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 Chromium 9 (Stretch) oder höher erforderlich. Wenn Ihre Looker-Instanz Docker mit einer Bare-Bones-Debian-Installation verwendet, installieren Sie procps und achten Sie darauf, dass Sie nicht als Root ausgeführt werden.

Schriftartenpakete installieren

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

Wenn Ihre Daten nicht englische Zeichen enthalten, 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 den Installationsbefehl aus, der für Ihr System gilt, um Chromium zu installieren. Beispiel:

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

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

    alias chromium='chromium-browser'

    Führen Sie den folgenden Befehl in der Befehlszeile aus, damit Looker diesen Alias erkennt:

    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 offenen Terminalsitzungen neu starten oder Ihre Shell-Datei ausführen, damit das Terminal die neue Konfiguration lesen kann.

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

Optionale Chromium-Umgebungsvariablen

  • CHROMIUM_PATH: Pfad zum Chromium-Binärprogramm, Standardwert ist chromium.

  • CHROMIUM_PID_DIR: Pfad, in dem die Bibliothek Chromium-PID-Dateien speichern kann. Der Standardwert ist chromium_pid_files im Arbeitsverzeichnis der Looker-Anwendung.

  • CHROMIUM_PORT_RANGE_START und CHROMIUM_PORT_RANGE_END: Die Chromium-Anwendung benötigt einen Portbereich für die Kommunikation zwischen Prozessen auf dem lokalen Computer. Der Standardbereich ist 40000–40500. Sie können diesen Standardwert jedoch überschreiben, indem Sie beide Umgebungsvariablen festlegen. Nicht verwendete Ports werden zufällig 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 ohne externen oder blockierten Internetzugriff sollten DISABLE_EXTERNAL_RENDER_ACCESS=true festlegen. In der Regel 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 erstellen. Einige dieser Anfragen werden möglicherweise aufgrund fehlender Verbindung verworfen, was zu Zeitüberschreitungen oder sehr langen Rendering-Zeiten führt. Wenn Sie diese Umgebungsvariable auf true setzen, wartet der Renderer nicht, bis alle Anfragen abgeschlossen sind. Für einige Kartenvisualisierungen und einige benutzerdefinierte Visualisierungen, die aus dem Looker Marketplace installiert wurden, ist möglicherweise ein Internetzugriff erforderlich.