Version 91.1 by Kilight Cao on 2024/12/16 17:18

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