1. 概述
1.1 版本
| FineBI伺服器版本 | 功能變更 |
|---|---|
| 6.0 | - |
1.2 應用場景
企業部署完工程後，可能會因為伺服器到期、測試生產環境互相copy等因素，需要遷移工程。
1.3 方案選擇
帆軟提供各種情況下的工程遷移方案。
本文方案，幫助使用者將原有非容器化部署的單機工程，遷移為非容器化部署的單機工程。
建議在查看本文方案之前，參考下表選擇更適合自己的遷移方案。如不需要更換工程部署方式，無需查看下表，參考本文遷移即可。
| 現有工程 | 遷移後工程 | 方案說明 | |
|---|---|---|---|
遷移方案選擇主旨：優先選擇叢集、優先選擇容器化部署 叢集優勢：相比於單機工程，叢集具有高可用性、高效能、易於管理、可伸縮性和安全保障等優點，適用於企業級的報表生成和管理需求 容器化部署優勢：相比於傳統部署架構，容器化部署具有隔離性、可轉移靈活性、可伸縮性和可控性等優點，可大幅降低企業的維護成本和資源成本 | |||
| 單機工程 | 非容器化部署 | 容器化叢集 | 伺服器資源充足 工程推薦配置節點數≥2節點 |
| 容器化單機 | 伺服器資源緊張 | ||
| 非容器化單機 | 仍堅持傳統方式遷移至新單機工程，可參考本文進行 | ||
| 容器化部署 | 容器化叢集 | 伺服器資源充足 工程推薦配置節點數≥2節點 | |
| 容器化單機 | 伺服器資源緊張 | ||
| 叢集工程 | 非容器化部署 | 容器化叢集（遷移工程和叢集組件） | 1）伺服器資源充足 2）遷移後原叢集工程仍可啟動 3）全新部署新叢集工程和叢集組件 |
| 容器化叢集（僅遷移工程） | 1）伺服器資源緊張 2）遷移後僅需啟動新叢集工程，無法啟動原工程 3）部署新叢集工程，呼叫原叢集組件 | ||
| 容器化部署 | 容器化叢集 | 唯一選擇 | |
2. 新工程準備
2.1 部署新工程
請參考 Linux下Tomcat伺服器部署包 ，部署一個全新FineBI工程。
2.2 確認新工程伺服器剩餘磁碟空間
1）檢查原工程的大小。
2）根據原工程大小，適度擴展新工程所在伺服器節點剩餘磁碟空間，建議大於原工程的兩倍。
2.3 確認新工程版本
由於官網下載的部署包，一般為帆軟發佈的最新版本。因此使用者需要先確認新工程版本，確定後續升級舊工程到同一版本。
管理者登入新工程，點選「管理系統>註冊管理>版本資訊」，查看新工程的小版本號（精確到JAR包日期）。
2.4 關閉新工程
請參考「關閉或重啟FineBI工程」文檔，關閉新工程。
3. 原工程準備
3.1 備份原工程
在進行工程遷移前，為避免遷移失敗，導致工程檔案丟失無法回退等問題，請務必對原工程進行備份後再進行後續操作。
請參考 工程備份還原方案 3.1節，對工程進行備份。
3.2 升級原工程
由於新部署的 FineBI 工程，一般為帆軟發佈的較新版本。
因此使用者需要將原工程升級到同一新版本，方可進行同版本間的遷移。
1）判斷是否需要升級
管理者登入老工程，點選「管理系統>註冊管理>版本資訊」，查看老工程的小版本號，檢查是否與2.3節新工程版本號一致。
若一致，則可跨越本節步驟；若不一致，必須執行本節操作，升級到同一版本方可。
2）獲取JAR包
付費使用者請聯絡帆軟技術支援，獲取2.3節新工程同一小版本的工程JAR包（精確到JAR包日期）。
技術支援聯絡方式：帆軟官方服務渠道使用説明。
3）升級原工程
請參考「FineBI小版本升級」文檔升級工程至指定版本。
3.3 確認原工程配置庫
為了保證新老工程的平台配置完全一致，需要同步兩個工程的配置庫。使用者需要先確認老工程所用的finedb資料庫資訊。
管理者登入原工程，點選「管理系統>系統管理>標準」，檢查外接資料庫是否已配置。
已配置：點選「已配置」，記錄該工程的外接資料庫位置資訊。使用者必須確定新工程所在伺服器與該外接資料庫所在伺服器互通。
未配置：說明工程未配置外接資料庫。（對於正式工程，建議管理者為其配置外接資料庫，工程使用更加穩定，詳情請參見：配置外接資料庫）
3.4 關閉原工程
請參考「關閉或重啟FineBI工程」文檔，關閉原工程。
3.5 檢查原工程路徑
一般來說，工程路徑為%Tomcat_HOME%/webapps/webroot，但是為了配置短鏈，可能配置了外掛目錄，工程路徑就會發生變化。
檢查方法：查看原工程%Tomcat_HOME%/conf/server.xml檔案，查看是否配置了docBase，若配置了，那麼該路徑即為原工程外掛目錄的路徑
4. 遷移工程
4.1 copy檔案
請將原工程路徑webroot資料夾內容，copy到新工程%Tomcat_HOME%/webapps/webroot中。
1）請提前按照3.5節，檢查原工程是否配置了外掛目錄，確定copy到正確的檔案。
2）請勿使用3.1節備份的檔案，而是使用工程最終的檔案進行copy操作。
3）若伺服器資源不足，webroot資料夾過大，請至少copy工程中以下檔案：
| 工程檔案 | 說明 |
|---|---|
| /webroot/backup | 作用：工程歷史備份檔案 是否必須copy：使用者自行決定，可儲存在原始的目錄下備份，可不copy |
| /webroot/bi-data | 作用：FineBI抽取資料 是否必須copy： 如果新老工程在同一伺服器上，可重新-v掛載原工程的bi-data資料夾，或在新工程啟動後重新抽取資料，無需copy 如果新老工程不在同一伺服器上，不建議copy，該資料夾一般資料量太大，copy困難，可在新工程啟動後重新抽取資料 |
| /webroot/help | 作用：工程自訂內容 是否必須copy：必須copy 該資料夾中存放着自訂地圖、自訂函式、客製css、客製js等檔案，不copy會導致範本預覽出現異常 |
| /webroot/logs | 作用：swift日誌 是否必須copy：使用者自行決定 如果不copy，會丟失工程歷史操作日誌（即logdb），「管理系統>平台日誌」功能無資料 如對歷史使用情況無要求，無需copy |
| /webroot/WEB-INF/assets/temp_attach | 作用：FineBI資料表相關資訊 是否必須copy：必須copy 該資料夾中存放着工程Excel原始檔案資訊，如不copy該資料夾會導致原始Excel丟失 |
| /webroot/WEB-INF/assets/vcs | 作用：FineReport範本備份檔案 是否必須copy：使用者自行決定 如果工程不需要回退歷史開發的FineReport範本，則無需copy |
| /webroot/WEB-INF/assets/其他檔案 | 作用：通用的共享持久化目錄 是否必須copy：必須copy 工程正常運作所需要的檔案，如不copy會影響工程正常使用 |
| /webroot/WEB-INF/classes | 作用：工程呼叫的預設和自訂class檔案 是否必須copy：必須copy 有可能存在自訂的class檔案，如不copy會影響工程正常使用 |
| /webroot/WEB-INF/config | 作用：配置庫相關檔案 是否必須copy：必須copy 平台呼叫的配置庫（finedb），如不copy會影響工程正常使用 |
| /webroot/WEB-INF/dpworks | 作用：FineDataLink任務相關的配置檔案 是否必須copy：必須copy，如不copy會影響FineDataLink任務使用 （如不存在該資料夾，說明工程沒有使用FDL相關功能，略過） |
| /webroot/WEB-INF/embed | 作用：存放着工程曾經/現在使用的內建finedb資料庫 是否必須copy：必須copy，即使現在使用着外接配置庫，也建議copy，方便回退 |
/webroot/WEB-INF/lib | 作用：工程原有/外部引入的JAR包，提供工程所有基礎功能，是工程的關鍵檔案 是否必須copy：必須copy，如不copy會影響範本存取 |
| /webroot/WEB-INF/plugins | 作用：插件相關檔案 是否必須copy：必須copy，如不copy會影響插件相關功能的實現 |
| /webroot/WEB-INF/reportlets | 作用：FineReport範本存放目錄 是否必須copy：必須copy，如不copy會導致工程所有範本丟失 |
| /webroot/WEB-INF/schedule | 作用：排程管理生成的檔案 是否必須copy：使用者自行決定 如果不copy，定時任務掛載到決策平台的結果報表無法存取 |
4.2 啟動新工程
請參考「關閉或重啟FineBI工程」文檔，啟動新工程。
4.3 遷移新工程外接資料庫
若3.3節原工程未配置外接資料庫，僅使用內建資料庫，請直接跨越本節內容。
若3.3節配置了外接資料庫，此時新老工程使用了同一個finedb資料庫，需要將新工程的外接資料庫遷移到其他資料庫。
1）建立空資料庫
請在老工程原外接資料庫地址建立一個庫名，作為待遷移的空庫。
2）遷移資料庫
管理者登入新工程，點選「管理系統>系統管理>標準>外接資料庫」。
配置外接資料庫為上一步的空庫
勾選「遷移資料至要啟動的資料庫」
點選「啟動新資料庫」
當出現提示「已成功切換至目標資料庫！」，則代表外接資料庫切換成功。
4.4 注意事項
工程遷移後，一般需要重新進行資料抽取。
請先登入新工程，檢查並修改資料存放路徑（新伺服器和老伺服器的路徑不一定一致，請確定是您所需要存放資料的路徑），詳情請參見：資料存放路徑
5. 啟動原工程
請參考「關閉或重啟FineBI工程」文檔，啟動原工程。
上一篇：工程備份還原
