Skip to Content
Version 101.1 by Kilight Cao on 2025/01/09 15:25
Show last authors
1 **Table of Contents:**
2
3 {{toc/}}
4
5
6
7
8 = 1.  Dragino Platform Monitor =
9
10
11 **Below list the support products and Requirements:**
12
13 1. LoRaWAN Gateway model:  **[[LG308N>>doc:Main.User Manual for All Gateway models.LG308N - LoRaWAN Gateway User Manual.WebHome]]**, **[[DLOS8N>>doc:Main.User Manual for All Gateway models.DLOS8N.WebHome]]**,**[[LPS8N>>doc:Main.User Manual for All Gateway models.LPS8N - LoRaWAN Gateway User Manual.WebHome]]**,**[[LPS8v2>>doc:Main.User Manual for All Gateway models.HP0C.WebHome]]**,**[[MS48-LR>>doc:Main.User Manual for All Gateway models.MS48-LR_LoRaWAN_To_Modbus_Gateway.WebHome]]**
14
15 The LG308,DLOS8N,LPS8N supports remote platform monitor functionality ,Since firmware: **[[lgw~~-~~-build-v5.4.1735869581>>https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/lgw--build-v5.4.1735869581-20250103-1003/]]**
16
17 The LPS8v2,MS48-LR supports remote platform monitor functionality,Since software version **dragino-ui : 2024-12-15 **
18
19
20 Once you have received your gateway and want to manage your gateway, you need to perform the following steps:
21
22
23 == 1.1 Create an account ==
24
25 Contact: (% style="color:blue" %)**support@dragino.cc**
26
27 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.
28
29
30 == 1.2 Configure gateway ==
31
32
33 To access the (% style="color:blue" %)**System~-~->Remote Mgmt**(%%) interface of the gateway, you can select "(% style="color:blue" %)**Enable**(%%)" and customize the owner,then click on "(% style="color:blue" %)**Save&Apply**(%%)".
34
35 ~1. Click "(% style="color:blue" %)**Enable**(%%)" ~-~-~-~-->  If this option is checked, the gateway will enable Remote Platform Monitor
36
37 2. Configure the (% style="color:blue" %)**Owner**(%%)  ~-~-~-~-->  Fill in the Owne given by the manufacturer, that's the only one.
38
39 3. Click "(% style="color:blue" %)**Save&Apply**(%%)"
40
41 (% style="color:red" %)Note: If the Owner parameter is set to Dragino, the device will be registered with the Dragino account
42
43 [[image:image-20250107151805-1.png]]
44
45
46 Check the remote platform connection status
47
48 [[image:image-20241216162640-2.png]]
49
50 After the above configuration is complete, wait for 2-3 minutes, the gateway will be displayed on the dashboard
51
52
53 == 1.3 Check the dashboard. ==
54
55 Check if you can see your gateway information in the dashboard
56
57 [[image:image-20241216163331-3.png||height="578" width="1258"]]
58
59
60 And click on your device to go to the next level to see if the gateway specific information is displayed properly
61
62
63 **Chart function introduction:**
64
65 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__1.Gateway information:  __**(%%) Will show Gateway time, uptime, mac address, lorawan status, model and other gateway information
66
67 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__2. Line chart: __**(%%) Record free RAM, used Disk, and CPU load of the current gateway
68
69 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__3. Auto-Update:  __**(%%) After clicking, the gateway will be updated
70
71 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__4. Refresh: __**(%%) After clicking, the gateway will immediately update the data information and displays the current package version on the dashboard
72
73 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__5. Reboot gateway: __**(%%) After clicking, the gateway will reboot.
74
75 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__6. Get Latest Log File: __**(%%) After clicking, the gateway records a log for 5 minutes and uploads it to the dashboard
76
77 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__7. Change Server Address: __**(%%) Add the lorawan server address and the gateway will be configured and modified
78
79 The format is as follows:
80
81 **{"action":"set_server1_address","server_address":"10.130.2.123"}**
82
83 (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__8. Download Dragino Gateway log: __**(%%) After you complete "Get Latest Log File", Click "Click me" to download gateway logs
84
85
86 [[image:image-20241216170144-6.png||height="596" width="1258"]]
87
88
89 [[image:image-20241216170119-5.png||height="249" width="1259"]]
90
91
92
93 = 2.  Monitor Gateway via ThingsSpeak =
94
95
96 This introduction shows how to use a script to monitor the gateway. The video link for this instruction is: [[https:~~/~~/youtu.be/8PieIwfSF_g>>url:https://youtu.be/8PieIwfSF_g]]
97
98
99 [[image:image-20220531155018-18.png]]
100
101
102 == 2.1  Steps ==
103
104
105 * Create account in ThingsSpeak and creat channel.
106
107 * Download script from dragino site and move it to properly directory
108
109 (% class="box infomessage" %)
110 (((
111 root@dragino-1baf44:~~# wget [[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh]]
112 Downloading '[[http:~~/~~/www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh'>>url:http://www.dragino.com/downloads/downloads/LoRa_Gateway/LPS8/Firmware/customized_script/monitor_gateway.sh']]
113 Connecting to 162.241.22.11:80
114 Writing to 'monitor_gateway.sh'
115 monitor_gateway.sh   100% |~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~**|  1860   0:00:00 ETA
116 Download completed (1860 bytes)
117 root@dragino-1baf44:~~# chmod +x monitor_gateway.sh;mv monitor_gateway.sh /usr/bin/
118 root@dragino-1baf44:~~#
119 root@dragino-1baf44:~~#
120 )))
121
122
123
124 * change the script monitor_gateway.sh with properly users setting:
125
126 (% class="box infomessage" %)
127 (((
128 USER='xxxxx'             # user name in your thinkspeak ~-~-> Profile
129 PASS='xxxxx'     #MQTT_API_KEY in your thinkspeak ~-~-> Profile
130 CHAN_ID='xxxx'    #Channel ID   of the channel for this gateway
131 CHAN_KEY='xxxxx'   #Channel Write API  of the channel for this gateway
132 )))
133
134
135
136 * run (% style="color:blue" %)**/usr/bin/monitor_gateway.sh**(%%) to test if upload is good.
137
138 * Add monitor_gateway.sh to cron work (% style="color:blue" %)**/etc/crontabs/root**(%%) to make this script runs perdiocally, below is an example to update every 20 minutes
139
140 (% class="box infomessage" %)
141 (((
142 # For details see man 4 crontabs
143 # Example of job definition:
144 # .~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~- minute (0 - 59)
145 # | .~-~-~-~-~-~-~-~-~-~-~-~-- hour (0 - 23)
146 # | | .~-~-~-~-~-~-~-~-~-~- day of month (1 - 31)
147 # | | | .~-~-~-~-~-~-- month (1 - 12) OR jan,feb,mar,apr ...
148 # | | | | .~-~-~-~- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
149 # | | | | |
150 # * * * * * user-name command to be executed
151 #*/10 * * * *  checklog
152 ~* 23 * * *  /etc/init.d/auto_update start
153 */20 * * * *  /usr/bin/monitor_gateway.sh     
154 )))
155
156 * Reboot device.
157
158 == 2.2  Monitor Public IP ==
159
160
161 The monitor_gateway.sh has been updated to upload the public ip of the device as well.
162
163 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.
164
165
166 [[image:image-20220531145559-2.png||height="658" width="1233"]]
167
168 Find Public IP
169
170
171 = 3.  Remote Access via Remote.it. =
172
173
174 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.
175
176
177 (% style="color:red" %)**Important Notice:**
178
179 * Remote.it access will give full control of your device to remote support.
180
181 * 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.
182
183 * For how to use remote.it for (% style="color:blue" %)**general remote control**(%%), please see :  [[Remoteit user instruction for Dragino Gateway>>https://www.remote.it/getting-started/dragino]].
184
185 * For Quick add remote.it to (% style="color:blue" %)**Dragino for remote debug**(%%), please see below:
186
187 (% style="color:blue" %)**1. Install the Remote.it software**
188
189 Users can directly click** "Install"** on the Web UI to install Remote. it.
190
191
192 [[image:image-20220725134300-1.png||height="438" width="905"]]
193
194
195
196 (% style="color:blue" %)**2. Enter the license key**
197
198 Users need to enter the license key in the box under **"2. Register"** section and click the **"Save"** button and** "Register"** button.
199
200 (% style="color:red" %)**When the user enters this license key, Dragino support will have access to your gateway.**
201
202
203 (% class="box infomessage" %)
204 (((
205 **fd173d1d-faed-493e-a868-c511a38aba45**
206 )))
207
208 [[image:image-20230607085305-1.png||height="555" width="993"]]
209
210
211
212 (% style="color:blue" %)**3. Connect and tell us your device ID or Hostname**
213
214 Users can view the device ID or Hostname of the gateway on** (% style="color:red" %)System ~-~-> System Overview(%%)** interface.Such as : dragino-1ef9ac
215
216
217 [[image:image-20220725115720-2.png||height="658" width="900"]]
218
219
220 == 3.1  How to save the registered remote after the gateway's firmware update. ==
221
222
223 Before version [[lgw~~-~~-build-v5.4.1668240318-20221112-1606>>http://repo.dragino.com/release/miscellaneous/remoteit/dragino-lgw--v5.4.1668240318-squashfs-sysupgrade.bin]], once the gateway firmware is upgraded the remote configuration is gone.
224
225 This issue is now corrected:
226
227
228
229 === **The gateway version is lower than** **lgw~-~-build-v5.4.1668240318-20221112-1606:** ===
230
231
232 **~1. upload the [[backup file>>http://repo.dragino.com/release/miscellaneous/remoteit/backup.tar.gz]] to update the configuration.**
233
234 [[image:image-20221112162644-4.png]]
235
236
237
238 **2. Check the 'Preserver Settings' check box when you upgrade the gateway with the firmware. **
239
240 [[image:image-20221112162543-2.png]]
241
242
243
244 === **The gateway version is greater or equal to**  **lgw~-~-build-v5.4.1668240318-20221112-1606:** ===
245
246
247
248 **~1. Only to do: Check the 'Preserver Settings' check box when you upgrade the gateway with the firmware. **
249
250 [[image:image-20221112162547-3.png]]
251
252
253 == 3.2  How to register hp0d with Remote.it ==
254
255
256 (% style="color:blue" %)**Prerequisites:**
257
258 Users must have an account and APP for remote.it
259
260 **[[https:~~/~~/app.remote.it>>https://app.remote.it]]**
261
262
263 === (% style="color:blue" %)**1.  Click "+" in the APP to add a device**(%%) ===
264
265
266 Then click Add "Linux & Raspberry Pi" and the APP will generate a command to register the device.
267
268
269 [[image:image-20220815173938-1.jpeg||height="574" width="919"]]
270
271
272
273 === (% style="color:blue" %)**2.  Copy the register device command**(%%) ===
274
275
276 [[image:image-20220815173944-2.jpeg||height="556" width="923"]]
277
278
279
280 === (% style="color:blue" %)**3.  Enter the command copied from the previous step on the HP0D Linux command line**(%%) ===
281
282
283 [[image:image-20220815173951-3.jpeg||height="424" width="1147"]]
284
285
286
287 === (% style="color:blue" %)**4.  Check whether the device is successfully registered on the Remote.it APP**(%%) ===
288
289
290 [[image:image-20220815173958-4.jpeg||height="580" width="964"]]
291
292
293 == 3.3 How to register the gateway with Remote.it via SSH Access for Linux console ==
294
295
296 (% style="color:blue" %)**Prerequisites:**
297
298 Users must have an account and APP for remote.it
299
300 **[[https:~~/~~/app.remote.it>>https://app.remote.it]]**
301
302 For detailed examples, please see: **[[OpenWrt How to Connect Guide (remote.it)>>url:https://www.remote.it/getting-started/openwrt]]**
303
304
305 === (% style="color:blue" %)**1.  Click "+" in the APP to add a device**(%%) ===
306
307
308 Then click Add "OpenWrt" and the APP will generate a command to register the device.
309
310 [[image:image-20230320110123-4.png||height="657" width="1191"]]
311
312
313
314 === (% style="color:blue" %)**2.  Copy the register device command**(%%) ===
315
316
317 [[image:image-20230320110309-5.png||height="635" width="1197"]]
318
319
320
321 === (% style="color:blue" %)**3.  Enter the command copied from the previous step on the gateway Linux command line**(%%) ===
322
323
324 (% class="wikigeneratedid" id="H" %)
325 [[image:image-20230320105212-1.png||height="758" width="820"]]
326
327
328
329 === (% style="color:blue" %)**4.  Check whether the device is successfully registered on the Remote.it APP**(%%) ===
330
331
332 [[image:image-20230320112057-6.png||height="603" width="1135"]]
333
334
335 == 3.4  Trouble Shooting ==
336
337
338 === **1. What should users do when gateway Remote.it installation fails** ===
339
340
341 [[image:image-20220907162028-4.png||height="564" width="1148"]]
342
343
344 (% style="color:blue" %)**Step 1:  **(%%)Users can download the archive and upload it to the gateway:** [[attach:backup.tar.gz||target="_blank"]]**
345
346 [[image:image-20220907161050-2.png]]
347
348
349
350 (% style="color:blue" %)**Step 2:  **(%%)Back to the Remote.it screen, and click **"Install"** again.
351
352 [[image:image-20220907161352-3.png]]
353
354
355 (% style="color:blue" %)**Step 3:**(%%) Follow the [[Remoteit user instruction for Dragino Gateway>>https://www.remote.it/getting-started/dragino]] steps to reconfigure
356
357
358 = 4.  RSSH Introduction =
359
360
361 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.
362
363 (% style="color:red" %)**Important Notice:**
364
365 (% class="box warningmessage" %)
366 (((
367 RSSH access will give full control of your device to remote support. Please remove sensitivity info before perform this
368 This RSSH allow Dragino Support Team to remote access to customer's device. Customer is not able to remote access it via Dragino Server.
369
370 If user want to access himself, he need to set up the RSSH server himself.
371 )))
372
373
374 **Below gateway support reverse SSH access:**
375
376 * Firmware Version > lgw~-~-build-v5.4.1618196981-20210412-1111 [[Firmware Download>>url:http://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/LPS8/Firmware/Release/]]
377 * LG01N, OLG01N (Note: LG01-P LG01-S doesn't support)
378 * LG02, OLG02
379 * LG308, DLOS8
380 * LPS8
381 * LIG16
382 * MS14 series if installed with the same firmware.
383
384 == 4.1  End User Guide to use SSH access ==
385
386
387 Go to this the Reverse SSH page as below:
388
389 [[image:image-20231107200442-2.png||height="684" width="973"]]
390
391
392 Get the RSSH configure page
393
394 [[image:image-20220531152815-14.png]]
395
396 Connection OK.
397
398 * (% style="color:#037691" %)**ConnectionType**(%%):  Select a type
399 * (% style="color:#037691" %)**Login ID**(%%):  Input the rssh server minimal ssh user
400 * (% style="color:#037691" %)**Host Address**(%%):  Input rssh server public IP address/domain name
401 * (% style="color:#037691" %)**Connect at Startup**(%%) :  Choose to enable connect once the device is powered.
402 * (% style="color:#037691" %)**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
403
404 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.
405
406
407 == 4.2  Set Up RSSH Server ==
408
409
410 Advance administrator can config a SSH server to provide support their end user themselves., Steps as below
411
412
413
414 === (% style="color:blue" %)**Step 1 :  Download the SSH service code**(%%) ===
415
416
417 **1).**  git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
418
419 [[image:image-20220531150750-5.png]]
420
421
422 **2).**  cd rssh-server; sudo make ~-~--> to Generate the execute file：rssh_serv
423
424 [[image:image-20220531150811-6.png]]
425
426
427 **Debug** :
428
429 (((
430 (% class="box" %)
431 (((
432 if you git fail.  ~-~->  (% style="color:#037691" %)**sudo: git: command not found**(%%).
433 please install git.  ~-~->    (% style="color:#037691" %)**yum install git -y  or  apt-get install git -y**(%%).
434 if you make error 127,it** (% style="color:#037691" %)lack of gcc(%%)**.
435 please install gcc.  ~-~->  (% style="color:#037691" %)**yum install gcc**(%%).
436 )))
437 )))
438
439 [[image:image-20220531151516-7.png]]
440
441
442 (((
443 (% class="box" %)
444 (((
445 if you make a fatal error : sqlite3.h,it (% style="color:#037691" %)**lack of sqlite3**(%%).
446 please insatell sqlite3.
447 )))
448 )))
449
450 [[image:image-20220531151628-8.png]]
451
452
453 (% style="color:blue" %)**How to install Sqlit3:**
454
455 (% class="box infomessage" %)
456 (((
457 **~ Step 1:** Download the SQLit3 installation package
458 sudo wget **[[https:~~/~~/www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz>>url:https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz]]**
459
460 **Step 2: **tar the SQLit3 installation package
461 sudo tar -zxvf sqlite-autoconf-3350300.tar.gz
462
463 **Step 3:** Generate the makefile
464 cd sqlite-autoconf-3350300/;./configure
465
466 **Step 4:** Compile makefile
467 sudo make
468
469 **Step 5:** Install makefile
470 sudo make install
471
472 **Check:**
473 cd /usr/local/bin;ls -al  ~-~->    Check to see if there is a file for sqlite3
474 cd sqlite-autoconf-3350300/;./sqlite3 test.db        ~-~->    Test whether the sqlite3 was installed successfully
475
476 **debug:**
477 If you get the imformation that is SQLite header and source version mismatch, when you execute./sqlite3 test.db.
478 Please execute the command /sbin/ldconfig.
479 After that execute the command ./sqlite3 test.db again.
480 )))
481
482
483
484 === (% style="color:blue" %)**Step 2 :  Install and run the RSS service**(%%) ===
485
486
487 **1). ** install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
488
489 user must enter the root account and run the following commands
490
491 (% class="box infomessage" %)
492 (((
493 **$ ./create_sqlite3_db.sh
494 $ ./rssh_serv -p  3721 2>&1 &
495 $ ps -ef | grep rssh_serv check 3721 port**
496 )))
497
498 [[image:image-20220531151958-10.png]]
499
500
501 **Debug:**
502
503 {{{ Check /var/rsshdb.sqlite3 --> ls /var/rsshdb.sqlite3
504 Check ls /var/rsshdb.sqlite3 --> sudo chmod 777 rssh_serv
505 }}}
506
507 {{{ if fail to open dpvlry or to bind to it
508 please kill rssh_serv,and run ./rssh_serv -p 3721 2>&1 & again
509 }}}
510
511
512
513 === (% style="color:blue" %)**Step 3 :  Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ===
514
515
516 (% class="box infomessage" %)
517 (((
518 **1):**  sudo useradd XXXXX (custom user name)
519 **2):**  sudo passwd xxxxxx
520 **3):**  cp /bin/bash /bin/rbash
521 **4):**  sudo nano /etc/passwd ~-~-> Change /bin/bash to /bin/rbash
522 **5):**  sudo nano /home/xxxxx/.bashrc **empty it,and input export PATH=$HOME/bin**
523 **6):**  sudo nano /home/xxxxx/.bash_profile **empty it,and input export PATH=$HOME/bin**
524 )))
525
526 (% style="color:red" %)**Now user "XXXXX" is the user with limited permissions of the current system**
527
528
529
530 === (% style="color:blue" %)**Step 4 :  Create an authorization key file**(%%) ===
531
532
533 **1):**  sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
534
535
536 **Debug:**
537
538 {{{ check: sudo ls /home/xxxxx/.ssh/authorizedkey}}}
539
540
541 == 4.3  How does user get the gateway to connect to a user's private server ==
542
543
544
545 === (% style="color:blue" %)**Step 1 :  Come back the gateway web UI to get the gateway Public key**(%%) ===
546
547
548 **1)**  in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span**
549
550 [[image:image-20220531152419-11.png]]
551
552
553
554 === (% style="color:blue" %)**Step 2 :  Authorization server**(%%) ===
555
556
557 Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file.
558
559 [[image:image-20220531152549-12.png]]
560
561
562
563 === (% style="color:blue" %)**Step 3 :  Connect private server**(%%) ===
564
565
566 This is same as connect Dragino Support Server but just change the server address to customize server address.
567
568 [[image:image-20220531152633-13.png]]
569
570
571
572 === (% style="color:blue" %)**Step 4 :  Check Connection**(%%) ===
573
574
575 Rssh Host connection Ok
576
577 [[image:image-20220531152815-14.png]]
578
579
580 User can use common ps | grep ssh to check it in the gateway.
581
582 [[image:image-20220531152840-15.png]]
583
584
585
586 === (% style="color:blue" %)**Step 5 :  Access the gateway from customized server**(%%) ===
587
588
589 Check what gateways link to server.
590
591 (% class="box infomessage" %)
592 (((
593 **$ ./connect-gw.sh -l**
594 )))
595
596 [[image:image-20220531153016-16.png]]
597
598
599
600 Access the gateway
601
602 (% class="box infomessage" %)
603 (((
604 **$ ./connect-gw.sh <GWID>**
605 )))
606
607 [[image:image-20220531153219-17.png]]