This article describes ASIC Hub installation and setup on Linux-based operating systems.

Supported distributions

Ubuntu 18 or above (latest LTS release recommended)
Debian stretch or above
Any other distro with systemd and glibc 2.24 (or above)

Installation

Simple install

Run this script to download and install ASIC Hub.

curl -f https://download.hiveos.farm/hub/install.sh | sh

Manual install

Download Hub installation tarball from here
Extract tarball.
Run install.sh script in extracted folder with sudo or as root.

Example:

wget https://download.hiveos.farm/hub/stable/latest/hub-linux-amd64.tar.gz
tar -xf hub-linux-amd64.tar.gz
cd hub-linux-amd64
sudo ./install.sh

Installation script will install ASIC Hub as asic-hub service and hubctl cli tool.

Use systemctl command to check if asic-hub service is running:

$ systemctl status asic-hub● asic-hub.service—ASIC Hub monitoring daemon.
     Loaded: loaded (/etc/systemd/system/asic-hub.service; enabled; vendor preset: enabled)
     Active: active (running) since Fri 2020-11-06 22:27:23 UTC; 20s ago
   Main PID: 2155 (hub)
      Tasks: 10 (limit: 2282)
     Memory: 4.1M
     CGroup: /system.slice/asic-hub.service
             └─2155 /opt/asic-hub/hub -c /etc/asic-hub/config.toml

Open http://localhost:8800 to open ASIC Hub web UI or use hubctl tool to register ASIC Hub.

Uninstall Hub

Using install script

Run this command to uninstall ASIC Hub:

sudo /opt/asic-hub/uninstall-asic-hub

Manual uninstall

Hub can be uninstalled manually if installation script is unavailable:

Stop and remove ASIC Hub service:

sudo systemctl stop asic-hub
sudo systemctl disable asic-hub
sudo systemctl daemon-reload
sudo rm /etc/systemd/system/asic-hub.service

Remove ASIC Hub files

sudo rm -rf /opt/asic-hub
sudo rm -rf /var/log/asic-hub
sudo rm -rf /etc/asic-hub
sudo rm -rf /usr/bin/hubctl

Start or stop service

Restart service:

sudo systemctl restart asic-hub

Stop service:

sudo systemctl stop asic-hub

Start service:

sudo systemctl start asic-hub

Where to go from here?

Move to the next step - ASIC Hub registration

Check the ASIC Hub knowledge base

Step 1 - ASIC Hub installation on Linux