Skip to Content
Last modified by Kilight Cao on 2025/05/09 11:46
From version 106.1
edited by Kilight Cao
on 2025/04/28 17:11
Change comment: There is no comment for this version
To version 69.1
edited by Kilight Cao
on 2023/03/20 11:03
Change comment: Uploaded new attachment "image-20230320110309-5.png", version {1}

Summary

Details

Page properties
Content
... ... @@ -5,98 +5,94 @@
5 5  
6 6  
7 7  
8 -= 1.  Dragino Platform Monitor =
8 += **1.  Monitor Gateway** =
9 9  
10 +== **1.1  Introduction** ==
10 10  
11 -**Below list the support products and Requirements:**
12 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]]**
13 +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]]
14 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 16  
17 -The LPS8v2,MS48-LR supports remote platform monitor functionality,Since software version **dragino-ui : 2024-12-15 **
16 +[[image:image-20220531155018-18.png]]
18 18  
19 19  
20 -Once you have received your gateway and want to manage your gateway, you need to perform the following steps:
21 21  
20 +== **1.2  Steps** ==
22 22  
23 -== 1.1 Create an account ==
24 24  
25 -Contact: (% style="color:blue" %)**[[support@dragino.cc>>mailto:support@dragino.cc]]**
23 +* Create account in ThingsSpeak and creat channel.
24 +* Download script from dragino site and move it to properly directory
26 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.
26 +(% class="box infomessage" %)
27 +(((
28 +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]]
29 +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']]
30 +Connecting to 162.241.22.11:80
31 +Writing to 'monitor_gateway.sh'
32 +monitor_gateway.sh   100% |~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~*~**|  1860   0:00:00 ETA
33 +Download completed (1860 bytes)
34 +root@dragino-1baf44:~~# chmod +x monitor_gateway.sh;mv monitor_gateway.sh /usr/bin/
35 +root@dragino-1baf44:~~#
36 +root@dragino-1baf44:~~#
37 +)))
28 28  
29 -Management platform entrance: **[[iot.dragino.com>>iot.dragino.com]]**
30 30  
31 -[[image:image-20250109152734-1.png||height="530" width="1331"]]
32 32  
33 -== 1.2 Configure gateway ==
41 +* change the script monitor_gateway.sh with properly users setting:
34 34  
43 +(% class="box infomessage" %)
44 +(((
45 +USER='xxxxx'             # user name in your thinkspeak ~-~-> Profile
46 +PASS='xxxxx'     #MQTT_API_KEY in your thinkspeak ~-~-> Profile
47 +CHAN_ID='xxxx'    #Channel ID   of the channel for this gateway
48 +CHAN_KEY='xxxxx'   #Channel Write API  of the channel for this gateway
49 +)))
35 35  
36 -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**(%%)".
37 37  
38 -~1. Click "(% style="color:blue" %)**Enable**(%%)" ~-~-~-~-->  If this option is checked, the gateway will enable Remote Platform Monitor
39 39  
40 -2. Configure the (% style="color:blue" %)**Owner**(%%)  ~-~-~-~-->  Fill in the Owne given by the manufacturer, that's the only one.The default is: registered email
53 +* run (% style="color:blue" %)**/usr/bin/monitor_gateway.sh**(%%) to test if upload is good.
41 41  
42 -3. Click "(% style="color:blue" %)**Save&Apply**(%%)"
55 +* 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
43 43  
44 -(% style="color:red" %)Note: If the Owner parameter is set to Dragino, the device will be registered with the Dragino account
57 +(% class="box infomessage" %)
58 +(((
59 +# For details see man 4 crontabs
60 +# Example of job definition:
61 +# .~-~-~-~-~-~-~-~-~-~-~-~-~-~-~-~- minute (0 - 59)
62 +# | .~-~-~-~-~-~-~-~-~-~-~-~-- hour (0 - 23)
63 +# | | .~-~-~-~-~-~-~-~-~-~- day of month (1 - 31)
64 +# | | | .~-~-~-~-~-~-- month (1 - 12) OR jan,feb,mar,apr ...
65 +# | | | | .~-~-~-~- day of week (0 - 6) (Sunday=0 or 7) OR sun,mon,tue,wed,thu,fri,sat
66 +# | | | | |
67 +# * * * * * user-name command to be executed
68 +#*/10 * * * *  checklog
69 +~* 23 * * *  /etc/init.d/auto_update start
70 +*/20 * * * *  /usr/bin/monitor_gateway.sh     
71 +)))
45 45  
46 -[[image:image-20250107151805-1.png]]
73 +* Reboot device.
47 47  
48 48  
49 -Check the remote platform connection status
50 50  
51 -[[image:image-20241216162640-2.png]]
77 +== **1.3  Monitor Public IP** ==
52 52  
53 -After the above configuration is complete, wait for 2-3 minutes, the gateway will be displayed on the dashboard
54 54  
80 +The monitor_gateway.sh has been updated to upload the public ip of the device as well.
55 55  
56 -== 1.3 Check the dashboard. ==
82 +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.
57 57  
58 -Check if you can see your gateway information in the dashboard
59 59  
60 -[[image:image-20241216163331-3.png||height="578" width="1258"]]
85 +[[image:image-20220531145559-2.png]]
61 61  
87 +Find Public IP
62 62  
63 -And click on your device to go to the next level to see if the gateway specific information is displayed properly
64 64  
65 65  
66 -**Chart function introduction:**
91 += **2.  Remote Access** =
67 67  
68 -(% 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
93 += **2.1  Remote Access via Remote.it.** =
69 69  
70 -(% 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
71 71  
72 -(% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__3. Auto-Update:  __**(%%) After clicking, the gateway will be updated
73 -
74 -(% 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
75 -
76 -(% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691" %)**__5. Reboot gateway: __**(%%) After clicking, the gateway will reboot.
77 -
78 -(% 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
79 -
80 -(% 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
81 -
82 -The format is as follows:
83 -
84 -**{"action":"set_server1_address","server_address":"10.130.2.123"}**
85 -
86 -(% 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
87 -
88 -
89 -[[image:image-20241216170144-6.png||height="596" width="1258"]]
90 -
91 -
92 -[[image:image-20241216170119-5.png||height="249" width="1259"]]
93 -
94 -
95 -
96 -
97 -= 2.  Remote Access via Remote.it. =
98 -
99 -
100 100  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.
101 101  
102 102  
... ... @@ -103,11 +103,9 @@
103 103  (% style="color:red" %)**Important Notice:**
104 104  
105 105  * Remote.it access will give full control of your device to remote support.
106 -
107 107  * 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.
108 108  
109 109  * 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]].
110 -
111 111  * For Quick add remote.it to (% style="color:blue" %)**Dragino for remote debug**(%%), please see below:
112 112  
113 113  (% style="color:blue" %)**1. Install the Remote.it software**
... ... @@ -128,10 +128,10 @@
128 128  
129 129  (% class="box infomessage" %)
130 130  (((
131 -**fd173d1d-faed-493e-a868-c511a38aba45**
125 +**57F60715-606F-510D-A3D2-739860EBDB98**
132 132  )))
133 133  
134 -[[image:image-20230607085305-1.png||height="555" width="993"]]
128 +[[image:image-20220725113010-1.png||height="455" width="899"]]
135 135  
136 136  
137 137  
... ... @@ -143,9 +143,10 @@
143 143  [[image:image-20220725115720-2.png||height="658" width="900"]]
144 144  
145 145  
146 -== 2.1  How to save the registered remote after the gateway's firmware update. ==
147 147  
141 +== **2.1.1  How to save the registered remote after the gateway's firmware update.** ==
148 148  
143 +
149 149  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.
150 150  
151 151  This issue is now corrected:
... ... @@ -176,14 +176,15 @@
176 176  [[image:image-20221112162547-3.png]]
177 177  
178 178  
179 -== 2.2  How to register hp0d with Remote.it ==
180 180  
175 +== **2.1.2  How to register hp0d with Remote.it** ==
181 181  
182 -(% style="color:blue" %)**Prerequisites:**
183 183  
178 +**Prerequisites:**
179 +
184 184  Users must have an account and APP for remote.it
185 185  
186 -**[[https:~~/~~/app.remote.it>>https://app.remote.it]]**
182 +[[https:~~/~~/app.remote.it>>https://app.remote.it]]
187 187  
188 188  
189 189  === (% style="color:blue" %)**1.  Click "+" in the APP to add a device**(%%) ===
... ... @@ -216,51 +216,10 @@
216 216  [[image:image-20220815173958-4.jpeg||height="580" width="964"]]
217 217  
218 218  
219 -== 2.3 How to register the gateway with Remote.it via SSH Access for Linux console ==
220 220  
216 +== **2.1.3  Trouble Shooting** ==
221 221  
222 -(% style="color:blue" %)**Prerequisites:**
223 223  
224 -Users must have an account and APP for remote.it
225 -
226 -**[[https:~~/~~/app.remote.it>>https://app.remote.it]]**
227 -
228 -For detailed examples, please see: **[[OpenWrt How to Connect Guide (remote.it)>>url:https://www.remote.it/getting-started/openwrt]]**
229 -
230 -
231 -=== (% style="color:blue" %)**1.  Click "+" in the APP to add a device**(%%) ===
232 -
233 -
234 -Then click Add "OpenWrt" and the APP will generate a command to register the device.
235 -
236 -[[image:image-20230320110123-4.png||height="657" width="1191"]]
237 -
238 -
239 -
240 -=== (% style="color:blue" %)**2.  Copy the register device command**(%%) ===
241 -
242 -
243 -[[image:image-20230320110309-5.png||height="635" width="1197"]]
244 -
245 -
246 -
247 -=== (% style="color:blue" %)**3.  Enter the command copied from the previous step on the gateway Linux command line**(%%) ===
248 -
249 -
250 -(% class="wikigeneratedid" id="H" %)
251 -[[image:image-20230320105212-1.png||height="758" width="820"]]
252 -
253 -
254 -
255 -=== (% style="color:blue" %)**4.  Check whether the device is successfully registered on the Remote.it APP**(%%) ===
256 -
257 -
258 -[[image:image-20230320112057-6.png||height="603" width="1135"]]
259 -
260 -
261 -== 2.4  Trouble Shooting ==
262 -
263 -
264 264  === **1. What should users do when gateway Remote.it installation fails** ===
265 265  
266 266  
... ... @@ -281,9 +281,10 @@
281 281  (% style="color:blue" %)**Step 3:**(%%) Follow the [[Remoteit user instruction for Dragino Gateway>>https://www.remote.it/getting-started/dragino]] steps to reconfigure
282 282  
283 283  
284 -= 3.  RSSH Introduction =
285 285  
240 += **2.2  RSSH Introduction** =
286 286  
242 +
287 287  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.
288 288  
289 289  (% style="color:red" %)**Important Notice:**
... ... @@ -291,9 +291,7 @@
291 291  (% class="box warningmessage" %)
292 292  (((
293 293  RSSH access will give full control of your device to remote support. Please remove sensitivity info before perform this
294 -This RSSH allow Dragino Support Team to remote access to customer's device. Customer is not able to remote access it via Dragino Server.
295 -
296 -If user want to access himself, he need to set up the RSSH server himself.
250 +This RSSH allow Dragino Support to remote access to the device, If user want to access himself, he need to set up the RSSH server himself.
297 297  )))
298 298  
299 299  
... ... @@ -307,37 +307,42 @@
307 307  * LIG16
308 308  * MS14 series if installed with the same firmware.
309 309  
310 -== 3.1  End User Guide to use SSH access ==
311 311  
265 +=== **2.2.1  End User Guide to use SSH access** ===
312 312  
267 +
313 313  Go to this the Reverse SSH page as below:
314 314  
315 -[[image:image-20231107200442-2.png||height="684" width="973"]]
316 316  
271 +[[image:image-20220531150151-3.png]]
317 317  
318 318  Get the RSSH configure page
319 319  
320 -[[image:image-20220531152815-14.png]]
321 321  
276 +
277 +[[image:image-20220531150338-4.png]]
278 +
322 322  Connection OK.
323 323  
324 -* (% style="color:#037691" %)**ConnectionType**(%%):  Select a type
325 -* (% style="color:#037691" %)**Login ID**(%%):  Input the rssh server minimal ssh user
326 -* (% style="color:#037691" %)**Host Address**(%%):  Input rssh server public IP address/domain name
327 -* (% style="color:#037691" %)**Connect at Startup**(%%) :  Choose to enable connect once the device is powered.
328 -* (% 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
329 329  
282 +* (% style="color:#037691" %)**Login ID**(%%):  Input sshuser
283 +* (% style="color:#037691" %)**Host Address**(%%):  Input support.dragino.com
284 +* (% style="color:#037691" %)**Host Port** (%%):  Please email to support @ dragino.com to get a valid host port.
285 +* (% style="color:#037691" %)**Connect at Startup**(%%) : Choose to enable connect once the device is powered.
286 +* (% 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
287 +
330 330  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.
331 331  
332 332  
333 -== 3.2  Set Up RSSH Server ==
334 334  
292 +=== **2.2.2  Set Up RSSH Server** ===
335 335  
294 +
336 336  Advance administrator can config a SSH server to provide support their end user themselves., Steps as below
337 337  
338 338  
339 339  
340 -=== (% style="color:blue" %)**Step 1 :  Download the SSH service code**(%%) ===
299 +==== (% style="color:blue" %)**Step 1 :  Download the SSH service code**(%%) ====
341 341  
342 342  
343 343  **1).**  git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
... ... @@ -407,7 +407,7 @@
407 407  
408 408  
409 409  
410 -=== (% style="color:blue" %)**Step 2 :  Install and run the RSS service**(%%) ===
369 +==== (% style="color:blue" %)**Step 2 :  Install and run the RSS service**(%%) ====
411 411  
412 412  
413 413  **1). ** install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
... ... @@ -436,7 +436,7 @@
436 436  
437 437  
438 438  
439 -=== (% style="color:blue" %)**Step 3 :  Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ===
398 +==== (% style="color:blue" %)**Step 3 :  Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ====
440 440  
441 441  
442 442  (% class="box infomessage" %)
... ... @@ -453,7 +453,7 @@
453 453  
454 454  
455 455  
456 -=== (% style="color:blue" %)**Step 4 :  Create an authorization key file**(%%) ===
415 +==== (% style="color:blue" %)**Step 4 :  Create an authorization key file**(%%) ====
457 457  
458 458  
459 459  **1):**  sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
... ... @@ -464,13 +464,14 @@
464 464  {{{ check: sudo ls /home/xxxxx/.ssh/authorizedkey}}}
465 465  
466 466  
467 -== 3.3  How does user get the gateway to connect to a user's private server ==
468 468  
427 +=== **2.2.3  How does user get the gateway to connect to a user's private server** ===
469 469  
470 470  
471 -=== (% style="color:blue" %)**Step 1 :  Come back the gateway web UI to get the gateway Public key**(%%) ===
472 472  
431 +==== (% style="color:blue" %)**Step 1 :  Come back the gateway web UI to get the gateway Public key**(%%) ====
473 473  
433 +
474 474  **1)**  in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span**
475 475  
476 476  [[image:image-20220531152419-11.png]]
... ... @@ -477,7 +477,7 @@
477 477  
478 478  
479 479  
480 -=== (% style="color:blue" %)**Step 2 :  Authorization server**(%%) ===
440 +==== (% style="color:blue" %)**Step 2 :  Authorization server**(%%) ====
481 481  
482 482  
483 483  Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file.
... ... @@ -486,7 +486,7 @@
486 486  
487 487  
488 488  
489 -=== (% style="color:blue" %)**Step 3 :  Connect private server**(%%) ===
449 +==== (% style="color:blue" %)**Step 3 :  Connect private server**(%%) ====
490 490  
491 491  
492 492  This is same as connect Dragino Support Server but just change the server address to customize server address.
... ... @@ -495,7 +495,7 @@
495 495  
496 496  
497 497  
498 -=== (% style="color:blue" %)**Step 4 :  Check Connection**(%%) ===
458 +==== (% style="color:blue" %)**Step 4 :  Check Connection**(%%) ====
499 499  
500 500  
501 501  Rssh Host connection Ok
... ... @@ -509,7 +509,7 @@
509 509  
510 510  
511 511  
512 -=== (% style="color:blue" %)**Step 5 :  Access the gateway from customized server**(%%) ===
472 +==== (% style="color:blue" %)**Step 5 :  Access the gateway from customized server**(%%) ====
513 513  
514 514  
515 515  Check what gateways link to server.
image-20230320112057-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -47.8 KB
Content
image-20230607085305-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -71.3 KB
Content
image-20231107200343-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoye
Size
... ... @@ -1,1 +1,0 @@
1 -57.5 KB
Content
image-20231107200442-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoye
Size
... ... @@ -1,1 +1,0 @@
1 -83.5 KB
Content
image-20241216161649-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -53.4 KB
Content
image-20241216162640-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -38.9 KB
Content
image-20241216163331-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -97.3 KB
Content
image-20241216163442-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -150.4 KB
Content
image-20241216170119-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -38.1 KB
Content
image-20241216170144-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -141.4 KB
Content
image-20250107151805-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -55.0 KB
Content
image-20250109152734-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Kilight
Size
... ... @@ -1,1 +1,0 @@
1 -44.6 KB
Content