Best Practice Guide - Connect edge Linux devices in scale at once

This guide goes over the best practice to connect a fleet of Linux based devices at once to Upswift platform. The best practice guidelines are taught how to register thousands of devices at once by using automatic technics which save manual registration for each and every device.

Connect devices at once to Upswift platform approaches

Upswift agent automatically recognizes new hardware based on the MAC addresses of the device. The next 2 methods can help to install Upswift on a fleet of devices easily without the need to register each device separately.

Guidelines

Method A

Register devices by duplicating an existing OS image that has Upswift Agent installed inside it.

1. Install Upswift agent on 1 device and make sure the device has been registered at Upswift dashboard.

2. Duplicate this device image, and burn it on other SD card, Nand or eMMC flashes.

3. Boot a new device with the duplicated image, Upswift agent will automatically recognize that it is running on new hardware and will automatically register that device as a new device.

Method B

Register devices by coping Upswift agent to the build of your custom OS (mainly for Yocto, Buildroot, and Debian based images).

1. Copy the Installation command and run it on one of your device's terminal.

2. Copy the next files/directories to the offline device file system:

• /etc/upswift

Depends if you have Systemd or SysV service manager:

For Systemd:

• /etc/systemd/system/upswift.service

For SysV:

• /etc/init.d/upswift

• /etc/crontab

Paste those files at the same paths on the build of the OS file-system. *In case of using Systemd, please also paste upswift.service in:

• /etc/systemd/system/multi-user.target.wants/