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