5.1-6.0備份升級回退方法

有些情況下，使用者可能需要恢復到升級前的版本。

文檔提供升級後回退至原版本，再進行升級的操作步驟。

進入「管理系統>系統管理>標準」可以看到是否使用了外接資料庫，如下圖所示：

• 如果顯示「待配置」：則資料庫型別為內建資料庫

• 如果顯示「已配置」：則資料庫型別為外接資料庫

如果使用了檔案伺服器，可以參考第 5 節叢集的檔案伺服器內容進行備份還原。

3.1 升級前備份

回退使用內建資料庫的工程，需要使用者在升級前進行以下備份：

關閉 FineBI 工程，在路徑%FineBI%\webapps\webroot下copy webroot 資料夾（備份的 webroot 檔案不能放在 FineBI 的安裝路徑下）

注：如果 webroot 比較大（超過4G），備份需要的時間太長，可以只備份 webroot 下的 WEB-INF 資料夾；如果 WEB-INF 也非常大（超過2G），備份需要的時間還是特別長，可以只備份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets、resources 資料夾。

3.2 回退步驟

1）關閉 BI 伺服器

2）更換工程

若在升級前使用內建資料庫，將備份的舊工程 webroot 檔案，更換%FineBI%\webapps路徑下的 webroot 檔案即可，如下圖所示：

注：如果只備份了WEB-INF，就恢復備份的WEB-INF，啟動工程；如果只備份了 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets 資料夾，那麼就恢復對應的資料夾。

3）重啓 BI 伺服器。

3.3 升級

詳情參考：6.0升級

4.1 方法一（推薦）

4.1.1 升級前備份

方法一要求使用者在升級前進行過以下備份：

1）關閉 FineBI 工程，在路徑%FineBI%\webapps\webroot下copy webroot 資料夾（備份的 webroot 檔案不能放在 FineBI 的安裝路徑下）

注：如果 webroot 比較大（超過 4G），備份需要的時間太長，可以只備份 webroot 下的 WEB-INF 資料夾；如果 WEB-INF 也非常大（超過 2G ），備份需要的時間還是特別長，可以只備份 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets 資料夾。

2）手動備份好外接資料庫，備份資料庫的密碼需要和之前資料庫的一致。

4.1.2 回退步驟

1）關閉 BI 伺服器。

2）更換工程

將備份的舊工程 webroot 檔案，更換%FineBI%\webapps路徑下的 webroot 檔案，如下圖所示：

注：如果只備份了 WEB-INF，就恢復備份的 WEB-INF；如果只備份了 WEB-INF 下的 dashboards、embed、lib、plugins、reportlets資料夾，那麼就恢復對應的資料夾。

3）恢復外接資料庫

若為建立一個資料庫備份外接資料庫，即備份恢復的資料庫名、帳號、密碼等與之前的資料庫名不一致，則修改%FineBI%/webapps/webroot/WEB-INF/config路徑下的 db.properties ，根據備份的資料庫的連結資訊對檔案進行修改，如下圖所示：

若備份恢復的資料庫的資料庫名、帳號、密碼等跟之前的資料庫的名稱一樣，則不需要修改其他的配置。

4）啟動  FineBI 完成回退。

4.2 方法二

4.2.1 升級前備份

使用方法二需要使用者在升級前進行過以下備份：

1）進入「管理系統>智慧維運>備份還原」，分別對「平台配置 、報表範本、BI範本、Jar包、插件」進行「手動備份」，如下圖所示：

4.2.2 回退步驟

1）關閉 FineBI 工程。

2）恢復報表範本。

將%FineBI%/webapps/webroot/WEB-INF目錄下的 reportlets 資料夾刪除；在%FineBI%/webapps/webroot/backup/reportlets/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 reportlets 資料夾複製到%FineBI%/webapps/webroot/WEB-INF目錄下。

3）恢復 BI 範本。

將%FineBI%/webapps/webroot/WEB-INF目錄下的 dashboards 資料夾刪除；在%FineBI%/webapps/webroot/backup/dashboards/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將dashboards 資料夾複製到%FineBI%/webapps/webroot/WEB-INF目錄下；

4）恢復 jar包。

將%FineBI%/webapps/webroot/WEB-INF目錄下的 lib 資料夾刪除；

