Skip to Content
Last modified by Kilight Cao on 2025/05/09 11:46
From version 107.1
edited by Kilight Cao
on 2025/05/09 11:45
Change comment: There is no comment for this version
To version 71.1
edited by Kilight Cao
on 2023/03/20 11:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -5,98 +5,93 @@
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
76 +== **1.3  Monitor Public IP** ==
50 50  
51 -[[image:image-20241216162640-2.png]]
52 52  
53 -After the above configuration is complete, wait for 2-3 minutes, the gateway will be displayed on the dashboard
79 +The monitor_gateway.sh has been updated to upload the public ip of the device as well.
54 54  
81 +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.
55 55  
56 -== 1.3 Check the dashboard. ==
57 57  
58 -Check if you can see your gateway information in the dashboard
84 +[[image:image-20220531145559-2.png]]
59 59  
60 -[[image:image-20241216163331-3.png||height="578" width="1258"]]
86 +Find Public IP
61 61  
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  
90 += **2.  Remote Access** =
65 65  
66 -**Chart function introduction:**
92 += **2.1  Remote Access via Remote.it.** =
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
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 -
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,8 @@
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 -
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**
123 +**57F60715-606F-510D-A3D2-739860EBDB98**
132 132  )))
133 133  
134 -[[image:image-20230607085305-1.png||height="555" width="993"]]
126 +[[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  
139 +== **2.1.1  How to save the registered remote after the gateway's firmware update.** ==
148 148  
141 +
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,11 +176,12 @@
176 176  [[image:image-20221112162547-3.png]]
177 177  
178 178  
179 -== 2.2  How to register hp0d with Remote.it ==
180 180  
173 +== **2.1.2  How to register hp0d with Remote.it** ==
181 181  
182 -(% style="color:blue" %)**Prerequisites:**
183 183  
176 +**Prerequisites:**
177 +
184 184  Users must have an account and APP for remote.it
185 185  
186 186  **[[https:~~/~~/app.remote.it>>https://app.remote.it]]**
... ... @@ -216,10 +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 ==
213 +== **2.1.3  How to register the gateway with Remote.it via SSH Access for Linux console** ==
220 220  
221 221  
222 -(% style="color:blue" %)**Prerequisites:**
216 +**Prerequisites:**
223 223  
224 224  Users must have an account and APP for remote.it
225 225  
... ... @@ -236,7 +236,6 @@
236 236  [[image:image-20230320110123-4.png||height="657" width="1191"]]
237 237  
238 238  
239 -
240 240  === (% style="color:blue" %)**2.  Copy the register device command**(%%) ===
241 241  
242 242  
... ... @@ -243,15 +243,11 @@
243 243  [[image:image-20230320110309-5.png||height="635" width="1197"]]
244 244  
245 245  
246 -
247 247  === (% style="color:blue" %)**3.  Enter the command copied from the previous step on the gateway Linux command line**(%%) ===
248 248  
241 +=== [[image:image-20230320105212-1.png||height="758" width="820"]] ===
249 249  
250 -(% class="wikigeneratedid" id="H" %)
251 -[[image:image-20230320105212-1.png||height="758" width="820"]]
252 252  
253 -
254 -
255 255  === (% style="color:blue" %)**4.  Check whether the device is successfully registered on the Remote.it APP**(%%) ===
256 256  
257 257  
... ... @@ -258,7 +258,7 @@
258 258  [[image:image-20230320112057-6.png||height="603" width="1135"]]
259 259  
260 260  
261 -== 2.4  Trouble Shooting ==
250 +== **2.1.4  Trouble Shooting** ==
262 262  
263 263  
264 264  === **1. What should users do when gateway Remote.it installation fails** ===
... ... @@ -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  
274 += **2.2  RSSH Introduction** =
286 286  
276 +
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.
284 +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,41 @@
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 ==
298 +=== **2.2.1  End User Guide to use SSH access** ===
311 311  
312 312  
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  
304 +[[image:image-20220531150151-3.png]]
317 317  
318 318  Get the RSSH configure page
319 319  
320 -[[image:image-20220531152815-14.png]]
321 321  
309 +
310 +[[image:image-20220531150338-4.png]]
311 +
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  
315 +* (% style="color:#037691" %)**Login ID**(%%):  Input sshuser
316 +* (% style="color:#037691" %)**Host Address**(%%):  Input support.dragino.com
317 +* (% style="color:#037691" %)**Host Port** (%%):  Please email to support @ dragino.com to get a valid host port.
318 +* (% style="color:#037691" %)**Connect at Startup**(%%) : Choose to enable connect once the device is powered.
319 +* (% 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
320 +
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  
325 +=== **2.2.2  Set Up RSSH Server** ===
335 335  
327 +
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**(%%) ===
332 +==== (% 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**(%%) ===
402 +==== (% 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)**(%%) ===
431 +==== (% 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**(%%) ===
448 +==== (% 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  
460 +=== **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  
464 +==== (% style="color:blue" %)**Step 1 :  Come back the gateway web UI to get the gateway Public key**(%%) ====
473 473  
466 +
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**(%%) ===
473 +==== (% 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**(%%) ===
482 +==== (% 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**(%%) ===
491 +==== (% 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**(%%) ===
505 +==== (% style="color:blue" %)**Step 5 :  Access the gateway from customized server**(%%) ====
513 513  
514 514  
515 515  Check what gateways link to server.
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