Skip to main content

Installing Connhex Edge

License​

Every device equipped with Connhex Edge needs to be associated with a unique license. To get one, contact us at connhex@compiuta.com.

Clean up previous installations​

Not always needed

This clean-up step is needed only if you're trying to re-configure a device in which Connhex Edge was previously installed.

  • Go to /opt/connhex/configs
  • Remove these two files: agent.tomland export.toml. Those are automatically created by Connhex Edge and synced with Connhex.
  • Remove the file agent.env

Download and installation​

Connhex Edge is distributed through two .deb packages. Download those with the following commands

wget https://registry.compiuta.com/static/connhex-edge/connhex-edge-agent_1.1.0_linux_armv7.deb
wget https://registry.compiuta.com/static/connhex-edge/connhex-edge-export_1.0.1_linux_armv7.deb

Install the packages with:

sudo dpkg -i connhex-edge-agent_1.1.0_linux_armv7.deb
sudo dpkg -i connhex-edge-export_1.0.1_linux_armv7.deb

Configuration​

Go to your Connhex Control instance and create a new Edge, then download its agent.env configuration file. Replace the - empty - agent file in /opt/connhex/configs/agent.env with the one you just downloaded.

Start Connhex Edge​

To start Connhex Edge the first time you can either execute these commands in the following order:

sudo /opt/connhex/bin/start-agent.sh
Additional Check

To make sure the previous script was executed properly, check the existence of agent.tomland export.toml in /opt/connhex/configs.

sudo /opt/connhex/bin/start-export.sh

or reboot the device.

This allows Connhex Edge to retrieve the device configuration from the Connhex instance: from now on, Connhex Edge will automatically start its execution as soon as the device boots.