Vom Kunden gehostete Renderingsoftware

Looker erfordert eine Rendering-Software namens Chromium, mit der Sie Daten in Bildformaten (HTML- und PNG- oder PDF-Dateien) senden oder herunterladen und Funktionen wie Papiergröße und Tabellen maximieren verwenden können. Auf dieser Seite wird beschrieben, wie Sie Renderingsoftware auf einer vom Kunden gehosteten Instanz von Looker installieren.

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

Beim Chromium-Rendering wird gewartet, bis alle von der Seite angeforderten Ressourcen fertiggestellt sind. Erst dann wird das Signal „Looked“ gesendet, um Looker zur Darstellung des gerenderten Inhalts zu bewegen. Aufgrund der Anzahl und Häufigkeit dieser Ressourcenanfragen können einige Netzwerke die Anfragen fälschlicherweise als schädlich melden, wodurch sie abgebrochen werden. Dadurch werden Ihre gerenderten Jobs verzögert.

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

Voraussetzungen und Voraussetzungen für die Chromium-Installation

Looker unterstützt Releaseversionen aller großen Linux-Distributionen für Unternehmen, darunter Ubuntu, Debian, RedHat, CentOS und Amazon Linux. Diese Seite enthält 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 mit dem Befehl chromium oder über einen benutzerdefinierten Pfad, der mit der Umgebungsvariable CHROMIUM_PATH festgelegt wurde, auf Chromium zugreifen.

Zum Ausführen von Chromium auf einer Looker-Instanz ist Chromium 86 oder höher erforderlich. Looker empfiehlt jedoch, die neueste verfügbare Version zu verwenden. Wenn Ihre Looker-Instanz unter Debian installiert ist, erfordert Chromium Debian 9 (Stretch) oder höher.

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

Wenn Ihre Daten nicht-englische Zeichen enthalten, müssen Sie neben der Installation von Chromium auch das Paket „Google Noto Fonts“ installieren.

Dieses Schriftpaket ist 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
  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, gilt Folgendes:

  cd $HOME
  rm -rf /tmp/fonts

Chromium wird unter Ubuntu installiert

Die Looker-Anwendung muss mit dem Befehl chromium oder über einen benutzerdefinierten Pfad, der mit der Umgebungsvariable CHROMIUM_PATH festgelegt wurde, 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 die Verwendung des Befehls sudo, wenn Schritte ausgeführt werden, die erhöhte Berechtigungen erfordern. 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 keine PDF- oder PNG-Darstellung ausführen.

  1. Damit Chromium gestartet werden kann, müssen Schriftarten auf dem System installiert werden. Sie können Schriftarten über die Befehlszeile installieren. Mit diesem Befehl werden beispielsweise die Standardschriftarten auf Ubuntu 16.04 LTS installiert:
    apt-get install fonts-freefont-otf
  1. Führen Sie den folgenden Befehl aus, um Chromium zu installieren:
    apt-get update && apt-get install -y chromium-browser
  1. Muss ein Alias von chromium-browser als chromium sein oder die Umgebungsvariable CHROMIUM_PATH exportieren. Wenn Sie chromium-browser als chromium benennen möchten, fügen Sie Folgendes in die Datei ~/.bashrc ein:
    alias chromium='chromium-browser'

To make this alias known to Looker, run this command on the command line:

    sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
  1. Nachdem Sie eine der optionalen Umgebungsvariablen festgelegt haben, starten Sie die Looker-Anwendung neu, damit sie wirksam wird. Möglicherweise müssen Sie auch alle offenen Terminalsitzungen neu starten oder source ~/.bash_profile ausführen, damit das Terminal die neue Konfiguration lesen kann.

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

Chromium unter Debian installieren

Looker empfiehlt die Verwendung des Befehls sudo, wenn Schritte ausgeführt werden, die erhöhte Berechtigungen erfordern. 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 keine PDF- oder PNG-Darstellung ausführen.

Chromium erfordert Debian 9 (Stretch) oder höher.

Wenn Ihre Looker-Instanz Docker mit einer reinen Debian-Installation verwendet, installieren Sie procps und achten Sie darauf, dass sie nicht als Root ausgeführt wird.

  1. Damit Chromium gestartet werden kann, müssen Schriftarten auf dem System installiert werden. So installieren Sie Schriftarten über die Befehlszeile:
    apt-get install fonts-freefont-otf
  1. Führen Sie den folgenden Befehl aus, um Chromium zu installieren:
    apt-get update && apt-get install -y chromium
  1. Nachdem Sie eine der optionalen Umgebungsvariablen festgelegt haben, starten Sie die Looker-Anwendung neu, damit sie wirksam wird. Möglicherweise müssen Sie auch alle offenen Terminalsitzungen neu starten oder source ~/.bash_profile ausführen, damit das Terminal die neue Konfiguration lesen kann.

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

Optionale Chromium-Umgebungsvariablen

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

  • CHROMIUM_PID_DIR: Pfad zum Speicherort der Chromium PID-Dateien in der Bibliothek. Die Standardeinstellung ist chromium_pid_files im Arbeitsverzeichnis der Looker-Anwendung.

  • CHROMIUM_PORT_RANGE_START CHROMIUM_PORT_RANGE_END: Die Chromium-Anwendung benötigt eine Reihe von Ports zur Kommunikation zwischen Prozessen auf dem lokalen Computer. Der Standardbereich liegt zwischen 40.000 und 40.500. Sie können diesen Standardwert ü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. In der Regel wartet der Chromium-Renderer, bis alle von der Seite angeforderten Ressourcen abgeschlossen sind, bevor der Renderer das Signal „Fertig“ sendet, wodurch Looker aufgefordert wird, den Inhalt zu erstellen. Einige dieser Anfragen werden unter Umständen wegen fehlender Verbindung abgebrochen, was zu Zeitüberschreitungen oder sehr langen Renderingzeiten führt. Wenn Sie diese Umgebungsvariable auf true festlegen, wartet der Renderer nicht auf den Abschluss aller Anfragen. Für einige Kartenvisualisierungen und einige benutzerdefinierte Visualisierungen, die über den Looker Marketplace installiert werden, ist möglicherweise Internetzugriff erforderlich.