1. 概述
在一些特定情况下,用户进行跨版本升级后可能需要恢复到升级前的版本。本文提供升级后回退至原版本的操作步骤。
2. 常用的启动/关闭工程命令
2.1 启动工程
2.1.1 Linux系统
进入工程 bin 目录下,重启工程。如下图所示:
cd /home/wendy/tomcat-linux/bin
./startup.sh
2.1.2 windows系统
进入 tomcat 的 bin 目录下,双击后者右击用管理员运行 startup.bat 。
2.1.3 其他
请参考:关闭或重启FineReport工程 或者自行解决。
2.2 关闭工程
2.2.1 Linux系统
1)执行下面命令,查看工程进程。如下图所示:
ps -ef|grep tomcat-linux
2)杀死工程进程,并检查是否有残余工程进程,需杀死所有本工程相关的进程。如下图所示:
kill -9 31126
2.2.2 windows系统
直接关闭 tomcat 黑色窗口,或者进入 tomcat 的 bin 目录下双击运行 shutdown.bat 。
2.2.3 其他
请参考:关闭或重启FineReport工程 或者自行解决。
2. 备份文件准备
要求升级前,对工程做过如下备份:详情见:10-11升级前准备
1)在10版本的「管理系统>智能运维>备份还原>平台配置」中选中手动备份。默认备份路径为:.../backup,备份文件储存在工程的 %FR_HOME%/webapps/webroot/backup 文件夹下,如下图所示:
2)备份整个 tomcat 或者备份%TOMCAT_HOME%/webapps下的 webroot 工程包
3. 单机回退
3.1 备份的文件为webroot
1)关闭 FineReport 工程。
2)替换工程:将备份的旧工程 webroot 文件,替换%FR_HOME%\webapps路径下的 webroot 文件即可,如下图所示:
注:需保证工程下只有一个 webroot,否则会导致启动后访问 404。
3)重启 FineReport 工程完成回退。
3.2 备份的文件为tomcat
1)关闭 升级后的tomcat。
2) 启动备份的tomcat即可。
3.3 特殊情况
注:升级前做了外接库的用户,由于某些原因,升级后将外接库迁移到原来的数据库的,需要先回退为内置 finedb 的形式,才能进行重启。
回退内置 finedb 的操作如下:
在%FR_HOME%/webapps/webroot/backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的 config.zip 解压得到的 finedb,替换%FR _HOME%/webapps/webroot/WEB-INF/embed下的 finedb 文件,如下图所示:
4. 集群回退
4.1 备份的文件为webroot
1)关闭 FineReport 工程,每个节点都需要关闭。
2)替换工程:
将每个节点备份的旧工程 webroot 文件,替换对应节点的%FR_HOME%\webapps路径下的 webroot 文件,如下图所示:
注:需保证工程下只有一个webroot,否则会导致启动后访问404。
3)依次启动所有节点,完成回退。
4.2 备份的文件为tomcat
1)关闭 升级后所有节点的 tomcat。
2) 依次启动所有备份的 tomcat 即可。
4.3 特殊情况
注:升级前做了外接库的用户,由于某些原因,升级后将外接库迁移到原来的数据库的,需要先回退为内置finedb的形式,才能进行重启。
1)先将单节点回退内置finedb:
在%FR_HOME%/webapps/webroot/backup/config/manual下,根据文件夹的名字(备份时间),找到备份的内容,将备份的 config.zip 解压得到的 finedb,替换%FR _HOME%/webapps/webroot/WEB-INF/embed下的 finedb 文件,如下图所示:
2)启动单节点。
3)配置 finedb 到原外接库表:进入「管理系统>系统管理>常规」点击外接库进行配置:配置外接数据库 。
配置完成后,确认集群模式开启状态:
4)关闭当前节点,依次启动所有节点,完成回退。