本文介紹 5.1.5 之後的版本在升級前的準備工作。
不同版本的準備工作有所不同，請根據實際情況查看。
做好準備工作後的升級步驟詳情參見：5.1.5後的版本升級指南
若安裝最新版本的「雲端健檢分析」插件，每次升級都要檢查一下插件是否安裝至最新版本。
混合工程登入成純直連或者純抽取資料工程，登入後必須要重啓一次。
整合使用者升級後在 fine_conf_entity 表內新增參數「UpdatePushConfig.open」，預設值為 false，這樣即遮蔽了 FineReport 的線上升級的訊息派送，避免客戶直接點選進行升級，帶來後續 JAR 包不匹配等問題。
如果升級前 jdk 版本為 oracle 的 1.8.0.25 版本，升級後會存在啟動當機的問題，需要更換為其他版本 jdk 再做升級。
若使用到「使用者存取日誌」業務包中的 5 個伺服器資料集的，且資料有百萬量級，有當機風險。
需要將%FineBI%\webapps\webroot\WEB-INF\classes\com\fr\log 中的 class 檔案更換為log.zip 。
如果用到時間過濾組件>動態時間/工作日，需要用到 2021 年的資訊，在換 JAR 包外需要更換%FineBI%\webapps\webroot\WEB-INF\assets\extdata中的 holiday.csv 。
由於 BI 使用了 servlet 3.0 的 api，如果 websphere（websphere 9.0 預設提供了 servlet 3.0 的 jar） 沒有提供 servlet 3.0 的 jar，啟動就會報錯。
目前有兩種方式規避掉報錯：
需要 websphere 提供 servlet 3.0 的運作環境（最好 websphere 能提供）
將 servlet 3.0 的 jar 包put 命令到 BI 的 %FineBI_HOME%\webroot\web-inf\lib 目錄下。
注：熱備、日誌插件等內建插件，如果被禁用後，升級到 5.1.13 及之前的版本會自動啟用，需要使用者手動再次禁用。
使用直連叢集的使用者需要在 nginx.conf 中直連請求對應的 FR.com（有的可能叫BI.cluster.com）中加一條語句：
hash "$cookie_fine_login_users - $http_sessionid";
儲存跳出後進入 /nginx/sbin 目錄下，使用：./nginx -s reload 重啓 nginx 生效。
因為 5.1.15 版本新增列彙總值改動的任務會導致啟動慢，升級過程中啟動慢可以看日誌等待（關鍵字：analysisTable addColumn summary upgrade），千萬不要中途停止進程再重啓，不然就會導致升級失敗。
因為 5.1.15 版本 null 值相容任務會導致啟動慢，升級過程中啟動慢可以看日誌等待（關鍵字：filter null value upgrade），千萬不要中途停止進程再重啓，不然就會導致升級失敗。
直連 null 值邏輯改動：null 和 "" 區分展示，不再合併。
升級前直連組件有點選空值進行聯動、鑽取操作的儀表板，升級後聯動/鑽取效果錯誤，需要重新觸發。
升級到 5.1.15，原來只可以「授權使用和授權權限」的次管升級後可以分配「使用、管理和授權」權限；
同時，原來只可以「授權」部分列的次管升級後可以分配所有列權限。
升級 5.1.14 以及之後的版本，由於優化自助資料集更新設定，新增 最簡自助資料集 概念。在進行升級相容時會導致啟動慢，升級過程中啟動慢可以查看日誌，但切勿中途kill進程再重啓，否則會導致升級失敗。
以下是關鍵日誌列印資訊：
TMDHandler upgrade start! #開始進行最簡表的升級{} DataAnalysisTables need to upgrade #有{}張分析性質的表需要升級處理TMDHandler upgrade end! #最簡表表升級結束
由於 5.1.12 版本對函式部分進行了大量的優化，為了升級相容函式問題，啟動會比較慢，請耐心等待。
注：函式升級後顯示不合法：抽取資料部分函式的使用規則進行了優化，之前對不規範使用的函式不會進行提示。升級後不規範使用的新增列/計算指標，會提示不合法。
解決辦法：升級後使用「智慧維運工具」，可一鍵修復不合法提示的公式。不合法提示內容詳見：運算子和不合法報錯
升級後只支援(數值/日期/正文) 或 (正文,正文)或(正文,正文,正文)的參數使用，例如TODATE(20180305,"yyyyMMdd")升級後會不合法
升級到 5.1.12 必須同時升級防當機插件到最新的 2.0 版本，安裝插件後，重啓後生效。
1）升級到 5.1.11 和之後的版本
外接資料庫為 mysql 資料庫，且表資料量很多，可以檢查資料庫 max_allowed_packet 參數項是否過小，需要調整為1073741824，即 1G，升級完成後建議再改回原來的數值。
參數檢查可輸入：show VARIABLES like '%max_allowed_packet%'
若參數過小，升級日誌中的關鍵報錯：
jdbc.PacketTooBigException: Packet for query is too large (1036056 > 999424). You can change this value on the server by setting the max_allowed_packet' variable
工程可以啟動，只是部分升級失敗的表會有異常。
2）因為 5.1.11 版本資料集轉義名問題會導致啟動慢。
升級過程中啟動慢可以看日誌，但切勿中途停止進程再重啓，否則會導致升級失敗。
轉義名日誌：
analysisTable transferName upgrade start!XXX analysisTables need to upgrade #XXX是表數量upgrade table XXX error! #XXX是表轉義名XXX/YYY have been upgraded #XXX是已經升級表數量，YYY是總共要升級的表數量analysisTable transferName upgrade end!
若使用者需要從 5.1.2 工程升級 5.1. 5純直連工程在向上升級，請避開 5.1.9 版本，直接升級到 5.1.10 及以後版本。
使用者升級此版本時，需要同步升級 BI 範本螢幕自適應插件 為 V1.1.48 版本，原因是新插件適配了 BI 新發布的 Tab 組件功能。
如果在升級前使用者遷移了外接資料庫，需要檢查%FineBI%/webroot/WEB-INF/config/db.properties中「hibernate.hbm2ddl.auto」值是否設定為「update」，如果不是，需要設定為「update」
否則在升級時不會自動檢查更新表結構，可能導致行權限等配置丟失。
升級 5.1.6 版本，會存在選中「智慧推薦」的指標卡在預覽區域新增指標欄位，在橫軸新增維度欄位，維度對指標設定排序/過濾不生效的問題，原因是產生了冗餘欄位，建議使用者直接升級 5.1.9 及之後的版本。