升级和迁移

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

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

系统升级

通常每 3 个月左右 RB 会发布一个版本（如 3.5、3.6），新版发布后将不再为之前的版本发布修订版本（如 3.6.1、3.6.2）。每个版本的发布除了新增功能，也涉及到大量的功能优化、BUG 及漏洞修复，我们强烈建议你定期升级。关于新版更新内容，请参见 更新日志。

如需升级版本，请按照以下步骤进行：

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

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

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

系统迁移

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

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

全新安装

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

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

修改数据库连接配置

对于已经安装完成，希望修改数据库连接配置的（包括数据库和缓存服务，如数据库密码等），推荐通过以下方式进行：

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

备份还原

如果你希望通过备份文件还原，请按照以下步骤进行：

1. 使用 backup_database.YMD.zip 还原数据库（解压后导入到 MySQL）
2. 使用 backup_datafile.YMD.zip 还原 数据目录（需存放在用户目录下（若修改过数据目录则以修改后的为准））
3. 最后启动服务即可

? 还原后建议清空系统缓存，以免存在缓存冲突。对于使用默认缓存（Ehcache）的，请删除 数据目录 下的 temp 目录，对于使用 Redis 的，请 参考此文 清空缓存

软件环境升级

升级 MySQL5.x 到 MySQL8.x

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

default_authentication_plugin=mysql_native_password

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

set session default_collation_for_utf8mb4 = utf8mb4_general_ci;

? 如未能按照以上步骤操作，可能出现原有实体/字段与升级后新增的实体/字段编码不兼容，提示 Illegal mix of collations (utf8mb4_general_ci,IMPLICIT) ... 错误，解决办法 参见此文

升级 Java 版本

RB 支持 JDK1.8 ~ JDK17 的版本（同时兼容 OpenJDK），只要在此版本区间都可以使用，同时我们建议你选择 LTS 版本（长期支持版本），推荐 JDK11 版本。

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

常见问题

提示错误 Table 'xxx' doesn't exist

此问题常见于迁移 MySQL，在数据导出-导入时未保持表名大小写，导致无法找到表。请配置 MySQL 忽略大小写即可，详情可参阅下列文章。

• MySQL5.x 版本参考 https://blog.csdn.net/guoliwei2010/article/details/78452691
• MySQL8.x 版本参考 http://yhrun.cn/article/16

另请参见安装文档 常见问题

是否支持版本降级

不建议降级（尤其是使用了新版本功能的），系统未对降级做任何额外处理，请自行评估可能的风险。