Last modified by Kilight Cao on 2025/05/09 11:46

From version 31.2
edited by Xiaoling
on 2022/07/14 11:19
Change comment: There is no comment for this version
To version 8.3
edited by Xiaoling
on 2022/05/31 14:44
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,24 +1,18 @@
1 -**Table of Contents:**
2 -
1 +{{box cssClass="floatinginfobox" title="**Contents**"}}
3 3  {{toc/}}
3 +{{/box}}
4 4  
5 += 1. Monitor Gateway =
5 5  
7 +== 1.1 Introduction ==
6 6  
7 -
8 -= **1.  Monitor Gateway** =
9 -
10 -== **1.1  Introduction** ==
11 -
12 -
13 13  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]]
14 14  
15 -[[image:image-20220531155018-18.png]]
11 +[[image:https://wiki.dragino.com/images/thumb/d/dc/Monitor_gateway.png/600px-Monitor_gateway.png||height="393" width="517"]]
16 16  
17 17  
14 +== 1.2 Steps ==
18 18  
19 -== **1.2  Steps** ==
20 -
21 -
22 22  * Create account in ThingsSpeak and creat channel.
23 23  * Download script from dragino site and move it to properly directory
24 24  
... ... @@ -69,37 +69,33 @@
69 69  
70 70  
71 71  
66 +== 1.3 Monitor Public IP ==
72 72  
73 -== **1.3  Monitor Public IP** ==
74 -
75 -
76 76  The monitor_gateway.sh has been updated to upload the public ip of the device as well.
77 77  
78 78  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.
79 79  
80 -[[image:image-20220531145559-2.png]]
72 +[[~[~[image:https://wiki.dragino.com/images/thumb/8/8f/Monitor_gateway_1.png/600px-Monitor_gateway_1.png~|~|height="332" width="586"~]~]>>url:https://wiki.dragino.com/index.php/File:Monitor_gateway_1.png]]
81 81  
82 82  Find Public IP
83 83  
84 84  
85 85  
86 -= **2.  Remote Access** =
78 += Remote Access =
87 87  
88 -== **2.1  Remote Access via Remote.it.** ==
80 +== Remote Access via Remote.it. ==
89 89  
90 -
91 91  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.
92 92  
84 +Important Notice:
93 93  
94 -(% style="color:red" %)**Important Notice:**
95 -
96 96  * Remote.it access will give full control of your device to remote support.
97 97  * 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.
98 98  
99 -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]].
89 +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]].
100 100  
101 101  
102 -== **2.2  RSSH Introduction** ==
92 +== RSSH Introduction ==
103 103  
104 104  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.
105 105  
... ... @@ -121,124 +121,99 @@
121 121  * LIG16
122 122  * MS14 series if installed with the same firmware.
123 123  
124 -=== **2.2.1  End User Guide to use SSH access** ===
114 +=== End User Guide to use SSH access ===
125 125  
126 -
127 127  Go to this the Reverse SSH page as below:
128 128  
129 -[[image:image-20220531150151-3.png]]
118 +[[~[~[image:https://wiki.dragino.com/images/thumb/5/55/RSSH_Menu2.png/500px-RSSH_Menu2.png~|~|height="256" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:RSSH_Menu2.png]]
130 130  
131 131  Get the RSSH configure page
132 132  
122 +[[~[~[image:https://wiki.dragino.com/images/thumb/7/78/RSSH_Menu3.png/500px-RSSH_Menu3.png~|~|height="313" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:RSSH_Menu3.png]]
133 133  
134 -
135 -[[image:image-20220531150338-4.png]]
136 -
137 137  Connection OK.
138 138  
126 +* **Login ID**: Input sshuser
127 +* **Host Address**: Input support.dragino.com
128 +* **Host Port** : Please email to support @ dragino.com to get a valid host port.
129 +* **Connect at Startup** : Choose to enable connect once the device is powered.
130 +* **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 -* (% style="color:#037691" %)**Login ID**(%%):  Input sshuser
141 -* (% style="color:#037691" %)**Host Address**(%%):  Input support.dragino.com
142 -* (% style="color:#037691" %)**Host Port** (%%):  Please email to support @ dragino.com to get a valid host port.
143 -* (% style="color:#037691" %)**Connect at Startup**(%%) : Choose to enable connect once the device is powered.
144 -* (% 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
145 -
146 146  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.
147 147  
148 148  
135 +=== Set Up RSSH Server ===
149 149  
150 -=== **2.2.2  Set Up RSSH Server** ===
151 -
152 152  Advance administrator can config a SSH server to provide support their end user themselves., Steps as below
153 153  
139 +==== Step 1:Download the SSH service code ====
154 154  
141 +1).git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
155 155  
156 -==== **2.2.2.1  Step 1 : Download the SSH service code** ====
143 +[[~[~[image:https://wiki.dragino.com/images/thumb/d/d0/Git_clone.png/500px-Git_clone.png~|~|height="89" width="555"~]~]>>url:https://wiki.dragino.com/index.php/File:Git_clone.png]]
157 157  
145 +2).cd rssh-server; sudo make ~-~--> to Generate the execute file:rssh_serv
158 158  
159 -**1).**  git clone [[https:~~/~~/github.com/dragino/rssh-server.git>>url:https://github.com/dragino/rssh-server.git]] rssh-server
147 +[[~[~[image:https://wiki.dragino.com/images/thumb/e/e3/Generate_the_execute_file.png/500px-Generate_the_execute_file.png~|~|height="114" width="554"~]~]>>url:https://wiki.dragino.com/index.php/File:Generate_the_execute_file.png]]
160 160  
161 -[[image:image-20220531150750-5.png]]
162 162  
163 -
164 -**2).**  cd rssh-server; sudo make ~-~--> to Generate the execute file:rssh_serv
165 -
166 -[[image:image-20220531150811-6.png]]
167 -
168 -
169 169  **Debug** :
170 170  
171 -(((
172 -(% class="box" %)
173 -(((
174 -if you git fail.  ~-~->  (% style="color:#037691" %)**sudo: git: command not found**(%%).
175 -please install git.  ~-~->    (% style="color:#037691" %)**yum install git -y  or  apt-get install git -y**(%%).
176 -if you make error 127,it** (% style="color:#037691" %)lack of gcc(%%)**.
177 -please install gcc.  ~-~->  (% style="color:#037691" %)**yum install gcc**(%%).
178 -)))
179 -)))
152 +{{{ if you git fail. --> sudo: git: command not found.
153 + please install git. --> yum install git -y or apt-get install git -y.
154 + if you make error 127,it lack of gcc.
155 + please install gcc. -->yum install gcc.
156 +}}}
180 180  
181 -[[image:image-20220531151516-7.png]]
158 +[[~[~[image:https://wiki.dragino.com/images/d/d7/Lack_of_gcc.png~|~|height="174" width="434"~]~]>>url:https://wiki.dragino.com/index.php/File:Lack_of_gcc.png]]
182 182  
183 183  
184 -(((
185 -(% class="box" %)
186 -(((
187 -if you make a fatal error : sqlite3.h,it (% style="color:#037691" %)**lack of sqlite3**(%%).
188 -please insatell sqlite3.
189 -)))
190 -)))
161 +{{{ if you make a fatal error : sqlite3.h,it lack of sqlite3.
162 + please insatell sqlite3.
163 +}}}
191 191  
192 -[[image:image-20220531151628-8.png]]
165 +[[~[~[image:https://wiki.dragino.com/images/thumb/9/93/Lack_of_sqlite3.png/500px-Lack_of_sqlite3.png~|~|height="137" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Lack_of_sqlite3.png]]
193 193  
194 194  
195 -(% style="color:blue" %)**How to install Sqlit3**
168 +**How to install Sqlit3**
196 196  
197 197  (% class="box infomessage" %)
198 198  (((
199 -**~ Step1:** Download the SQLit3 installation package
200 - sudo wget **[[https:~~/~~/www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz>>url:https://www.sqlite.org/2021/sqlite-autoconf-3350400.tar.gz]]**
201 -
202 -
203 -**Step2: **tar the SQLit3 installation package
172 + Step1:Download the SQLit3 installation package
173 + sudo wget
174 +Step2:tar the SQLit3 installation package
204 204   sudo tar -zxvf sqlite-autoconf-3350300.tar.gz
205 -
206 -**Step3:** Generate the makefile
176 +Step3:Generate the makefile
207 207   cd sqlite-autoconf-3350300/;./configure
208 -
209 -**Step4:** Compile makefile
178 +Step4:Compile makefile
210 210   sudo make
211 -
212 -**Step5:** Install makefile
180 +Step5:Install makefile
213 213   sudo make install
214 -
215 -**Check:**
182 +Check:
216 216   cd /usr/local/bin;ls -al                             ~-~->    Check to see if there is a file for sqlite3
217 217   cd sqlite-autoconf-3350300/;./sqlite3 test.db        ~-~->    Test whether the sqlite3 was installed successfully
218 -
219 -**debug:**
185 +debug:
220 220   If you get the imformation that is SQLite header and source version mismatch, when you execute./sqlite3 test.db.
221 221   Please execute the command /sbin/ldconfig.
222 222   After that execute the command ./sqlite3 test.db again.
223 223  )))
224 224  
191 +===== =====
225 225  
193 +==== Step 2 :Install and run the RSS service ====
226 226  
227 -==== **2.2.2.2  Step 2 : Install and run the RSS service** ====
195 +1):install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
228 228  
229 -
230 -**1). ** install database for /var/rsshdb.sqlite3 and Server development port for 3721(The default is 3721)
231 -
232 232  user must enter the root account and run the following commands
233 233  
234 234  (% class="box infomessage" %)
235 235  (((
236 -$ ./create_sqlite3_db.sh
201 + $ ./create_sqlite3_db.sh
237 237  $ ./rssh_serv -p  3721 2>&1 &
238 238  $ ps -ef | grep rssh_serv check 3721 port
239 239  )))
240 240  
241 -[[image:image-20220531151958-10.png]]
206 +[[~[~[image:https://wiki.dragino.com/images/thumb/c/cb/Intall_database_and_server_development_port.png/500px-Intall_database_and_server_development_port.png~|~|height="70" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Intall_database_and_server_development_port.png]]
242 242  
243 243  
244 244  **Debug:**
... ... @@ -251,30 +251,29 @@
251 251   please kill rssh_serv,and run ./rssh_serv -p 3721 2>&1 & again
252 252  }}}
253 253  
219 +===== =====
254 254  
221 +===== =====
255 255  
256 -==== **2.2.2.3  Step 3 : Create a minimal SSH user (reverse SSH proxy for the gateway)** ====
223 +==== Step 3 :Create a minimal SSH user (reverse SSH proxy for the gateway) ====
257 257  
258 -
259 259  (% class="box infomessage" %)
260 260  (((
261 -**1):**  sudo useradd XXXXX (custom user name)
262 -**2):**  sudo passwd xxxxxx
263 -**3):**  cp /bin/bash /bin/rbash
264 -**4):**  sudo nano /etc/passwd ~-~-> Change /bin/bash to /bin/rbash
265 -**5):**  sudo nano /home/xxxxx/.bashrc **empty it,and input export PATH=$HOME/bin**
266 -**6):**  sudo nano /home/xxxxx/.bash_profile **empty it,and input export PATH=$HOME/bin**
227 +1):sudo useradd XXXXX (custom user name)
228 +2):sudo passwd xxxxxx
229 +3):cp /bin/bash /bin/rbash
230 +4):sudo nano /etc/passwd ~-~-> Change /bin/bash to /bin/rbash
231 +5):sudo nano /home/xxxxx/.bashrc **empty it,and input export PATH=$HOME/bin**
232 +6):sudo nano /home/xxxxx/.bash_profile **empty it,and input export PATH=$HOME/bin**
267 267  )))
268 268  
269 -(% style="color:red" %)**Now user "XXXXX" is the user with limited permissions of the current system**
235 +**Now user "XXXXX" is the user with limited permissions of the current system**
270 270  
271 271  
238 +==== Step4:Create an authorization key file ====
272 272  
273 -==== **2.2.2.4  Step 4 : Create an authorization key file** ====
240 +1):sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
274 274  
275 -
276 -**1):**  sudo mkdir /home/xxxxx/.ssh; sudo touch /home/xxxxx/.ssh/authorizedkey
277 -
278 278  **Debug:**
279 279  
280 280  {{{ check: sudo ls /home/xxxxx/.ssh/authorizedkey}}}
... ... @@ -281,71 +281,54 @@
281 281  
282 282  
283 283  
284 -=== **2.2.3  How does user get the gateway to connect to a user's private server** ===
248 +=== How does user get the gateway to connect to a user's private server ===
285 285  
250 +==== Step1: Come back the gateway web UI to get the gateway Public key ====
286 286  
287 -==== **2.2.3.1  Step 1 : Come back the gateway web UI to get the gateway Public key** ====
252 +1)in the system ~-~-> Remote Mgmt/span>
288 288  
254 +[[~[~[image:https://wiki.dragino.com/images/thumb/8/8f/Remote_Mgmt.png/500px-Remote_Mgmt.png~|~|height="367" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Remote_Mgmt.png]]
289 289  
290 -**1)**  in the system ~-~-> (% style="color:#037691" %)**Remote Mgmt/span**
291 291  
292 -[[image:image-20220531152419-11.png]]
257 +==== Step2: Authorization server ====
293 293  
294 -
295 -
296 -==== **2.2.3.2  Step 2 : Authorization server** ====
297 -
298 -
299 299  Input the Gateway Publickey into user's private server "/home/XXXXX/.ssh/authorized_keys" file.
300 300  
301 -[[image:image-20220531152549-12.png]]
261 +[[~[~[image:https://wiki.dragino.com/images/thumb/4/49/Publickey.png/500px-Publickey.png~|~|height="81" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Publickey.png]]
302 302  
303 303  
264 +===== Step3: Connect private server =====
304 304  
305 -==== **2.2.3.3  Step 3 : Connect private server** ====
306 -
307 -
308 308  This is same as connect Dragino Support Server but just change the server address to customize server address.
309 309  
310 -[[image:image-20220531152633-13.png]]
268 +[[~[~[image:https://wiki.dragino.com/images/thumb/0/04/Gateway_web_UI.png/500px-Gateway_web_UI.png~|~|height="389" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Gateway_web_UI.png]]
311 311  
312 312  
313 313  
314 -==== **2.2.3.4  Step 4 : Check Connection** ====
272 +===== Step 4 :Check Connection =====
315 315  
316 -
317 317  Rssh Host connection Ok
318 318  
319 -[[image:image-20220531152815-14.png]]
276 +[[~[~[image:https://wiki.dragino.com/images/thumb/6/6f/Rssh_Host_connection_Ok.png/500px-Rssh_Host_connection_Ok.png~|~|height="225" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Rssh_Host_connection_Ok.png]]
320 320  
321 321  
322 322  User can use common ps | grep ssh to check it in the gateway.
323 323  
324 -[[image:image-20220531152840-15.png]]
281 +[[~[~[image:https://wiki.dragino.com/images/thumb/a/ad/Check_the_gateway.png/500px-Check_the_gateway.png~|~|height="47" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Check_the_gateway.png]]
325 325  
326 326  
284 +==== Step5:Access the gateway from customized server ====
327 327  
328 -==== **2.2.3.5  Step 5 : Access the gateway from customized server** ====
329 -
330 -
331 331  Check what gateways link to server.
332 332  
333 -(% class="box infomessage" %)
334 -(((
335 335  $ ./connect-gw.sh -l
336 -)))
337 337  
338 -[[image:image-20220531153016-16.png]]
290 +[[~[~[image:https://wiki.dragino.com/images/thumb/e/ee/Check_gateway_link_server.png/500px-Check_gateway_link_server.png~|~|height="157" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Check_gateway_link_server.png]]
339 339  
340 340  
341 341  
342 342  Access the gateway
343 343  
344 -(% class="box infomessage" %)
345 -(((
346 346  $ ./connect-gw.sh <GWID>
347 -)))
348 348  
349 -[[image:image-20220531153219-17.png]]
350 -
351 -
298 +[[~[~[image:https://wiki.dragino.com/images/thumb/b/b7/Reverse_ssh_access_the_gateway1.png/500px-Reverse_ssh_access_the_gateway1.png~|~|height="230" width="500"~]~]>>url:https://wiki.dragino.com/index.php/File:Reverse_ssh_access_the_gateway1.png]]
image-20220531144606-1.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -59.0 KB
Content
image-20220531145559-2.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -118.5 KB
Content
image-20220531150151-3.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -52.5 KB
Content
image-20220531150338-4.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -40.3 KB
Content
image-20220531150750-5.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -13.3 KB
Content
image-20220531150811-6.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -29.7 KB
Content
image-20220531151516-7.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -9.9 KB
Content
image-20220531151628-8.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -11.7 KB
Content
image-20220531151858-9.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -8.4 KB
Content
image-20220531151958-10.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -8.5 KB
Content
image-20220531152419-11.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -79.6 KB
Content
image-20220531152549-12.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -30.6 KB
Content
image-20220531152633-13.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -66.7 KB
Content
image-20220531152815-14.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -22.5 KB
Content
image-20220531152840-15.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -13.6 KB
Content
image-20220531153016-16.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -9.3 KB
Content
image-20220531153219-17.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -28.8 KB
Content
image-20220531155018-18.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.Xiaoling
Size
... ... @@ -1,1 +1,0 @@
1 -45.3 KB
Content