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
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|
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.
Step 2 - Select the version. The default is latest.
Step 3 - Type in the installation location. The default is /opt .
Step 4 - Select platform. The default is generic.
Step 5 - Select the network configurer. The default is none.
Step 6 - Select device identifier. The default is MAC of eth0.
The file name is given.
Step 7 - Enter the account/company ID
Your company ID can be found in the EdgeIQ web portal under Onboard > Accounts > Manage Account > Account ID.
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.
The most common reason for EdgeIQ installation to fail is the device not being configured in the EdgeIQ platform.
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."
Updated over 1 year ago