Memperbarui instance Looker yang dihosting pelanggan

Untuk mengakses perbaikan bug terbaru dan fitur baru, update instance Looker yang dihosting pelanggan dengan mengikuti langkah-langkah manual berikut.

Sebelum melanjutkan, perlu diketahui bahwa melakukan roll back ke versi sebelumnya dapat menyebabkan masalah serius. Sebagai gantinya, selalu pulihkan dari cadangan jika Anda perlu mengembalikan. Jika Anda mengoperasikan cluster Looker, update setiap node sepenuhnya, satu per satu. Proses ini juga mengasumsikan bahwa instance Anda menyertakan skrip startup yang diinstal selama penyiapan awal.

  1. Download rilis terbaru file JAR Looker seperti yang dijelaskan di halaman dokumentasi Mendownload File JAR Looker.

  2. Hentikan proses Looker dari shell, sebagai pengguna looker:

    sudo su - looker
cd /home/looker/looker
./looker stop

    Jika Anda memperbarui cluster Looker, ulangi proses ini agar Looker dihentikan di setiap node.

  3. Cadangkan seluruh direktori Looker Anda, termasuk direktori tersembunyi (lihat halaman dokumentasi Memulihkan cadangan untuk mengetahui detail selengkapnya).

  4. Jika Anda telah memigrasikan database dalam memori default Looker ke database MySQL eksternal, atau jika Anda memperbarui cluster Looker, cadangkan database MySQL.

  5. Mengganti nama looker-x.x.x.jar menjadi looker.jar, dan looker-dependencies-x.x.x.jar menjadi looker-dependencies.jar. Salin looker.jar dan looker-dependencies.jar ke direktori server (/home/looker/looker/looker.jar). Kedua file harus berada di direktori yang sama.

  6. Mulai proses Looker dari shell sebagai pengguna looker:

    Jika Anda memperbarui cluster Looker, mulai proses Looker hanya di satu node. Jangan memulai Looker di node lain hingga node pertama menyelesaikan proses update.

    ./looker start

    Anda juga dapat menggunakan perintah java -jar untuk memulai Looker. JAR inti akan menemukan JAR dependensi selama JAR tersebut berada di direktori ./looker bersama dengan JAR inti.

    Selain itu, jika Anda lebih memilih menggunakan skrip startup yang disediakan Looker, Anda dapat menemukan skrip startup di: https://github.com/looker/customer-scripts.

    Saat Anda mengupdate versi Looker, Looker juga harus mengupdate database internalnya. Update database biasanya memerlukan waktu kurang dari lima menit, tetapi terkadang bisa lebih lama daripada proses startup Looker. Jika Anda mencoba memulai Looker saat database internal masih diupdate, proses daemon akan mencapai waktu tunggu habis dalam enam menit dengan pesan "Timed out waiting for Looker to start".

    Selama update, migrasi yang diperlukan dapat memakan waktu hingga satu jam, terutama jika Anda melewati beberapa rilis. Jika Anda menerima pesan error ini, tunggu hingga update selesai dan Looker dimulai. Anda dapat mengonfirmasi apakah proses update masih berjalan menggunakan perintah:

    ps -f $(pgrep -f -- '-jar looker.jar')

    Menghentikan dan memulai ulang proses Looker saat pembaruan database internal sedang berlangsung dapat merusak database internal. Jika hal ini terjadi, pulihkan Looker dari cadangan yang ada dan lakukan update lagi.

  7. Jika Anda mengupdate cluster Looker, tunggu hingga node pertama menyelesaikan proses update sebelum memulai Looker di node lainnya.