Version 100.1 by Kilight Cao on 2025/01/07 15:58

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