wehub-resource-sync
138 lines
6.3 KiB
Markdown
138 lines
6.3 KiB
Markdown
---
|
||
id: package-deploy
|
||
title: Install HertzBeat via Package
|
||
sidebar_label: Install via Package
|
||
---
|
||
|
||
:::tip
|
||
You can install and run Apache HertzBeat™ on Linux Windows Mac system, and CPU supports X86/ARM64.
|
||
Since version 1.6.0 uses `Java 17` and the installation package no longer provides a built-in JDK version, use the new HertzBeat according to the following situations:
|
||
|
||
- When the default environment variable on your server is `Java 17`, you do not need to take any action for this step.
|
||
- When the default environment variable on your server is not `Java 17`, such as `Java 8` or `Java 11`, and if there are no other applications on your server that require a lower version of Java, download the appropriate version from [https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) according to your system, and search the engine for how to set a new environment variable pointing to the new `Java 17`.
|
||
- When the default environment variable on your server is not `Java 17`, such as `Java 8` or `Java 11`,and you don't want to change the environment variable because if there are other applications on your server that require a lower version of Java, download the appropriate version from [https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html](https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html) according to your system, and rename the extracted folder to `java`, then copy it to the HertzBeat extraction directory.
|
||
|
||
:::
|
||
|
||
## Deploy HertzBeat Server
|
||
|
||
1. Download installation package
|
||
|
||
Download installation package `apache-hertzbeat-xxx-bin.tar.gz` corresponding to your system environment
|
||
- [Download Page](/docs/download)
|
||
|
||
2. Configure HertzBeat's configuration file(optional)
|
||
|
||
Unzip the installation package to the host eg: /opt/hertzbeat
|
||
|
||
```shell
|
||
tar zxvf apache-hertzbeat-xxx-bin.tar.gz
|
||
```
|
||
|
||
:::tip
|
||
The configuration file is located in `config/application.yml`, you can modify the configuration file according to your needs to configure external dependent services, such as databases, time series databases, etc.
|
||
HertzBeat defaults to using internal services when started, but it is recommended to switch to external database services in production environments.
|
||
:::
|
||
|
||
It is recommended to use [PostgreSQL](postgresql-change) for metadata storage and [VictoriaMetrics](victoria-metrics-init) for metric data storage. Specific steps are as follows
|
||
|
||
- [Switch built-in H2 database to PostgreSQL](postgresql-change)
|
||
- [Using VictoriaMetrics to store metric data](victoria-metrics-init)
|
||
|
||
3. Configure the account file(optional)
|
||
|
||
HertzBeat default built-in three user accounts, respectively `admin/hertzbeat tom/hertzbeat guest/hertzbeat`
|
||
If you need modify account or password, configure `config/sureness.yml`.
|
||
For detail steps, please refer to [Configure Account Password](account-modify)
|
||
|
||
4. Start the service
|
||
|
||
Execute the startup script in the installation directory `bin/`, or `startup.bat` in windows.
|
||
|
||
```shell
|
||
./startup.sh
|
||
```
|
||
|
||
5. Begin to explore HertzBeat
|
||
|
||
Access [http://ip:1157/](http://ip:1157/) using browser. You can explore HertzBeat with default account `admin/hertzbeat` now!
|
||
|
||
### Deploy HertzBeat Collector Cluster(Optional)
|
||
|
||
:::note
|
||
HertzBeat Collector is a lightweight data collector used to collect and send data to HertzBeat Server.
|
||
Deploying multiple HertzBeat Collectors can achieve high availability, load balancing, and cloud-edge collaboration of data.
|
||
:::
|
||
|
||
|
||
|
||
1. Download installation package
|
||
|
||
Download installation package `apache-hertzbeat-collector-xxx-bin.tar.gz` corresponding to your system environment
|
||
- [Download Page](/docs/download)
|
||
|
||
2. Configure the collector configuration file
|
||
|
||
Unzip the installation package to the host eg: /opt/hertzbeat-collector
|
||
|
||
```shell
|
||
tar zxvf apache-hertzbeat-collector-xxx-bin.tar.gz
|
||
```
|
||
|
||
Configure the collector configuration yml file `config/application.yml`: unique `identity` name, running `mode` (public or private), hertzbeat `manager-host`, hertzbeat `manager-port`
|
||
|
||
```yaml
|
||
collector:
|
||
dispatch:
|
||
entrance:
|
||
netty:
|
||
enabled: true
|
||
identity: ${IDENTITY:}
|
||
mode: ${MODE:public}
|
||
manager-host: ${MANAGER_HOST:127.0.0.1}
|
||
manager-port: ${MANAGER_PORT:1158}
|
||
```
|
||
|
||
> Parameters detailed explanation
|
||
|
||
- `identity` : (optional) Set the unique identifier name of the collector. Note that the name of the collector must be unique when there are multiple collectors.
|
||
- `mode` : Configure the running mode (public or private), public cluster mode or private cloud-edge mode.
|
||
- `manager-host` : Important, configure the address of the connected HertzBeat Server,
|
||
- `manager-port` : (optional) Configure the port of the connected HertzBeat Server, default 1158.
|
||
|
||
3. Start the service
|
||
|
||
Run command `$ ./bin/startup.sh` or `bin/startup.bat`
|
||
|
||
4. Begin to explore HertzBeat Collector
|
||
|
||
Access `http://ip:1157` and you will see the registered new collector in dashboard
|
||
|
||
**HAVE FUN**
|
||
|
||
----
|
||
|
||
### FAQ
|
||
|
||
1. you need to prepare the JAVA environment in advance
|
||
|
||
Install JAVA runtime environment-refer to [official website](https://www.oracle.com/java/technologies/downloads/)
|
||
requirement：JDK17 ENV
|
||
download JAVA installation package: [mirror website](https://mirrors.huaweicloud.com/openjdk/)
|
||
After installation use command line to check whether you install it successfully.
|
||
|
||
```shell
|
||
$ java -version
|
||
java version "17.0.9"
|
||
Java(TM) SE Runtime Environment 17.0.9 (build 17.0.9+8-LTS-237)
|
||
Java HotSpot(TM) 64-Bit Server VM 17.0.9 (build 17.0.9+8-LTS-237, mixed mode)
|
||
|
||
```
|
||
|
||
2. According to the process deploy，visit [http://ip:1157/](http://ip:1157/) no interface
|
||
Please refer to the following points to troubleshoot issues:
|
||
|
||
> 1：If you switch to dependency service MYSQL database，check whether the database is created and started successfully.
|
||
> 2：Check whether dependent services, IP account and password configuration is correct in HertzBeat's configuration file `hertzbeat/config/application.yml`.
|
||
> 3：Check whether the running log has errors in `hertzbeat/logs/` directory. If you haven't solved the issue, report it to the communication group or community.
|