更新客戶代管的 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-x.x.x.jar 重新命名為 looker.jar,並將 looker-dependencies-x.x.x.jar 重新命名為 looker-dependencies.jar。將 looker.jarlooker-dependencies.jar 複製到伺服器目錄 (/home/looker/looker/looker.jar)。這兩個檔案必須位於同一目錄。

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

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

    ./looker start
    

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

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

    更新 Looker 版本時,Looker 也必須更新內部資料庫。資料庫更新作業通常會在五分鐘內完成,但有時可能比 Looker 啟動程序更久。如果內部資料庫仍在更新,您嘗試啟動 Looker 時,精靈化程序會在六分鐘後逾時,並顯示「Timed out waiting for Looker to start」訊息。

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

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

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

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