hertzbeat/home/docs/start/package-deploy.md

id, title, sidebar_label

id	title	sidebar_label
package-deploy	通过安装包安装HertzBeat	安装包方式部署

HertzBeat支持在Linux Windows Mac系统安装运行，CPU支持X86/ARM64。由于安装包自身不包含JAVA运行环境，需您提前准备JAVA运行环境。

安装部署视频教程: HertzBeat安装部署-BiliBili

1. 安装JAVA运行环境-可参考官方网站
   要求：JDK8+(已验证JDK8)
   下载JAVA安装包: 镜像站
   安装后命令行检查是否成功安装

   $ java -version
   openjdk version "1.8.0_312"
   OpenJDK Runtime Environment (Zulu 8.58.0.13-CA-macos-aarch64) (build 1.8.0_312-b07)
   OpenJDK 64-Bit Server VM (Zulu 8.58.0.13-CA-macos-aarch64) (build 25.312-b07, mixed mode)
   

2. 下载HertzBeat安装包 下载您系统环境对应的安装包

   • 从GITEE Release 仓库下载
   • 从GITHUB Release 仓库下载

3. 配置HertzBeat的配置文件
   解压安装包到主机 eg: /opt/hertzbeat

   $ tar zxvf hertzbeat-[版本号].tar.gz 
   

   修改位于 hertzbeat/config/application.yml 的配置文件
   需要替换里面的MYSQL服务和TDengine服务参数，IP端口账户密码（若使用邮件告警，需替换里面的邮件服务器参数） 具体替换参数如下:

   spring.datasource.url
   spring.datasource.username
   spring.datasource.password
   
   warehouse.store.td-engine.url
   warehouse.store.td-engine.username
   warehouse.store.td-engine.password
   
   spring.mail.host
   spring.mail.port
   spring.mail.username
   spring.mail.password
   
   

4. 配置用户配置文件(非必须,配置账户需要)
   HertzBeat默认内置三个用户账户,分别为 admin/admin tom/tom@123 lili/lili
   若需要新增删除修改账户或密码，可以通过修改位于 hertzbeat/config/sureness.yml 的配置文件实现，若无此需求可忽略此步骤 修改sureness.yml的如下部分参数：[注意⚠️sureness配置的其它默认参数需保留]

用户账户信息

下面有 admin tom lili 三个账户

eg: admin 拥有[admin,user]角色,密码为admin

eg: tom 拥有[user],密码为tom@123

eg: lili 拥有[guest],明文密码为lili, 加盐密码为1A676730B0C7F54654B0E09184448289

account:

• appId: admin credential: admin role: [admin,user]

• appId: tom credential: tom@123 role: [user]

• appId: guest credential: guest role: [guest]

• appId: lili

  注意 Digest认证不支持加盐加密的密码账户

  加盐加密的密码，通过 MD5(password+salt)计算

  此账户的原始密码为 lili

  credential: 1A676730B0C7F54654B0E09184448289 salt: 123 role: [guest]

5. 部署启动 执行位于安装目录hertzbeat/bin/下的启动脚本 startup.sh

   $ ./startup.sh 
   

6. 开始探索HertzBeat
   浏览器访问 http://ip:1157/console 开始使用HertzBeat进行监控告警，默认账户密码 admin/admin。

HAVE FUN

安装包部署常见问题

1. 按照流程部署，访问 http://ip:1157/console 无界面
   请参考下面几点排查问题：

一：依赖服务MYSQL数据库，TDENGINE数据库是否已按照启动成功，对应hertzbeat数据库是否已创建，SQL脚本是否执行
二：HertzBeat的配置文件 hertzbeat/config/application.yml 里面的依赖服务IP账户密码等配置是否正确
三：若都无问题可以查看 hertzbeat/logs/ 目录下面的运行日志是否有明显错误，提issue或交流群或社区反馈

2. 日志报错TDengine连接或插入SQL失败

一：排查配置的数据库账户密码是否正确，数据库是否创建
二：若是安装包安装的TDengine2.3+，除了启动server外，还需执行 systemctl start taosadapter 启动 adapter