Installing the weeve agent
A step-by-step guide to installing the weeve agent.
The weeve Agent is the edge software that is responsible for executing the deployed Edge Applications. It can be installed on edge hardware like gateways, industrial computers or smart machines and turns them into weeve Edgeβ€”Nodes, a manageable asset in the weeve Manager. The minimal requirements for hardware and operating system to run the weeve agent are the following and include a working connection to the internet.
Before starting with the installation process it is recommended to get to know the hardware and software requirements for the weeve Agent.

Quick-start

Registering a new node

Log into your account in the weeve Manager web UI and navigate to Nodes. Then click on "+ Register Node" and input all the necessary information. After clicking "Submit" you will be shown the ID of the newly registered node and offered the option to download the configuration file. If you want to create the file manually fill the following json schema:
{
"RootCertPath": "",
"NodeId": "<NodeID shown on the screen>",
"Password": "",
"APIkey": "",
"NodeName": "<name you chose for the node>",
"Registered": true
}

Pre-installation process tweaks for RedHat based distributions

  • binary and dependencies should go in this specific path /usr/local/bin
  • enable docker on start-up systemctl enable docker
  • Following commands are to add rule to SELinux, allowing the binary to be executed: sudo ausearch -c '(ux_amd64)' --raw | audit2allow -M my-uxamd64 sudo semodule -X 300 -i my-uxamd64.pp
  • Following command is to change permissions of the specific directory: /sbin/restorecon -v /usr/local/bin/<name-of-the-binary>

Installing & uninstalling weeve agent

Curl and run the installer
curl -sO http://weeve-agent.s3.amazonaws.com/weeve-agent-installer.sh
sh weeve-agent-installer.sh configpath=<path-to-config-file> release=prod
and answer the questions in the following prompt. Voila, the weeve agent is installed and you can check it's status with systemctl status weeve-agent.service.
To remove the agent installation execute this one-liner:
curl -sO http://weeve-agent.s3.amazonaws.com/weeve-agent-uninstaller.sh && sh weeve-agent-uninstaller.sh

weeve agent CLI arguments

Arguments
Short
Required
Description
Default
Text
broker
b
true
URL of the MQTT broker to connect
​
​
out
​
false
Print logs to stdout
false
​
heartbeat
t
false
Time period of heartbeat messages (sec)
30
​
mqttlogs
m
false
For developer - Display detailed MQTT logging messages
​
​
notls
​
false
For developer - disable TLS for MQTT
​
​
loglevel
l
false
Set the logging level
info
​
logfilename
​
false
Set the name of the log file
Weeve_Agent.log
​
logsize
​
false
Set the size of each log files (MB)
1
​
logage
​
false
Set the time period to retain the log files (days)
1
​
logbackup
​
false
Set the max number of log files to retain
5
​
logcompress
​
false
Compress the log files
false
​
nodeId
i
false
ID of this node
​
​
name
n
false
Name of this node
​
​
rootcert
r
false
Path to MQTT broker (server) certificate
​
​
config
​
false
Path to the .json config file
<exe dir>
​
manifest
​
false
Path to the .json manifest file to be deployed
​
​