Table of Contents:

1. Dragino Platform Monitor
2. Monitor Gateway via ThingsSpeak
- 2.1 Steps
- 2.2 Monitor Public IP
3. Remote Access via Remote.it.
4. RSSH Introduction

1. Dragino Platform Monitor

Below list the support products and Requirements:

LoRaWAN Gateway model: LG308N, DLOS8N,LPS8N,LPS8v2,MS48-LR

The LG308,DLOS8N,LPS8N supports remote platform functionality ,Since firmware: lgw--v5.4.1734082928

The LPS8v2, MS48-LR supports remote platform functionality,Since software version dragino-ui : 2024-12-15

Once you have received your gateway and want to manage your gateway, you need to perform the following steps:

1.1 Create an account

Contact: support@dragino.cc

We will create a gateway management platform for you.Once created we will give you a platform and you will need to enter a password and then your gateway management platform will be created.

1.2 Import Dashboard

Before importing the dashboard we need to download the gateway management dashboard file from GitHub.

where to get:https://github.com/dragino/dragino-end-node-decoder/blob/main/Gateway%20Management/

Once the download is complete we need to import the dashboard into our gateway management account:

Firstly, we need to open the dashboard module,

click on the "+" in the upper right corner, select "import dashboard",

then we shoud drag the downloaded _dashboard file into the text box.

1.3 Configure gateway

To access the System-->Remote Mgmt interface of the gateway, you can select "Enable" and customize the owner,then click on "Save&Apply".

Check the remote platform connection status

After the above configuration is complete, wait for 2-3 minutes, the gateway will be displayed on the dashboard

1.4 Check the dashboard.

Check if you can see your gateway information in the dashboard

And click on your device to go to the next level to see if the gateway specific information is displayed properly

Chart function introduction:

1.Gateway information: Will show Gateway time, uptime, mac address, lorawan status, model and other gateway information

2. Line chart: Record free RAM, used Disk, and CPU load of the current gateway

3. Auto-Update: After clicking, the gateway will be updated

4. Refresh: After clicking, the gateway will immediately update the data information and displays the current package version on the dashboard

5. Reboot gateway: After clicking, the gateway will reboot.

6. Get Latest Log File: After clicking, the gateway records a log for 5 minutes and uploads it to the dashboard

7. Change Server Address: Add the lorawan server address and the gateway will be configured and modified

The format is as follows:

{"action":"set_server1_address","server_address":"10.130.2.123"}

8. Download Dragino Gateway log: After you complete "Get Latest Log File", Click "Click me" to download gateway logs

2. Monitor Gateway via ThingsSpeak

This introduction shows how to use a script to monitor the gateway. The video link for this instruction is: https://youtu.be/8PieIwfSF_g

2.1 Steps

Create account in ThingsSpeak and creat channel.

Download script from dragino site and move it to properly directory

root@dragino-1baf44:~# wget http://www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh
Downloading 'http://www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh'
Connecting to 162.241.22.11:80
Writing to 'monitor_gateway.sh'
monitor_gateway.sh 100% |*******************************| 1860 0:00:00 ETA
Download completed (1860 bytes)
root@dragino-1baf44:~# chmod +x monitor_gateway.sh;mv monitor_gateway.sh /usr/bin/
root@dragino-1baf44:~#
root@dragino-1baf44:~#

change the script monitor_gateway.sh with properly users setting:

USER='xxxxx'             # user name in your thinkspeak --> Profile
PASS='xxxxx'     #MQTT_API_KEY in your thinkspeak --> Profile
CHAN_ID='xxxx'    #Channel ID   of the channel for this gateway
CHAN_KEY='xxxxx'   #Channel Write API of the channel for this gateway

run /usr/bin/monitor_gateway.sh to test if upload is good.

Add monitor_gateway.sh to cron work /etc/crontabs/root to make this script runs perdiocally, below is an example to update every 20 minutes

