Installation using edgectl

The Edge local service can be installed using our edgectl utility, or by using a manual/scripted installation method. This article explains how to install using edgectl, which you can add download from our repository or through a manual download.

Install edgectl utility from the repository

Follow these steps to install the EdgeIQ SmartEdge service on your edge gateway device using our apt repository. If apt is not available on your system, please skip to the next section for instructions on manually downloading and installing edgectl.

Step 1 - Add the repository

echo "deb [trusted=yes] https://apt.fury.io/edgeiq/ /" > /etc/apt/sources.list.d/edgeiq.list

Step 2 - Update apt

apt update

Step 3 - Install edgectl

apt install edgeiq-edgectl

Manually download the edgectl utility

Follow these steps to install the EdgeIQ SmartEdge service on your edge gateway device.

Step 1 - Download edgectl using wget

NOTE: Replace [YOUR_DEVICE_ARCHITECTURE] with a value that matches your architecture: arm5, armhf, arm64, arm7, or amd64
wget https://api.edgeiq.io/api/v1/platform/edgectl/latest/edgectl-linux-[YOUR_DEVICE_ARCHITECTURE]-latest

Step 2 - Move edgectl and change permissions

mv ./edgectl-* ./edgectl && chmod +x ./edgectl

Install Edge using the edgectl utility

Step 1 - Run the following command to begin installation using edgectl.

edgectl install

Step 2 - Select the version. The default is latest.

1420

Step 3 - Type in the installation location. The default is /opt .

1488

Step 4 - Select platform. The default is generic.

1486

Step 5 - Select the network configurer. The default is none.

1524

Step 6 - Select device identifier. The default is MAC of eth0.

1500

Auto for device unique ID.

The file name is given.

1576

File for device unique ID.

Step 7 - Enter the account/company ID

1634

Your company ID can be found in the EdgeIQ web portal under Onboard > Accounts > Manage Account > Account ID.

1938

Step 8 - Verify Results

In addition to receiving a "Success" response from edgectl, you should see the device status indicator turn green in the portal. Also, heartbeat payloads should begin appearing according to the configured interval time (the default is 4 hours).

The responses will be similar to what is shown in the figure below.

1640

Success

Device Health:

1854

Device Health

Heartbeats:

2096

Heartbeats

Failure

The most common reason for EdgeIQ installation to fail is the device not being configured in the EdgeIQ platform.

1810

You see an error similar to "Unable to connect to EdgeIQ, ensure you have the representative device data created in EdgeIQ followed by edge log output."

2186