概述
非运维平台部署的工程，如需迁移至运维平台部署，可能会存在一些兼容影响。
请务必先提前确认以下兼容问题，再进行工程迁移。
兼容说明
非官方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数据集插件
更多项目使用问题
详情请参见：项目使用常见问题
