更新客戶代管的 Looker 執行個體

如要取得最新錯誤修正和新功能,請按照下列手動步驟,更新客戶託管的 Looker 執行個體。

請注意,復原至舊版本可能會導致嚴重問題。如需還原,請一律從備份還原。如果您操作的是 Looker 叢集,請一次完整更新一個節點。這項程序也假設執行個體包含初始設定期間安裝的開機指令碼。

  1. 按照「下載 Looker JAR 檔案」說明文件頁面的指示,下載最新版本的 Looker JAR 檔案。
  2. 以 looker 使用者身分,從殼層停止 Looker 程序:

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

    如果您要更新 Looker 叢集,請重複這項程序,在每個節點上停止 Looker。

  3. 備份整個 Looker 目錄,包括隱藏目錄 (詳情請參閱「還原備份」說明文件頁面)。

  4. 如果您已將 Looker 的預設記憶體內資料庫遷移至外部 MySQL 資料庫,或正在更新 Looker 叢集,請備份 MySQL 資料庫。

  5. 更新 Looker 前,請一併確認 MySQL 伺服器參數和後端資料庫預設定序設為 utf8mb4_general_ci。否則,更新後可能會看到定序不符錯誤。

  6. 將 looker-x.x.x.jar 重新命名為 looker.jar,並將 looker-dependencies-x.x.x.jar 重新命名為 looker-dependencies.jar。將 looker.jar 和 looker-dependencies.jar 複製到伺服器目錄 (/home/looker/looker/looker.jar)。這兩個檔案必須位於同一個目錄。

  7. 以 looker 使用者身分,從殼層啟動 Looker 程序:

    如果您要更新 Looker 叢集,請只在一個節點上啟動 Looker 程序。第一個節點完成更新程序後,才能在其他節點上啟動 Looker。

    ./looker start
    

    您也可以使用 java -jar 指令啟動 Looker。只要依附元件 JAR 位於 ./looker 目錄中,且與核心 JAR 位於同一目錄,核心 JAR 就會找到依附元件 JAR。

    此外,如果您想使用 Looker 提供的開機指令碼,請前往 https://github.com/looker/customer-scripts。

    更新 Looker 版本時,Looker 也必須更新內部資料庫。資料庫更新通常會在五分鐘內完成,但有時可能需要比 Looker 啟動程序更長的時間。如果在內部資料庫更新期間嘗試啟動 Looker,daemon 程序會在六分鐘後逾時,並顯示「Timed out waiting for Looker to start」訊息。

    更新期間,必要的遷移作業最多可能需要一小時,尤其是略過多個版本時。如果收到這則錯誤訊息,請等待更新完成,Looker 啟動後再繼續操作。您可以使用下列指令,確認更新程序是否仍在執行:

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

    如果在內部資料庫更新期間停止並重新啟動 Looker 程序,可能會導致內部資料庫損毀。如果發生這種情況,請從現有備份還原 Looker,然後再次執行更新。

  8. 如果您要更新 Looker 叢集,請等到第一個節點完成更新程序,再啟動其他節點上的 Looker。