Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Questa pagina è stata tradotta dall'API Cloud Translation.

Installazione del software di rendering ospitata dal cliente

Looker richiede un software di rendering chiamato Chromium per inviare o scaricare dati in formati basati su immagini (file HTML e PNG o PDF) e per utilizzare funzionalità come Formato carta ed Espandi tabelle. Questa pagina spiega come installare il software di rendering in un'istanza di Looker ospitata dal cliente.

Chromium è già installato per le istanze ospitate da Looker.

Il rendering di Chromium attende il completamento di tutte le risorse richieste dalla pagina prima di inviare l'indicatore "fine" che chiede a Looker di produrre i contenuti visualizzati. A causa del numero e della frequenza di queste richieste di risorse, alcune reti possono segnalare erroneamente le richieste come dannose, causandone l'eliminazione, con un conseguente ritardo dei job visualizzati.

Il progetto Chromium è un progetto open source avviato da Google per condividere le parti non proprietarie di Google Chrome.

Requisiti e prerequisiti per l'installazione di Chromium

Looker supporta le versioni di release di tutte le principali distribuzioni Linux aziendali, tra cui Ubuntu, Debian, RedHat, CentOS e Amazon Linux. Questa pagina fornisce istruzioni per installare Chromium su Ubuntu, Debian e RedHat/CentOS/Amazon Linux.

Chromium deve essere installato in un percorso eseguibile sulla macchina che ospita l'istanza Looker. L'applicazione Looker deve accedere a Chromium utilizzando il comando chromium o un percorso personalizzato impostato con la variabile di ambiente CHROMIUM_PATH.

Per eseguire Chromium in un'istanza di Looker, è necessario Chromium 86 o versioni successive, ma Looker consiglia di utilizzare specificamente Chromium 102.x. Se l'istanza Looker è installata su Debian, Chromium richiede Debian 9 (stretch) o versioni successive.

Se stai installando Chromium in un'installazione di Looker in cluster, la versione di Chromium su ogni nodo deve essere completamente identica. Anche differenze minime, come numeri di build diversi, possono interferire con le funzionalità di rendering di Looker.

Se i dati contengono caratteri non inglesi, installa il pacchetto Google Noto Fonts (che ha una dimensione di diversi GB) oltre a installare Chromium. Per installare questo pacchetto di caratteri, esegui questi comandi nella riga di comando:

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

In caso di esito positivo:

cd $HOME
rm -rf /tmp/fonts

Installazione di Chromium su Ubuntu

L'applicazione Looker deve accedere a Chromium utilizzando il comando chromium o un percorso personalizzato impostato con la variabile di ambiente CHROMIUM_PATH. Per le installazioni Ubuntu, devi installare il browser web Chromium e quindi impostare un alias in modo che l'applicazione Looker possa trovare l'installazione.

Looker consiglia di utilizzare il comando sudo quando esegui passaggi che richiedono autorizzazioni elevate. Non installare Chromium se hai eseguito l'accesso come utente root. Se installi Chromium dopo aver eseguito l'accesso come utente root, Looker potrebbe non essere in grado di eseguire il rendering di PDF o PNG.

I caratteri devono essere installati sul sistema per l'avvio di Chromium. Puoi installare i caratteri utilizzando l'interfaccia a riga di comando. Ad esempio, questo comando installa i caratteri predefiniti su Ubuntu 16.04 LTS:
```
apt-get install fonts-freefont-otf
```

Per installare Chromium, esegui:

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

Devi alias chromium-browser come chromium o esportare la variabile di ambiente CHROMIUM_PATH. Per eseguire l'alias chromium-browser come chromium, inserisci quanto segue nel file ~/.bashrc:
```
alias chromium='chromium-browser'
```
Per rendere noto a Looker questo alias, esegui questo comando dalla riga di comando:
```
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
```
Dopo aver impostato una delle variabili di ambiente facoltative, riavvia l'applicazione Looker affinché le modifiche vengano applicate. Potresti anche dover riavviare le sessioni del terminale aperte o eseguire source ~/.bash_profile per consentire al terminale di leggere la nuova configurazione.

Dopo aver installato Chromium, dovresti ricevere una risposta valida da chromium --version se non hai impostato la variabile di ambiente CHROMIUM_PATH o da $CHROMIUM_PATH --version se hai impostato la variabile di ambiente CHROMIUM_PATH.

Installazione di Chromium su Debian

Looker consiglia di utilizzare il comando sudo quando esegui passaggi che richiedono autorizzazioni elevate. Non installare Chromium se hai eseguito l'accesso come utente root. Se installi Chromium dopo aver eseguito l'accesso come utente root, Looker potrebbe non essere in grado di eseguire il rendering PDF o PNG.

Chromium richiede Debian 9 (stretch) o versioni successive.

Se la tua istanza di Looker utilizza Docker con un'installazione Debian di base, installa procps e assicurati di non eseguire il comando come root.

Per poter avviare Chromium, i caratteri devono essere installati sul sistema. Puoi installare i caratteri utilizzando l'interfaccia a riga di comando eseguendo:
```
apt-get install fonts-freefont-otf
```

Per installare Chromium, esegui:

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

Dopo aver impostato una delle variabili di ambiente facoltative, riavvia l'applicazione Looker affinché le modifiche vengano applicate. Potresti anche dover riavviare le sessioni del terminale aperte o eseguire source ~/.bash_profile per consentire al terminale di leggere la nuova configurazione.

Variabili di ambiente facoltative di Chromium

CHROMIUM_PATH: percorso del file binario di Chromium, il valore predefinito è chromium.
CHROMIUM_PID_DIR: percorso in cui la libreria può archiviare i file PID di Chromium. Il valore predefinito è chromium_pid_files nella directory di lavoro dell'applicazione Looker.
CHROMIUM_PORT_RANGE_START e CHROMIUM_PORT_RANGE_END: l'applicazione Chromium ha bisogno di una serie di porte per comunicare tra i processi sulla macchina locale. L'intervallo predefinito è 40.000-40.500, ma puoi ignorare questo valore predefinito impostando entrambe le variabili di ambiente. Le porte inutilizzate vengono selezionate in modo casuale dall'intervallo e vengono utilizzate solo per la durata di un singolo rendering.
DISABLE_EXTERNAL_RENDER_ACCESS: gli amministratori di istanze o server Looker ospitati dal cliente che non hanno accesso a internet esterno o bloccato devono impostare DISABLE_EXTERNAL_RENDER_ACCESS=true. In genere, il renderer di Chromium attende il completamento di tutte le risorse richieste dalla pagina prima che invii il renderer "finited" un indicatore che richiede a Looker di produrre i contenuti. Alcune di queste richieste potrebbero essere ignorate a causa della mancanza di connessione, con conseguente timeout o tempi di rendering molto lunghi. L'impostazione di questa variabile di ambiente su true impedisce al renderer di attendere il completamento di tutte le richieste. Alcune visualizzazioni di mappe e alcune visualizzazioni personalizzate installate da Looker Marketplace potrebbero richiedere l'accesso a internet.