在实际使用 FineBI 过程中，用户有时需要将一个在使用的 BI 工程迁移到另一个 BI 工程中。

本文详细介绍工程迁移的操作步骤。

2.1 确认版本

在迁移工程之前首先要确保两个服务器部署的 FineBI 版本一致。

进入「管理系统>注册管理>版本信息>BI模板」查看，如下图所示：

若版本不一致，参考 FineBI 升级指南 进行升级或者 重新安装 新版本。

2.1 全局迁移

2.1.1 配置外接数据库的工程进行备份

若迁移前旧工程配置了 外接数据库，需要进入「管理系统>智能运维>备份还原」，在「平台配置、报表模板、BI模板、JAR 包、插件」Tab 栏下分别点击「手动备份」，备份相关信息，详情参见：备份还原 。

2.1.2 停止 BI 进程

先检查 FineBI 是否正在运行，保证在 FineBI 关闭状态下进行迁移。

2.1.3 配置内置数据库的工程进行备份

若迁移前旧工程没有配置过外接数据库，则需要备份好 webroot 文件夹，在 webroot 路径%FineBI%\webapps\webroot下拷贝工程。

注：备份都以压缩文件夹形式存放，或者把备份文件拷贝到非工程所在目录，确保 Web 容器里只有一个名为 webroot 的工程。

2.1.4 替换工程

将迁移前旧工程目录%FineBI%/webapps下的 webroot 文件夹拷贝至迁移后新工程中替换。

2.1.5 外接数据库回迁内置数据库

注：若使用内置数据库则不需要此步骤。

1）删除需要迁移到的新工程%FineBI%/webapps/webroot/WEB-INF/config下的「db.properties」文件。

2）在迁移前的旧工程%FineBI%/webapps/webroot/backup/config/manual文件夹下，找到备份的 congfig.zip 文件。

解压「config」文件，并将解压后的备份文件拷贝到新系统%FineBI%/webapps/webroot/WEB-INF/embed中，如下图所示：

注：详情可参见：外接数据库如何回迁内置数据库 。

2.1.6 重启服务器

重新启动新的服务器，启动完成即可在新的工程中正常使用。

注：工程迁移成功后，可根据需要 配置外接数据库 。

2.2 增量迁移

若在旧系统中只是做了一些新的仪表板想要放到新系统，可以使用 FineBI的 资源迁移 功能。