本文将详细的介绍 Finereport 10.0 升级至 11.0 前，需要做的准备工作。
1）FineReport 10.0 与 11.0 版本之间没有内置升级功能，用户需要使用 10-11 升级工具完成。升级工具使用可参考：10-11 升级工具 。
2）FineReport 9.0 升级 FineReport 11.0，要先升级到 FineReport 10.0，再升级至 11.0。FineReport 9.0 升级 FineReport 10.0 可参考 ：FineReport 9.0 版本升级 10.0 。
3）如果您是 FineReport 与 FineBI 集成使用的用户，请您在升级前仔细阅读：FineBI与FineReport版本适配说明 。
4）升级前请先仔细阅读：10-11 兼容说明 。
5）用户在进行升级前，为避免升级失败出现文件丢失的情况，请将所需要的文件进行备份后再升级。备份可参考：备份还原 。
6）因大版本的授权不能共用，授权也需要升级，进行10-11前，请务必和对应的销售进行确认，否则会导致升级后授权无法使用。
下面详述升级前备份相关的准备工作：
1.备份平台配置编辑
注：必做
使用管理账号登录数据决策系统，在「管理系统>智能运维>备份还原>平台配置」中选中手动备份。默认备份路径为：.../backup，备份文件储存在工程的 %FR_HOME%/webapps/webroot/backup 文件夹下。
2.备份工程文件编辑
注：必做
可以备份整个tomcat，或者%TOMCAT_HOME%/webapps下的webroot工程包。建议可备份整个tomcat，原来的 10.0 的工程在 tomcat 中，把 tomcat 复制一份，重命名为 tomcat11
3.新建数据库表空间编辑
注：必做
如果升级前配置了外接库，在升级工具处理后，平台回转为默认的内置 finedb 模式。升级工具进行处理时，不会修改外接库里的数据，而是转为内置的表进行升级的。
但是为了跟原先 10 的外接库互相独立，不影响之前的表数据，建议新建一个数据库做迁移，建表相关文档见：配置外接数据库。待后续 11 运行稳定，可以将原先 10 的外接库删除。
finedb与数据连接的区别：升级后须知 中2.2节
4. 升级工具获取与升级技术协助编辑
升级技术协助
Finereport 大版本升级技术协助，目前由专属的升级团队负责，您可以通过提交「升级风险评估书」，做个简单的前置环境信息了解，评估书链接如下：升级风险评估书 。在提交「升级风险评估书」后会自动进入系统排队，升级团队会在您填写的预期升级时间内，主动与您取得联系，对接具体升级事宜，商务问题请联系您的销售经理进行确认。
升级工具获取
由于 FineReport 功能不断优化，产品不断迭代升级，因此升级工具也在不断更新，本文暂不提供升级工具下载链接。您可以选择直接提交风险评估书，届时升级团队会给您发放；或者联系技术支持获取。技术支持联系方式 QQ：800049425，电话：400-811-8890
5.正式授权预处理编辑
说明：商务给的授权迁移插件或者迁移工具，执行后会生成一个默认7天的临时授权，该授权需要在后期申请正式授权时使用，请妥善保存！！
请使用合同中指定的邮箱发送注册信息给 FineReport 商务business@fanruan.com，邮件格式如下：
| 发件人 | 请使用合同中指定的邮箱 |
| 收件人 | business@fanruan.com |
| 标题 | XXX 公司Finereport10版本升级Finereport11版本，升级前处理 FineReport 正式授权 |
| 内容 | Finereport10版本升级11版本，升级前授权销毁 因**公司的帆软服务器工程要从Finereport10升级至FineReport11.0，故需要对正式授权做变更。升级后的功能点和合同版本保持一致。 现在需要申请将原本的授权进行销毁，而后等正式升级成功后，在申请正式FineReport11版本的授权。附件为现在的正式授权以及注册成功页面截图。 |
| 附件一 | 当前版本的正式授权 %FR_HOME%/webroot/WEB-INF/resources目录下的「FanRuan.lic」文件 |
| 附件二 | 当前版本导出的 注册信息的rif 文件 系统管理》注册管理》导出注册信息 |
| 附件三 | 请发送工程决策平台》注册管理的截图。其中必须显示【原服务器注册信息】及【原服务器“注册成功”字样】 |
6.升级前须知编辑
1）磁盘容量：由于升级工具体积较大，升级过程会对必要的文件进行解压，同时可以对 10.0 进行整体 webroot 备份，所以升级工具所在磁盘保证剩余容量大于 3G 。如果需要备份，备份路径所在磁盘保证剩余容量大于 webroot 工程大小。
2）工程及升级工具路径：升级工具和工程所在路径不要包含较多特殊字符，可包含中文、英文、数字、英文括号、下划线、英文连接符、空格（一般不要将工程放在 C 盘内）。
3）关闭工程：升级之前请先关闭待升级的 10.0 工程，关闭或重启报表工程 。
4）工程配置：10.0 工程如果配置了外置库、状态服务器、文件服务器，升级过程需要保证均可以正常连接以便更新文件。
5）端口占用：升级过程会占用 20216 和 20217 端口
6）升级环境：支持断网升级，支持无 JDK 环境升级
7）工程配置：支持对单机工程和集群工程进行升级。集群升级时，只对单节点进行升级，升级成功后将升级成功的 webroot 拷贝替换至其他节点下。
8）定制情况：10.0 工程存在定制情况，比如 JAR 定制、外置库定制、二开、集成定制等，请提前与技术支持确认升级后是否兼容以及如何兼容适配。升级工具在进行 10.0 升11.0 的时候升级工具会替换 webroot\scripts 和 webroot\upm 文件夹，若在 scripts 和 upm 文件夹下存在定制文件（例如自定义的 js、css 文件）需要提前备份，再升级完成后手动复制到升级后的 11.0 工程中。
9）插件适配：当前 FR11.0 只适配了官方插件，所以第三方插件、定制插件可能会出现升级后无法使用的情况，需要提前确认。
10）JAR 包版本：在进行升级前需要将 JAR 包升级至 2020-08-04 及之后的日期。若未将 JAR 包未升级至 2020-08-04 就使用升级工具进行升级，将会提示报错：工程版本低于2020.08.04，无法升级，建议更新后再尝试升级。
7.工程拿到其他的环境升级编辑
单机的环境如果需要将工程拿到其他环境下升级，则需要将finedb还原成内置finedb模式，避免新环境外接库连不上而导致升级失败。还原内置 finedb 具体操作：
1）“1.备份平台配置”操作完成后，进入工程的/webapps/webroot/backup/config/manual/下，找到最新的日期的文件夹（比如：2022-04-13-13:47:53，文件夹名字是手动备份的时间），其中 config.zip 里面存放的是转换为内置库模式的 finedb。
2）解压 config.zip 文件，将解压后的 finedb 文件拷贝到备份工程的 /webapps/webroot/WEB-INF/embed 中，替换掉之前的 finedb 文件夹（按照 tomcat10 为原始环境，tomcat11 为备份环境来看，就需要将tomcat11/webapps/webroot/WEB-INF/embed中的 finedb 替换掉）。
3）再进入备份tomcat11/webapps/webroot/WEB-INF/config目录，删除 db.properties 配置文件（该文件保存了外接数据库的配置）。
tomcat1 1完成转换为内置 finedb 模式，至此 tomcat11 和原先的 tomcat10 完全独立，互不影响，但是不能在一个环境上同时启动（端口占用导致不能同时启动）。
4）再对还原内置 finedb 后的 webroot 用升级工具进行升级即可。