Version 89.1 by Kilight Cao on 2024/12/16 17:01

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