Version 103.1 by Kilight Cao on 2025/01/09 15:27

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