安装

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

系统环境准备

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.zip 为外置 Tomcat 运行模式,其中包含了 Tomcat-8.5 和 OpenJDK-11(此 JDK 仅针对 64 位 Windows 系统,其他操作系统请自备 JDK/JRE)
  • rebuild-boot.jar 为 SpringBoot jar 独立运行模式(2.0 版本开始提供)

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

您也可以将 rebuild-standalone.zip 文件解压后,复制目录下的 REBUILD 至其他 Java Web 容器中使用

开始安装

启动

外置 Tomcat 启动

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

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

SpringBoot jar 启动

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

java -jar rebuild-boot.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.jar >/dev/null 2>&1 &

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

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

安装模式

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

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

? 如未自动进入安装页,可能是之前已经安装过。请将 RB 数据目录 ~/.rebuild/(其中 ~ 表示用户目录)删除后重新启动即可。如果需要在一台服务器上运行多个 RB 服务,请参考 在一台服务器上运行多个实例

标准安装

设置数据库 (1/5)

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

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

设置缓存服务 (2/5)

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

  • Ehcache(内置)
  • Redis(需要额外安装)

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

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

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

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

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

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

完成安装 (5/5)

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

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

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

授权码

在安装完成后,系统将为您生成一个唯一授权码(或称 SN),授权码是重要的授权凭证,请勿随意泄漏!在您购买 RB 商业版本时,我们将对您的授权码进行授权,授权后即可获得相应权益。

如何查看我的授权码

登录 RB 后点击右上角 ⚙️ 进入管理中心 - 通用配置,在页面右侧“关于 REBUILD”区域,点击“授权类型”即可查看您的专属授权码。

关于 REBUILD

授权码

高可用

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

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

腾讯云配置示例

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

该文档内容对您是否有帮助?没有
如有任何疑问,请与我们的 社区QQ 群 联系
Updated 8/9/2021, 11:10:39 PM