Looker memerlukan software rendering yang disebut Chromium untuk mengirim atau mendownload data dalam format berbasis gambar — file HTML dan PNG atau PDF — serta untuk menggunakan fitur seperti Ukuran kertas dan Meluaskan tabel. Halaman ini menjelaskan cara menginstal software rendering pada instance Looker yang dihosting pelanggan.
Chromium sudah diinstal untuk instance yang dihosting Looker.
Rendering Chromium menunggu semua resource yang diminta oleh halaman selesai sebelum mengirimkan sinyal "selesai" yang meminta Looker untuk menghasilkan konten yang dirender. Karena jumlah dan frekuensi permintaan resource ini, beberapa jaringan dapat salah menandai permintaan sebagai berbahaya, menyebabkan permintaan tersebut turun, yang akan menunda tugas yang Anda render.
Proyek Chromium adalah proyek sumber terbuka yang dimulai oleh Google untuk berbagi bagian non-milik dari Google Chrome.
Persyaratan dan prasyarat penginstalan Chromium
Looker mendukung versi rilis semua distribusi Linux perusahaan utama, termasuk Ubuntu, Debian, RedHat, CentOS, dan Amazon Linux. Halaman ini memberikan petunjuk untuk menginstal Chromium di Ubuntu, Debian, dan RedHat/CentOS/Amazon Linux.
Chromium harus diinstal ke jalur yang dapat dieksekusi di komputer yang menghosting instance Looker. Aplikasi Looker perlu mengakses Chromium menggunakan perintah chromium
atau melalui jalur kustom yang ditetapkan dengan variabel lingkungan CHROMIUM_PATH
.
Untuk menjalankan Chromium di instance Looker, Chromium 86 atau yang lebih baru diperlukan, tetapi Looker merekomendasikan penggunaan Chromium 97.x secara khusus. Jika instance Looker Anda diinstal di Debian, Chromium memerlukan Debian 9 (stretch) atau yang lebih baru.
Jika Anda menginstal Chromium pada penginstalan Looker yang dikelompokkan, versi Chromium di setiap node harus sepenuhnya identik. Bahkan perbedaan kecil, seperti nomor build yang berbeda, dapat mengganggu kemampuan rendering Looker.
Jika data Anda berisi karakter non-bahasa Inggris, instal paket Google Noto Fonts (ukurannya beberapa GB) selain menginstal Chromium. Untuk menginstal paket font ini, jalankan perintah ini di command line Anda:
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
Jika berhasil, maka:
cd $HOME
rm -rf /tmp/fonts
Menginstal Chromium di Ubuntu
Aplikasi Looker perlu mengakses Chromium menggunakan perintah chromium
atau melalui jalur kustom yang ditetapkan dengan variabel lingkungan CHROMIUM_PATH
. Untuk penginstalan di Ubuntu, Anda harus menginstal browser web Chromium, lalu menetapkan alias agar aplikasi Looker dapat menemukan penginstalannya.
Looker merekomendasikan penggunaan perintah
sudo
saat melakukan langkah apa pun yang memerlukan izin yang lebih tinggi. Jangan menginstal Chromium saat Anda login sebagai pengguna root. Jika Anda menginstal Chromium saat login sebagai pengguna root, Looker mungkin tidak dapat menjalankan rendering PDF atau PNG.
Font harus diinstal di sistem agar Chromium dapat memulai. Anda dapat menginstal font menggunakan antarmuka command line. Misalnya, perintah ini menginstal font default di Ubuntu 16.04 LTS:
apt-get install fonts-freefont-otf
Untuk menginstal Chromium, jalankan:
apt-get update && apt-get install -y chromium-browser
Harus berupa alias
chromium-browser
sebagaichromium
atau mengekspor variabel lingkunganCHROMIUM_PATH
. Untuk membuat aliaschromium-browser
sebagaichromium
, tempatkan baris berikut dalam file~/.bashrc
:alias chromium='chromium-browser'
Agar alias ini diketahui oleh Looker, jalankan perintah ini di command line:
sudo ln -s /usr/bin/chromium-browser /usr/bin/chromium
Setelah menetapkan variabel lingkungan opsional, mulai ulang aplikasi Looker agar dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau menjalankan
source ~/.bash_profile
agar terminal membaca konfigurasi baru.
Setelah menginstal Chromium, Anda akan mendapatkan respons yang valid dari chromium --version
jika belum menetapkan variabel lingkungan CHROMIUM_PATH
atau $CHROMIUM_PATH --version
jika telah menetapkan variabel lingkungan CHROMIUM_PATH
.
Menginstal Chromium di Debian
Looker merekomendasikan penggunaan perintah sudo
saat melakukan langkah apa pun yang memerlukan izin yang lebih tinggi. Jangan menginstal Chromium saat Anda login sebagai pengguna root. Jika Anda menginstal Chromium saat login sebagai pengguna root, Looker mungkin tidak dapat menjalankan rendering PDF atau PNG.
Chromium memerlukan Debian 9 (stretch) atau yang lebih baru.
Jika instance Looker Anda menggunakan Docker dengan penginstalan Debian sederhana, instal procps dan pastikan Anda tidak berjalan sebagai root.
Font harus diinstal di sistem agar Chromium dapat memulai. Anda dapat menginstal font menggunakan antarmuka command line dengan menjalankan:
apt-get install fonts-freefont-otf
Untuk menginstal Chromium, jalankan:
apt-get update && apt-get install -y chromium
Setelah menetapkan variabel lingkungan opsional, mulai ulang aplikasi Looker agar dapat diterapkan. Anda mungkin juga perlu memulai ulang sesi terminal yang terbuka, atau menjalankan
source ~/.bash_profile
agar terminal membaca konfigurasi baru.
Setelah menginstal Chromium, Anda akan mendapatkan respons yang valid dari chromium --version
jika belum menetapkan variabel lingkungan CHROMIUM_PATH
atau $CHROMIUM_PATH --version
jika telah menetapkan variabel lingkungan CHROMIUM_PATH
.
Variabel lingkungan Chromium opsional
CHROMIUM_PATH
: Jalur ke biner Chromium, defaultnya adalahchromium
.CHROMIUM_PID_DIR
: Jalur tempat library dapat menyimpan file PID Chromium, setelan defaultnya adalahchromium_pid_files
di direktori kerja aplikasi Looker.CHROMIUM_PORT_RANGE_START
&CHROMIUM_PORT_RANGE_END
: Aplikasi Chromium memerlukan berbagai port untuk berkomunikasi antar-proses di komputer lokal. Rentang defaultnya adalah 40000-40500, tetapi Anda dapat mengganti default ini dengan menetapkan kedua variabel lingkungan ini. Port yang tidak digunakan dipilih secara acak dari rentang dan hanya digunakan selama durasi render tunggal.DISABLE_EXTERNAL_RENDER_ACCESS
: Admin instance atau server Looker yang dihosting pelanggan dan tidak memiliki akses Internet eksternal atau yang diblokir harus menetapkanDISABLE_EXTERNAL_RENDER_ACCESS=true
. Biasanya, perender Chromium akan menunggu semua resource yang diminta oleh halaman selesai sebelum perender mengirimkan sinyal "selesai" yang meminta Looker untuk membuat konten. Beberapa permintaan ini mungkin dibatalkan karena kurangnya koneksi, mengakibatkan waktu tunggu habis atau waktu render yang sangat lama. Menyetel variabel lingkungan ini ketrue
akan mencegah perender menunggu semua permintaan selesai. Beberapa visualisasi peta dan beberapa visualisasi kustom yang diinstal dari Looker Marketplace mungkin memerlukan akses Internet.