chore: import upstream snapshot with attribution
This commit is contained in:
wehub-resource-sync
@@ -0,0 +1,137 @@
|
||||
---
|
||||
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.
|
||||
Reference in New Issue
Block a user