Changes for page Armbian OS instruction
Last modified by Edwin Chen on 2025/02/26 08:18
From version 117.1
edited by Kilight Cao
on 2024/11/05 16:25
on 2024/11/05 16:25
Change comment:
There is no comment for this version
To version 26.1
edited by Kilight Cao
on 2022/06/02 11:59
on 2022/06/02 11:59
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 45 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,720 +2,139 @@ 2 2 3 3 {{toc/}} 4 4 5 += Overview = 5 5 6 - 7 - 8 -= 1. Overview = 9 - 10 - 11 11 This is a general instruction for the use of Armbian base OS of Dragino devices. Current models include: 12 12 13 13 * HP0A 14 14 * HP0C 15 15 * LPS8v2 16 -* MS20 17 17 18 - (%style="display:none"%)13 += Development Guide = 19 19 15 +For advanced users to develop Driver/ Linux etc 20 20 21 -= 2. Development Guide = 22 22 18 += Advance = 23 23 24 - Foradvanced userstodevelop Driver/Linuxetc.20 +== SSH Access for Linux console == 25 25 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. 26 26 27 - ==2.1HowtorecompileLoRaWANConcentratorDriver( dragino-fwdpackage). ==24 +IP address: IP address of HP0C 28 28 26 +Port: 22 29 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 - 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 -Access the gateway Linux CLI to flash the image to the gateway's built memory 235 - 236 -* **Use the IP address to access the gateway CLI** 237 - 238 -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. 239 - 240 -IP address: IP address of gateway or **Fallback IP**(172.31.255.254) 241 - 242 -Port: 22 243 - 244 244 User Name: **root** 245 245 246 -Password: 30 +Password: **draginohp** (default) 247 247 248 - //After logging in, you will be in thegateway CLIand can enter commands as shown below.//32 +After logging in, you will be in the Linux console and can enter commands as shown below. 249 249 250 -[[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"]] 251 251 252 - **Runcommand:**35 +== How to flash SD card to eMMC == 253 253 254 -**nand-sata-install** 255 255 256 - [[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"]]38 +Run command: 257 257 258 -Select the **"Boot from eMMC - system on eMMC".** 259 - 260 -[[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"]] 261 - 262 -[[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"]] 263 - 264 -Select the **"1 ext4"** 265 - 266 -[[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"]] 267 - 268 -It takes 4-5 minutes to burn from SD card to eMMC 269 - 270 -[[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"]] 271 - 272 -[[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"]] 273 - 274 -[[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"]] 275 - 276 -**Note: After the flash is complete, power off the device and then remove the SD card.** 277 - 278 - 279 -== 2.4 How to extend the gateway size of memory with SD card == 280 - 281 - 282 -Users can use the SD card slot to expand the gateway memory size by following the steps below 283 - 284 - 285 -=== 2.4.1 View SD card information === 286 - 287 287 (% class="box infomessage" %) 288 288 ((( 289 - fdisk-l42 +nand-sata-install 290 290 ))) 291 291 292 -[[image:image-202 30831150518-3.png]]45 +[[image:image-20220602112051-1.png]] 293 293 47 +**Select the "Boot from eMMC - system on eMMC"** 294 294 295 - === 2.4.2 Displays thecurrent file systemdisk usagestatisticson Linux systems===49 +[[image:image-20220602112058-2.png||height="292" width="646"]] 296 296 51 +[[image:image-20220602112106-3.png||height="301" width="643"]] 297 297 298 -(% class="box infomessage" %) 299 -((( 300 -df -h 301 -))) 302 302 303 - [[image:image-20230831150341-2.png]]54 +**Select the "1 ext4"** 304 304 56 +[[image:image-20220602112113-4.png||height="271" width="642"]] 305 305 306 -=== 2.4.3 Mount SD card === 307 307 59 +**It takes 4-5 minutes to burn from SD card to eMMC** 308 308 309 -(% class="box infomessage" %) 310 -((( 311 -mkdir /mnt/sd 61 +[[image:image-20220602112119-5.png||height="309" width="641"]] 312 312 313 -mount /dev/mmcblk0p1 /mnt/sd 314 -))) 63 +[[image:image-20220602112125-6.png||height="281" width="640"]] 315 315 316 - After the mountis successful to check the file systemdisk usageontheLinux systemagain:65 +[[image:image-20220602112131-7.png||height="241" width="638"]] 317 317 318 -[[image:image-20230831151432-4.png]] 319 319 68 +(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card** 320 320 321 - Ifthe mountfails,you canformatthe filesystemandtry the mountagain70 +== How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == 322 322 323 -(% class="box infomessage" %) 324 -((( 325 -mkfs.ext4 /dev/mmcblk0p1 326 -))) 72 +=== Step 1. Clone dragino-fwd package === 327 327 328 -== 2.5 Default Built Version == 329 329 75 +Run command clone dragino-fwd package: 330 330 331 -[[image:image-20220902155621-1.png]] 332 - 333 - 334 -== 2.6 How to upgrade the nodejs version to the latest. == 335 - 336 - 337 -By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old. 338 - 339 -[[image:image-20221112145029-2.png]] 340 - 341 -**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.** 342 - 343 - 344 -#install n, which is an Interactively Manage Your Node.js Versions 345 - 346 -[[image:image-20221112154230-3.png||height="89" width="689"]] 347 - 348 348 (% class="box infomessage" %) 349 349 ((( 350 - **npmstall -g**79 +git clone https:~/~/github.com/dragino/dragino_fwd_src.git 351 351 ))) 352 352 82 +[[image:image-20220527151010-1.png]] 353 353 354 -#Install the latest LTS Node.js release (downloading if necessary) 355 355 356 - [[image:image-20221112154418-4.png||height="184"width="893"]]85 +=== Step 2. Compile dragino_fwd === 357 357 358 -(% class="box infomessage" %) 359 -((( 360 -**n lts** 361 -))) 362 362 88 +After cloning is complete, Run the command starts compiling: 363 363 364 -#Remove all downloaded versions except the installed version 365 - 366 -[[image:image-20221112154456-5.png||height="139" width="899"]] 367 - 368 368 (% class="box infomessage" %) 369 369 ((( 370 -**n prune** 92 +Compile HP0D/rasspberrypi fwd: ./hp0z-make-deb.sh d 93 +Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c 371 371 ))) 372 372 96 +The following example compilers HP0C fwd. 373 373 374 -(% class="box infomessage" %) 375 -((( 376 -**apt remove nodejs -y && apt autoremove -y && reboot** 377 -))) 98 +[[image:image-20220527153913-3.png]] 378 378 379 379 380 - Checkthe currentversion101 +**When the compilation is complete a draginofwd-*.deb package is generated.** 381 381 382 -[[image:image-2022 1112154724-6.png]]103 +[[image:image-20220527154311-4.png||height="385" width="773"]] 383 383 384 -(% class="box infomessage" %) 385 -((( 386 -**node -v** 387 -))) 388 388 106 +=== Step 3. Install the dragino_fwd === 389 389 390 -== 2.7 How to install Grafana and influxdb == 391 391 109 +Run command: 392 392 393 -=== **Grafana:** === 394 - 395 - 396 396 (% class="box infomessage" %) 397 397 ((( 398 -curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null 399 -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 400 -apt update && apt install grafana 113 +dpkg -i draginofwd-*.deb 401 401 ))) 402 402 116 +[[image:image-20220527154811-5.png]] 403 403 404 -Check the running status: 405 405 119 +=== Step 4. Test === 406 406 407 -(% class="box infomessage" %) 408 -((( 409 -systemctl status grafana-server 410 -))) 411 411 122 +Check the dragino_fwd log: 412 412 413 -configuration path: 414 - 415 - 416 416 (% class="box infomessage" %) 417 417 ((( 418 - /etc/grafana/grafana.ini126 +journalctl -u draginofwd -f 419 419 ))) 420 420 129 +[[image:image-20220527165221-7.png||height="182" width="931"]] 421 421 422 - ===**Influxdb:**===131 +Start/stop dragino_fwd via systemctl: 423 423 424 - 425 425 (% class="box infomessage" %) 426 426 ((( 427 -curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null 428 -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 429 -apt update && apt install influxdb 135 +systemctl start draginofwd 136 +systemctl stop draginofwd 430 430 ))) 431 431 432 432 433 -Check the running status: 434 - 435 - 436 -(% class="box infomessage" %) 437 -((( 438 -systemctl status influxdb 439 -))) 440 - 441 - 442 -configuration path: 443 - 444 - 445 -(% class="box infomessage" %) 446 -((( 447 -/etc/influxdb/influxdb.conf 448 -))) 449 - 450 - 451 -= 3. Package Management = 452 - 453 -== 3.1 Default Package Maintain System == 454 - 455 -=== 3.1.1 How Package-Auto-Update works? === 456 - 457 - 458 -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. 459 - 460 - 461 -(% style="color:blue" %)**When devices will check for updates**? 462 - 463 -* Devices will check for updates for every boot. 464 -* Devices will check for updates on every day midnight. 465 - 466 -(% style="color:blue" %)**What packages will be checked for updates**? 467 - 468 -dragino-httpd ~-~- Main Web UI http configuration 469 - 470 -dragino-sid ~-~- SN write and read tool 471 - 472 -dragino-ui ~-~- Gateway Web UI package 473 - 474 -draginofwd ~-~- UDP packet forwarder, LoRa Base Station 475 - 476 -draginoups ~-~- Miscellaneous between different versions 477 - 478 - 479 - 480 -(% style="color:blue" %)**Location and changelog for packages**: 481 - 482 -* Location: http:~/~/repo.dragino.com/release/tool/ 483 -* Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]] 484 - 485 -(% style="color:blue" %)**How to view auto-updated log** 486 - 487 -You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.** 488 - 489 - 490 -[[image:1661305025451-220.png]] 491 - 492 - 493 - 494 -(% style="color:blue" %)**Can I disable package-auto-update?** 495 - 496 -You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 497 - 498 - 499 -[[image:1661305258501-636.png]] 500 - 501 - 502 -=== 3.1.2 How to manually update core packages? === 503 - 504 - 505 -You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. 506 - 507 - 508 -[[image:1661305328295-218.png]] 509 - 510 - 511 -=== 3.1.3 How to manually update other packages? === 512 - 513 - 514 -For the other packages, you have to access the device's CLI to do it via the apt command. 515 - 516 - 517 -== 3.2 Set up a 3^^rd^^ party package maintain server == 518 - 519 -=== 3.2.1 Overview === 520 - 521 - 522 -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. 523 - 524 - 525 -=== 3.2.2 Install Apache2 HTTP server === 526 - 527 - 528 -(% style="background-color:yellow; color:green" %)**apt install apache2** 529 - 530 - 531 -=== 3.2.3 Creating Package Directories === 532 - 533 - 534 -**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** 535 - 536 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 537 - 538 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 539 - 540 - 541 -**Tree Structure:** 542 - 543 -(% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.** 544 - 545 - 546 -└── debian 547 - 548 - └── release 549 - 550 - ├── dists 551 - 552 - │ └── stable 553 - 554 - │ └── main 555 - 556 - │ └── binary-armhf 557 - 558 - └── pool 559 - 560 - └── main 561 - 562 - └── d 563 - 564 - └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** 565 - 566 - 567 -=== 3.2.4 Get deb packages === 568 - 569 - 570 -The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)** 571 - 572 -Below is an example package(testing-0808.deb) for test purpose: 573 - 574 - 575 -**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 576 - 577 -**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 578 - 579 - 580 -=== 3.2.5 Generate Package Index file === 581 - 582 - 583 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** 584 - 585 -(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 586 - 587 -(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 588 - 589 - 590 -(% 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.** 591 - 592 - 593 -=== 3.2.6 Generate Release file === 594 - 595 - 596 -==== (% style="color:blue" %)**Create the generated script:**(%%) ==== 597 - 598 - 599 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 600 - 601 - 602 -(% 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]]** 603 - 604 -(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** 605 - 606 -(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** 607 - 608 - 609 -=== 3.2.7 Sign the Release file with gpg and generating Inrelease file === 610 - 611 - 612 -==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== 613 - 614 - 615 -(% style="background-color:yellow; color:green" %)**apt install gnupg** 616 - 617 - 618 - 619 -==== (% style="color:blue" %)**generate gpg key**(%%) ==== 620 - 621 - 622 -(% style="background-color:yellow; color:green" %)**gpg -gen-key** 623 - 624 - 625 -(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** 626 - 627 - 628 - 629 -==== (% style="color:blue" %)**Check the gen-key**(%%) ==== 630 - 631 - 632 -(% style="background-color:yellow; color:green" %)**gen -list-key** 633 - 634 - 635 - 636 -==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== 637 - 638 - 639 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 640 - 641 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 642 - 643 - 644 -(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** 645 - 646 - 647 - 648 -==== (% style="color:blue" %)**Generate the public key**(%%) ==== 649 - 650 - 651 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 652 - 653 - 654 -**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 655 - 656 - 657 - 658 -=== 3.2.8 Add url as apt source in LPS8v2 / MS20 === 659 - 660 - 661 - 662 -==== (% style="color:blue" %)**Add the public key**(%%) ==== 663 - 664 - 665 -(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 666 - 667 - 668 -(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 669 - 670 - 671 - 672 -==== (% style="color:blue" %)**Add the apt source list**(%%) ==== 673 - 674 - 675 -Add the apt source list url and name this as test_server.list 676 - 677 -(% 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** 678 - 679 - 680 - 681 -==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== 682 - 683 - 684 -Get and install the testing package (download testing-0808.deb and test) 685 - 686 -(% style="background-color:yellow; color:green" %)**apt update && apt install testing** 687 - 688 - 689 -Example output: 690 - 691 -[[image:1661306420449-569.png]] 692 - 693 - 694 -=== 3.2.9 Configure the gateway's auto-upgrade rules === 695 - 696 - 697 -==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== 698 - 699 - 700 -(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** 701 - 702 - 703 -[[image:1661306460134-112.png]] 704 - 705 - 706 - 707 -==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== 708 - 709 - 710 -(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 711 - 712 - 713 -The device performs automatic updates from this script, 714 - 715 -But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword. 716 - 717 - 718 -[[image:1661306487761-768.png]] 719 - 720 - 721 721
- 1661305025451-220.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -247.0 KB - Content
- 1661305258501-636.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -115.4 KB - Content
- 1661305321820-965.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.3 KB - Content
- 1661305328295-218.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -78.3 KB - Content
- 1661306420449-569.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -237.0 KB - Content
- 1661306460134-112.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -146.8 KB - Content
- 1661306487761-768.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoling - Size
-
... ... @@ -1,1 +1,0 @@ 1 -291.9 KB - Content
- image-20220609101627-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -14.7 KB - Content
- image-20220609101638-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -16.3 KB - Content
- image-20220609101748-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -26.1 KB - Content
- image-20220609101820-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -20.4 KB - Content
- image-20220609101843-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -18.7 KB - Content
- image-20220609101905-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -19.8 KB - Content
- image-20220609101944-7.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.2 KB - Content
- image-20220609102257-8.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.9 KB - Content
- image-20220609102320-9.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -22.9 KB - Content
- image-20220609102911-10.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -63.7 KB - Content
- image-20220609103538-11.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -17.7 KB - Content
- image-20220609103619-12.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -17.6 KB - Content
- image-20220609104104-13.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -45.3 KB - Content
- image-20220902155621-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Edwin - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.7 KB - Content
- image-20221112145017-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -1.9 KB - Content
- image-20221112145029-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -3.3 KB - Content
- image-20221112154230-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -5.2 KB - Content
- image-20221112154418-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -18.2 KB - Content
- image-20221112154456-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -14.6 KB - Content
- image-20221112154724-6.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -3.2 KB - Content
- image-20230327152105-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -27.5 KB - Content
- image-20230327152431-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -47.5 KB - Content
- image-20230327154700-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -26.7 KB - Content
- image-20230327165836-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -17.1 KB - Content
- image-20230327171824-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -46.1 KB - Content
- image-20230327174537-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -8.8 KB - Content
- image-20230327174556-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -16.0 KB - Content
- image-20230327174853-5.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -20.0 KB - Content
- image-20230508155357-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -24.3 KB - Content
- image-20230712201032-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -872.4 KB - Content
- image-20230712201424-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -872.4 KB - Content
- image-20230712201458-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -854.1 KB - Content
- image-20230831144800-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -86.9 KB - Content
- image-20230831150341-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -30.7 KB - Content
- image-20230831150518-3.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -89.9 KB - Content
- image-20230831151432-4.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -37.7 KB - Content
- image-20241008091544-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -36.1 KB - Content
- image-20241008091850-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -36.2 KB - Content