在%FineBI%/webapps/webroot/backup/jar/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將lib資料夾複製到%FineBI%/webapps/webroot/WEB-INF目錄下；

5）恢復插件。

將%FineBI%/webapps/webroot/WEB-INF目錄下的 plugins 資料夾刪除；

在%FineBI%/webapps/webroot/backup/plugins/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 plugins 資料夾複製到%FineBI%/webapps/webroot/WEB-INF目錄下；

6）恢復外接資料庫。

在%FineBI%/webapps/webroot/backup/config/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將備份的config.zip 解壓得到的 finedb，更換%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 檔案，如下圖所示：

將%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 檔案刪除；此檔案刪除後，工程啟動就讀內建 finedb 的內容。

7）啟動工程，完成回退，使用者可以根據需要，重新配置外接資料庫。

4.3 升級

詳情參考：6.0升級

5.1 方法一（推薦使用）

【備份】

1）關閉工程所有的節點;

2）備份各個節點的webroot資料夾；

注：如果webroot比較大（超過4G），備份需要的時間太長，各節點下可以只備份webroot下的WEB-INF資料夾；如果WEB-INF也非常大（超過2G），備份需要的時間還是特別長，可以只備份WEB-INF下的lib、plugins資料夾。

3）備份檔案伺服器上的WEB-INF資料夾；

注：如果WEB-INF比較大（超過2G），備份需要的時間太長，檔案伺服器上可以只備份WEB-INF下的dashboards、reportlets資料夾。

4）資料庫端備份外接資料庫。備份的資料庫的密碼要跟之前的外接資料庫一樣。

【還原】

1）各節點恢復之前備份的webroot；

注：如果只備份了WEB-INF，就恢復備份的WEB-INF；如果只備份了WEB-INF下的lib、plugins資料夾，那麼就恢復對應的資料夾；

2）恢復檔案伺服器上的WEB-INF資料夾；

如果只備份了WEB-INF下的dashboards、reportlets資料夾，那麼就恢復對應的資料夾；

3）恢復外接資料庫；

• 備份恢復的資料庫的資料庫名、帳號等跟之前的不一樣，恢復時需要修改以下配置：

修改叢集各節點%FineBI%/webapps/webroot/WEB-INF/config路徑下的db.properties，根據備份的資料庫的連結資訊進行修改

• 備份恢復的資料庫的資料庫名、帳號、密碼等跟之前的資料庫的名稱一樣，則不需要修改db.properties的配置；

4）依次啟動叢集各節點。

5.2 方法二

【備份】

1）進入「管理系統>智慧維運>備份還原」，分別對「平台配置 、報表範本、BI範本、Jar包、插件」進行「手動備份」，如下圖所示：

【還原】

備份的內容在檔案伺服器上，到檔案伺服器上 WEB-INF 同層級目錄下找到 backup 資料夾。

1）恢復報表範本。

將檔案伺服器 WEB-INF 目錄下的 reportlets 資料夾刪除；

在檔案伺服器backup/reportlets/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 reportlets 資料夾複製到檔案伺服器的 WEB-INF 目錄下；

2）恢復 BI範本。

將檔案伺服器 WEB-INF 目錄下的 dashboards 資料夾刪除；

在檔案伺服器backup/dashboards/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 dashboards 資料夾複製到檔案伺服器的 WEB-INF 目錄下；

3）恢復jar包。

將叢集各節點/webapps/webroot/WEB-INF目錄下的 lib 資料夾刪除；

在backup/jar/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將lib資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下。

4、恢復插件。

將叢集各節點下的 plugins 資料夾刪除；

在檔案伺服器backup/plugins/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 plugins 資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下。

5、恢復外接資料庫。

在檔案伺服器backup/config/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將備份的 config.zip 解壓得到的 finedb ，更換叢集一個節點%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 檔案；

將叢集這個節點下的%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 檔案刪除。（此檔案刪除後，工程啟動就讀內建 finedb 的內容了）

6、啟動叢集的這個節點。

7、啟動成功後，配置外接資料庫。

8、將這個節點%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 檔案，copy到叢集其他節點的FineBI/webapps/webroot/WEB-INF/config下。

9、 啟動其他的節點。

5.3 升級

參考文檔：6.0叢集升級

6.1 方法一（推薦使用）

【備份】

1）關閉工程所有的節點;

2）備份各個節點的 webroot 資料夾；

