Changes for page Armbian OS instruction
Last modified by Edwin Chen on 2025/02/26 08:18
From version 124.1
edited by Edwin Chen
on 2025/02/26 08:18
on 2025/02/26 08:18
Change comment:
There is no comment for this version
To 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
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 48 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
- image-20241107100901-1.png
- image-20241107100929-2.png
- image-20250224114945-1.png
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Edwin1 +XWiki.Kilight - Content
-
... ... @@ -2,744 +2,120 @@ 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 -**2.2.2 Mounting a USB Flash Drive/SD Card in the Linux CLI** 101 - 102 - 103 -(% id="cke_bm_13244S" style="display:none" %) [[image:image-20241107100929-2.png||height="208" width="669"]] 104 - 105 -mount /dev/sda1 /mnt/ 106 - 107 - 108 -**2.2.3 Using the dd command, copy Emmc as an img file** 109 - 110 - 111 -[[image:image-20241107100901-1.png||height="269" width="994"]] 112 - 113 - 114 -dd if=/dev/mmcblk2 of=/mnt/custom.img bs=1M count=3686 status=progress 115 - 116 - 117 -**2.2.4 Export the img file and follow the steps in 2.3 for burning** 118 - 119 - 120 - 121 -== 2.3 How to flash a new image(OS) to the gateway(LPS8V2) == 122 - 123 - 124 -Since the gateway has a large system, you need to use the sd card to reflash the system for the gateway 125 - 126 - 127 -//2.3.1: Making an SD card with the new image// 128 - 129 -//2.3.2: Instal the SD card to the gateway// 130 - 131 -//2.3.3: Flash the image to the gateway's built memory from the SD card// 132 - 133 -//2.3.4: Finished the process of flash and power cycle the gateway// 134 - 135 - 136 -==== (% style="background-color:yellow" %)**//Preparations~://**(%%) ==== 137 - 138 -1. Prepare an SD card 139 -1. Prepare a card reader device 140 -1. Download the OS image from the release.image~: **[[draginolps8v2-release-v1.7>>http://repo.dragino.com/release/hp0c-image/]]** 141 -1. A Flash software tool ( Such as v1.7.9 from [[balenaEtcher>>url:https://www.balena.io/etcher/]] ) 142 -1. SD Card [[format>>url:http://repo.dragino.com/release/tool/PanasonicSDFormatter.zip]] tool 143 - 144 -=== **2.3.1 Making an SD Card with the new image** === 145 - 146 - 147 -==== Step 1. Formatting the SD Card ==== 148 - 149 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609111027-9.png?rev=1.1||alt="image-20220609111027-9.png" height="318" width="292"]] 150 - 151 - 152 -==== Step 2. Select the OS image ==== 153 - 154 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104907-8.png?rev=1.1||alt="image-20220609104907-8.png" height="435" width="689"]] 155 - 156 - 157 -==== Step 3. Select the target ==== 158 - 159 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104637-2.png?rev=1.1||alt="image-20220609104637-2.png" height="436" width="690"]] 160 - 161 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104701-3.png?rev=1.1||alt="image-20220609104701-3.png" height="436" width="690"]] 162 - 163 - 164 -==== Step 4. Flash start ==== 165 - 166 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104727-4.png?rev=1.1||alt="image-20220609104727-4.png" height="435" width="689"]] 167 - 168 -[[image:http://wiki.dragino.com/xwiki/bin/download/Main/User%20Manual%20for%20All%20Gateway%20models/HP0D/WebHome/image-20220609104741-5.png?rev=1.1||alt="image-20220609104741-5.png" height="434" width="687"]] 169 - 170 - 171 - 172 -=== **2.3.2 Instal the SD card to the gateway** === 173 - 174 -1. Open the device's enclosure, and put the SD card into the SD card slot 175 - 176 -[[image:image-20230712201032-1.png]] 177 - 178 - 179 -2. Power the gateway with 5V2A, and access the gateway's Ethernet port to your PC 180 - 181 -[[image:image-20230712201458-3.png||height="649" width="832"]] 182 - 183 - 184 -Note: The PWR LED on red 185 - 186 - The LAN LED blink 187 - 188 - The SYS LED on red 189 - 190 - 191 - 192 -=== **3.2.3 Flash the image to the gateway's built memory from the SD card(LPS8v2)** === 193 - 194 - 195 -Access the gateway Linux CLI to flash the image to the gateway's built memory 196 - 197 - 198 -* **Use the IP address to access the gateway CLI** 199 - 200 -Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it. 201 - 202 - 203 -IP address: IP address of gateway or **Fallback IP**(172.31.255.254) 204 - 205 -Port: 22 206 - 207 -User Name: (% style="color:blue" %)**root** 208 - 209 -Password: (% style="color:blue" %)**dragino**(%%) (default) 210 - 211 -//After logging in, you will be in the gateway CLI and can enter commands as shown below.// 212 - 213 - 214 -[[image:image-20230508155357-1.png||height="225" width="634"]] 215 - 216 - 217 -**Run command:** 218 - 219 -draginolps8v2-release-chirpsrtack-v1.7-240725 image : 220 - 221 -(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-ChirpStack-240725-1.img ** 222 - 223 -draginolps8v2-release-ttnstack-v1.7-240712 image : 224 - 225 -(% style="background-color:#ffff00; color:#008000" %)** flash_emmc /usr/local/image/dragino-LPS8V2-TTN-231124.img** 226 - 227 -[[image:image-20241008091850-2.png]] 228 - 229 -(% style="color:red" %)**Note: Note: After the flash is completed, please power off the device (run the command halt) and disconnect the power supply, and then unplug the SD card.** 230 - 231 - 232 -=== **3.2.4 Flash the image to the gateway's built memory from the SD card(MS48-LR/LG01v2)** === 233 - 234 - 235 -Download the OS image from the release.image~: **[[MS48-LR-image>>https://www.dropbox.com/scl/fi/ug25bbwyk6gnqjnsee2m1/dragino-MS48-LR-231124.rar?rlkey=bqva7hkeft0m3haiui5uj12sv&st=ii6mp2g7&dl=0]] [[LG01v2-image>>https://www.dropbox.com/scl/fi/g0si61lcrvdjyto4ma951/dragino-lg01v2-1.7-0210.zip?rlkey=t03oqo493r2p7ign488rs2jsv&dl=0]]** 236 - 237 - 238 -Access the gateway Linux CLI to flash the image to the gateway's built memory 239 - 240 -* **Use the IP address to access the gateway CLI** 241 - 242 -Users can access the gateway CLI via the SSH protocol. Make sure your PC and the gateway are connected to the same network, then use a SSH tool (such as [[putty>>url:http://www.chiark.greenend.org.uk/~~sgtatham/putty/download.html]] in Windows) to access it. 243 - 244 -IP address: IP address of gateway or **Fallback IP**(172.31.255.254) 245 - 246 -Port: 22 247 - 248 248 User Name: **root** 249 249 250 -Password: 30 +Password: **draginohp** (default) 251 251 252 - //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. 253 253 254 -[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20230508155357-1.png?rev=1.1&width=634&height=225||alt="image-20230508155357-1.png" height="225" width="634"]] 255 255 256 - **Runcommand:**35 +== How to burn from SD card to eMMC == 257 257 258 - **nand-sata-install**37 +[[image:image-20220602112051-1.png]] 259 259 260 -[[image: https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112051-1.png?rev=1.1||alt="image-20220602112051-1.png"]]39 +[[image:image-20220602112058-2.png||height="292" width="646"]] 261 261 262 - Select the**"Bootfrom eMMC - system on eMMC".**41 +[[image:image-20220602112106-3.png||height="301" width="643"]] 263 263 264 -[[image: https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112058-2.png?rev=1.1&width=646&height=292||alt="image-20220602112058-2.png"height="292" width="646"]]43 +[[image:image-20220602112113-4.png||height="271" width="642"]] 265 265 266 -[[image: https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112106-3.png?rev=1.1&width=643&height=301||alt="image-20220602112106-3.png"height="301" width="643"]]45 +[[image:image-20220602112119-5.png||height="309" width="641"]] 267 267 268 - Select the**"1ext4"**47 +[[image:image-20220602112125-6.png||height="281" width="640"]] 269 269 270 -[[image: https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112113-4.png?rev=1.1&width=642&height=271||alt="image-20220602112113-4.png"height="271" width="642"]]49 +[[image:image-20220602112131-7.png||height="241" width="638"]] 271 271 272 - Ittakes4-5minutestoburnfromSDcardtoeMMC51 +== How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == 273 273 274 - [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112119-5.png?rev=1.1&width=641&height=309||alt="image-20220602112119-5.png"height="309" width="641"]]53 +=== Step 1. Clone dragino-fwd package === 275 275 276 -[[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112125-6.png?rev=1.1&width=640&height=281||alt="image-20220602112125-6.png" height="281" width="640"]] 277 277 278 - [[image:https://wiki.dragino.com/xwiki/bin/downloadrev/Main/Armbian%20OS%20instruction/WebHome/image-20220602112131-7.png?rev=1.1&width=638&height=241||alt="image-20220602112131-7.png" height="241" width="638"]]56 +Run command clone dragino-fwd package: 279 279 280 -**Note: After the flash is complete, power off the device and then remove the SD card.** 281 - 282 - 283 - 284 -=== **3.2.5 Trouble Shooting** === 285 - 286 - 287 -==== **Why is no space displayed after flash LPS8V2 built-in TTN image** ==== 288 - 289 -Because the space that emmc can burn is only 3.6G memory, it displays the "No space" error, 290 - 291 -The error does not affect the flash image and gateway work. 292 - 293 -[[image:image-20250224114945-1.png]] 294 - 295 - 296 -== 2.4 How to extend the gateway size of memory with SD card == 297 - 298 - 299 -Users can use the SD card slot to expand the gateway memory size by following the steps below 300 - 301 - 302 -=== 2.4.1 View SD card information === 303 - 304 304 (% class="box infomessage" %) 305 305 ((( 306 - fdisk-l60 +git clone https:~/~/github.com/dragino/dragino_fwd_src.git 307 307 ))) 308 308 309 -[[image:image-202 30831150518-3.png]]63 +[[image:image-20220527151010-1.png]] 310 310 311 311 312 -=== 2.4.2 Displaysthecurrentfilesystemdisk usage statistics onLinux systems===66 +=== Step 2. Compile dragino_fwd === 313 313 314 314 315 -(% class="box infomessage" %) 316 -((( 317 -df -h 318 -))) 69 +After cloning is complete, Run the command starts compiling: 319 319 320 -[[image:image-20230831150341-2.png]] 321 - 322 - 323 -=== 2.4.3 Mount SD card === 324 - 325 - 326 326 (% class="box infomessage" %) 327 327 ((( 328 -mkdir /mnt/sd 329 - 330 -mount /dev/mmcblk0p1 /mnt/sd 73 +Compile HP0D/rasspberrypi fwd: ./hp0z-make-deb.sh d 74 +Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c 331 331 ))) 332 332 333 - After themount is successfultocheck the filesystem disk usage on the Linux systemagain:77 +The following example compilers HP0C fwd. 334 334 335 -[[image:image-202 30831151432-4.png]]79 +[[image:image-20220527153913-3.png]] 336 336 337 337 338 - Ifthe mountfails,youcan format the filesystemandtry the mountagain82 +**When the compilation is complete a draginofwd-*.deb package is generated.** 339 339 340 -(% class="box infomessage" %) 341 -((( 342 -mkfs.ext4 /dev/mmcblk0p1 343 -))) 84 +[[image:image-20220527154311-4.png||height="385" width="773"]] 344 344 345 -== 2.5 Default Built Version == 346 346 87 +=== Step 3. Install the dragino_fwd === 347 347 348 -[[image:image-20220902155621-1.png]] 349 349 90 +Run command: 350 350 351 -== 2.6 How to upgrade the nodejs version to the latest. == 352 - 353 - 354 -By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old. 355 - 356 -[[image:image-20221112145029-2.png]] 357 - 358 -**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.** 359 - 360 - 361 -#install n, which is an Interactively Manage Your Node.js Versions 362 - 363 -[[image:image-20221112154230-3.png||height="89" width="689"]] 364 - 365 365 (% class="box infomessage" %) 366 366 ((( 367 - **npminstall-g*94 +dpkg -i draginofwd-*.deb 368 368 ))) 369 369 97 +[[image:image-20220527154811-5.png]] 370 370 371 -#Install the latest LTS Node.js release (downloading if necessary) 372 372 373 - [[image:image-20221112154418-4.png||height="184"width="893"]]100 +=== Step 4. Test === 374 374 375 -(% class="box infomessage" %) 376 -((( 377 -**n lts** 378 -))) 379 379 103 +Check the dragino_fwd log: 380 380 381 -#Remove all downloaded versions except the installed version 382 - 383 -[[image:image-20221112154456-5.png||height="139" width="899"]] 384 - 385 385 (% class="box infomessage" %) 386 386 ((( 387 - **nprune**107 +journalctl -u draginofwd -f 388 388 ))) 389 389 110 +[[image:image-20220527165221-7.png||height="182" width="931"]] 390 390 391 -(% class="box infomessage" %) 392 -((( 393 -**apt remove nodejs -y && apt autoremove -y && reboot** 394 -))) 112 +Start/stop dragino_fwd via systemctl: 395 395 396 - 397 -Check the current version 398 - 399 -[[image:image-20221112154724-6.png]] 400 - 401 401 (% class="box infomessage" %) 402 402 ((( 403 -**node -v** 116 +systemctl start draginofwd 117 +systemctl stop draginofwd 404 404 ))) 405 405 406 406 407 -== 2.7 How to install Grafana and influxdb == 408 - 409 - 410 -=== **Grafana:** === 411 - 412 - 413 -(% class="box infomessage" %) 414 -((( 415 -curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null 416 -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 417 -apt update && apt install grafana 418 -))) 419 - 420 - 421 -Check the running status: 422 - 423 - 424 -(% class="box infomessage" %) 425 -((( 426 -systemctl status grafana-server 427 -))) 428 - 429 - 430 -configuration path: 431 - 432 - 433 -(% class="box infomessage" %) 434 -((( 435 -/etc/grafana/grafana.ini 436 -))) 437 - 438 - 439 -=== **Influxdb:** === 440 - 441 - 442 -(% class="box infomessage" %) 443 -((( 444 -curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null 445 -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 446 -apt update && apt install influxdb 447 -))) 448 - 449 - 450 -Check the running status: 451 - 452 - 453 -(% class="box infomessage" %) 454 -((( 455 -systemctl status influxdb 456 -))) 457 - 458 - 459 -configuration path: 460 - 461 - 462 -(% class="box infomessage" %) 463 -((( 464 -/etc/influxdb/influxdb.conf 465 -))) 466 - 467 - 468 -= 3. Package Management = 469 - 470 -== 3.1 Default Package Maintain System == 471 - 472 -=== 3.1.1 How Package-Auto-Update works? === 473 - 474 - 475 -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. 476 - 477 - 478 -(% style="color:blue" %)**When devices will check for updates**? 479 - 480 -* Devices will check for updates for every boot. 481 -* Devices will check for updates on every day midnight. 482 - 483 -(% style="color:blue" %)**What packages will be checked for updates**? 484 - 485 -dragino-httpd ~-~- Main Web UI http configuration 486 - 487 -dragino-sid ~-~- SN write and read tool 488 - 489 -dragino-ui ~-~- Gateway Web UI package 490 - 491 -draginofwd ~-~- UDP packet forwarder, LoRa Base Station 492 - 493 -draginoups ~-~- Miscellaneous between different versions 494 - 495 - 496 - 497 -(% style="color:blue" %)**Location and changelog for packages**: 498 - 499 -* Location: http:~/~/repo.dragino.com/release/tool/ 500 -* Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]] 501 - 502 -(% style="color:blue" %)**How to view auto-updated log** 503 - 504 -You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.** 505 - 506 - 507 -[[image:1661305025451-220.png]] 508 - 509 - 510 - 511 -(% style="color:blue" %)**Can I disable package-auto-update?** 512 - 513 -You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 514 - 515 - 516 -[[image:1661305258501-636.png]] 517 - 518 - 519 -=== 3.1.2 How to manually update core packages? === 520 - 521 - 522 -You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. 523 - 524 - 525 -[[image:1661305328295-218.png]] 526 - 527 - 528 -=== 3.1.3 How to manually update other packages? === 529 - 530 - 531 -For the other packages, you have to access the device's CLI to do it via the apt command. 532 - 533 -Example: 534 - 535 -(% class="box infomessage" %) 536 -((( 537 -dpkg -i draginofwd-*.deb 538 -))) 539 - 540 - 541 -== 3.2 Set up a 3^^rd^^ party package maintain server == 542 - 543 -=== 3.2.1 Overview === 544 - 545 - 546 -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. 547 - 548 - 549 -=== 3.2.2 Install Apache2 HTTP server === 550 - 551 - 552 -(% style="background-color:yellow; color:green" %)**apt install apache2** 553 - 554 - 555 -=== 3.2.3 Creating Package Directories === 556 - 557 - 558 -**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** 559 - 560 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 561 - 562 -**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 563 - 564 - 565 -**Tree Structure:** 566 - 567 -(% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.** 568 - 569 - 570 -└── debian 571 - 572 - └── release 573 - 574 - ├── dists 575 - 576 - │ └── stable 577 - 578 - │ └── main 579 - 580 - │ └── binary-armhf 581 - 582 - └── pool 583 - 584 - └── main 585 - 586 - └── d 587 - 588 - └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** 589 - 590 - 591 -=== 3.2.4 Get deb packages === 592 - 593 - 594 -The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)** 595 - 596 -Below is an example package(testing-0808.deb) for test purpose: 597 - 598 - 599 -**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 600 - 601 -**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 602 - 603 - 604 -=== 3.2.5 Generate Package Index file === 605 - 606 - 607 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** 608 - 609 -(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 610 - 611 -(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 612 - 613 - 614 -(% 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.** 615 - 616 - 617 -=== 3.2.6 Generate Release file === 618 - 619 - 620 -==== (% style="color:blue" %)**Create the generated script:**(%%) ==== 621 - 622 - 623 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 624 - 625 - 626 -(% 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]]** 627 - 628 -(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** 629 - 630 -(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** 631 - 632 - 633 -=== 3.2.7 Sign the Release file with gpg and generating Inrelease file === 634 - 635 - 636 -==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== 637 - 638 - 639 -(% style="background-color:yellow; color:green" %)**apt install gnupg** 640 - 641 - 642 - 643 -==== (% style="color:blue" %)**generate gpg key**(%%) ==== 644 - 645 - 646 -(% style="background-color:yellow; color:green" %)**gpg -gen-key** 647 - 648 - 649 -(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** 650 - 651 - 652 - 653 -==== (% style="color:blue" %)**Check the gen-key**(%%) ==== 654 - 655 - 656 -(% style="background-color:yellow; color:green" %)**gen -list-key** 657 - 658 - 659 - 660 -==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== 661 - 662 - 663 -(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 664 - 665 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 666 - 667 - 668 -(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** 669 - 670 - 671 - 672 -==== (% style="color:blue" %)**Generate the public key**(%%) ==== 673 - 674 - 675 -(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 676 - 677 - 678 -**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 679 - 680 - 681 - 682 -=== 3.2.8 Add url as apt source in LPS8v2 / MS20 === 683 - 684 - 685 - 686 -==== (% style="color:blue" %)**Add the public key**(%%) ==== 687 - 688 - 689 -(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 690 - 691 - 692 -(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 693 - 694 - 695 - 696 -==== (% style="color:blue" %)**Add the apt source list**(%%) ==== 697 - 698 - 699 -Add the apt source list url and name this as test_server.list 700 - 701 -(% 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** 702 - 703 - 704 - 705 -==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== 706 - 707 - 708 -Get and install the testing package (download testing-0808.deb and test) 709 - 710 -(% style="background-color:yellow; color:green" %)**apt update && apt install testing** 711 - 712 - 713 -Example output: 714 - 715 -[[image:1661306420449-569.png]] 716 - 717 - 718 -=== 3.2.9 Configure the gateway's auto-upgrade rules === 719 - 720 - 721 -==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== 722 - 723 - 724 -(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** 725 - 726 - 727 -[[image:1661306460134-112.png]] 728 - 729 - 730 - 731 -==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== 732 - 733 - 734 -(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 735 - 736 - 737 -The device performs automatic updates from this script, 738 - 739 -But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword. 740 - 741 - 742 -[[image:1661306487761-768.png]] 743 - 744 - 745 745
- 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
- image-20241107100901-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -66.7 KB - Content
- image-20241107100929-2.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Xiaoye - Size
-
... ... @@ -1,1 +1,0 @@ 1 -33.3 KB - Content
- image-20250224114945-1.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.Kilight - Size
-
... ... @@ -1,1 +1,0 @@ 1 -21.6 KB - Content