安装

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

系统环境准备

REBUILD (简称 RB)使用 Java 开发,因此可运行在几乎所有操作系统上,如 Windows/Linux/Unix 等。 同时系统还依赖以下软件环境,建议在安装前准备好。如果您使用 集成安装包 并仅用于测试评估,那么它们都不是必须的。

  • MySQL 5.6+
  • JDK 1.8+(可选,集成安装包自带)
  • Redis 3.2+(可选,可使用自带 Ehcache 缓存)

? MySQL 5.7 及以上请移除 SQL_MODE 中的 ONLY_FULL_GROUP_BY 项。详见 https://www.cnblogs.com/easilyai/p/11729882.html
MySQL 8 及以上需要启用 mysql_native_password 即密码认证模式。详见 https://blog.csdn.net/beyond_yanbo/article/details/82458494

您可以下载我们配置好的 MySQL 绿色安装包,解压即可使用。请注意此安装包仅支持 Windows 64 位平台,同时建议您阅读安装包内的 README.txt 文件

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

若您使用宝塔面板,请 参考此文档 进行安装

下载安装包

您可以到 RB 官网 下载最新版安装包,也可以至 RB 的 GitHub 项目 页下载。每个发行版本我们都会提供编译好的安装包,安装包分为两种:

  • 集成安装包 rebuild-standalone.zip 除了 REBUILD 程序外还自带了运行环境,包括:
    • Apache Tomcat
    • OpenJDK(此 JDK 不适用 macOS 系统,macOS 系统请先自行安装 JDK)
    • 启动/停止脚本
  • Boot 安装包 rebuild-boot.jar 只包含 REBUILD 程序自身

如果您对 Spring Boot 了解,可以使用 Boot 安装包,否则建议您使用集成安装包,两种安装包在功能上没有差异。

开始安装

启动

集成安装包启动

解压安装包并进入安装目录,运行 start-rebuild.bat(Windows)或 start-rebuild.sh(Linux/Unix)即可启动。

? Linux/Unix 执行 .sh 脚本时若提示没有执行权限,请在 RB 安装目录执行命令 chmod +x chmodx.sh && ./chmodx.sh 添加执行权限

如遇启动异常,您可以在命令行窗口为启动脚本添加 run 参数前端启动,以便查看启动过程中遇到的问题。如 start-rebuild.sh run

Boot 安装包启动

可以通过以下命令启动 Boot 安装包:

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://localhost:18080/ 访问,RB 会自动进入安装页并引导您完成安装。

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

安装模式

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

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

标准安装

设置数据库 (1/5)

点击 [标准安装] 并同意服务协议后,首先进入数据库设置,请按照要求正确填写您的数据库连接参数,填写后点击下一步,系统会自动测试连接,如测试失败将提示失败原因,请根据错误做相应调整。

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

? 若您填写的数据库已经存在,系统会自动检测是否为 RB 数据库后执行挂载,请确保数据库完整

设置缓存服务 (2/5)

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

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

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

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

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

选择初始业务实体 (4/5)

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

RB 的 业务实体 是由用户配置搭建后使用的,因此您也可以根据自身需求进行搭建

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

完成安装 (5/5)

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

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

常见问题

MySQL 连接错误

通常情况下安装失败都是由于 MySQL 连接问题导致,以下是一些常见问题。

无法连接到 MySQL,请确认 MySQL 是否启动且运行正常,以及您填写的主机、端口是否有误。

Access denied for user 'xxx'@'xxx' (using password: YES)

MySQL 用户名或密码错误。请确认 MySQL 用户名、密码是否正确。

Specified key was too long; max key length is xxx bytes

此问题常见于 MySQL 5.6 版本,原因为索引长度超限,建议升级 MySQL 5.7 或更高版本(MySQL 官方对 5.6 版本已 停止维护)。

Invalid ID for region-based ZoneId, invalid format: xxx

RB 无法获取正确的系统时区。请添加 JVM 启动参数手动指定时区,如 -Duser.timezone=Asia/Shanghai

Public Key Retrieval is not allowed

此问题常见于 MySQL 8 版本,为 SSL/TLS 协议传输问题,建议使用 mysql_native_password 模式添加 allowPublicKeyRetrieval=true 参数。问题参考 https://www.cnblogs.com/lusaisai/p/13372763.html

Table xxx doesn't exist

此问题常见于迁移 MySQL,在数据导出-导入时未保持表名大小写,导致无法找到表。请配置 MySQL 忽略大小写即可。详情参见 https://blog.csdn.net/guoliwei2010/article/details/78452691

该文档内容对您是否有帮助?没有
如有任何疑问,请与我们的 社区QQ 群 联系
Updated 2024-05-11
目录