注：如果webroot比較大（超過4G），備份需要的時間太長，各節點下可以只備份webroot下的WEB-INF資料夾；如果WEB-INF也非常大（超過2G），備份需要的時間還是特別長，可以只備份WEB-INF下的dashboards、lib、plugins、reportlets資料夾。

3）資料庫端備份外接資料庫。備份的資料庫的密碼要跟之前的外接資料庫一樣。

【還原】

1）叢集各節點恢復之前備份的 webroot。

注：如果只備份了WEB-INF，就恢復備份的WEB-INF；如果只備份了WEB-INF下的dashboards、lib、plugins、reportlets資料夾，那麼就恢復對應的資料夾。

2）恢復外接資料庫；

• 備份恢復的資料庫的資料庫名、帳號等跟之前的不一樣，恢復時需要修改以下配置：

修改叢集各節點%FineBI%/webapps/webroot/WEB-INF/config路徑下的 db.properties ，根據備份的資料庫的連結資訊進行修改

•  備份恢復的資料庫的資料庫名、帳號、密碼等跟之前的資料庫的名稱一樣，則不需要修改db.properties的配置；

3）依次啟動叢集各節點。

6.2 方法二

【備份】

1）進入「管理系統>智慧維運>備份還原」，分別對「平台配置 、報表範本、BI範本、Jar包、插件」進行「手動備份」，如下圖所示：

【還原】

備份的內容在叢集主節點的FineBI/webapps/webroot/backup下。

1）恢復報表範本。

將叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下的 reportlets 資料夾刪除；

在%FineBI%/webapps/webroot/backup/reportlets/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 reportlets 資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下。

2、恢復BI範本。

將叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下的 dashboards 資料夾刪除；

在%FineBI%/webapps/webroot/backup/dashboards/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 dashboards 資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下；

3、恢復 jar 包。

將叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下的 lib 資料夾刪除；

在%FineBI%/webapps/webroot/backup/jar/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 lib 資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下；

4、恢復插件。

將叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下的 plugins 資料夾刪除；

在%FineBI%/webapps/webroot/backup/plugins/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將 plugins 資料夾複製到叢集各節點%FineBI%/webapps/webroot/WEB-INF目錄下；

5）恢復外接資料庫。

在%FineBI%/webapps/webroot/backup/config/manual下，根據資料夾的名稱（備份時間），找到備份的內容，將備份的 config.zip 解壓得到的 finedb，更換%FineBI%/webapps/webroot/WEB-INF/embed下的 finedb 檔案，如下圖所示：

將%FineBI%/webapps/webroot/WEB-INF/config下的 db.properties 檔案刪除；此檔案刪除後，工程啟動就讀內建 finedb 的內容。

6）啟動叢集的這個節點；

7）啟動成功後，配置外接資料庫。

8）將這個節點%FineBI%/webapps/webroot/WEB-INF/config下的db.properties檔案，copy到叢集其他節點的%FineBI%/webapps/webroot/WEB-INF/config下。

9）啟動其他的節點。

6.3 升級

參考文檔：6.0叢集升級

7.1 更新

因為升級後會將所有的設定了隨父表更新的自助資料集都更新一遍，因此自助資料集更新的 db 檔案結構會改變，如果回退到 5.1 版本，一些自助資料集可能因為更新的 db 檔案結構變動導致預覽失敗，需要重新更新一下才能正常展示；

如果需要更新的表太多，又不方便進行全局更新，可以設定如下參數：

• 表：fine_conf_entity

• id：DistributedOptimizationConfig.spiderConfig.spider_ignore_base_update   

• value：true

設定參數後，工程需要重啓才能生效；

設定這個參數後，再觸發全局更新，遇到基礎表會直接跨越更新，只更新自助資料集。

7.2 插件

5.1.18及之前版本升級到 6.0 需要注意此項。

BI 5.1.18 及之前（FR10）和之後（FR11）的版本插件商城資源不一樣。

如果是 FR10 版本升級到 FR11 版本，升級工具會直接將插件商城資源更換為 FR11 的資源；這種情況下如果要回退的話，內網客戶需要手動將插件商城資源更換為 FR10 版本的資源；

5.1.18及之前（FR10）版本插件商城資源路徑：%FineBI%/webapps/webroot下資源檔案 scripts.zip、upm.zip，下載下來後，解壓到%FineBI%/webapps/webroot下。