Changes for page Armbian OS instruction
Last modified by Edwin Chen on 2025/02/26 08:18
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 7 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -17,7 +17,6 @@ 17 17 18 18 19 19 20 - 21 21 = 2. Development Guide = 22 22 23 23 ... ... @@ -24,11 +24,9 @@ 24 24 For advanced users to develop Driver/ Linux etc. 25 25 26 26 27 - 28 28 == 2.1 How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == 29 29 30 30 31 - 32 32 === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) === 33 33 34 34 ... ... @@ -45,14 +45,13 @@ 45 45 [[image:image-20220527151010-1.png]] 46 46 47 47 48 - 49 49 === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) === 50 50 51 51 52 52 **After cloning is complete, Run the command starts compiling:** 53 53 50 +(% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c** 54 54 55 -(% style="background-color:yellow;color:green" %)Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c 56 56 57 57 The following example compilers HP0C fwd. 58 58 ... ... @@ -59,63 +59,55 @@ 59 59 [[image:image-20220527153913-3.png]] 60 60 61 61 62 -**When the compilation is complete a draginofwd-*.deb package is generated.** 63 63 59 +When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated. 60 + 64 64 [[image:image-20220527154311-4.png||height="385" width="773"]] 65 65 66 66 67 - 68 68 === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) === 69 69 70 70 71 71 **Run command:** 72 72 69 +(% style="background-color:yellow; color:green" %)**dpkg -i draginofwd-*.deb ** 73 73 74 -(% style="background-color:yellow;color:green" %)**dpkg -i draginofwd-*.deb ** 75 75 76 - 77 77 [[image:image-20220527154811-5.png]] 78 78 79 79 80 - 81 81 === (% style="color:blue" %)**Step 4. Test**(%%) === 82 82 83 83 84 -Check the dragino_fwd log: 78 +**Check the dragino_fwd log:** 85 85 86 -(% style="background-color:yellow;color:green" %)journalctl -u draginofwd -f 80 +(% style="background-color:yellow; color:green" %)**journalctl -u draginofwd -f** 87 87 88 88 89 89 [[image:image-20220527165221-7.png||height="182" width="931"]] 90 90 91 91 92 -Start/stop dragino_fwd via systemctl: 86 +**Start/stop dragino_fwd via systemctl:** 93 93 88 +(% style="background-color:yellow; color:green" %)**systemctl start draginofwd** 94 94 95 -(% style="background-color:yellow;color:green" %)systemctl st artdraginofwd90 +(% style="background-color:yellow; color:green" %)**systemctl stop draginofwd** 96 96 97 -(% style="background-color:yellow;color:green" %)systemctl stop draginofwd 98 98 99 - 100 - 101 - 102 102 == 2.2 How to clone Complete OS on the EMMC to SD card == 103 103 104 - 105 - 106 106 == 2.3 How to flash SD card to (eMMC) device's built-in Memory == 107 107 108 - 109 109 === 2.3.1 Prepare an SD card with OS === 110 110 111 111 112 - //**Preparations:**// 100 + (% style="background-color:yellow" %)//**Preparations:**// 113 113 114 114 ~1. Prepare an SD card and a// card reader device// 115 115 116 116 2. Formatting the SD card (//Make sure the SD card is empty//) 117 117 118 -3. //Download the OS image from **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )// 106 +3. //Download the OS image from the **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )// 119 119 120 120 4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )// 121 121 ... ... @@ -133,31 +133,36 @@ 133 133 134 134 **Run command:** 135 135 136 -(% style="background-color:yellow;color:green" %) 137 -nand-sata-install 124 +(% style="background-color:yellow; color:green" %)**nand-sata-install** 138 138 139 139 140 140 [[image:image-20220602112051-1.png]] 141 141 142 142 143 -Select the "Boot from eMMC - system on eMMC" 144 144 131 +Select the (% style="color:red" %)**"Boot from eMMC - system on eMMC".** 132 + 145 145 [[image:image-20220602112058-2.png||height="292" width="646"]] 146 146 135 + 147 147 [[image:image-20220602112106-3.png||height="301" width="643"]] 148 148 149 149 150 -Select the "1 ext4" 151 151 140 +Select the (% style="color:red" %)**"1 ext4"** 141 + 152 152 [[image:image-20220602112113-4.png||height="271" width="642"]] 153 153 154 154 145 + 155 155 It takes 4-5 minutes to burn from SD card to eMMC 156 156 157 157 [[image:image-20220602112119-5.png||height="309" width="641"]] 158 158 150 + 159 159 [[image:image-20220602112125-6.png||height="281" width="640"]] 160 160 153 + 161 161 [[image:image-20220602112131-7.png||height="241" width="638"]] 162 162 163 163 ... ... @@ -164,13 +164,133 @@ 164 164 (% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.** 165 165 166 166 160 +== 2.4 Default Built Version == 167 167 168 -= 3. Package Maintain Note = 169 169 163 +[[image:image-20220902155621-1.png]] 170 170 171 -== 3.1 Default Package Maintain System == 172 172 166 +== 2.5 How to upgrade the nodejs version to the latest. == 173 173 168 + 169 +By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old. 170 + 171 +[[image:image-20221112145029-2.png]] 172 + 173 +**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.** 174 + 175 + 176 +#install n, which is an Interactively Manage Your Node.js Versions 177 + 178 +[[image:image-20221112154230-3.png||height="89" width="689"]] 179 + 180 +(% class="box infomessage" %) 181 +((( 182 +**npm install -g n** 183 +))) 184 + 185 + 186 +#Install the latest LTS Node.js release (downloading if necessary) 187 + 188 +[[image:image-20221112154418-4.png||height="184" width="893"]] 189 + 190 +(% class="box infomessage" %) 191 +((( 192 +**n lts** 193 +))) 194 + 195 + 196 +#Remove all downloaded versions except the installed version 197 + 198 +[[image:image-20221112154456-5.png||height="139" width="899"]] 199 + 200 +(% class="box infomessage" %) 201 +((( 202 +**n prune** 203 +))) 204 + 205 + 206 +(% class="box infomessage" %) 207 +((( 208 +**apt remove nodejs -y && apt autoremove -y && reboot** 209 +))) 210 + 211 + 212 +Check the current version 213 + 214 +[[image:image-20221112154724-6.png]] 215 + 216 +(% class="box infomessage" %) 217 +((( 218 +**node -v** 219 +))) 220 + 221 + 222 +== 2.6 How to install Grafana and influxdb == 223 + 224 + 225 +=== **Grafana:** === 226 + 227 + 228 +(% class="box infomessage" %) 229 +((( 230 +curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null 231 +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 232 +apt update && apt install grafana 233 +))) 234 + 235 + 236 +Check the running status: 237 + 238 + 239 +(% class="box infomessage" %) 240 +((( 241 +systemctl status grafana-server 242 +))) 243 + 244 + 245 +configuration path: 246 + 247 + 248 +(% class="box infomessage" %) 249 +((( 250 +/etc/grafana/grafana.ini 251 +))) 252 + 253 + 254 +=== **Influxdb:** === 255 + 256 + 257 +(% class="box infomessage" %) 258 +((( 259 +curl https:~/~/repos.influxdata.com/influxdb.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null 260 +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 261 +apt update && apt install influxdb 262 +))) 263 + 264 + 265 +Check the running status: 266 + 267 + 268 +(% class="box infomessage" %) 269 +((( 270 +systemctl status influxdb 271 +))) 272 + 273 + 274 +configuration path: 275 + 276 + 277 +(% class="box infomessage" %) 278 +((( 279 +/etc/influxdb/influxdb.conf 280 +))) 281 + 282 + 283 += 3. Package Maintain Note = 284 + 285 +== 3.1 Default Package Maintain System == 286 + 174 174 === 3.1.1 How Package-Auto-Update works? === 175 175 176 176 ... ... @@ -195,6 +195,7 @@ 195 195 draginoups ~-~- Miscellaneous between different versions 196 196 197 197 311 + 198 198 (% style="color:blue" %)**Location and changelog for packages**: 199 199 200 200 * Location: http:~/~/repo.dragino.com/release/tool/ ... ... @@ -208,9 +208,10 @@ 208 208 [[image:1661305025451-220.png]] 209 209 210 210 325 + 211 211 (% style="color:blue" %)**Can I disable package-auto-update?** 212 212 213 -You can check the checkbox and click the(% style="color: #037691" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.328 +You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 214 214 215 215 216 216 [[image:1661305258501-636.png]] ... ... @@ -220,7 +220,7 @@ 220 220 === 3.1.2 How to manually update core packages? === 221 221 222 222 223 -You can click the (% style="color: #037691" %)**‘Manual Update’**(%%) to update the dragino's packages.338 +You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. 224 224 225 225 226 226 [[image:1661305328295-218.png]] ... ... @@ -236,7 +236,6 @@ 236 236 237 237 == 3.2 Set up a 3^^rd^^ party package maintain server == 238 238 239 - 240 240 === 3.2.1 Overview === 241 241 242 242 ... ... @@ -243,22 +243,20 @@ 243 243 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. 244 244 245 245 246 - 247 247 === 3.2.2 Install Apache2 HTTP server === 248 248 249 249 250 -(% style="background-color:yellow;color:green" %)**apt install apache2** 363 +(% style="background-color:yellow; color:green" %)**apt install apache2** 251 251 252 252 253 - 254 254 === 3.2.3 Creating Package Directories === 255 255 256 256 257 -**~ (% style="background-color:yellow;color:green" %)cd /var/www/html/(%%)** 369 +**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** 258 258 259 -**~ (% style="background-color:yellow;color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 371 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 260 260 261 -**~ (% style="background-color:yellow;color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 373 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 262 262 263 263 264 264 **Tree Structure:** ... ... @@ -284,10 +284,9 @@ 284 284 285 285 └── d 286 286 287 - └── dragino ~-~-> (% style="background-color:yellow;color:green" %)**This is the directory to store the packages. User can change it to other name.** 399 + └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** 288 288 289 289 290 - 291 291 === 3.2.4 Get deb packages === 292 292 293 293 ... ... @@ -296,89 +296,85 @@ 296 296 Below is an example package(testing-0808.deb) for test purpose: 297 297 298 298 299 -**~ (% style="background-color:yellow;color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 410 +**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 300 300 301 -**~ (% style="background-color:yellow;color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 412 +**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 302 302 303 303 304 - 305 305 === 3.2.5 Generate Package Index file === 306 306 307 307 308 -(% style="background-color:yellow;color:green" %)**cd /var/www/html/debian/release/** 418 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** 309 309 310 -(% style="background-color:yellow;color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 420 +(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 311 311 312 -(% style="background-color:yellow;color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 422 +(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 313 313 314 314 315 315 (% 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.** 316 316 317 317 318 - 319 319 === 3.2.6 Generate Release file === 320 320 321 321 322 -==== (% style="color:blue" %)Create the generated script:(%%) ==== 431 +==== (% style="color:blue" %)**Create the generated script:**(%%) ==== 323 323 324 324 325 -(% style="background-color:yellow;color:green" %)**cd /var/www/html/debian/release/dists/stable** 434 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 326 326 327 327 328 -(% 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]]** 437 +(% 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]]** 329 329 330 -(% style="background-color:yellow;color:green" %)**chmod + x ./generate-release.sh** 439 +(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** 331 331 332 -(% style="background-color:yellow;color:green" %)**./generate-release.sh > Release** 441 +(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** 333 333 334 334 335 - 336 336 === 3.2.7 Sign the Release file with gpg and generating Inrelease file === 337 337 338 338 447 +==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== 339 339 340 -==== (% style="color:blue" %)Make sure auto-update server has gnupg(%%) ==== 341 341 450 +(% style="background-color:yellow; color:green" %)**apt install gnupg** 342 342 343 -(% style="background-color:yellow;color:green" %)**apt install gnupg** 344 344 345 345 454 +==== (% style="color:blue" %)**generate gpg key**(%%) ==== 346 346 347 -==== (% style="color:blue" %)generate gpg key(%%) ==== 348 348 457 +(% style="background-color:yellow; color:green" %)**gpg -gen-key** 349 349 350 -(% style="background-color:yellow;color:green" %)**gpg -gen-key** 351 351 460 +(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** 352 352 353 -**((% style="color:red" %)Note: Fill in the content as required and remember the name and email address)(%%)** 354 354 355 355 464 +==== (% style="color:blue" %)**Check the gen-key**(%%) ==== 356 356 357 -==== (% style="color:blue" %)Check the gen-key(%%) ==== 358 358 467 +(% style="background-color:yellow; color:green" %)**gen -list-key** 359 359 360 -(% style="background-color:yellow;color:green" %)**gen -list-key** 361 361 362 362 471 +==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== 363 363 364 -==== (% style="color:blue" %)Generate the release.gpg(%%) ==== 365 365 474 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 366 366 367 -(% style="background-color:yellow;color:green" %)** cd/var/www/html/debian/release/dists/stable**476 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 368 368 369 -(% style="background-color:yellow;color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 370 370 479 +(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** 371 371 372 -(% style="background-color:yellow;color:green" %)**gpg ~-~-clearsign -o InRelease Release** 373 373 374 374 483 +==== (% style="color:blue" %)**Generate the public key**(%%) ==== 375 375 376 -==== (% style="color:blue" %)Generate the public key(%%) ==== 377 377 486 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 378 378 379 -(% style="background-color:yellow;color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 380 380 381 - 382 382 **example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 383 383 384 384 ... ... @@ -387,30 +387,31 @@ 387 387 388 388 389 389 390 -==== (% style="color:blue" %)Add the public key(%%) ==== 497 +==== (% style="color:blue" %)**Add the public key**(%%) ==== 391 391 392 392 393 -(% style="background-color:yellow;color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 500 +(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 394 394 502 + 395 395 (% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 396 396 397 397 398 398 399 -==== (% style="color:blue" %)Add the apt source list(%%) ==== 507 +==== (% style="color:blue" %)**Add the apt source list**(%%) ==== 400 400 401 401 402 402 Add the apt source list url and name this as test_server.list 403 403 404 -(% 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** 512 +(% 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** 405 405 406 406 407 407 408 -==== (% style="color:blue" %)Validate the apt repository(%%) ==== 516 +==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== 409 409 410 410 411 411 Get and install the testing package (download testing-0808.deb and test) 412 412 413 -(% style="background-color:yellow;color:green" %)**apt update && apt install testing** 521 +(% style="background-color:yellow; color:green" %)**apt update && apt install testing** 414 414 415 415 416 416 Example output: ... ... @@ -418,14 +418,13 @@ 418 418 [[image:1661306420449-569.png]] 419 419 420 420 421 - 422 422 === 3.2.9 Configure the gateway's auto-upgrade rules === 423 423 424 424 425 -==== (% style="color:blue" %)Remove dragino apt source(%%) ==== 532 +==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== 426 426 427 427 428 -(% style="background-color:yellow;color:green" %)**/etc/apt/sources.list** 535 +(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** 429 429 430 430 431 431 [[image:1661306460134-112.png]] ... ... @@ -432,10 +432,10 @@ 432 432 433 433 434 434 435 -==== (% style="color:blue" %)Set up automatic updates(%%) ==== 542 +==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== 436 436 437 437 438 -(% style="background-color:yellow;color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 545 +(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 439 439 440 440 441 441 The device performs automatic updates from this script, ... ... @@ -444,5 +444,3 @@ 444 444 445 445 446 446 [[image:1661306487761-768.png]] 447 - 448 -
- 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