Changes for page Armbian OS instruction
Last modified by Xiaoye on 2024/11/07 10:11
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 6 removed)
Details
- Page properties
-
- Content
-
... ... @@ -114,9 +114,8 @@ 114 114 == 2.3 How to flash SD card to (eMMC) device's built-in Memory == 115 115 116 116 117 -=== 2.3.1 Prepare an SD card with OS === 117 +=== 2.3.1 Prepare an SD card with OS. === 118 118 119 - 120 120 //**Preparations:**// 121 121 122 122 ~1. Prepare an SD card and a// card reader device// ... ... @@ -128,10 +128,8 @@ 128 128 4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )// 129 129 130 130 130 +=== 2.3.2 Flash SD card to device's eMMC. === 131 131 132 -=== 2.3.2 Flash SD card to device's eMMC === 133 - 134 - 135 135 //1. Open the device's enclosure, and put the SD card into the SD card slot// 136 136 137 137 //2. Power on the device and access the gateway's CLI via the serial port.// ... ... @@ -173,286 +173,6 @@ 173 173 (% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.** 174 174 175 175 176 - 177 177 = 3. Package Maintain Note = 178 178 179 - 180 -== 3.1 Default Package Maintain System == 181 - 182 - 183 -=== 3.1.1 How Package-Auto-Update works? === 184 - 185 - 186 -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. 187 - 188 - 189 -(% style="color:blue" %)**When devices will check for updates**? 190 - 191 -* Devices will check for updates for every boot. 192 -* Devices will check for updates on every day midnight. 193 - 194 -(% style="color:blue" %)**What packages will be checked for updates**? 195 - 196 -dragino-httpd ~-~- Main Web UI http configuration 197 - 198 -dragino-sid ~-~- SN write and read tool 199 - 200 -dragino-ui ~-~- Gateway Web UI package 201 - 202 -draginofwd ~-~- UDP packet forwarder, LoRa Base Station 203 - 204 -draginoups ~-~- Miscellaneous between different versions 205 - 206 - 207 -(% style="color:blue" %)**Location and changelog for packages**: 208 - 209 -* Location: http:~/~/repo.dragino.com/release/tool/ 210 -* Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]] 211 - 212 -(% style="color:blue" %)**How to view auto-updated log** 213 - 214 -You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.** 215 - 216 - 217 -[[image:1661305025451-220.png]] 218 - 219 - 220 -(% style="color:blue" %)**Can I disable package-auto-update?** 221 - 222 -You can check the checkbox and click the(% style="color:#037691" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 223 - 224 - 225 -[[image:1661305258501-636.png]] 226 - 227 - 228 - 229 -=== 3.1.2 How to manually update core packages? === 230 - 231 - 232 -You can click the (% style="color:#037691" %)**‘Manual Update’**(%%) to update the dragino's packages. 233 - 234 - 235 -[[image:1661305328295-218.png]] 236 - 237 - 238 - 239 -=== 3.1.3 How to manually update other packages? === 240 - 241 - 242 -For the other packages, you have to access the device's CLI to do it via the apt command. 243 - 244 - 245 - 246 -== 3.2 Set up a 3^^rd^^ party package maintain server == 247 - 248 - 249 -=== 3.2.1 Overview === 250 - 251 - 252 -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. 253 - 254 - 255 - 256 -=== 3.2.2 Install Apache2 HTTP server === 257 - 258 - 259 -(% style="background-color:yellow" %)**apt install apache2** 260 - 261 - 262 - 263 -=== 3.2.3 Creating Package Directories === 264 - 265 - 266 -**~ (% style="background-color:yellow" %)cd /var/www/html/(%%)** 267 - 268 -**~ (% style="background-color:yellow" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 269 - 270 -**~ (% style="background-color:yellow" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 271 - 272 - 273 -**Tree Structure:** 274 - 275 -(% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.** 276 - 277 - 278 -└── debian 279 - 280 - └── release 281 - 282 - ├── dists 283 - 284 - │ └── stable 285 - 286 - │ └── main 287 - 288 - │ └── binary-armhf 289 - 290 - └── pool 291 - 292 - └── main 293 - 294 - └── d 295 - 296 - └── dragino ~-~-> (% style="background-color:yellow" %)**This is the directory to store the packages. User can change it to other name.** 297 - 298 - 299 - 300 -=== 3.2.4 Get deb packages === 301 - 302 - 303 -The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)** 304 - 305 -Below is an example package(testing-0808.deb) for test purpose: 306 - 307 - 308 -**~ (% style="background-color:yellow" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 309 - 310 -**~ (% style="background-color:yellow" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 311 - 312 - 313 - 314 -=== 3.2.5 Generate Package Index file === 315 - 316 - 317 -(% style="background-color:yellow" %)**cd /var/www/html/debian/release/** 318 - 319 -(% style="background-color:yellow" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 320 - 321 -(% style="background-color:yellow" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 322 - 323 - 324 -(% 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.** 325 - 326 - 327 - 328 -=== 3.2.6 Generate Release file === 329 - 330 - 331 -==== (% style="color:blue" %)Create the generated script:(%%) ==== 332 - 333 - 334 -(% style="background-color:yellow" %)**cd /var/www/html/debian/release/dists/stable** 335 - 336 - 337 -(% style="background-color:yellow" %)**wget [[http:~~/~~/repo.dragino.com/release/tool/unimportant/generate-release.sh>>url:http://repo.dragino.com/release/tool/unimportant/generate-release.sh]]** 338 - 339 -(% style="background-color:yellow" %)**chmod + x ./generate-release.sh** 340 - 341 -(% style="background-color:yellow" %)**./generate-release.sh > Release** 342 - 343 - 344 - 345 -=== 3.2.7 Sign the Release file with gpg and generating Inrelease file === 346 - 347 - 348 - 349 -==== (% style="color:blue" %)Make sure auto-update server has gnupg(%%) ==== 350 - 351 - 352 -(% style="background-color:yellow" %)**apt install gnupg** 353 - 354 - 355 - 356 -==== (% style="color:blue" %)generate gpg key(%%) ==== 357 - 358 - 359 -(% style="background-color:yellow" %)**gpg -gen-key** 360 - 361 - 362 -**((% style="color:red" %)Note: Fill in the content as required and remember the name and email address)(%%)** 363 - 364 - 365 - 366 -==== (% style="color:blue" %)Check the gen-key(%%) ==== 367 - 368 - 369 -(% style="background-color:yellow" %)**gen -list-key** 370 - 371 - 372 - 373 -==== (% style="color:blue" %)Generate the release.gpg(%%) ==== 374 - 375 - 376 -(% style="background-color:yellow" %)**cd /var/www/html/debian/release/dists/stable** 377 - 378 -(% style="background-color:yellow" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 379 - 380 - 381 -(% style="background-color:yellow" %)**gpg ~-~-clearsign -o InRelease Release** 382 - 383 - 384 - 385 -==== (% style="color:blue" %)Generate the public key(%%) ==== 386 - 387 - 388 -(% style="background-color:yellow" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 389 - 390 - 391 -**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 392 - 393 - 394 - 395 -=== 3.2.8 Add url as apt source in LPS8v2 / MS20 === 396 - 397 - 398 - 399 -==== (% style="color:blue" %)Add the public key(%%) ==== 400 - 401 - 402 -(% style="background-color:yellow" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 403 - 404 -(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 405 - 406 - 407 - 408 -==== (% style="color:blue" %)Add the apt source list(%%) ==== 409 - 410 - 411 -Add the apt source list url and name this as test_server.list 412 - 413 -(% style="background-color:yellow" %)**echo "deb http:~/~/<IP_address or hostname>/debian/release stable main" | tee /etc/apt/sources.list.d/test_server.list** 414 - 415 - 416 - 417 -==== (% style="color:blue" %)Validate the apt repository(%%) ==== 418 - 419 - 420 -Get and install the testing package (download testing-0808.deb and test) 421 - 422 -(% style="background-color:yellow" %)**apt update && apt install testing** 423 - 424 - 425 -Example output: 426 - 427 -[[image:1661306420449-569.png]] 428 - 429 - 430 - 431 -=== 3.2.9 Configure the gateway's auto-upgrade rules === 432 - 433 - 434 - 435 -==== (% style="color:blue" %)Remove dragino apt source(%%) ==== 436 - 437 - 438 -(% style="background-color:yellow" %)**/etc/apt/sources.list** 439 - 440 - 441 -[[image:1661306460134-112.png]] 442 - 443 - 444 - 445 -==== (% style="color:blue" %)Set up automatic updates(%%) ==== 446 - 447 - 448 -**(% style="background-color:yellow" %)Path : /usr/lib/dragino/dragino-apt-updates** 449 - 450 - 451 -The device performs automatic updates from this script, 452 - 453 -But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword. 454 - 455 - 456 -[[image:1661306487761-768.png]] 457 - 458 458
- 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