Last modified by Kilight Cao on 2025/01/14 10:25
<
From version < 25.7 >
edited by Xiaoling
on 2022/05/31 15:35
To version < 44.6 >
edited by Xiaoling
on 2022/07/25 17:25
>
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,4 +1,4 @@
1 -**Contents:**
1 +**Table of Contents:**
2 2  
3 3  {{toc/}}
4 4  
... ... @@ -5,17 +5,20 @@
5 5  
6 6  
7 7  
8 -= **1. Monitor Gateway** =
8 += **1.  Monitor Gateway** =
9 9  
10 -== **1.1 Introduction** ==
10 +== **1.1  Introduction** ==
11 11  
12 +
12 12  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]]
13 13  
14 -[[image:image-20220531144606-1.png]]
15 +[[image:image-20220531155018-18.png]]
15 15  
16 16  
17 -== **1.2 Steps** ==
18 18  
19 +== **1.2  Steps** ==
20 +
21 +
19 19  * Create account in ThingsSpeak and creat channel.
20 20  * Download script from dragino site and move it to properly directory
21 21  
... ... @@ -32,6 +32,7 @@
32 32  root@dragino-1baf44:~~#
33 33  )))
34 34  
38 +
35 35  * change the script monitor_gateway.sh with properly users setting:
36 36  
37 37  (% class="box infomessage" %)
... ... @@ -42,10 +42,11 @@
42 42  CHAN_KEY='xxxxx'   #Channel Write API  of the channel for this gateway
43 43  )))
44 44  
45 -* run **/usr/bin/monitor_gateway.sh** to test if upload is good.
46 46  
47 -* Add monitor_gateway.sh to cron work **/etc/crontabs/root** to make this script runs perdiocally, below is an example to update every 20 minutes
50 +* run (% style="color:blue" %)**/usr/bin/monitor_gateway.sh**(%%) to test if upload is good.
48 48  
52 +* 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
53 +
49 49  (% class="box infomessage" %)
50 50  (((
51 51  # For details see man 4 crontabs
... ... @@ -66,12 +66,14 @@
66 66  
67 67  
68 68  
69 -== **1.3 Monitor Public IP** ==
74 +== **1.3  Monitor Public IP** ==
70 70  
76 +
71 71  The monitor_gateway.sh has been updated to upload the public ip of the device as well.
72 72  
73 73  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.
74 74  
81 +
75 75  [[image:image-20220531145559-2.png]]
76 76  
77 77  Find Public IP
... ... @@ -78,25 +78,63 @@
78 78  
79 79  
80 80  
81 -= **2. Remote Access** =
88 += **2.  Remote Access** =
82 82  
83 -== **2.1 Remote Access via Remote.it.** ==
90 +== **2.1  Remote Access via Remote.it.** ==
84 84  
92 +
85 85  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.
86 86  
87 -Important Notice:
88 88  
96 +(% style="color:red" %)**Important Notice:**
97 +
89 89  * Remote.it access will give full control of your device to remote support.
90 -* The Remote.it allow Dragino Support to remote access to the device, If user want to access himself, it need to sign up for an remote.it account.
99 +* 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.
91 91  
92 -For how to use remoteit, please see : [[Remoteit user instruction for Dragino Gateway>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/&file=Dragino-Remoteit_User_Manual.pdf]].
101 +* For how to use remote.it for (% style="color:blue" %)**general remote control**(%%), please see :  [[Remoteit user instruction for Dragino Gateway>>url:https://www.dragino.com/downloads/index.php?dir=LoRa_Gateway/&file=Dragino-Remoteit_User_Manual.pdf]].
102 +* For Quick add remote.it to (% style="color:blue" %)**Dragino for remote debug**(%%), please see below:
93 93  
94 94  
95 -== **2.2 RSSH Introduction** ==
105 +(% style="color:blue" %)**1. Install the Remote.it software**
96 96  
107 +Users can directly click** "Install"** on the Web UI to install Remote. it.
108 +
109 +
110 +[[image:image-20220725134300-1.png||height="438" width="905"]]
111 +
112 +
113 +
114 +(% style="color:blue" %)**2. Enter the license key**
115 +
116 +Users need to enter the license key in the box under **"2. Register"** section and click the **"Save"** button and** "Register"** button.
117 +
118 +(% style="color:red" %)**When the user enters this license key, Dragino support will have access to your gateway.**
119 +
120 +
121 +(% class="box infomessage" %)
122 +(((
123 +**57F60715-606F-510D-A3D2-739860EBDB98**
124 +)))
125 +
126 +[[image:image-20220725113010-1.png||height="455" width="899"]]
127 +
128 +
129 +
130 +(% style="color:blue" %)**3. Connect and tell us your device ID or Hostname**
131 +
132 +Users can view the device ID or Hostname of the gateway on** (% style="color:red" %)System ~-~-> System Overview(%%)** interface.Such as : dragino-1ef9ac
133 +
134 +
135 +[[image:image-20220725115720-2.png||height="658" width="900"]]
136 +
137 +
138 +
139 +== **2.2  RSSH Introduction** ==
140 +
141 +
97 97  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.
98 98  
99 -Important Notice:
144 +(% style="color:red" %)**Important Notice:**
100 100  
101 101  (% class="box warningmessage" %)
102 102  (((
... ... @@ -104,8 +104,9 @@
104 104  This RSSH allow Dragino Support to remote access to the device, If user want to access himself, he need to set up the RSSH server himself.
105 105  )))
106 106  
107 -Below gateway support reverse SSH access:
108 108  
153 +**Below gateway support reverse SSH access:**
154 +
109 109  * 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/]]
110 110  * LG01N, OLG01N (Note: LG01-P LG01-S doesn't support)
111 111  * LG02, OLG02
... ... @@ -116,10 +116,13 @@
116 116  
117 117  
118 118  
119 -=== **2.2.1 End User Guide to use SSH access** ===
120 120  
166 +=== **2.2.1  End User Guide to use SSH access** ===
167 +
168 +
121 121  Go to this the Reverse SSH page as below:
122 122  
171 +
123 123  [[image:image-20220531150151-3.png]]
124 124  
125 125  Get the RSSH configure page
... ... @@ -131,28 +131,33 @@
131 131  Connection OK.
132 132  
133 133  
134 -* (% style="color:#037691" %)**Login ID**(%%): Input sshuser
135 -* (% style="color:#037691" %)**Host Address**(%%): Input support.dragino.com
136 -* (% style="color:#037691" %)**Host Port** (%%): Please email to support @ dragino.com to get a valid host port.
183 +* (% style="color:#037691" %)**Login ID**(%%):  Input sshuser
184 +* (% style="color:#037691" %)**Host Address**(%%):  Input support.dragino.com
185 +* (% style="color:#037691" %)**Host Port** (%%):  Please email to support @ dragino.com to get a valid host port.
137 137  * (% style="color:#037691" %)**Connect at Startup**(%%) : Choose to enable connect once the device is powered.
138 -* (% 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
187 +* (% 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
139 139  
140 140  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.
141 141  
142 142  
143 -=== **2.2.2 Set Up RSSH Server** ===
144 144  
193 +=== **2.2.2  Set Up RSSH Server** ===
194 +
195 +
145 145  Advance administrator can config a SSH server to provide support their end user themselves., Steps as below
146 146  
147 147  
148 -==== **2.2.2.1 Step 1:Download the SSH service code** ====
149 149  
150 -1).git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
200 +==== (% style="color:blue" %)**Step 1 :  Download the SSH service code**(%%) ====
151 151  
202 +
203 +**1).**  git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
204 +
152 152  [[image:image-20220531150750-5.png]]
153 153  
154 -2).cd rssh-server; sudo make ~-~--> to Generate the execute file：rssh_serv
155 155  
208 +**2).**  cd rssh-server; sudo make ~-~--> to Generate the execute file：rssh_serv
209 +
156 156  [[image:image-20220531150811-6.png]]
157 157  
158 158  
... ... @@ -182,36 +182,43 @@
182 182  [[image:image-20220531151628-8.png]]
183 183  
184 184  
185 -**How to install Sqlit3**
239 +(% style="color:blue" %)**How to install Sqlit3**
186 186  
187 187  (% class="box infomessage" %)
188 188  (((
189 - Step1:Download the SQLit3 installation package
190 - sudo wget **[[https:~~/~~/www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz>>url:https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz]]**
243 +**~ Step 1:** Download the SQLit3 installation package
244 + sudo wget **[[https:~~/~~/www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz>>url:https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz]]**
191 191  
192 -Step2:tar the SQLit3 installation package
246 +
247 +**Step 2: **tar the SQLit3 installation package
193 193   sudo tar -zxvf sqlite-autoconf-3350300.tar.gz
194 -Step3:Generate the makefile
249 +
250 +**Step 3:** Generate the makefile
195 195   cd sqlite-autoconf-3350300/;./configure
196 -Step4:Compile makefile
252 +
253 +**Step 4:** Compile makefile
197 197   sudo make
198 -Step5:Install makefile
255 +
256 +**Step 5:** Install makefile
199 199   sudo make install
200 -Check:
201 - cd /usr/local/bin;ls -al                             ~-~->    Check to see if there is a file for sqlite3
258 +
259 +**Check:**
260 + cd /usr/local/bin;ls -al  ~-~->    Check to see if there is a file for sqlite3
202 202   cd sqlite-autoconf-3350300/;./sqlite3 test.db        ~-~->    Test whether the sqlite3 was installed successfully
203 -debug:
262 +
263 +**debug:**
204 204   If you get the imformation that is SQLite header and source version mismatch, when you execute./sqlite3 test.db.
205 205   Please execute the command /sbin/ldconfig.
206 206   After that execute the command ./sqlite3 test.db again.
207 207  )))
208 208  
209 -===== =====
210 210  
211 -==== **2.2.2.2 Step 2 :Install and run the RSS service** ====
212 212  
213 -1):install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
271 +==== (% style="color:blue" %)**Step 2 :  Install and run the RSS service**(%%) ====
214 214  
273 +
274 +**1). ** install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
275 +
215 215  user must enter the root account and run the following commands
216 216  
217 217  (% class="box infomessage" %)
... ... @@ -234,30 +234,30 @@
234 234   please kill rssh_serv,and run ./rssh_serv -p 3721 2>&1 & again
235 235  }}}
236 236  
237 -===== =====
238 238  
239 -===== =====
240 240  
241 -==== **2.2.2.3 Step 3 :Create a minimal SSH user (reverse SSH proxy for the gateway)** ====
300 +==== (% style="color:blue" %)**Step 3 :  Create a minimal SSH user (reverse SSH proxy for the gateway)**(%%) ====
242 242  
302 +
243 243  (% class="box infomessage" %)
244 244  (((
245 -1):sudo useradd XXXXX (custom user name)
246 -2):sudo passwd xxxxxx
247 -3):cp /bin/bash /bin/rbash
248 -4):sudo nano /etc/passwd ~-~-> Change /bin/bash to /bin/rbash
249 -5):sudo nano /home/xxxxx/.bashrc **empty it,and input export PATH=$HOME/bin**
250 -6):sudo nano /home/xxxxx/.bash_profile **empty it,and input export PATH=$HOME/bin**
305 +**1):**  sudo useradd XXXXX (custom user name)
306 +**2):**  sudo passwd xxxxxx
307 +**3):**  cp /bin/bash /bin/rbash
308 +**4):**  sudo nano /etc/passwd ~-~-> Change /bin/bash to /bin/rbash
309 +**5):**  sudo nano /home/xxxxx/.bashrc **empty it,and input export PATH=$HOME/bin**
310 +**6):**  sudo nano /home/xxxxx/.bash_profile **empty it,and input export PATH=$HOME/bin**
251 251  )))
252 252  
253 -**Now user "XXXXX" is the user with limited permissions of the current system**
313 +(% style="color:red" %)**Now user "XXXXX" is the user with limited permissions of the current system**
254 254  
255 255  
256 256  
257 -==== **2.2.2.4 Step4:Create an authorization key file** ====
317 +==== (% style="color:blue" %)**Step 4 :  Create an authorization key file**(%%) ====
258 258  
259 -1):sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
260 260  
320 +**1):**  sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
321 +
261 261  **Debug:**
262 262  
263 263  {{{ check: sudo ls /home/xxxxx/.ssh/authorizedkey}}}
... ... @@ -264,25 +264,31 @@
264 264  
265 265  
266 266  
267 -=== **2.3 How does user get the gateway to connect to a user's private server** ===
328 +=== **2.2.3  How does user get the gateway to connect to a user's private server** ===
268 268  
269 269  
270 -==== **2.3.1 Step1: Come back the gateway web UI to get the gateway Public key** ====
271 271  
272 -1)in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span**
332 +==== (% style="color:blue" %)**Step 1 :  Come back the gateway web UI to get the gateway Public key**(%%) ====
273 273  
334 +
335 +**1)**  in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span**
336 +
274 274  [[image:image-20220531152419-11.png]]
275 275  
276 276  
277 -==== **2.3.2 Step2: Authorization server** ====
278 278  
341 +==== (% style="color:blue" %)**Step 2 :  Authorization server**(%%) ====
342 +
343 +
279 279  Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file.
280 280  
281 281  [[image:image-20220531152549-12.png]]
282 282  
283 283  
284 -===== **2.3.3 Step3: Connect private server** =====
285 285  
350 +==== (% style="color:blue" %)**Step 3 :  Connect private server**(%%) ====
351 +
352 +
286 286  This is same as connect Dragino Support Server but just change the server address to customize server address.
287 287  
288 288  [[image:image-20220531152633-13.png]]
... ... @@ -289,8 +289,9 @@
289 289  
290 290  
291 291  
292 -===== **2.3.4 Step 4 :Check Connection** =====
359 +==== (% style="color:blue" %)**Step 4 :  Check Connection**(%%) ====
293 293  
361 +
294 294  Rssh Host connection Ok
295 295  
296 296  [[image:image-20220531152815-14.png]]
... ... @@ -301,13 +301,15 @@
301 301  [[image:image-20220531152840-15.png]]
302 302  
303 303  
304 -==== **2.3.5 Step5:Access the gateway from customized server** ====
305 305  
373 +==== (% style="color:blue" %)**Step 5 :  Access the gateway from customized server**(%%) ====
374 +
375 +
306 306  Check what gateways link to server.
307 307  
308 308  (% class="box infomessage" %)
309 309  (((
310 -$ ./connect-gw.sh -l
380 +**$ ./connect-gw.sh -l**
311 311  )))
312 312  
313 313  [[image:image-20220531153016-16.png]]
... ... @@ -318,7 +318,9 @@
318 318  
319 319  (% class="box infomessage" %)
320 320  (((
321 -$ ./connect-gw.sh <GWID>
391 +**$ ./connect-gw.sh <GWID>**
322 322  )))
323 323  
324 324  [[image:image-20220531153219-17.png]]
395 +
396 +
image-20220531155018-18.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Xiaoling
Size
... ... @@ -1,0 +1,1 @@
1 +45.3 KB
Content
image-20220725113010-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +58.9 KB
Content
image-20220725115720-2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +81.7 KB
Content
image-20220725134300-1.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.Kilight
Size
... ... @@ -1,0 +1,1 @@
1 +53.5 KB
Content

Applications

Navigation

Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0