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