作为系统管理员,我们假定您具备一定的专业背景知识,否则以下升级和迁移过程可能无法顺利进行。如您不具备相关的专业知识,可以考虑 购买 我们的商业服务
友情提示:RB V3、V2 版本与 V1 版本完全兼容,请放心升级
通常每 3 个月左右 RB 会发布一个版本(如 3.5
、3.6
),新版发布后将不再为之前的版本发布修订版本(如 3.6.1
、3.6.2
)。每个版本的发布除了新增功能,也涉及到大量的功能优化、BUG 及漏洞修复,我们强烈建议您定期升级。关于新版更新内容,请参见 更新日志。
如需升级版本,请按照以下步骤进行:
针对 集成安装包 或使用其他 Java Web 容器,您也可以直接使用安装目录中的 REBUILD 目录替换(请注意先将旧的 REBUILD 目录删除再复制新的进去,以免有残留文件)
? 升级完成后建议重新打开一次浏览器,避免因浏览器缓存策略问题而导致页面加载错误
如果希望将 RB 迁移到其他服务器,请按照以下步骤进行:
全新安装只需删除 数据目录 即可。数据库不是必须要删除的,但在安装时请注意使用新的数据库(名称),若使用原有数据库 RB 会进行自动挂载。
您可以仅删除数据目录下的
.rebuild
文件后重新安装,安装时可调整数据库连接、缓存连接等参数
对于已经安装完成,希望修改数据库连接配置的(包括数据库和缓存服务,如数据库密码),推荐通过以下方式进行:
.rebuild
文件(注意不是文件夹)如果您希望通过备份文件还原,请按照以下步骤进行:
backup_database.YMD.zip
还原数据库(解压后导入到 MySQL)backup_datafile.YMD.zip
还原数据目录(请注意数据目录位置,默认位置为当前用户目录下)由于 MySQL5.x 与 MySQL8 的默认认证方式存在较大差异,因此您需要为 MySQL8 添加额外的配置参数。请在 MySQL8 配置文件(my.ini
或 my.cnf
)的 [mysqld]
区域下方添加如下参数(添加后请重启 MySQL)。
default_authentication_plugin=mysql_native_password
同时,由于 MySQL8 对默认的排序字符集进行了修改(默认为 utf8mb4_0900_ai_ci
),在导入备份前应首先执行以下命令再进行数据库导入操作。
set session default_collation_for_utf8mb4 = utf8mb4_general_ci;
? 如未能按照以上步骤操作,可能出现原有实体/字段与升级后新增的实体/字段编码不兼容,解决办法 参见此文
RB 支持 JDK1.8 ~ JDK17 的版本(同时兼容 OpenJDK),只要在此版本区间都可以使用,同时我们建议您选择 LTS 版本(长期支持版本),例如 JDK11。
? FrontJS 目前仅支持 JDK1.8 ~ JDK14 版本
请参见安装文档 常见问题
如您使用数据库备份还原系统,还原后请清空系统缓存,以免存在缓存冲突。对于使用默认缓存的,请删除 数据目录 下的 temp
目录;对于使用 Redis 的,请 参考此文 清空缓存。
不建议降级(尤其是使用了新版本功能的),系统未对降级做任何额外处理,请自行评估可能的风险。