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