1. 概述
1.1 版本
| 工程版本 | 功能變更 |
|---|---|
FineReport11.0 FineBI6.0 FineDataLink4.1 | - |
注：本文不適用於FineBI6.1，如有相關場景，請聯絡帆軟技術支援協助。
1.2 應用場景
有時使用者需要複用一個工程，或者遷移工程所在伺服器。
本文方案，幫助使用者將原有容器化部署的單機工程，遷移到另一個容器化部署的單機工程。
注：全文以FineBI作為示範。FineReport和FineDataLink遷移步驟基本一致，僅需要兩個點：
1）copy檔案時，FineReport、FineDataLink和FineBI需要copy的檔案不完全相同，注意文檔中的表格即可。
2）使用維運平台啟停容器時，FineReport關閉的是fr組件，FineBI關閉的是bi6組件。
2. 新工程準備
注：建議部署新工程、老工程、維運平台所用伺服器內網互通，會大幅降低遷移難度。
2.1 部署維運平台
詳情請參見：部署維運平台
如果已有維運平台，無需重複部署。一個維運平台可以部署/對接多個專案。
2.2 部署新工程
詳情請參見：部署新專案
注意事項1：遷移時，需要將老工程的一些必要檔案、資源copy到新工程中，因此必須要確定新工程磁碟空間足夠大。
1）檢查原工程的大小。
2）根據原工程大小，適度擴展新工程所在伺服器節點剩餘磁碟空間，建議大於原工程的兩倍，最少剩餘磁碟大小500G。
注意事項2：遷移後，為了確定新老工程的存取地址一致，必須確定存取路徑名稱一致
請在「部署新專案-專案設定」環節，確認存取路徑配置。
如果老工程做了短域名/IP存取，請將存取路徑置空
如果老工程修改了存取路徑，即http://IP:port/webroot/decision中的webroot被修改為了其他詞，請將存取路徑修改為對應詞
注意事項3：遷移時，需要將老工程的一些檔案copy到新工程中，因此需要記錄下新工程存放檔案的外掛目錄位置。
請在「部署新專案-節點配置」環節，記錄下主應用節點的掛載路徑。
注意事項4：部署新工程時，會同時部署一些必要組件，建議記錄下組件的資訊，方便在後續維護程式中查看。
請在「部署新專案-部署列表」環節，記錄下MySQL、ElasticSearch組件的相關資訊。
由於組件密碼隨機生成，且後續需要copy配置檔案，請務！必！修改組件的密碼，與老工程組件密碼完！全！一！致！，後續方可使用。
2.4 關閉新工程
1）管理者登入維運平台，選擇新工程，點選「維護>組件管理」。
2）找到bi6/fr組件，點選「停止」按鈕，即可關閉新工程。
2.5 備份新工程config資料夾
1）使用終端裝置存取新容器化工程所在伺服器，進入2.2節記錄的掛載路徑/fanruanxxx/bi目錄下。
注：如果忘記了新工程的掛載路徑，可透過匯出專案部署資訊查看。
2）找到config資料夾，資料夾中存放的yaml檔案有着工程部署所用語句，請務必異地備份。
3. 原工程準備
3.1 備份原工程
1）管理者登入維運平台，選擇原專案，點選「維護>備份管理」。
2）勾選「備份鏡像」，點選「開始備份」
3）確認在下方全部備份中出現相關備份後，代表備份成功。
3.2 升級工程
工程遷移的前提是，兩個工程必須處於同一版本。
管理者登入維運平台，選擇新老專案，點選「維護>組件管理」查看當前版本是否完全一致（精確到日期）。
若兩個工程版本不相同，可參考該文檔更新工程版本：內網升級維運專案
3.3 停止資料管道任務（FDL）
如為FineDataLink專案，請在遷移前，暫停所有資料管道任務，否則可能導致資料丟失.
管理者登入 FineDataLink，點選「維運中心>管道任務>任務管理」，全選所有任務，點選「批量暫停」。
3.4 關閉原工程
1）管理者登入維運平台，選擇原工程，點選「維護>組件管理」。
2）找到bi6/fr組件，點選「停止」按鈕，即可關閉新工程。
4. 遷移工程
4.1 copy外接資料庫
將原容器化專案中的MySQL組件的外掛目錄資料，copy到新工程專案中的MySQL組件的外掛目錄裏。
注：MySQL組件的外掛目錄地址，一般在專案掛載路徑/fanruanxxx/mysql下。
4.2 copy工程檔案
將原容器化專案中的bi6組件的外掛目錄資料，copy到新工程專案中的bi6組件的外掛目錄裏。
1）請提前檢查原工程，是否修改了外掛目錄位置、是否配置共享檔案伺服器，確定copy到正確的檔案。
2）新工程外掛檔案所在位置，為2.2節記錄的掛載路徑。
3）將以下檔案，從原工程外掛目錄，copy到新工程外掛目錄中：
注1：請勿直接copy整個外掛目錄資料夾到新工程，部分檔案不可以被改寫。
注2：請勿使用3.1節備份的檔案，而是使用工程最終的檔案進行copy操作。
FineBI需要copy的檔案
| 外掛目錄檔案位置 | 說明 |
|---|---|
| %BI_HOME%/fanruanxxx/bi6/assets/temp_attach | 作用：FineBI資料表相關資訊 是否必須copy：必須copy 該資料夾中存放着工程Excel原始檔案資訊，如不copy該資料夾會導致原始Excel丟失 |
| %BI_HOME%/fanruanxxx/bi6/assets/vcs | 作用：FineReport範本備份檔案 是否必須copy：使用者自行決定 如果工程未使用FineReport範本，或不需要回退歷史開發的FineReport範本，則無需copy |
| %BI_HOME%/fanruanxxx/bi6/assets/其他檔案 | 作用：通用的共享持久化目錄 是否必須copy：必須copy 工程正常運作所需要的檔案，如不copy會影響工程正常使用 |
| %BI_HOME%/fanruanxxx/bi6/backup | 作用：工程歷史備份檔案 是否必須copy：使用者自行決定，可儲存在原始的目錄下備份，可不copy |
| %BI_HOME%/fanruanxxx/bi6/bi-data | 作用：FineBI抽取資料 是否必須copy： 如果新老工程在同一伺服器上，可重新-v掛載原工程的bi-data資料夾，或在新工程啟動後重新抽取資料，無需copy 如果新老工程不在同一伺服器上，不建議copy，該資料夾一般資料量太大，copy困難，可在新工程啟動後重新抽取資料 |
| %BI_HOME%/fanruanxxx/bi6/classes | 作用：工程呼叫的預設和自訂class檔案 是否必須copy：必須copy 有可能存在自訂的class檔案，如不copy會影響工程正常使用 |
| %BI_HOME%/fanruanxxx/bi6/customlib | 作用：工程客製/外部引入的JAR包 是否必須copy：必須copy，如不copy會影響範本存取 |
| %BI_HOME%/fanruanxxx/bi6/dpworks | 作用：FineDataLink任務相關的配置檔案 是否必須copy：必須copy，如不copy會影響FineDataLink任務使用 （如不存在該資料夾，說明工程沒有使用FDL相關功能，略過） |
| %BI_HOME%/fanruanxxx/bi6/logs | 作用：swift日誌 是否必須copy：使用者自行決定 如果不copy，會丟失工程歷史操作日誌（即logdb），「管理系統>平台日誌」功能無資料 如對歷史使用情況無要求，無需copy |
| %BI_HOME%/fanruanxxx/bi6/plugins | 作用：插件相關檔案 是否必須copy：必須copy，如不copy會影響插件相關功能的實現 |
| %BI_HOME%/fanruanxxx/bi6/reportlets | 作用：FineReport範本存放目錄 是否必須copy：使用者自行決定 如果工程未使用FineReport範本，則無需copy |
| %BI_HOME%/fanruanxxx/bi6/schedule | 作用：排程管理生成的檔案 是否必須copy：使用者自行決定 如果不copy，定時任務掛載到決策平台的結果報表無法存取 |
| %BI_HOME%/fanruanxxx/bi6/tomcat_logs | 作用：Tomcat通用日誌位置 是否必須copy：使用者自行決定，Tomcat歷史存取日誌，可不copy |
FineReport需要copy的檔案
| 外掛目錄檔案位置 | 說明 |
|---|---|
| %FR_HOME%/fanruanxxx/fr/assets/temp_attach | 作用：讀寫快取儲存路徑 是否必須copy：必須copy 該資料夾中存放着工程讀寫（圖片）快取，不copy可能會導致範本設定的背景圖片預覽為空 |
| %FR_HOME%/fanruanxxx/fr/assets/vcs | 作用：FineReport範本備份檔案 是否必須copy：使用者自行決定 如果工程不需要回退歷史開發的FineReport範本，則無需copy |
| %FR_HOME%/fanruanxxx/fr/assets/其他檔案 | 作用：通用的共享持久化目錄 是否必須copy：必須copy 工程正常運作所需要的檔案，如不copy會影響工程正常使用 |
| %FR_HOME%/fanruanxxx/fr/backup | 作用：工程歷史備份檔案 是否必須copy：使用者自行決定，可儲存在原始的目錄下備份，可不copy |
| %FR_HOME%/fanruanxxx/fr/classes | 作用：工程呼叫的預設和自訂class檔案 是否必須copy：必須copy 有可能存在自訂的class檔案，如不copy會影響工程正常使用 |
| %FR_HOME%/fanruanxxx/fr/customlib | 作用：工程客製/外部引入的JAR包 是否必須copy：必須copy，如不copy會影響範本存取 |
| %FR_HOME%/fanruanxxx/fr/dpworks | 作用：FineDataLink任務相關的配置檔案 是否必須copy：必須copy，如不copy會影響FineDataLink任務使用 （如不存在該資料夾，說明工程沒有使用FDL相關功能，略過） |
| %FR_HOME%/fanruanxxx/fr/logs | 作用：swift日誌 是否必須copy：使用者自行決定 如果不copy，會丟失工程歷史操作日誌（即logdb），「管理系統>平台日誌」功能無資料 如對歷史使用情況無要求，無需copy |
| %FR_HOME%/fanruanxxx/fr/plugins | 作用：插件相關檔案 是否必須copy：必須copy，如不copy會影響插件相關功能的實現 |
| %FR_HOME%/fanruanxxx/fr/reportlets | 作用：FineReport範本存放目錄 是否必須copy：必須copy，如不copy會導致工程所有範本丟失 |
| %FR_HOME%/fanruanxxx/fr/schedule | 作用：排程管理生成的檔案 是否必須copy：使用者自行決定 如果不copy，定時任務掛載到決策平台的結果報表無法存取 |
| %FR_HOME%/fanruanxxx/fr/tomcat_logs | 作用：Tomcat通用日誌位置 是否必須copy：使用者自行決定，Tomcat歷史存取日誌，可不copy |
FineDataLink需要copy的檔案
| 外掛目錄檔案位置 | 說明 |
|---|---|
| %FDL_HOME%/fanruanxxx/fdl/assets | 作用：通用的共享持久化目錄 是否必須copy：必須copy 工程正常運作所需要的檔案，如不copy會影響工程正常使用 |
| %FDL_HOME%/fanruanxxx/fdl/backup | 作用：工程歷史備份檔案 是否必須copy：使用者自行決定，可儲存在原始的目錄下備份，可不copy |
| %FDL_HOME%/fanruanxxx/fdl/classes | 作用：工程呼叫的預設和自訂class檔案 是否必須copy：必須copy 有可能存在自訂的class檔案，如不copy會影響工程正常使用 |
| %FDL_HOME%/fanruanxxx/fdl/customlib | 作用：工程客製/外部引入的JAR包 是否必須copy：必須copy，如不copy會影響範本存取 |
| %FDL_HOME%/fanruanxxx/fdl/dpworks | 作用：FineDataLink任務相關的配置檔案 是否必須copy：必須copy，如不copy會影響FineDataLink任務使用 |
| %FDL_HOME%/fanruanxxx/fdl/logs | 作用：swift日誌 是否必須copy：使用者自行決定 如果不copy，會丟失工程歷史操作日誌（即logdb），「管理系統>平台日誌」功能無資料 如對歷史使用情況無要求，無需copy |
| %FDL_HOME%/fanruanxxx/fdl/plugins | 作用：插件相關檔案 是否必須copy：必須copy，如不copy會影響插件相關功能的實現 |
| %FDL_HOME%/fanruanxxx/fdl/tomcat_logs | 作用：Tomcat通用日誌位置 是否必須copy：使用者自行決定，Tomcat歷史存取日誌，可不copy |
5. 遷移後操作
5.1 啟動新老工程
1）管理者登入維運平台，選擇新老工程，點選「維護>組件管理」。
2）找到bi6/fr組件，點選「停止」按鈕，即可啟動新老工程。
5.2 新工程註冊
容器化工程一般使用「容器私有雲認證」方式進行註冊。
請參考文檔第四章進行授權遷移操作：遷移工程授權
5.3 資料抽取（BI）
注：僅FineBI工程需要執行本節操作。
1）管理者登入新工程，點選「公共資料>全局更新」。
2）執行「立即全局更新」，即可抽取最新資料，並存放到正確的儲存路徑中。
5.7 啟動資料管道任務（FDL）
注：僅FineDataLink工程需要執行本節操作。
管理者登入 FineDataLink，點選「維運中心>管道任務>任務管理」。
篩選出運作狀態為「暫停運作」的任務，可全選所有任務，點選「批量啟動」。
注：請注意甄別是否均為需要啟動的任務。