# For details see man 4 crontabs
# Example of job definition:
# .---------------- minute (0 - 59)
# | .------------- hour (0 - 23)
# | | .---------- day of month (1 - 31)
# | | | .------- month (1 - 12) OR jan,feb,mar,apr ...
# | | | | .---- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
# | | | | |
# * * * * * user-name command to be executed
#*/10 * * * * checklog
* 23 * * * /etc/init.d/auto_update start
*/20 * * * * /usr/bin/monitor_gateway.sh

Reboot device.

2.2 Monitor Public IP

The monitor_gateway.sh has been updated to upload the public ip of the device as well.

User can find the public ip in field7, the chart is not able to show the complete public ip, user can check that in the export.

Find Public IP

3. Remote Access via Remote.it.

Remote.it for remote access is available in the latest Dragino firmware for gateway. For security concern, the remote.it only available base on end user demand.

Important Notice:

Remote.it access will give full control of your device to remote support.

The Remote.it allows Dragino Support to remote access to the device, If user want to access himself, it need to sign up for an remote.it account.

For how to use remote.it for general remote control, please see : Remoteit user instruction for Dragino Gateway.

For Quick add remote.it to Dragino for remote debug, please see below:

1. Install the Remote.it software

Users can directly click "Install" on the Web UI to install Remote. it.

2. Enter the license key

Users need to enter the license key in the box under "2. Register" section and click the "Save" button and "Register" button.

When the user enters this license key, Dragino support will have access to your gateway.

fd173d1d-faed-493e-a868-c511a38aba45

3. Connect and tell us your device ID or Hostname

Users can view the device ID or Hostname of the gateway on System --> System Overview interface.Such as : dragino-1ef9ac

3.1 How to save the registered remote after the gateway's firmware update.

Before version lgw--build-v5.4.1668240318-20221112-1606, once the gateway firmware is upgraded the remote configuration is gone.

This issue is now corrected:

The gateway version is lower than lgw--build-v5.4.1668240318-20221112-1606:

1. upload the backup file to update the configuration.

2. Check the 'Preserver Settings' check box when you upgrade the gateway with the firmware.

The gateway version is greater or equal to lgw--build-v5.4.1668240318-20221112-1606:

1. Only to do: Check the 'Preserver Settings' check box when you upgrade the gateway with the firmware.

3.2 How to register hp0d with Remote.it

Prerequisites:

Users must have an account and APP for remote.it

https://app.remote.it

1. Click "+" in the APP to add a device

Then click Add "Linux & Raspberry Pi" and the APP will generate a command to register the device.

2. Copy the register device command

3. Enter the command copied from the previous step on the HP0D Linux command line

4. Check whether the device is successfully registered on the Remote.it APP

3.3 How to register the gateway with Remote.it via SSH Access for Linux console

Prerequisites:

Users must have an account and APP for remote.it

https://app.remote.it

For detailed examples, please see: OpenWrt How to Connect Guide (remote.it)

1. Click "+" in the APP to add a device

Then click Add "OpenWrt" and the APP will generate a command to register the device.

2. Copy the register device command

3. Enter the command copied from the previous step on the gateway Linux command line

4. Check whether the device is successfully registered on the Remote.it APP

3.4 Trouble Shooting

1. What should users do when gateway Remote.it installation fails

Step 1: Users can download the archive and upload it to the gateway: backup.tar.gz

Step 2: Back to the Remote.it screen, and click "Install" again.

Step 3: Follow the Remoteit user instruction for Dragino Gateway steps to reconfigure

4. RSSH Introduction

Reverse SSH for remote access is available in the latest Dragino firmware for gateway. For security concern, the RSSH only available base on end user demand.

Important Notice:

RSSH access will give full control of your device to remote support. Please remove sensitivity info before perform this
This RSSH allow Dragino Support Team to remote access to customer's device. Customer is not able to remote access it via Dragino Server.

If user want to access himself, he need to set up the RSSH server himself.

Below gateway support reverse SSH access:

