Changes for page Armbian OS instruction
Last modified by Edwin Chen on 2025/02/26 08:18
From version 25.1
edited by Kilight Cao
on 2022/06/02 11:22
on 2022/06/02 11:22
Change comment:
There is no comment for this version
To version 115.1
edited by Kilight Cao
on 2024/11/05 16:24
on 2024/11/05 16:24
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 45 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-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
Details
- Page properties
-
- Content
-
... ... @@ -2,120 +2,721 @@ 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 21 += 2. Development Guide = 17 17 18 -= Advance = 19 19 20 - ==SSH Accessfor Linuxconsole==24 +For advanced users to develop Driver/ Linux etc. 21 21 22 -Connect the HP0C Ethernet port to your router and HP0C will obtain an IP address from your router. In the router’s management portal, you should be able to find what IP address the router has assigned to the HP0C. You can use this IP to connect the SSH access of HP0C. 23 23 24 - IPaddress:IPaddressofHP0C27 +== 2.1 How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == 25 25 26 -Port: 22 27 27 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 + 101 + 102 +**2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI** 103 + 104 + 105 + 106 + 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 + 114 +**2.2.4 Export the img file and follow the steps in 2.3 for burning** 115 + 116 + 117 +== 2.3 How to flash a new image(OS) to the gateway(LPS8V2) == 118 + 119 + 120 +Since the gateway has a large system, you need to use the sd card to reflash the system for the gateway 121 + 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 + 132 +==== (% style="background-color:yellow" %)**//Preparations~://**(%%) ==== 133 + 134 +1. Prepare an SD card 135 +1. Prepare a card reader device 136 +1. Download the OS image from the release.image~: **[[draginolps8v2-release-v1.7>>http://repo.dragino.com/release/hp0c-image/]]** 137 +1. A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] ) 138 +1. SD Card [[format>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]] tool 139 + 140 +=== **2.3.1 Making an SD Card with the new image** === 141 + 142 + 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 + 168 +=== **2.3.2 Instal the SD card to the gateway** === 169 + 170 +1. Open the device's enclosure, and put the SD card into the SD card slot 171 + 172 +[[image:image-20230712201032-1.png]] 173 + 174 + 175 +2. Power the gateway with 5V2A, and access the gateway's Ethernet port to your PC 176 + 177 +[[image:image-20230712201458-3.png||height="649" width="832"]] 178 + 179 + 180 +Note: The PWR LED on red 181 + 182 + The LAN LED blink 183 + 184 + The SYS LED on red 185 + 186 + 187 + 188 +=== **3.2.3 Flash the image to the gateway's built memory from the SD card(LPS8v2)** === 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 + 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. 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 + 213 +**Run command:** 214 + 215 +draginolps8v2-release-chirpsrtack-v1.7-240725 image : 216 + 217 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img ** 218 + 219 +draginolps8v2-release-ttnstack-v1.7-240712 image : 220 + 221 +(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img** 222 + 223 +[[image:image-20241008091850-2.png]] 224 + 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.** 226 + 227 + 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 + 28 28 User Name: **root** 29 29 30 -Password: hp** (default)247 +Password: **dragino** (default) 31 31 32 -After logging in, you will be in the Linux console and can enter commands as shown below.249 +//After logging in, you will be in the gateway CLI and can enter commands as shown below.// 33 33 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"]] 34 34 35 - == How to burnfromSD cardto eMMC ==253 +**Run command:** 36 36 37 - [[image:image-20220602112051-1.png]]255 +**nand-sata-install** 38 38 39 -[[image:image-2022060211205 8-2.png||height="292" width="646"]]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"]] 40 40 41 - [[image:image-20220602112106-3.png||height="301"width="643"]]259 +Select the **"Boot from eMMC - system on eMMC".** 42 42 43 -[[image:image-20220602112 113-4.png||height="271" width="642"]]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"]] 44 44 45 -[[image:image-202206021121 19-5.png||height="309" width="641"]]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"]] 46 46 47 - [[image:image-20220602112125-6.png||height="281"width="640"]]265 +Select the **"1 ext4"** 48 48 49 -[[image:image-202206021121 31-7.png||height="241" width="638"]]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"]] 50 50 51 - == HowtorecompileLoRaWANConcentratorDriver( dragino-fwdpackage).==269 +It takes 4-5 minutes to burn from SD card to eMMC 52 52 53 - === Step1.Clonedragino-fwdpackage ===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"]] 54 54 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"]] 55 55 56 - Runmandclonedragino-fwdpackage: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"]] 57 57 277 +**Note: After the flash is complete, power off the device and then remove the SD card.** 278 + 279 + 280 +== 2.4 How to extend the gateway size of memory with SD card == 281 + 282 + 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 + 58 58 (% class="box infomessage" %) 59 59 ((( 60 - git clone https:~/~/github.com/dragino/dragino_fwd_src.git290 +fdisk -l 61 61 ))) 62 62 63 -[[image:image-202 20527151010-1.png]]293 +[[image:image-20230831150518-3.png]] 64 64 65 65 66 -=== Step2.Compile dragino_fwd===296 +=== 2.4.2 Displays the current file system disk usage statistics on Linux systems === 67 67 68 68 69 -After cloning is complete, Run the command starts compiling: 299 +(% class="box infomessage" %) 300 +((( 301 +df -h 302 +))) 70 70 304 +[[image:image-20230831150341-2.png]] 305 + 306 + 307 +=== 2.4.3 Mount SD card === 308 + 309 + 71 71 (% class="box infomessage" %) 72 72 ((( 73 -Compile HP0D/rasspberrypi fwd: ./hp0z-make-deb.sh d 74 -Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c 312 +mkdir /mnt/sd 313 + 314 +mount /dev/mmcblk0p1 /mnt/sd 75 75 ))) 76 76 77 - ThefollowingexamplecompilersHP0C fwd.317 +After the mount is successful to check the file system disk usage on the Linux system again: 78 78 79 -[[image:image-202 20527153913-3.png]]319 +[[image:image-20230831151432-4.png]] 80 80 81 81 82 - **Whenthecompilation is complete adraginofwd-*.deb packageisgenerated.**322 +If the mount fails, you can format the file system and try the mount again 83 83 84 -[[image:image-20220527154311-4.png||height="385" width="773"]] 324 +(% class="box infomessage" %) 325 +((( 326 +mkfs.ext4 /dev/mmcblk0p1 327 +))) 85 85 329 +== 2.5 Default Built Version == 86 86 87 -=== Step 3. Install the dragino_fwd === 88 88 332 +[[image:image-20220902155621-1.png]] 89 89 90 -Run command: 91 91 335 +== 2.6 How to upgrade the nodejs version to the latest. == 336 + 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 + 347 +[[image:image-20221112154230-3.png||height="89" width="689"]] 348 + 92 92 (% class="box infomessage" %) 93 93 ((( 94 - dpkg-idraginofwd-*.deb351 +**npm install -g n** 95 95 ))) 96 96 97 -[[image:image-20220527154811-5.png]] 98 98 355 +#Install the latest LTS Node.js release (downloading if necessary) 99 99 100 - === Step4.Test ===357 +[[image:image-20221112154418-4.png||height="184" width="893"]] 101 101 359 +(% class="box infomessage" %) 360 +((( 361 +**n lts** 362 +))) 102 102 103 -Check the dragino_fwd log: 104 104 365 +#Remove all downloaded versions except the installed version 366 + 367 +[[image:image-20221112154456-5.png||height="139" width="899"]] 368 + 105 105 (% class="box infomessage" %) 106 106 ((( 107 - journalctl-u draginofwd -f371 +**n prune** 108 108 ))) 109 109 110 -[[image:image-20220527165221-7.png||height="182" width="931"]] 111 111 112 -Start/stop dragino_fwd via systemctl: 375 +(% class="box infomessage" %) 376 +((( 377 +**apt remove nodejs -y && apt autoremove -y && reboot** 378 +))) 113 113 380 + 381 +Check the current version 382 + 383 +[[image:image-20221112154724-6.png]] 384 + 114 114 (% class="box infomessage" %) 115 115 ((( 116 -systemctl start draginofwd 117 -systemctl stop draginofwd 387 +**node -v** 118 118 ))) 119 119 120 120 391 +== 2.7 How to install Grafana and influxdb == 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 +((( 428 +curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null 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 + 452 += 3. Package Management = 453 + 454 +== 3.1 Default Package Maintain System == 455 + 456 +=== 3.1.1 How Package-Auto-Update works? === 457 + 458 + 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 + 480 + 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 + 494 + 495 +(% style="color:blue" %)**Can I disable package-auto-update?** 496 + 497 +You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 498 + 499 + 500 +[[image:1661305258501-636.png]] 501 + 502 + 503 +=== 3.1.2 How to manually update core packages? === 504 + 505 + 506 +You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. 507 + 508 + 509 +[[image:1661305328295-218.png]] 510 + 511 + 512 +=== 3.1.3 How to manually update other packages? === 513 + 514 + 515 +For the other packages, you have to access the device's CLI to do it via the apt command. 516 + 517 + 518 +== 3.2 Set up a 3^^rd^^ party package maintain server == 519 + 520 +=== 3.2.1 Overview === 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 + 526 +=== 3.2.2 Install Apache2 HTTP server === 527 + 528 + 529 +(% style="background-color:yellow; color:green" %)**apt install apache2** 530 + 531 + 532 +=== 3.2.3 Creating Package Directories === 533 + 534 + 535 +**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** 536 + 537 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 538 + 539 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 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 + 565 + └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** 566 + 567 + 568 +=== 3.2.4 Get deb packages === 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 + 576 +**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 577 + 578 +**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 579 + 580 + 581 +=== 3.2.5 Generate Package Index file === 582 + 583 + 584 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** 585 + 586 +(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 587 + 588 +(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 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 + 594 +=== 3.2.6 Generate Release file === 595 + 596 + 597 +==== (% style="color:blue" %)**Create the generated script:**(%%) ==== 598 + 599 + 600 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 601 + 602 + 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]]** 604 + 605 +(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** 606 + 607 +(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** 608 + 609 + 610 +=== 3.2.7 Sign the Release file with gpg and generating Inrelease file === 611 + 612 + 613 +==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== 614 + 615 + 616 +(% style="background-color:yellow; color:green" %)**apt install gnupg** 617 + 618 + 619 + 620 +==== (% style="color:blue" %)**generate gpg key**(%%) ==== 621 + 622 + 623 +(% style="background-color:yellow; color:green" %)**gpg -gen-key** 624 + 625 + 626 +(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** 627 + 628 + 629 + 630 +==== (% style="color:blue" %)**Check the gen-key**(%%) ==== 631 + 632 + 633 +(% style="background-color:yellow; color:green" %)**gen -list-key** 634 + 635 + 636 + 637 +==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== 638 + 639 + 640 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 641 + 642 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 643 + 644 + 645 +(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** 646 + 647 + 648 + 649 +==== (% style="color:blue" %)**Generate the public key**(%%) ==== 650 + 651 + 652 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 653 + 654 + 655 +**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 656 + 657 + 658 + 659 +=== 3.2.8 Add url as apt source in LPS8v2 / MS20 === 660 + 661 + 662 + 663 +==== (% style="color:blue" %)**Add the public key**(%%) ==== 664 + 665 + 666 +(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 667 + 668 + 669 +(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 670 + 671 + 672 + 673 +==== (% style="color:blue" %)**Add the apt source list**(%%) ==== 674 + 675 + 676 +Add the apt source list url and name this as test_server.list 677 + 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** 679 + 680 + 681 + 682 +==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== 683 + 684 + 685 +Get and install the testing package (download testing-0808.deb and test) 686 + 687 +(% style="background-color:yellow; color:green" %)**apt update && apt install testing** 688 + 689 + 690 +Example output: 691 + 692 +[[image:1661306420449-569.png]] 693 + 694 + 695 +=== 3.2.9 Configure the gateway's auto-upgrade rules === 696 + 697 + 698 +==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== 699 + 700 + 701 +(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** 702 + 703 + 704 +[[image:1661306460134-112.png]] 705 + 706 + 707 + 708 +==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== 709 + 710 + 711 +(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 712 + 713 + 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 + 719 +[[image:1661306487761-768.png]] 720 + 721 + 121 121
- 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-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