Hide last authors
Kilight Cao 15.1 1 **Table of Contents:**
2
3 {{toc/}}
4
Edwin Chen 1.1 5
Xiaoling 50.1 6
7
Xiaoling 48.2 8 = 1.  Overview =
9
10
Edwin Chen 1.1 11 This is a general instruction for the use of Armbian base OS of Dragino devices. Current models include:
12
13 * HP0A
14 * HP0C
15 * LPS8v2
Edwin Chen 55.1 16 * MS20
Edwin Chen 1.1 17
Xiaoling 90.3 18 (% style="display:none" %)
Xiaoling 90.2 19
20
Xiaoling 48.2 21 = 2.  Development Guide =
22
23
Xiaoling 70.4 24 For advanced users to develop Driver/ Linux etc.
Edwin Chen 4.1 25
Kilight Cao 25.1 26
Xiaoling 48.2 27 == 2.1  How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). ==
Edwin Chen 4.1 28
29
Xiaoling 48.3 30 === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) ===
Edwin Chen 4.1 31
Kilight Cao 30.1 32
Xiaoling 70.4 33 **Requirements:**
Xiaoling 48.3 34
Xiaoling 70.4 35 **~ (% style="background-color:yellow; color:green" %)sudo apt install -y libsqlite3-dev(%%)**
Kilight Cao 30.1 36
Xiaoling 70.4 37 **~ (% style="background-color:yellow; color:green" %)sudo apt install -y libftdi1-dev(%%)**
Kilight Cao 11.1 38
Xiaoling 48.3 39
Xiaoling 70.4 40 **Run command clone dragino-fwd package: (% style="background-color:yellow; color:green" %)git clone https:~/~/github.com/dragino/dragino_fwd_src.git(%%)**
Kilight Cao 11.1 41
Xiaoling 70.4 42
Kilight Cao 11.1 43 [[image:image-20220527151010-1.png]]
44
45
Xiaoling 48.3 46 === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) ===
Kilight Cao 48.1 47
Kilight Cao 11.1 48
Xiaoling 70.4 49 **After cloning is complete, Run the command starts compiling:**
Xiaoling 48.3 50
Xiaoling 70.5 51 (% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd:  ./hp0z-make-deb.sh c**
Xiaoling 70.4 52
Xiaoling 70.5 53
Kilight Cao 11.1 54 The following example compilers HP0C fwd.
55
56 [[image:image-20220527153913-3.png]]
57
58
59
Xiaoling 70.5 60 When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated.
61
Kilight Cao 11.1 62 [[image:image-20220527154311-4.png||height="385" width="773"]]
63
Kilight Cao 25.1 64
Xiaoling 48.3 65 === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) ===
Kilight Cao 11.1 66
Kilight Cao 14.1 67
Xiaoling 70.4 68 **Run command:**
Kilight Cao 11.1 69
Xiaoling 70.5 70 (% style="background-color:yellow; color:green" %)**dpkg -i draginofwd-*.deb **
Kilight Cao 11.1 71
Xiaoling 70.4 72
Kilight Cao 11.1 73 [[image:image-20220527154811-5.png]]
74
75
Xiaoling 48.3 76 === (% style="color:blue" %)**Step 4. Test**(%%) ===
Kilight Cao 14.1 77
Xiaoling 48.3 78
Xiaoling 70.5 79 **Check the dragino_fwd log:**
Kilight Cao 11.1 80
Xiaoling 70.5 81 (% style="background-color:yellow; color:green" %)**journalctl -u draginofwd -f**
Kilight Cao 11.1 82
Xiaoling 70.4 83
Kilight Cao 13.1 84 [[image:image-20220527165221-7.png||height="182" width="931"]]
Kilight Cao 11.1 85
Xiaoling 48.3 86
Xiaoling 70.5 87 **Start/stop dragino_fwd via systemctl:**
Kilight Cao 11.1 88
Xiaoling 70.5 89 (% style="background-color:yellow; color:green" %)**systemctl start draginofwd**
Kilight Cao 13.1 90
Xiaoling 70.5 91 (% style="background-color:yellow; color:green" %)**systemctl stop draginofwd**
Xiaoye 46.1 92
Kilight Cao 13.1 93
Xiaoling 48.3 94 == 2.2  How to clone Complete OS on the EMMC to SD card ==
Kilight Cao 27.1 95
Xiaoling 48.3 96
Xiaoye 113.1 97 **2.2.1 Prepare a USB flash drive/SD card and plug it into the USB port of the gateway.**
Xiaoling 67.2 98
Xiaoye 51.1 99
Xiaoye 114.1 100
101
Xiaoye 113.1 102 **2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI**
Xiaoye 51.1 103
104
105
106
Xiaoye 114.1 107 **2.2.3 Using the dd command, copy Emmc as an img file**
108
109
110 dd if=/etc/sidmem of=/dev/mmcblk2p2 bs=1M count=1
111
112
113
Xiaoye 113.1 114 **2.2.4 Export the img file and follow the steps in 2.3 for burning**
Xiaoye 51.1 115
116
Xiaoye 102.1 117 == 2.3  How to flash a new image(OS) to the gateway(LPS8V2) ==
Xiaoye 98.1 118
119
Xiaoye 102.1 120 Since the gateway has a large system, you need to use the sd card to reflash the system for the gateway
Xiaoye 98.1 121
Xiaoye 102.1 122
123 //2.3.1: Making an SD card with the new image//
124
125 //2.3.2: Instal the SD card to the gateway//
126
127 //2.3.3: Flash the image to the gateway's built memory from the SD card//
128
129 //2.3.4: Finished the process of flash and power cycle the gateway//
130
131
Xiaoye 98.1 132 ==== (% style="background-color:yellow" %)**//Preparations~://**(%%) ====
133
Xiaoye 102.1 134 1. Prepare an SD card
135 1. Prepare a card reader device
Kilight Cao 112.1 136 1. Download the OS image from the release.image~: **[[draginolps8v2-release-v1.7>>http://repo.dragino.com/release/hp0c-image/]]**
Xiaoye 98.1 137 1. A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] )
Xiaoye 102.1 138 1. SD Card [[format>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]] tool
Xiaoye 98.1 139
Xiaoye 102.1 140 === **2.3.1 Making an SD Card with the new image** ===
141
142
Kilight Cao 97.1 143 ==== Step 1.  Formatting the SD Card ====
144
145 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609111027-9.png?rev=1.1||alt="image-20220609111027-9.png" height="318" width="292"]]
146
147
148 ==== Step 2. Select the OS image ====
149
150 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104907-8.png?rev=1.1||alt="image-20220609104907-8.png" height="435" width="689"]]
151
152
153 ==== Step 3. Select the target ====
154
155 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104637-2.png?rev=1.1||alt="image-20220609104637-2.png" height="436" width="690"]]
156
157 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104701-3.png?rev=1.1||alt="image-20220609104701-3.png" height="436" width="690"]]
158
159
160 ==== Step 4. Flash start ====
161
162 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104727-4.png?rev=1.1||alt="image-20220609104727-4.png" height="435" width="689"]]
163
164 [[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104741-5.png?rev=1.1||alt="image-20220609104741-5.png" height="434" width="687"]]
165
166
167
Xiaoye 102.1 168 === **2.3.2 Instal the SD card to the gateway** ===
Xiaoling 67.2 169
Xiaoye 98.1 170 1. Open the device's enclosure, and put the SD card into the SD card slot
Xiaoye 51.1 171
Xiaoye 102.1 172 [[image:image-20230712201032-1.png]]
Xiaoye 51.1 173
Kilight Cao 97.1 174
Xiaoye 102.1 175 2. Power the gateway with 5V2A, and access the gateway's Ethernet port to your PC
Kilight Cao 97.1 176
Xiaoye 102.1 177 [[image:image-20230712201458-3.png||height="649" width="832"]]
Kilight Cao 97.1 178
179
Xiaoye 102.1 180 Note: The PWR LED on red
Kilight Cao 97.1 181
Xiaoye 102.1 182 The  LAN LED blink
Kilight Cao 97.1 183
Xiaoye 102.1 184 The SYS LED on red
Kilight Cao 97.1 185
Xiaoye 102.1 186
187
Kilight Cao 115.1 188 === **3.2.3 Flash the image to the gateway's built memory from the SD card(LPS8v2)** ===
Xiaoye 102.1 189
190
191 Access the gateway Linux CLI to flash the image to the gateway's built memory
192
193
194 * **Use the IP address to access the gateway CLI**
195
Xiaoye 98.1 196 Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.
Kilight Cao 97.1 197
198
199 IP address:  IP address of gateway or **Fallback IP**(172.31.255.254)
200
201 Port:  22
202
203 User Name:      (% style="color:blue" %)**root**
204
205 Password:         (% style="color:blue" %)**dragino**(%%) (default)
206
207 //After logging in, you will be in the gateway CLI and can enter commands as shown below.//
208
209
210 [[image:image-20230508155357-1.png||height="225" width="634"]]
211
212
Xiaoling 70.4 213 **Run command:**
Kilight Cao 27.1 214
Kilight Cao 112.1 215 draginolps8v2-release-chirpsrtack-v1.7-240725 image :
Kilight Cao 27.1 216
Kilight Cao 112.1 217 (% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img **
Xiaoling 70.4 218
Kilight Cao 112.1 219 draginolps8v2-release-ttnstack-v1.7-240712 image :
Kilight Cao 27.1 220
Kilight Cao 112.1 221 (% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img**
Kilight Cao 28.1 222
Kilight Cao 112.1 223 [[image:image-20241008091850-2.png]]
Kilight Cao 27.1 224
Kilight Cao 112.1 225 (% style="color:red" %)**Note: Note: After the flash is completed, please power off the device (run the command halt) and disconnect the power supply, and then unplug the SD card.**
Xiaoling 70.7 226
Kilight Cao 27.1 227
Kilight Cao 115.1 228 == **3.2.4 Flash the image to the gateway's built memory from the SD card(MS48-LR)** ==
229
230
231 Download the OS image from the release.image~: **[[MS48-LR-image>>https://www.dropbox.com/scl/fi/ug25bbwyk6gnqjnsee2m1/dragino-MS48-LR-231124.rar?rlkey=bqva7hkeft0m3haiui5uj12sv&st=ii6mp2g7&dl=0]]**
232
233 === ===
234
235 Access the gateway Linux CLI to flash the image to the gateway's built memory
236
237 * **Use the IP address to access the gateway CLI**
238
239 Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it.
240
241 IP address:  IP address of gateway or **Fallback IP**(172.31.255.254)
242
243 Port:  22
244
245 User Name:      **root**
246
247 Password:         **dragino** (default)
248
249 //After logging in, you will be in the gateway CLI and can enter commands as shown below.//
250
251 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20230508155357-1.png?rev=1.1&width=634&height=225||alt="image-20230508155357-1.png" height="225" width="634"]]
252
253 **Run command:**
254
255 **nand-sata-install**
256
257 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112051-1.png?rev=1.1||alt="image-20220602112051-1.png"]]
258
259 Select the **"Boot from eMMC - system on eMMC".**
260
261 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112058-2.png?rev=1.1&width=646&height=292||alt="image-20220602112058-2.png" height="292" width="646"]]
262
263 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112106-3.png?rev=1.1&width=643&height=301||alt="image-20220602112106-3.png" height="301" width="643"]]
264
265 Select the **"1  ext4"**
266
267 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112113-4.png?rev=1.1&width=642&height=271||alt="image-20220602112113-4.png" height="271" width="642"]]
268
269 It takes 4-5 minutes to burn from SD card to eMMC
270
271 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112119-5.png?rev=1.1&width=641&height=309||alt="image-20220602112119-5.png" height="309" width="641"]]
272
273 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112125-6.png?rev=1.1&width=640&height=281||alt="image-20220602112125-6.png" height="281" width="640"]]
274
275 [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112131-7.png?rev=1.1&width=638&height=241||alt="image-20220602112131-7.png" height="241" width="638"]]
276
277 **Note: After the flash is complete, power off the device and then remove the SD card.**
278
279
Kilight Cao 107.1 280 == 2.4 How to extend the gateway size of memory with SD card ==
Xiaoling 67.2 281
Xiaoling 72.2 282
Kilight Cao 107.1 283 Users can use the SD card slot to expand the gateway memory size by following the steps below
284
285
286 === 2.4.1 View SD card information ===
287
288 (% class="box infomessage" %)
289 (((
290 fdisk -l
291 )))
292
293 [[image:image-20230831150518-3.png]]
294
295
296 === 2.4.2 Displays the current file system disk usage statistics on Linux systems ===
297
298
299 (% class="box infomessage" %)
300 (((
301 df -h
302 )))
303
304 [[image:image-20230831150341-2.png]]
305
306
307 === 2.4.3 Mount SD card ===
308
309
310 (% class="box infomessage" %)
311 (((
312 mkdir /mnt/sd
313
314 mount /dev/mmcblk0p1 /mnt/sd
315 )))
316
317 After the mount is successful to check the file system disk usage on the Linux system again:
318
319 [[image:image-20230831151432-4.png]]
320
321
322 If the mount fails, you can format the file system and try the mount again
323
324 (% class="box infomessage" %)
325 (((
326 mkfs.ext4 /dev/mmcblk0p1
327 )))
328
329 == 2.5 Default Built Version ==
330
331
Edwin Chen 72.1 332 [[image:image-20220902155621-1.png]]
333
334
Kilight Cao 107.1 335 == 2.6 How to upgrade the nodejs version to the latest. ==
Edwin Chen 72.1 336
Xiaoye 78.1 337
338 By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old.
339
340 [[image:image-20221112145029-2.png]]
341
342 **If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.**
343
344
345 #install n, which is an Interactively Manage Your Node.js Versions
346
Xiaoye 83.1 347 [[image:image-20221112154230-3.png||height="89" width="689"]]
Xiaoye 78.1 348
349 (% class="box infomessage" %)
350 (((
351 **npm install -g n**
352 )))
353
354
355 #Install the latest LTS Node.js release (downloading if necessary)
356
Xiaoye 83.1 357 [[image:image-20221112154418-4.png||height="184" width="893"]]
358
Xiaoye 78.1 359 (% class="box infomessage" %)
360 (((
361 **n lts**
362 )))
363
364
365 #Remove all downloaded versions except the installed version
366
Xiaoye 83.1 367 [[image:image-20221112154456-5.png||height="139" width="899"]]
Xiaoye 78.1 368
369 (% class="box infomessage" %)
370 (((
371 **n prune**
372 )))
373
374
375 (% class="box infomessage" %)
376 (((
Xiaoye 83.1 377 **apt remove nodejs -y && apt autoremove -y && reboot**
Xiaoye 78.1 378 )))
379
380
381 Check the current version
382
Xiaoye 83.1 383 [[image:image-20221112154724-6.png]]
Xiaoye 78.1 384
385 (% class="box infomessage" %)
386 (((
387 **node -v**
388 )))
389
390
Kilight Cao 107.1 391 == 2.7 How to install Grafana and influxdb ==
Xiaoye 84.1 392
393
394 === **Grafana:** ===
395
396
397 (% class="box infomessage" %)
398 (((
399 curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null
400 echo "deb [signed-by=/usr/share/keyrings/grafana-archive-keyrings.gpg] https:~/~/packages.grafana.com/oss/deb stable main" | sudo tee /etc/apt/sources.list.d/grafana.list
401 apt update && apt install grafana
402 )))
403
404
405 Check the running status:
406
407
408 (% class="box infomessage" %)
409 (((
410 systemctl status grafana-server
411 )))
412
413
414 configuration path:
415
416
417 (% class="box infomessage" %)
418 (((
419 /etc/grafana/grafana.ini
420 )))
421
422
423 === **Influxdb:** ===
424
425
426 (% class="box infomessage" %)
427 (((
Kilight Cao 109.1 428 curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null
Xiaoye 84.1 429 echo "deb [signed-by=/usr/share/keyrings/influxdb-archive-keyring.gpg] https:~/~/repos.influxdata.com/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/influxdb.list
430 apt update && apt install influxdb
431 )))
432
433
434 Check the running status:
435
436
437 (% class="box infomessage" %)
438 (((
439 systemctl status influxdb
440 )))
441
442
443 configuration path:
444
445
446 (% class="box infomessage" %)
447 (((
448 /etc/influxdb/influxdb.conf
449 )))
450
451
Xiaoling 95.6 452 = 3.  Package Management =
453
Kilight Cao 95.1 454 == 3.1 Default Package Maintain System ==
455
Xiaoling 95.6 456 === 3.1.1  How Package-Auto-Update works? ===
Kilight Cao 95.1 457
458
Xiaoling 67.2 459 By default, LPS8v2 / MS20 series products have an auto-update feature for main packages. The device will connect to Dragino's auto-update server and check for updates. 
460
461
462 (% style="color:blue" %)**When devices will check for updates**?
463
464 * Devices will check for updates for every boot.
465 * Devices will check for updates on every day midnight.
466
467 (% style="color:blue" %)**What packages will be checked for updates**?
468
469 dragino-httpd ~-~- Main Web UI http configuration
470
471 dragino-sid  ~-~- SN write and read tool
472
473 dragino-ui  ~-~- Gateway Web UI package
474
475 draginofwd   ~-~- UDP packet forwarder, LoRa Base Station
476
477 draginoups   ~-~- Miscellaneous between different versions
478
479
Xiaoling 70.9 480
Xiaoling 67.2 481 (% style="color:blue" %)**Location and changelog for packages**:
482
483 * Location: http:~/~/repo.dragino.com/release/tool/
484 * Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]]
485
486 (% style="color:blue" %)**How to view auto-updated log**
487
488 You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.**
489
490
491 [[image:1661305025451-220.png]]
492
493
Xiaoling 70.7 494
Xiaoling 67.2 495 (% style="color:blue" %)**Can I disable package-auto-update?**
496
Xiaoling 70.8 497 You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.
Xiaoling 67.2 498
499
500 [[image:1661305258501-636.png]]
501
502
Kilight Cao 95.1 503 === 3.1.2 How to manually update core packages? ===
Xiaoling 67.2 504
505
Xiaoling 70.8 506 You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages.
Xiaoling 67.2 507
508
509 [[image:1661305328295-218.png]]
510
511
Kilight Cao 95.1 512 === 3.1.3 How to manually update other packages? ===
Xiaoling 67.2 513
514
515 For the other packages, you have to access the device's CLI to do it via the apt command.
516
517
Kilight Cao 95.1 518 == 3.2 Set up a 3^^rd^^ party package maintain server ==
Xiaoling 67.2 519
Kilight Cao 95.1 520 === 3.2.1 Overview ===
Xiaoling 67.2 521
522
523 Customers can use their own package maintenance system instead of using the default one from Dragino. They need to set up a package maintenance system for Debian. Lots of instructions are available in Internet, below is a reference instruction.
524
525
Kilight Cao 95.1 526 === 3.2.2 Install Apache2 HTTP server ===
Xiaoling 67.2 527
528
Xiaoling 70.5 529 (% style="background-color:yellow; color:green" %)**apt install apache2**
Xiaoling 67.2 530
531
Kilight Cao 95.1 532 === 3.2.3 Creating Package Directories ===
Xiaoling 67.2 533
534
Xiaoling 70.5 535 **~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)**
Xiaoling 67.2 536
Xiaoling 70.5 537 **~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)**
Xiaoling 67.2 538
Xiaoling 70.5 539 **~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)**
Xiaoling 67.2 540
541
542 **Tree Structure:**
543
544 (% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.**
545
546
547 └── debian
548
549 └── release
550
551 ├── dists
552
553 │   └── stable
554
555 │       └── main
556
557 │           └── binary-armhf
558
559 └── pool
560
561 └── main
562
563 └── d
564
Xiaoling 70.5 565 └── dragino   ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.**
Xiaoling 67.2 566
567
Kilight Cao 95.1 568 === 3.2.4 Get deb packages ===
Xiaoling 67.2 569
570
571 The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)**
572
573 Below is an example package(testing-0808.deb) for test purpose:
574
575
Xiaoling 70.5 576 **~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)**
Xiaoling 67.2 577
Xiaoling 70.5 578 **~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)**
Xiaoling 67.2 579
580
Kilight Cao 95.1 581 === 3.2.5 Generate Package Index file ===
Xiaoling 67.2 582
583
Xiaoling 70.5 584 (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/**
Xiaoling 67.2 585
Xiaoling 70.5 586 (% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages**
Xiaoling 67.2 587
Xiaoling 70.5 588 (% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz**
Xiaoling 67.2 589
590
591 (% style="color:red" %)**Note: Every time a package has been update, above comments need to be executed in the server to get the up-to-date package list.**
592
593
Kilight Cao 95.1 594 === 3.2.6 Generate Release file ===
Xiaoling 67.2 595
596
Xiaoling 70.10 597 ==== (% style="color:blue" %)**Create the generated script:**(%%) ====
Xiaoling 67.2 598
599
Xiaoling 70.5 600 (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
Xiaoling 67.2 601
602
Xiaoling 70.5 603 (% style="background-color:yellow; color:green" %)**wget [[http:~~/~~/repo.dragino.com/release/tool/unimportant/generate-release.sh>>url:http://repo.dragino.com/release/tool/unimportant/generate-release.sh]]**
Xiaoling 67.2 604
Xiaoling 70.5 605 (% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh**
Xiaoling 67.2 606
Xiaoling 70.5 607 (% style="background-color:yellow; color:green" %)**./generate-release.sh > Release**
Xiaoling 67.2 608
609
Kilight Cao 95.1 610 === 3.2.7 Sign the Release file with gpg and generating Inrelease file ===
Xiaoling 67.2 611
612
Xiaoling 70.7 613 ==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ====
Xiaoling 67.2 614
615
Xiaoling 70.5 616 (% style="background-color:yellow; color:green" %)**apt install gnupg**
Xiaoling 68.2 617
618
619
Xiaoling 70.7 620 ==== (% style="color:blue" %)**generate gpg key**(%%) ====
Xiaoling 67.2 621
622
Xiaoling 70.5 623 (% style="background-color:yellow; color:green" %)**gpg -gen-key**
Xiaoling 67.2 624
Xiaoling 68.2 625
Xiaoling 70.10 626 (% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.**
Xiaoling 67.2 627
628
Xiaoling 68.2 629
Xiaoling 70.7 630 ==== (% style="color:blue" %)**Check the gen-key**(%%) ====
Xiaoling 67.2 631
632
Xiaoling 70.5 633 (% style="background-color:yellow; color:green" %)**gen -list-key**
Xiaoling 67.2 634
Xiaoling 68.2 635
636
Xiaoling 70.7 637 ==== (% style="color:blue" %)**Generate the release.gpg**(%%) ====
Xiaoling 67.2 638
639
Xiaoling 70.5 640 (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable**
Xiaoling 67.2 641
Xiaoling 70.5 642 (% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release**
Xiaoling 67.2 643
644
Xiaoling 70.5 645 (% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release**
Xiaoling 67.2 646
647
Xiaoling 68.2 648
Xiaoling 70.7 649 ==== (% style="color:blue" %)**Generate the public key**(%%) ====
Xiaoling 67.2 650
651
Xiaoling 70.5 652 (% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>**
Xiaoling 67.2 653
Xiaoling 68.2 654
Xiaoling 67.2 655 **example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]]
656
657
658
Kilight Cao 95.1 659 === 3.2.8 Add url as apt source in LPS8v2 / MS20 ===
Xiaoling 67.2 660
Xiaoling 68.2 661
662
Xiaoling 70.7 663 ==== (% style="color:blue" %)**Add the public key**(%%) ====
Xiaoling 67.2 664
665
Xiaoling 70.5 666 (% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/**
Xiaoling 67.2 667
Xiaoling 70.7 668
Xiaoling 68.2 669 (% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.**
Xiaoling 67.2 670
Xiaoling 68.2 671
672
Xiaoling 70.7 673 ==== (% style="color:blue" %)**Add the apt source list**(%%) ====
Xiaoling 67.2 674
Xiaoling 68.2 675
Xiaoling 67.2 676 Add the apt source list url and name this as test_server.list
677
Xiaoling 70.5 678 (% style="background-color:yellow; color:green" %)**echo "deb http:~/~/<IP_address or hostname>/debian/release stable main" | tee /etc/apt/sources.list.d/test_server.list**
Xiaoling 67.2 679
680
Xiaoling 68.2 681
Xiaoling 70.7 682 ==== (% style="color:blue" %)**Validate the apt repository**(%%) ====
Xiaoling 67.2 683
Xiaoling 68.2 684
Xiaoling 67.2 685 Get and install the testing package (download testing-0808.deb and test)
686
Xiaoling 70.5 687 (% style="background-color:yellow; color:green" %)**apt update && apt install testing**
Xiaoling 67.2 688
Xiaoling 68.2 689
Xiaoling 67.2 690 Example output:
691
Xiaoling 68.2 692 [[image:1661306420449-569.png]]
Xiaoling 67.2 693
694
Kilight Cao 95.1 695 === 3.2.9 Configure the gateway's auto-upgrade rules ===
Xiaoling 67.2 696
697
Xiaoling 70.7 698 ==== (% style="color:blue" %)**Remove dragino apt source**(%%) ====
Xiaoling 67.2 699
700
Xiaoling 70.5 701 (% style="background-color:yellow; color:green" %)**/etc/apt/sources.list**
Xiaoling 67.2 702
703
Xiaoling 70.2 704 [[image:1661306460134-112.png]]
Xiaoling 67.2 705
706
707
Xiaoling 70.7 708 ==== (% style="color:blue" %)**Set up automatic updates**(%%) ====
Xiaoling 67.2 709
710
Xiaoling 70.5 711 (% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates**
Xiaoling 67.2 712
Xiaoling 70.2 713
Xiaoling 67.2 714 The device performs automatic updates from this script,
715
716 But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword.
717
718
Xiaoling 70.2 719 [[image:1661306487761-768.png]]
Xiaoling 95.2 720
721
722
Copyright ©2010-2024 Dragino Technology Co., LTD. All rights reserved
Dragino Wiki v2.0