由於 FineBI 5.1.19 適配的 FineReport 11.0.1屬於大版本更新，因此必須更換 Lic ，若有疑問，請聯絡技術支援（QQ：800049425）獲取幫助。
1. 概述
1.1 版本
| FineBI 版本 | 內容變動 |
|---|---|
| 5.1.19（適配 FR 11.0.1） | BI 5.1.15（JAR 日期為：2021.08.05）至 5.1.18 版本才可以使用此工具 注：如果是5.1.15之前的版本，需要將工程先升級到5.1.15至5.1.18之間的任意版本，再使用從工具升級。 |
| 5.1.20（適配 FR 11.0.2） | BI 5.1.5（JAR 日期為：2020.08.07）至 5.1.18 版本均可以使用此工具。 |
1.2 應用場景
FineBI 5.1.19 適配 FineReport 11.0.1，因此提供該升級工具，若你需要將 BI 工程升級至 5.1.19 以及之後的版本，可參考本文進行升級操作。
1.3 使用範圍
見本文 1.1 節功能變動。
版本資訊可在 登入管理中查看。
1.4 叢集升級注意
叢集環境升級請先停止所有節點的進程，在其中任一節點運作升級工具，完成升級後將當前節點的 webroot 檔案下的 WEB-INF、scripts、upm copy到其他節點，完成後先啟動一個節點，待工程可以存取後，再依次啟動其他的節點。
2. 操作步骤
2.1 獲取升級工具
若您是未聯絡帆軟銷售經理的個人使用者，可致電 400-8118890 轉1 與帆軟商務聯絡獲取相關資訊；
若您已與帆軟銷售經理有對接，可透過 FineBI 技術支援（QQ：800049425）獲取升級工具和 「BI升級」插件包。
2.2 應答已有的登入功能
由於升級後必須更換 Lic 檔案，因此在升級前可先確定已有的登入功能點，詳情參見：登入管理。
2.3 工程备份
進入「管理系統>系統管理>標準」，應答資料庫型別，如下圖所示：
如果顯示「待配置」：則資料庫型別為內建資料庫
如果顯示「已配置」：則資料庫型別為外接資料庫
內建資料庫備份方式：
關閉 FineBI 工程，在路徑%FineBI%\webapps\webroot下copy webroot 資料夾（備份的 webroot 檔案不能放在 FineBI 的安裝路徑下）
注：如果 webroot 比較大（超過4G），備份需要的時間太長，可以只備份 webroot 下的 WEB-INF 資料夾；如果 WEB-INF 也非常大（超過2G），備份需要的時間還是特別長，可以只備份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources 資料夾。
外接資料庫備份方式：
方案一：
1）關閉 FineBI 工程，在路徑%FineBI%\webapps\webroot下copy webroot 資料夾（備份的 webroot 檔案不能放在 FineBI 的安裝路徑下）
注1：如果 webroot 比較大（超過 4G），備份需要的時間太長，可以只備份 webroot 下的 WEB-INF 資料夾；如果 WEB-INF 也非常大（超過 2G ），備份需要的時間還是特別長，可以只備份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources資料夾。
注2：叢集環境有幾個節點則備份幾個 webroot 工程。
2）手動備份好外接資料庫，備份資料庫的密碼需要和之前資料庫的一致。
方案二：
進入「管理系統>智慧維運>備份還原」，分別對「平台配置 、報表範本、BI範本、Jar包、插件」進行「手動備份」，如下圖所示：
注：2020.01.15 之前發佈的 FineBI 不能成功備份釘釘配置。
2.4 進行升級檢查
參考 5.1.15-5.1.18版本升級指南 2.2 節內容進行升級前的檢查，並根據你的實際情況修改「阻擋項」和「建議項」。
2.5 關閉工程
備份完成後關閉 BI 工程
2.6 運作升級工具
注1：升級過程會佔用 20216 和 20217 埠，請應答埠未被其他進程佔用。
注2：升級工具運作時的記憶體預設為 Xms:4G -Xmx：物理記憶體的一半，需要保證伺服器至少有8G的可用記憶體，防止升級過程記憶體上限溢位。
注3：叢集環境只能對一個節點進行升級，升級後將升級好的webrootcopy到其他的節點。
注4：升級工具日誌在工具同級目錄下，名稱為 upgrade.log。
2.6.1 Windows 系統升級
運作升級工具，選擇BI 工程 webroot 所在的位置，然後點選開始升級，如下圖所示：
注：升級工具和工程所在路徑不要包含較多特殊字元，可包含中文、英文、數字、英文括號、底線、英文連結符、空格（一般不要將工程放在 C 盤內）。
等待升級完成，如下圖所示：
注：升級完成後，啟動之前檢查 %FineBI%/webroot/WEB-INF/lib下的 jar 是否正確，因為 windows 環境特性，檔案被系統佔用，可能刪不掉10.0的 jar。
2.6.2 Linux 系统升級
在 Linux 系統中下載升級工具後，使用命令 chmod 777 升級工具 sh 檔案名稱給工具授予權限，如下圖所示：
然後啟動升級工具，如下圖所示：
輸入工程 webroot 路徑，並等待升級，如下圖所示：
升級完成後提示：升級成功，如下圖所示：
2.7 重啓工程
升級結束，工程處於關閉狀態，需要手動啟動工程。
2.8 更換 Lic 檔案
升級至 5.1.19 後，需要更換Llic，更換的 Lic 功能與之前的 Lic 功能需要保持一致