This guide will help you to enable remote shell feature and control operation system with ThingsBoard IoT Gateway from your ThingsBoard platform instance.
For purpose of this guide, we will use following things:
Example of the thingsboard section in the general configuration file:
thingsboard: host: demo.thingsboard.io port: 1883 remoteShell: true remoteConfiguration: false security: accessToken: PUT_YOUR_GW_ACCESS_TOKEN_HERE
To use the remote shell we have to use the widget RPC remote shell from Control widget bundle. To do this we use following steps:
Open Dashboards tab:
We will add a new dashboard:
Open created dashboard, open edit mode by pencil button and add new widget:
Select widget budle “Control widgets”:
Scroll down and select RPC remote shell widget:
We haven’t specify the entity type for the widget so we will Create a new one:
We have to fill required fields and same the entity. Gateway - is our gateway device:
To prevent TimeoutException, we will increase the default RPC command timeout to 5000 milliseconds in the advanced settings tab and press ADD and check mark icon to save the dashboard:
The connected widget looks like (Connection setups automatically):
Now you can use the shell to control device with the gateway. For example we run ls command to get the list of files and directories in the current directory.
Explore guides related to main ThingsBoard features: