為滿足客戶的新需求以及完善之前版本某些功能的不足之處,FineReport/FineBI在不斷地更新迭代。
小明部署好容器化FR/BI工程後,需要定期對工程進行更新升級,但是他發現傳統的升級方式存在着一些問題。
1)FineReport內網/FineBI的小版本升級需要手動取代JAR包,操作門檻高。
2)由於部分版本的相容問題,使用者需要升級指定版本而非最新版本,只能手動取代JAR包,操作門檻高。
3)FineReport外網升級,需要手動重啟工程/叢集所有節點,操作麻煩。
4)升級失敗後工程無法自動回退,存在風險。
FineOps維運平台提供面向組件的「更新」功能。
1)支援升級最新/指定版本。
2)透過推播鏡像方式,支援內網安全更新。
3)任何更新失敗均可自動回退。
內網升級版本:僅內網使用的維運平台,透過finekey推播鏡像,將專案組件升級到指定/最新版本時的解決方案。
注1:外網升級最新版本,請參考:外網升級維運專案
注2:最新版finekey預設不攜帶FineBI6.0相關鏡像,無法透過本文方案完成FineBI6.0.x小版本升級。
內網如需升級6.0.x小版本,請透過服務平台聯絡帆軟技術支援,獲取鏡像包。技術支援聯絡方式:「服務>線上支援」
使用維運平台更新帆軟專案,僅面向容器化部署的專案,非容器化部署工程不支援本文相關操作。
請先檢查當前工程版本。
管理者登入FR/BI工程,點選「管理系統>註冊管理>版本資訊」,查看當前版本號。
檢查 FineReport更新日誌、FineBI更新日誌 即可查看官方發佈的最新版本號,確認自己需要升級到的版本。
對於多應用叢集(注意,對於FineBI6.1專案,即使只有1個應用節點,也是叢集),請在升級專案前,檢查叢集配置是否全部開啟。
請確認各個工程節點與檔案伺服器、狀態伺服器、資料儲存組件、外接配置庫等組件間的對接是否正常
如對接異常或斷開,升級後可能導致工程檔案永久性丟失,相關範本和資料無法找回。
在更新組件前,必須對專案進行整體備份,防止更新程式出現不可控意外。
更新時如檢查不到24小時內的備份,則無法更新。提示「組件更新失敗,更新前請保證至少有24小時內的備份,請備份後重試」
管理者登入維運平台,選擇指定專案,點選「維護>備份管理」。
建議勾選「備份鏡像」,點選「開始備份」,維運平台即會對該專案進行整體備份。
注:部分檔案未進行備份(例如/assets/temp_attach),請自行對此類檔案進行備份。
備份內容請參見:備份內容
從原容器化部署工具finekey/conf目錄下獲取finekey.yaml檔案,下文需要用到。
1)最新版本
點選可跳轉至下載頁下載安裝包:FineOps維運平台下載
請下載全量版離線安裝包。
2)指定版本
付費使用者交握技術支援,索要指定版本的鏡像檔案。請提供所需的FineReport/FineBI小版本號。
技術支援交握方式:帆軟官方服務渠道使用説明
技術支援會提供該版本對應的FineKey容器化部署工具,工具中有相關鏡像包。
獲得工具包後,需要將它上傳到 Linux,上傳檔案的方法請自行查閱相關資料。
本文範例是將工具包上傳到了 CentOS 7.6.1810 的 /home 路徑下,如下圖所示:
1)先使用 cd 命令進入工具包所在資料夾下。
2)鍵入如下命令進行解壓:
tar zxvf finekey-operation.tar.gz
解壓後的檔案如下表所示:
yaml 檔案指的是工具解壓目錄下 conf 資料夾裏的 finekey.yaml,該檔案是控制後面整個升級流程的。
取代finekey.yaml檔案
取出3.1節從原finekey部署工具finekey/conf目錄下獲取finekey.yaml檔案,將檔案中的配置值,一項一項的複製取代到新fineKey部署工具finekey/conf目錄下的finekey.yaml檔案。
注:請勿直接取代yaml檔案,或一鍵複製貼上檔案內容,因為新舊版本中,yaml檔案設定可能存在微小差異,建議逐項copy配置值即可。
1)先使用 cd 命令進入工具包所在資料夾的bin目錄下。
2)使用語句啟動升級:./finekey update
推播成功後,管理者登入維運平台,點選「維護中心>鏡像管理」,查看推播到倉庫的新鏡像。
記下需要更新到的版本號,下文需要用到。
鏡像準備完畢後,使用者即可對組件進行更新。
1)更新維運專案組件,支援對組件批量更新,支援對單個組件更新,但不支援對單個組件下的部分容器進行更新
此設定是為了確定同一組件下容器版本的一致
帆軟建議,在升級時將專案下的所有組件都更新到最新版本,以便提升專案安全性。
2)部分組件版本之間存在主從依賴關係(例如升級bi-web組件,會觸發bi-engine-worker組件的更新)
如組件間版本存在主從依賴關係,從屬組件的更新按鈕灰化,僅可對主組件進行更新。
更新組件時,如有聯動更新組件,會提示「觸發更新後,xxx組件會同時停機更新至對應版本」
對於專案中的各個組件支援批量更新或對指定組件進行更新。
帆軟建議在升級時,將專案下的所有組件都更新到最新版本,以便提升專案安全性。
1)管理者登入維運平台,選擇維運專案。點選「維護>組件管理」。
2)找到待更新組件,點選「更新」。
注:如組件間版本存在主從依賴關係,從屬組件的更新按鈕灰化,僅可對主組件進行更新。
更新時會提示「觸發更新後,xxx組件會同時停機更新至對應版本」
3)點選「開始更新」後,提示「更新程式將重啟組件,可能影響專案正常運作,請勿在使用期間操作。是否確認更新」
點選「確定」後,開始更新組件,如下圖所示:
4)更新完畢後,自動重新整理組件管理介面,提示「更新完成」,組件版本顯示:「當前已為最新版本」
1)管理者登入維運平台,選擇維運專案。點選「維護>組件管理」,點選「批量更新」。
2)升級最新版本,無需輸入更新版本號,直接點選「開始更新>確定」,即可進行專案更新。
觸發更新後,組件會同時停機更新到最新版本,可能影響專案正常運作,請勿在使用期間操作。
如不存在24小時內的備份,則更新終止,請對專案進行備份後再進行更新。