Connecting a device
The next step after registering to Upswift platform is creating a project. You probably have done it during the first login onboarding, but if you haven't, at the top of the dashboard, click on
Create Projectand enter your project name.
After creating a project, at the top of the dashboard, click on
Register Device. A window will pop up with instructions on how to register a Linux device. Basically, all you need to do is run the shown command on the device's terminal.
su -c 'wget -O - "https://dashboard.upswift.io/install_upswift" | sh -s <USER_TOKEN> <PROJECT_NAME>'
Please note that you must replace the
<USER_TOKEN>with your private user token and
<PROJECT_NAME>with your project name.
- 1.Device Name - to enter a device name at registration, add the flag
-n=<DEVICE_NAME>at the end of the registration command (for example, you can use "$HOSTNAME" as your device name).
- 2.Device Group - to make the device register to a specific group, add the flag
-g=<GROUP_NAME>at the end of the registration command (the group must exist).
- 3.Device Software version - to set the device software version at registration, add the flag
-s=<SOFTWARE_VERSION>at the end of the registration command.
su -c 'wget -O - "https://dashboard.upswift.io/install_upswift" | sh -s <USER_TOKEN> <PROJECT_NAME> -n=<DEVICE_NAME> -g=<GROUP_NAME> -s=<SOFTWARE_VERSION>'
After a few seconds, your device should appear in the Devices category on the Dashboard.
If you don't see your device in the dashboard:
- 1.Check the network connection of your device.
- 2.Make sure
- 3.If you are using
SysV, make sure the
systemddirectory doesn't exist:
- 4.Make sure the
- 5.Make sure You run the installation command as a root user.
To unregister/delete a device from the dashboard, go to the
Devicescategory, click on the device you want to unregister, click on
Edit Detailsbelow at the
General Detailssection. A
Delete devicebutton will appear. Click on it and the device will be unregistered from the dashboard.
The agent on the device will automatically delete itself in ~30 minutes. If you would like to delete the agent immediately,
rebootthe device or restart Upswift service using the command:
systemctl restart upswift/
service upswift restart