概述
非維運平台部署的工程，如需遷移至維運平台部署，可能會存在一些相容影響。
請務必先提前確認以下相容問題，再進行工程遷移。
相容說明
非官方JAR包遷移後不確定生效
相容說明：
維運平台部署的專案，是基於帆軟標準化產品產出。
對於自訂二開的JAR包，遷移後不確定仍可正常使用。
解決方案：
1）如相關客製JAR包由帆軟提供，建議聯絡帆軟協助評估遷移對此部分內容的影響。
2）請在遷移結束後，確認相關自訂JAR包是否已上傳至工程外掛目錄/customlib/lib資料夾中。
3）請再次確認JAR包對應功能是否生效。
非官方插件遷移後不確定生效
相容說明：
維運平台部署的專案，是基於帆軟標準化產品產出。
對於非帆軟市場可下載的插件（即插件來源為第三方渠道），遷移後不確定仍可正常使用。
解決方案：
1）如相關客製插件由帆軟提供，建議聯絡帆軟協助評估遷移對此部分內容的影響。
2）請在遷移結束後，透過「管理系統>插件管理」確認安裝並啟動相關插件。
3）請再次確認插件對應功能是否生效。
遷移後不支援自訂web.xml檔案
相容說明：
對於/webroot/WEB-INF目錄下的web.xml，遷移前，使用者可能對其進行了客製化修改（例如CAS相關配置）。
遷移後，維運平台部署的專案，不再支援自訂web.xml檔案。
解決方案：
建議聯絡帆軟協助評估遷移對此部分內容的影響
遷移後自訂資源檔案不可隨意存放
相容說明：
帆軟應用中，可能會存在一些工程需要呼叫的css、js、html、圖片等自訂資源。
對於維運平台部署的專案，這些資源檔案應當統一上傳到工程外掛目錄/help資料夾。
如果上傳到非外掛持久化目錄中，會因重啟而丟失。持久化的外掛目錄包括：
解決方案：
1）對於工程需要呼叫的一些css、js、html、圖片等自訂資源。
遷移前，可能存放在webroot下的任意位置
遷移後，需要自行手動上傳到工程外掛目錄/help資料夾中，可透過「檔案管理」上傳
2）對於呼叫到了這些資源檔案的範本，需要手動修改範本中呼叫的資源路徑。
例如上傳了 xxx.jsp 檔案，存取該資源的路徑即為http://ip:port/webroot/help/xxx.jsp
遷移後工程不支援自簽章憑證
相容說明：
維運平台部署的工程，僅支援為 nginx 組件配置正規 CA 廠商頒發的 .crt 或 .pem 格式的 SSL 證書，不支援自簽章憑證。
影響的功能包括但不限於：
資料儲存服務
LDAP域同步
工程https存取
解決方案：
1）如原先使用 JDK 自帶的 keytool 工具生成自簽章憑證，遷移後無法使用。
遷移後，必須自行向 CA 廠商購買正式的憑證，用於配置 SSL 。
2）使用維運平台部署新專案時，必須勾選部署 nginx 內網關組件，以安裝憑證。
3）遷移成功後，請參考文檔手動配置憑證：為維運專案開啟SSL
操作日誌Logdb的備份與遷移
相容說明：
非維運平台部署的工程，預設使用Swift引擎儲存工程操作日誌，儲存在%Tomcat_HOME%/webapps/webroot/logs/cubes資料夾中。
維運平台部署的工程，如部署並啟動了ElasticSearch組件，預設使用ElasticSearch儲存工程操作日誌。
如使用遷移工具遷移，預設不對歷史檔案進行遷移。
解決方案：
| 啟動ElasticSearch | 場景：
說明：
|
| 不啟動ElasticSearch | 場景：
說明： 如不啟動ElasticSearch，仍使用logdb作為日誌儲存，且需要對歷史操作日誌進行保留。請在遷移前，使用 平台日誌同步到其他資料庫插件 ，將歷史日誌匯出到自備的相關資料庫中 |
遷移後常見問題
遷移後單點登入失敗
相容說明：
部分瀏覽器的安全策略，導致單點登入失敗。
對於非維運平台部署的工程，內建HTTPS_SameSite_跨域策略可以直接解決該問題。
但是維運平台部署的工程，需要進行一些配置方可生效。
解決方案：
1）首先請確定 為維運專案開啟SSL
2）請參考 報表頁首與頁尾 2.1.2節，執行相關操作即可
遷移後釘釘/企微整合失效
相容說明：
釘釘/企微整合，需要將可信域名歸屬校驗檔案上傳至域名根目錄下。
該檔案的儲存位置，在遷移前後不盡相同。
解決方案：
請在遷移後，手動將相關可信域名歸屬校驗檔案，上傳至工程外掛目錄/ROOT資料夾下
遷移後FineBI工程自帶的首頁報錯
相容說明：
FineBI工程預設內建首頁，使用了一些自訂資源，遷移後無法正常預覽
解決方案：
1）將%Tomcat_home%/webroot下的Demo_files資料夾和Demo.html檔案，上傳至工程外掛目錄/help資料夾中。
2）在「管理系統>目錄管理」中，將首頁地址修改為help/Demo.html
遷移後無法短域名存取
相容說明：
遷移前，使用者可能透過修改配置檔案，實現了短域名/IP存取工程
遷移後，維運平台部署的專案，不再支援自訂相關配置檔案。
解決方案：
使用者無需透過自訂修改web.xml檔案，來實現短域名/IP存取工程。
遷移後工程圖示異常
相容說明：
遷移後，工程左上角圖示顯示異常，需要手動重新配置。
解決方案：
在「管理系統>外觀配置>平台樣式」Tab 頁下，「平台Logo」中重新上傳圖示即可。
官方預設logo獲取：
遷移後SAP資料集功能失效
相容說明：
SAP資料集功能，依賴sapjco3.jar、sapjco3.dll檔案，只有正確讀取到了相關檔案，功能才能生效。
升級前後，檔案的存放位置可能不完全一致，導致功能失效
解決方案：
升級後，請將sapjco3.jar、sapjco3.dll檔案，上傳至工程外掛目錄/plugins目錄下的SAP插件資料夾中即可
檔案獲取請參考：新SAPBW資料集插件
更多專案使用問題
詳情請參見：專案使用常見問題