Installing MachineShop EdgeIQ - FreeWaveTechnologies/ZumIQ GitHub Wiki

Introduction

EdgeIQ (formerly MachineShop) is a fleet management tool that allows you to manage multiple Zum devices from a centralized Web interface.

Prerequisites

You must obtain an account_id from EdgeIQ. Details TBD.
EdgeIQ requires systemd tools in order to operated. Therefore, it can only be installed on Zum devices running firmware versions 1.3.1.6 or later. To upgrade the firmware on your system, go to http://support.freewave.com > ZumIQ Firmware > Z9-P ... > Firmware ZIP Files. Make sure to download both ZIP files. Follow the software update instructions at insert link here.

Creating your Device on the EdgeIQ Portal

Before installing EdgeIQ on the device, create the device on the EdgeIQ portal.

Point your browser at the EdgeIQ Hub website. Login using your corporate login. On the left side menu bar, select Management > Devices. In the Devices window, select + Create Device. The portal walks you through an easy-to-understand setup procedure. Two notes:

The Unique ID is the serial number of your ZumLink, which can be found in the ZumLink's System Information webpage.
The Serial Number is also the serial number of your ZumLink.

Installing EdgeIQ

Your ZumLink must have access to the Internet. The installation, and connection to the EdgeIQ portal, will be successful even if the connection goes through a bridge or a firewall.

WARNING! BEFORE YOU CONNECT YOUR ZUMLINK DIRECTLY TO THE INTERNET (NOT THROUGH A BRIDGE OR FIREWALL), PLEASE PLEASE PLEASE CHANGE THE devuser AND admin PASSWORDS! If your device is connected to the Internet and hackers identify it as a FreeWave device, they will hack into it as just easily as they hack into a Raspberry Pi. (Very few people bother changing the password on their Raspberry Pi, either.)

To install EdgeIQ, login to the Zum as devuser and then enter this command to switch to root.

sudo su

At the root@freewave-ib:/home/devuser# prompt, enter the following one-line command. You can copy and paste it from this page.

wget -q https://machineshopapi.com/api/v1/platform/installers/install.sh -O install.sh && /bin/bash install.sh -e prod -c freewave_demo -mk freewave -md z9-pe -u https://machineshopapi.com/api/v1/platform/installers/freewave/z9-pe/edge-2.5.9.run

You should see output similar to the following:

Failed to stop edge.service: Unit edge.service not loaded.
edge process stopped cleanly
Backing up previous edge version to temp dir: /tmp ...
tar: edge: Cannot stat: No such file or directory
tar: Exiting with failure status due to previous errors
Error zipping previous edge version to temp dir: /tmp
Creating directory edge
Verifying archive integrity...  100%   All good.
Uncompressing Edge  100%
Edge Extracted Successfully
Created symlink /etc/systemd/system/multi-user.target.wants/edge.service → /etc/systemd/system/edge.service.
Updated init script: /etc/systemd/system/edge.service

If you type the command ps -ef, you will see that /opt/edge/edge is running:

root@freewave-ib:/home/devuser# ps -ef
UID        PID  PPID  C STIME TTY          TIME CMD
root         1     0  3 21:15 ?        00:00:03 /lib/systemd/systemd
root        81     1  0 21:15 ?        00:00:00 /lib/systemd/systemd-journald
message+   107     1  0 21:15 ?        00:00:00 /usr/bin/dbus-daemon --system --address=systemd: --nofork --nopidfile --systemd-activation --syslog-only
...
root       126     1  1 21:16 ?        00:00:00 /lib/systemd/systemd --user
root       127   126  0 21:16 ?        00:00:00 (sd-pam)
root       137   124  0 21:16 pts/0    00:00:00 bash
root       245     1 30 21:16 ?        00:00:02 /opt/edge/edge

You should see your device on your account's portal page, https://portal.machineshop.io, under Management > Devices .