Changes for page Monitor & Remote Access Gateway
Last modified by Kilight Cao on 2025/01/14 10:25
<
edited by Kilight Cao
on 2025/01/14 10:25
on 2025/01/14 10:25
Change comment:
Uploaded new attachment "image-20231107200442-2.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 8 removed)
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Kilight1 +XWiki.Xiaoye - Content
-
... ... @@ -5,96 +5,93 @@ 5 5 6 6 7 7 8 -= 1. Dragino PlatformMonitor =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.UserManual for All Gateway models.LG308N- LoRaWANGatewayUserManual.WebHome]]**, **[[DLOS8N>>doc:Main.User Manual forAllGatewaymodels.DLOS8N.WebHome]]**,**[[LPS8N>>doc:Main.UserManualforAll Gateway models.LPS8N- LoRaWAN Gateway UserManual.WebHome]]**,**[[LPS8v2>>doc:Main.UserManual for All Gatewaymodels.HP0C.WebHome]]**,**[[MS48-LR>>doc:Main.User ManualforAll Gatewaymodels.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,Sincesoftware version **dragino-ui :2024-12-15**16 +[[image:image-20220531155018-18.png]] 18 18 19 19 20 - Onceyouhave received your gateway and want to manage your gateway, you need toperform the followingsteps:19 +== 1.2 Steps == 21 21 22 22 23 - ==1.1Create an account==22 +* Create account in ThingsSpeak and creat channel. 24 24 25 - Contact:(%style="color:blue"%)**support@dragino.cc**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 -[[image:image-20250109152734-1.png||height="530" width="1331"]] 30 30 31 -== 1.2 Configure gateway == 32 32 41 +* change the script monitor_gateway.sh with properly users setting: 33 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**(%%)". 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 -~1. Click "(% style="color:blue" %)**Enable**(%%)" ~-~-~-~--> If this option is checked, the gateway will enable Remote Platform Monitor 37 37 38 -2. Configure the (% style="color:blue" %)**Owner**(%%) ~-~-~-~--> Fill in the Owne given by the manufacturer, that's the only one. 39 39 40 - 3.Click"(% style="color:blue" %)**Save&Apply**(%%)"53 +* run (% style="color:blue" %)**/usr/bin/monitor_gateway.sh**(%%) to test if upload is good. 41 41 42 -(% style="color: red" %)Note: Ifthe Ownerparameteris setto Dragino,theevice will beregisteredwiththeDragino account55 +* 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 -[[image:image-20250107151805-1.png]] 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 73 +* Reboot device. 46 46 47 -Check the remote platform connection status 48 48 49 -[[image:image-20241216162640-2.png]] 50 50 51 - Aftertheabove configuration is complete, wait for2-3 minutes, the gateway willbe displayedonthe dashboard77 +== 1.3 Monitor Public IP == 52 52 53 53 54 - ==1.3Checktheshboard.==80 +The monitor_gateway.sh has been updated to upload the public ip of the device as well. 55 55 56 - Checkifyoucanseeyourgatewayinformationinthedashboard82 +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 -[[image:image-20241216163331-3.png||height="578" width="1258"]] 59 59 85 +[[image:image-20220531145559-2.png||height="658" width="1233"]] 60 60 61 - And click onyourdeviceto go to the nextlevel to seeif the gateway specificinformation is displayed properly87 +Find Public IP 62 62 63 63 64 - **Chartfunctionintroduction:**90 += 2. Remote Access = 65 65 66 - (% data-sider-select-id="31384c06-f8bc-420e-ba58-0a2d5916e600" style="color:#037691"%)**__1.Gateway information:__**(%%) Will show Gateway time, uptime,macaddress,lorawanstatus,model and other gatewayinformation92 +== 2.1 Remote Access via Remote.it. == 67 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 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 - 95 -= 2. Remote Access via Remote.it. = 96 - 97 - 98 98 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. 99 99 100 100 ... ... @@ -141,7 +141,7 @@ 141 141 [[image:image-20220725115720-2.png||height="658" width="900"]] 142 142 143 143 144 -== 2.1 How to save the registered remote after the gateway's firmware update. == 141 +=== 2.1.1 How to save the registered remote after the gateway's firmware update. === 145 145 146 146 147 147 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,7 +150,7 @@ 150 150 151 151 152 152 153 -=== **The gateway version is lower than** **lgw~-~-build-v5.4.1668240318-20221112-1606:** === 150 +==== **The gateway version is lower than** **lgw~-~-build-v5.4.1668240318-20221112-1606:** ==== 154 154 155 155 156 156 **~1. upload the [[backup file>>http://repo.dragino.com/release/miscellaneous/remoteit/backup.tar.gz]] to update the configuration.** ... ... @@ -165,7 +165,7 @@ 165 165 166 166 167 167 168 -=== **The gateway version is greater or equal to** **lgw~-~-build-v5.4.1668240318-20221112-1606:** === 165 +==== **The gateway version is greater or equal to** **lgw~-~-build-v5.4.1668240318-20221112-1606:** ==== 169 169 170 170 171 171 ... ... @@ -174,7 +174,7 @@ 174 174 [[image:image-20221112162547-3.png]] 175 175 176 176 177 -== 2.2 How to register hp0d with Remote.it == 174 +=== 2.1.2 How to register hp0d with Remote.it === 178 178 179 179 180 180 (% style="color:blue" %)**Prerequisites:** ... ... @@ -184,7 +184,7 @@ 184 184 **[[https:~~/~~/app.remote.it>>https://app.remote.it]]** 185 185 186 186 187 -=== (% style="color:blue" %)**1. Click "+" in the APP to add a device**(%%) === 184 +==== (% style="color:blue" %)**1. Click "+" in the APP to add a device**(%%) ==== 188 188 189 189 190 190 Then click Add "Linux & Raspberry Pi" and the APP will generate a command to register the device. ... ... @@ -194,7 +194,7 @@ 194 194 195 195 196 196 197 -=== (% style="color:blue" %)**2. Copy the register device command**(%%) === 194 +==== (% style="color:blue" %)**2. Copy the register device command**(%%) ==== 198 198 199 199 200 200 [[image:image-20220815173944-2.jpeg||height="556" width="923"]] ... ... @@ -201,7 +201,7 @@ 201 201 202 202 203 203 204 -=== (% style="color:blue" %)**3. Enter the command copied from the previous step on the HP0D Linux command line**(%%) === 201 +==== (% style="color:blue" %)**3. Enter the command copied from the previous step on the HP0D Linux command line**(%%) ==== 205 205 206 206 207 207 [[image:image-20220815173951-3.jpeg||height="424" width="1147"]] ... ... @@ -208,13 +208,13 @@ 208 208 209 209 210 210 211 -=== (% style="color:blue" %)**4. Check whether the device is successfully registered on the Remote.it APP**(%%) === 208 +==== (% style="color:blue" %)**4. Check whether the device is successfully registered on the Remote.it APP**(%%) ==== 212 212 213 213 214 214 [[image:image-20220815173958-4.jpeg||height="580" width="964"]] 215 215 216 216 217 -== 2.3 How to register the gateway with Remote.it via SSH Access for Linux console == 214 +=== 2.1.3 How to register the gateway with Remote.it via SSH Access for Linux console === 218 218 219 219 220 220 (% style="color:blue" %)**Prerequisites:** ... ... @@ -226,7 +226,7 @@ 226 226 For detailed examples, please see: **[[OpenWrt How to Connect Guide (remote.it)>>url:https://www.remote.it/getting-started/openwrt]]** 227 227 228 228 229 -=== (% style="color:blue" %)**1. Click "+" in the APP to add a device**(%%) === 226 +==== (% style="color:blue" %)**1. Click "+" in the APP to add a device**(%%) ==== 230 230 231 231 232 232 Then click Add "OpenWrt" and the APP will generate a command to register the device. ... ... @@ -235,7 +235,7 @@ 235 235 236 236 237 237 238 -=== (% style="color:blue" %)**2. Copy the register device command**(%%) === 235 +==== (% style="color:blue" %)**2. Copy the register device command**(%%) ==== 239 239 240 240 241 241 [[image:image-20230320110309-5.png||height="635" width="1197"]] ... ... @@ -242,7 +242,7 @@ 242 242 243 243 244 244 245 -=== (% style="color:blue" %)**3. Enter the command copied from the previous step on the gateway Linux command line**(%%) === 242 +==== (% style="color:blue" %)**3. Enter the command copied from the previous step on the gateway Linux command line**(%%) ==== 246 246 247 247 248 248 (% class="wikigeneratedid" id="H" %) ... ... @@ -250,16 +250,16 @@ 250 250 251 251 252 252 253 -=== (% style="color:blue" %)**4. Check whether the device is successfully registered on the Remote.it APP**(%%) === 250 +==== (% style="color:blue" %)**4. Check whether the device is successfully registered on the Remote.it APP**(%%) ==== 254 254 255 255 256 256 [[image:image-20230320112057-6.png||height="603" width="1135"]] 257 257 258 258 259 -== 2.4 Trouble Shooting == 256 +=== 2.1.4 Trouble Shooting === 260 260 261 261 262 -=== **1. What should users do when gateway Remote.it installation fails** === 259 +==== **1. What should users do when gateway Remote.it installation fails** ==== 263 263 264 264 265 265 [[image:image-20220907162028-4.png||height="564" width="1148"]] ... ... @@ -279,7 +279,7 @@ 279 279 (% style="color:blue" %)**Step 3:**(%%) Follow the [[Remoteit user instruction for Dragino Gateway>>https://www.remote.it/getting-started/dragino]] steps to reconfigure 280 280 281 281 282 -= 3. RSSH Introduction =279 +== 2.2 RSSH Introduction == 283 283 284 284 285 285 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. ... ... @@ -305,30 +305,35 @@ 305 305 * LIG16 306 306 * MS14 series if installed with the same firmware. 307 307 308 -== 3.1 End User Guide to use SSH access == 309 309 310 310 307 +=== 2.2.1 End User Guide to use SSH access === 308 + 309 + 311 311 Go to this the Reverse SSH page as below: 312 312 313 -[[image:image-20231107200442-2.png||height="684" width="973"]] 314 314 313 +[[image:image-20220531150151-3.png]] 315 315 316 316 Get the RSSH configure page 317 317 318 -[[image:image-20220531152815-14.png]] 319 319 318 + 319 +[[image:image-20220531150338-4.png]] 320 + 320 320 Connection OK. 321 321 322 -* (% style="color:#037691" %)**ConnectionType**(%%): Select a type 323 -* (% style="color:#037691" %)**Login ID**(%%): Input the rssh server minimal ssh user 324 -* (% style="color:#037691" %)**Host Address**(%%): Input rssh server public IP address/domain name 325 -* (% style="color:#037691" %)**Connect at Startup**(%%) : Choose to enable connect once the device is powered. 326 -* (% 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 327 327 324 +* (% style="color:#037691" %)**Login ID**(%%): Input sshuser 325 +* (% style="color:#037691" %)**Host Address**(%%): Input support.dragino.com 326 +* (% style="color:#037691" %)**Host Port** (%%): Please email to support @ dragino.com to get a valid host port. 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 + 328 328 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. 329 329 330 330 331 -== 3.2 Set Up RSSH Server ==333 +=== 2.2.2 Set Up RSSH Server === 332 332 333 333 334 334 Advance administrator can config a SSH server to provide support their end user themselves., Steps as below ... ... @@ -335,7 +335,7 @@ 335 335 336 336 337 337 338 -=== (% style="color:blue" %)**Step 1 : Download the SSH service code**(%%) === 340 +==== (% style="color:blue" %)**Step 1 : Download the SSH service code**(%%) ==== 339 339 340 340 341 341 **1).** git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server ... ... @@ -405,7 +405,7 @@ 405 405 406 406 407 407 408 -=== (% style="color:blue" %)**Step 2 : Install and run the RSS service**(%%) === 410 +==== (% style="color:blue" %)**Step 2 : Install and run the RSS service**(%%) ==== 409 409 410 410 411 411 **1). ** install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721) ... ... @@ -434,7 +434,7 @@ 434 434 435 435 436 436 437 -=== (% style="color:blue" %)**Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) === 439 +==== (% style="color:blue" %)**Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ==== 438 438 439 439 440 440 (% class="box infomessage" %) ... ... @@ -451,7 +451,7 @@ 451 451 452 452 453 453 454 -=== (% style="color:blue" %)**Step 4 : Create an authorization key file**(%%) === 456 +==== (% style="color:blue" %)**Step 4 : Create an authorization key file**(%%) ==== 455 455 456 456 457 457 **1):** sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey ... ... @@ -462,11 +462,11 @@ 462 462 {{{ check: sudo ls /home/xxxxx/.ssh/authorizedkey}}} 463 463 464 464 465 -== 3.3 How does user get the gateway to connect to a user's private server ==467 +=== 2.2.3 How does user get the gateway to connect to a user's private server === 466 466 467 467 468 468 469 -=== (% style="color:blue" %)**Step 1 : Come back the gateway web UI to get the gateway Public key**(%%) === 471 +==== (% style="color:blue" %)**Step 1 : Come back the gateway web UI to get the gateway Public key**(%%) ==== 470 470 471 471 472 472 **1)** in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span** ... ... @@ -475,7 +475,7 @@ 475 475 476 476 477 477 478 -=== (% style="color:blue" %)**Step 2 : Authorization server**(%%) === 480 +==== (% style="color:blue" %)**Step 2 : Authorization server**(%%) ==== 479 479 480 480 481 481 Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file. ... ... @@ -484,7 +484,7 @@ 484 484 485 485 486 486 487 -=== (% style="color:blue" %)**Step 3 : Connect private server**(%%) === 489 +==== (% style="color:blue" %)**Step 3 : Connect private server**(%%) ==== 488 488 489 489 490 490 This is same as connect Dragino Support Server but just change the server address to customize server address. ... ... @@ -493,7 +493,7 @@ 493 493 494 494 495 495 496 -=== (% style="color:blue" %)**Step 4 : Check Connection**(%%) === 498 +==== (% style="color:blue" %)**Step 4 : Check Connection**(%%) ==== 497 497 498 498 499 499 Rssh Host connection Ok ... ... @@ -507,7 +507,7 @@ 507 507 508 508 509 509 510 -=== (% style="color:blue" %)**Step 5 : Access the gateway from customized server**(%%) === 512 +==== (% style="color:blue" %)**Step 5 : Access the gateway from customized server**(%%) ==== 511 511 512 512 513 513 Check what gateways link to server. ... ... @@ -529,3 +529,5 @@ 529 529 ))) 530 530 531 531 [[image:image-20220531153219-17.png]] 534 + 535 +
- 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