Skip to main content
Version: v1.6.x

Install HertzBeat via Package

tip

You can install and run Apache HertzBeat (incubating) 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 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 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-incubating-bin.tar.gz corresponding to your system environment

  2. Configure HertzBeat's configuration file(optional)

    Unzip the installation package to the host eg: /opt/hertzbeat

    tar zxvf apache-hertzbeat-xxx-incubating-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 for metadata storage and VictoriaMetrics for metric data storage. Specific steps are as follows

  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

  4. Start the service

    Execute the startup script in the installation directory bin/, or startup.bat in windows.

    ./startup.sh

  5. Begin to explore HertzBeat

    Access 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.

HertzBeat

  1. Download installation package

    Download installation package apache-hertzbeat-collector-xxx-incubating-bin.tar.gz corresponding to your system environment

  2. Configure the collector configuration file

    Unzip the installation package to the host eg: /opt/hertzbeat-collector

    tar zxvf apache-hertzbeat-collector-xxx-incubating-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

    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 requirement：JDK17 ENV download JAVA installation package: mirror website After installation use command line to check whether you install it successfully.

    $ 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/ 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.