升级和迁移

作为系统管理员,我们假定您具备了一定的专业背景知识,否则以下升级和迁移过程可能无法顺利进行。如果您不具备相关的专业知识,可以考虑 购买 我们的商业服务

友情提示:RB V3、V2 版本与 V1 版本完全兼容,请放心升级

系统升级

通常每 3 个月左右 RB 会发布一个主要版本(Minor),新版本发布后不再为之前的版本发布修订版本(关键更新)。每个版本的发布除了新增功能,也涉及到大量的功能优化、BUG 及漏洞修复,我们强烈建议您定期升级。关于新版本更新内容,请参见 更新日志

如需升级版本,请按照以下步骤进行:

  1. 下载 最新的 RB 安装包备用
  2. 停止 RB 服务
  3. 备份原安装目录/文件和数据库
  4. 删除原安装目录/文件,使用新安装目录/文件替代
  5. 最后启动服务即可,RB 会自动完成升级过程

? 升级完成后建议重新打开一次浏览器,避免因浏览器缓存策略问题而导致页面加载错误

针对 集成安装包 或使用其他 Java Web 容器,您也可以直接使用安装目录中的 REBUILD 目录替换(请注意先将旧的 REBUILD 目录删除再复制新的进去,以免有残留文件)

系统迁移

如果希望将 RB 迁移到其他服务器,请按照以下步骤进行:

  1. 停止 RB 服务
  2. 复制 RB 安装目录/文件到新服务器(存放目录不要求与原目录一致)
  3. 复制 RB 数据目录 到新服务器(需存放在用户目录下)
  4. 复制(迁移) MySQL 数据库到新服务器,同时注意新 MySQL 的用户和密码须与原 MySQL 的用户名密码一致
  5. 最后启动服务即可

全新安装

全新安装只需删除 数据目录 即可。数据库不是必须要删除的,但在安装时请注意使用新的数据库(名称),若使用原有数据库 RB 会进行自动挂载。

您可以仅删除数据目录下的 .rebuild 文件后重新安装,安装时可调整数据库连接、缓存连接等参数

修改数据库连接配置

对于已经安装完成,希望修改数据库连接配置的(包括数据库和缓存服务),推荐通过以下方式进行:

  1. 停止 RB 服务
  2. 删除 数据目录 下的 .rebuild 文件
  3. 启动 RB 服务,系统会再次进入安装页面
  4. 填写新的数据库、缓存服务参数。请特别注意数据库应填写已存在的数据库名,系统会自动挂载
  5. 等待安装完成即可

软件环境升级

升级 MySQL5.x 到 MySQL8

由于 MySQL5.x 与 MySQL8 的默认认证方式存在较大差异,因此您需要为 MySQL8 添加额外的配置参数。请在 MySQL8 配置文件(my.inimy.cnf)的 [mysqld] 区域下方添加如下参数(添加后请重启 MySQL)。

default_authentication_plugin=mysql_native_password

同时,由于 MySQL8 对默认的排序字符集进行了修改(默认为 utf8mb4_0900_ai_ci),在导入备份前应首先执行以下命令再进行数据库导入操作。

set session default_collation_for_utf8mb4 = utf8mb4_general_ci;

? 如未能按照以上步骤操作,可能出现原有实体/字段与升级/迁移后新增的实体/字段编码不兼容,解决办法 参见此文

升级 Java 版本

RB 支持 JDK1.8 ~ JDK17 的版本(同时兼容 OpenJDK),只要在此版本区间都可以使用,同时我们建议您选择 LTS 版本(长期支持版本),例如 JDK11。

? FrontJS 目前仅支持 JDK1.8 ~ JDK14 版本

常见问题

安装常见问题

请参见安装文档 常见问题

备份还原注意事项

如您使用数据库备份还原系统,还原后请清空缓存,以免存在缓存冲突。对于使用默认缓存的,请删除 数据目录 下的 temp 目录;对于使用 Redis 的,请 参考此文 清空缓存。

是否支持版本降级

一般情况下不建议直接降级,系统未对降级做任何额外处理,请自行评估可能的风险。

该文档内容对您是否有帮助?没有
如有任何疑问,请与我们的 社区QQ 群 联系
更新时间 4/2/2024, 8:12:55 PM
目录