On-Cab Client Setup (experimental)

This is an experimental script that will install the HiveMind client directly on the cab. This script is still experimental, use it at your own risk.

All commands should be run on the cab as the root user, either via SSH or command line.

Command Line Access

  • Attach a keyboard to the cab's PC and press Ctrl+Alt+F3

OR

  • Find the cab's IP address on the local network
  • From a PC on the same network, connect to the cab using SSH.
    • On a Windows PC, use PuTTY
    • On Mac or Linux, open a command prompt and type ssh <CAB IP ADDRESS>

Sign In

  • Sign in as root with the cab's root password.
    • You can get the password from Bumblebear support (or by asking around)

Install Script

curl https://gitlab.com/kqhivemind/hivemind-client/-/raw/main/on_cab.sh | sh -s <SCENE SHORT NAME> <CABINET SHORT NAME> <CABINET TOKEN>

This script will create a hivemind user, install any missing prerequisites, and install the client as a system service.

Viewing Logs

less /home/hivemind/hivemind-client.log

Editing Config File

nano /home/hivemind/config.json

Stop/Restart/Disable

systemctl restart hivemind-client will restart the client.

systemctl stop hivemind-client will temporarily stop the stats client. It will start up again on next boot.

systemctl start hivemind-client starts the client again.

systemctl disable hivemind-client will prevent the client from starting automatically at boot.

systemctl enable hivemind-client re-enables automatically starting at boot.