Version 101.1 by Kilight Cao on 2025/01/09 15:25

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