Version 96.1 by Kilight Cao on 2025/01/06 09:19

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