Firmware Version > lgw--build-v5.4.1618196981-20210412-1111 Firmware Download
LG01N, OLG01N (Note: LG01-P LG01-S doesn't support)
LG02, OLG02
LG308, DLOS8
LPS8
LIG16
MS14 series if installed with the same firmware.

4.1 End User Guide to use SSH access

Go to this the Reverse SSH page as below:

Get the RSSH configure page

Connection OK.

ConnectionType: Select a type
Login ID: Input the rssh server minimal ssh user
Host Address: Input rssh server public IP address/domain name
Connect at Startup : Choose to enable connect once the device is powered.
Network Keys: Click the Generate keys to generate the keys and download / mail it to Dragino support so Dragino can prepare the remote access to

After doing above, please download and mail the public keys to Dragino support and wait for our mail for the valid host port. Input the valid host port got from our support and click connect so we can remote access to your gateway.

4.2 Set Up RSSH Server

Advance administrator can config a SSH server to provide support their end user themselves., Steps as below

Step 1 : Download the SSH service code

1). git clone https://github.com/dragino/rssh-server.git rssh-server

2). cd rssh-server; sudo make ---> to Generate the execute file：rssh_serv

Debug :

if you git fail. --> sudo: git: command not found.
please install git. --> yum install git -y or apt-get install git -y.
if you make error 127,it lack of gcc.
please install gcc. --> yum install gcc.

if you make a fatal error : sqlite3.h,it lack of sqlite3.
please insatell sqlite3.

How to install Sqlit3:

Step 1: Download the SQLit3 installation package
sudo wget https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz

Step 2: tar the SQLit3 installation package
sudo tar -zxvf sqlite-autoconf-3350300.tar.gz

Step 3: Generate the makefile
cd sqlite-autoconf-3350300/;./configure

Step 4: Compile makefile
sudo make

Step 5: Install makefile
sudo make install

Check:
cd /usr/local/bin;ls -al --> Check to see if there is a file for sqlite3
cd sqlite-autoconf-3350300/;./sqlite3 test.db --> Test whether the sqlite3 was installed successfully

debug:
          If you get the imformation that is SQLite header and source version mismatch, when you execute./sqlite3 test.db.
          Please execute the command /sbin/ldconfig.
          After that execute the command ./sqlite3 test.db again.

Step 2 : Install and run the RSS service

1). install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)

user must enter the root account and run the following commands

$ ./create_sqlite3_db.sh
$ ./rssh_serv -p 3721 2>&1 &
$ ps -ef | grep rssh_serv check 3721 port

Debug:

 Check /var/rsshdb.sqlite3 --> ls /var/rsshdb.sqlite3
 Check ls /var/rsshdb.sqlite3 --> sudo chmod 777 rssh_serv

 if fail to open dpvlry or to bind to it
 please kill rssh_serv,and run  ./rssh_serv -p  3721 2>&1 &  again

Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)

1): sudo useradd XXXXX (custom user name)
2): sudo passwd xxxxxx
3): cp /bin/bash /bin/rbash
4): sudo nano /etc/passwd --> Change /bin/bash to /bin/rbash
5): sudo nano /home/xxxxx/.bashrc empty it,and input export PATH=$HOME/bin
6): sudo nano /home/xxxxx/.bash_profile empty it,and input export PATH=$HOME/bin

Now user "XXXXX" is the user with limited permissions of the current system

Step 4 : Create an authorization key file

1): sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey

Debug:

 check: sudo ls /home/xxxxx/.ssh/authorizedkey

4.3 How does user get the gateway to connect to a user's private server

Step 1 : Come back the gateway web UI to get the gateway Public key

1) in the system --> Remote Mgmt/span

Step 2 : Authorization server

Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file.

Step 3 : Connect private server

This is same as connect Dragino Support Server but just change the server address to customize server address.

Step 4 : Check Connection

Rssh Host connection Ok

User can use common ps | grep ssh to check it in the gateway.

Step 5 : Access the gateway from customized server

Check what gateways link to server.

$ ./connect-gw.sh -l

Access the gateway

$ ./connect-gw.sh <GWID>