Summary

安装

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

系统环境准备

RB 使用 Java 开发，因此可运行在几乎所有操作系统上，如 Windows/Linux/macOS 等。 同时 RB 还依赖以下软件环境，建议在安装前准备好。如果您使用 Windows 平台并只是用于测试评估，那么它们都不是必须的（请参照下文）。

  • JDK/JRE 1.8+
  • MySQL 5.5+
  • Redis 3.2+（可选）

? MySQL 5.7 及以上请移除 SQL_MODE 中的 ONLY_FULL_GROUP_BY 项。详见 https://www.cnblogs.com/easilyai/p/11729882.html

? MySQL 8.0 及以上需要启用 mysql_native_password 即密码认证模式。详见 https://blog.csdn.net/beyond_yanbo/article/details/82458494

! 请勿与其他系统共用 Redis，因为在某些情况下 RB 可能会刷新/清空缓存

硬件要求

对于硬件方面的需求，主要取决于系统的并发量和数据量。按照一般情况，我们建议的硬件如下：

  • 最低配置：4 核 CPU + 8G 内存 + 500G 硬盘
  • 推荐配置：8 核 CPU + 16G 内存 + 500G 硬盘（SSD）

下载 RB 安装包

您可以到 RB 官网 下载最新版安装包，也可以至 RB 的 GitHub 项目 页下载。每个发型版本我们都会提供一键安装包，安装包分为两种：

  • rebuild-standalone-x.y.z.zip 为外置 Tomcat 运行模式，其中包含了 Tomcat-8.5 和 OpenJDK-11（此 JDK 仅针对 64 位 Windows 系统，其他操作系统请自备 JDK/JRE）
  • rebuild-boot-x.y.z.jar 为 SpringBoot jar 独立运行模式（2.0 版本开始提供）

请下载需要的版本安装包备用。

您也可以将 rebuild-standalone-x.y.z.zip 文件解压后，复制目录下的 REBUILD 至其他 Tomcat 中使用

开始安装

启动

外置 Tomcat 启动

解压安装包并进入主目录，双击 start-rebuild.bat 即可启动。

? bat 文件仅适用于 Windows 平台，如果您使用 Linux/macOS 请至 bin 目录下运行 startup.sh 脚本启动，启动前请确认已正确配置 JDK/JRE 环境，否则启动会失败。

SpringBoot jar 启动

可以通过以下命令直接启动。

java -jar rebuild-boot-x.y.z.jar

通常情况下您还需要指定一些额外的启动参数，并以后台模式运行，因此以下（Shell）命令可能更为适合。

// https://github.com/getrebuild/rebuild/tree/master/.deploy/restart-rebuild.sh
nohup java -Xms2G -Xmx2G -XX:+UseG1GC -Djava.awt.headless=true -jar rebuild-boot-x.y.z.jar >/dev/null 2>&1 &

启动后请打开浏览器，并输入 http://127.0.0.1:18080/ 访问，RB 会自动引导您进入安装过程。

RB 使用 SpringBoot 开发，若有兴趣可以参考 官方文档 查询更多启动方式

安装模式

进入安装页后，有两种安装模式可供选择。其中 [快速安装] 将使用内置的 H2 数据库进行安装，此模式非常简单，可以快速安装体验 RB 功能，但请注意，此模式仅供测试使用，且部分功能可能无法使用。

使用 [快速安装] 模式步骤较为简单，因此本文主要介绍 [标准安装] 。

标准安装

设置数据库 (1/5)

点击 [标准安装] 首先进入数据库设置。在数据库设置字段中都有合理的默认值，您可以使用默认值，也可以自行填写。设置完毕后点击下一步，系统会自动测试连接，如测试失败将提示失败原因，请根据错误做相应调整。

?请赋予 MySQL 用户足够的权限，否则数据库可能会初始化失败

设置缓存服务 (2/5)

缓存有助于提高系统访问速度，RB 支持以下两种缓存：

  • Ehcache（内置）
  • Redis（需要额外安装）

其中 Redis 具有更好的访问性能，与之相对的是更为复杂的配置。非高并发情况下使用内置的 Ehcache 即可满足。

设置超级管理员 (3/5)

在管理员设置页面，您可以为管理员指定新的密码和管理员邮箱，默认密码为 admin。需要注意的是，管理员的登录名不能修改，固定为 admin。

QQ20201114140201

选择初始业务实体 (4/5) ~~v2.1

您可以选择由 RB 仓库 提供的已经配置好的实体直接使用。此步骤不是必须的，您也可以在安装完成后至管理员后台 - 实体管理 - [添加实体] 进行安装，所提供的实体与此步骤是一致的。

选择完毕后点击 [完成安装] 即可进入安装过程。

QQ20201114140207

完成安装 (5/5)

按照设置好的参数，RB 将进入自动安装过程，此过程一般需要 30-60 秒左右，完成后即可登录使用。如果安装失败，系统会提示错误原因，请根据错误提示进行相应调整后重新安装。

安装过程如遇问题，请向我们 提交 或购买我们的 商业服务 支持。

以上安装过程适用于 V2.0 及更高版本，之前的版本请 参考此处

高可用

在生产环境中，系统可用性是关键的系统质量指标，RB 会定期检测系统健康并实时反应在服务状态页面。

同时，RB 还提供了一个供第三方监控系统使用的接口 http://YOUR-RB-SERVER/error/server-status.json。您可以使用任意监控系统对此地址进行监控，并对返回结果进行验证即可。

腾讯云配置示例

进入腾讯云控制台 - 云拔测 - 站点质量监控，点击 [新建任务] 添加一个新的监测，并参考如下配置。

编辑更新时间 4/13/2021, 1:30:53 AM