Wiki source code of Armbian OS instruction
Version 90.1 by Kilight Cao on 2023/03/27 16:59
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
15.1 | 1 | **Table of Contents：** |
| 2 | |||
| 3 | {{toc/}} | ||
| 4 | |||
 |
1.1 | 5 | |
| |
50.1 | 6 | |
| 7 | |||
| |
48.2 | 8 | = 1. Overview = |
| 9 | |||
| 10 | |||
| |
1.1 | 11 | This is a general instruction for the use of Armbian base OS of Dragino devices. Current models include: |
| 12 | |||
| 13 | * HP0A | ||
| 14 | * HP0C | ||
| 15 | * LPS8v2 | ||
| |
55.1 | 16 | * MS20 |
| |
1.1 | 17 | |
| |
48.2 | 18 | = 2. Development Guide = |
| 19 | |||
| 20 | |||
| |
70.4 | 21 | For advanced users to develop Driver/ Linux etc. |
| |
4.1 | 22 | |
| |
25.1 | 23 | |
| |
48.2 | 24 | == 2.1 How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == |
| |
4.1 | 25 | |
| 26 | |||
| |
48.3 | 27 | === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) === |
| |
4.1 | 28 | |
| |
30.1 | 29 | |
| |
70.4 | 30 | **Requirements:** |
| |
48.3 | 31 | |
| |
70.4 | 32 | **~ (% style="background-color:yellow; color:green" %)sudo apt install -y libsqlite3-dev(%%)** |
| |
30.1 | 33 | |
| |
70.4 | 34 | **~ (% style="background-color:yellow; color:green" %)sudo apt install -y libftdi1-dev(%%)** |
| |
11.1 | 35 | |
| |
48.3 | 36 | |
| |
70.4 | 37 | **Run command clone dragino-fwd package: (% style="background-color:yellow; color:green" %)git clone https:~/~/github.com/dragino/dragino_fwd_src.git(%%)** |
| |
11.1 | 38 | |
| |
70.4 | 39 | |
| |
11.1 | 40 | [[image:image-20220527151010-1.png]] |
| 41 | |||
| 42 | |||
| |
48.3 | 43 | === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) === |
| |
48.1 | 44 | |
| |
11.1 | 45 | |
| |
70.4 | 46 | **After cloning is complete, Run the command starts compiling:** |
| |
48.3 | 47 | |
| |
70.5 | 48 | (% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c** |
| |
70.4 | 49 | |
| |
70.5 | 50 | |
| |
11.1 | 51 | The following example compilers HP0C fwd. |
| 52 | |||
| 53 | [[image:image-20220527153913-3.png]] | ||
| 54 | |||
| 55 | |||
| 56 | |||
| |
70.5 | 57 | When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated. |
| 58 | |||
| |
11.1 | 59 | [[image:image-20220527154311-4.png||height="385" width="773"]] |
| 60 | |||
| |
25.1 | 61 | |
| |
48.3 | 62 | === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) === |
| |
11.1 | 63 | |
| |
14.1 | 64 | |
| |
70.4 | 65 | **Run command:** |
| |
11.1 | 66 | |
| |
70.5 | 67 | (% style="background-color:yellow; color:green" %)**dpkg -i draginofwd-*.deb ** |
| |
11.1 | 68 | |
| |
70.4 | 69 | |
| |
11.1 | 70 | [[image:image-20220527154811-5.png]] |
| 71 | |||
| 72 | |||
| |
48.3 | 73 | === (% style="color:blue" %)**Step 4. Test**(%%) === |
| |
14.1 | 74 | |
| |
48.3 | 75 | |
| |
70.5 | 76 | **Check the dragino_fwd log:** |
| |
11.1 | 77 | |
| |
70.5 | 78 | (% style="background-color:yellow; color:green" %)**journalctl -u draginofwd -f** |
| |
11.1 | 79 | |
| |
70.4 | 80 | |
| |
13.1 | 81 | [[image:image-20220527165221-7.png||height="182" width="931"]] |
| |
11.1 | 82 | |
| |
48.3 | 83 | |
| |
70.5 | 84 | **Start/stop dragino_fwd via systemctl:** |
| |
11.1 | 85 | |
| |
70.5 | 86 | (% style="background-color:yellow; color:green" %)**systemctl start draginofwd** |
| |
13.1 | 87 | |
| |
70.5 | 88 | (% style="background-color:yellow; color:green" %)**systemctl stop draginofwd** |
| |
46.1 | 89 | |
| |
13.1 | 90 | |
| |
48.3 | 91 | == 2.2 How to clone Complete OS on the EMMC to SD card == |
| |
27.1 | 92 | |
| |
57.1 | 93 | == 2.3 How to flash SD card to (eMMC) device's built-in Memory == |
| |
48.3 | 94 | |
| |
67.2 | 95 | === 2.3.1 Prepare an SD card with OS === |
| |
57.1 | 96 | |
| |
67.2 | 97 | |
| |
70.5 | 98 | (% style="background-color:yellow" %)//**Preparations:**// |
| |
51.1 | 99 | |
| 100 | ~1. Prepare an SD card and a// card reader device// | ||
| 101 | |||
| 102 | 2. Formatting the SD card (//Make sure the SD card is empty//) | ||
| 103 | |||
| |
75.1 | 104 | 3. //Download the OS image from the **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )// |
| |
51.1 | 105 | |
| |
61.1 | 106 | 4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )// |
| |
51.1 | 107 | |
| 108 | |||
| 109 | |||
| |
67.2 | 110 | === 2.3.2 Flash SD card to device's eMMC === |
| 111 | |||
| 112 | |||
| |
57.1 | 113 | //1. Open the device's enclosure, and put the SD card into the SD card slot// |
| |
51.1 | 114 | |
| |
57.1 | 115 | //2. Power on the device and access the gateway's CLI via the serial port.// |
| |
51.1 | 116 | |
| |
57.1 | 117 | //3. Login and run the below command to flash.// |
| 118 | |||
| 119 | |||
| |
70.4 | 120 | **Run command:** |
| |
27.1 | 121 | |
| |
70.6 | 122 | (% style="background-color:yellow; color:green" %)**nand-sata-install** |
| |
27.1 | 123 | |
| |
70.4 | 124 | |
| |
27.1 | 125 | [[image:image-20220602112051-1.png]] |
| 126 | |||
| |
28.1 | 127 | |
| |
27.1 | 128 | |
| |
70.7 | 129 | Select the (% style="color:red" %)**"Boot from eMMC - system on eMMC".** |
| 130 | |||
| |
27.1 | 131 | [[image:image-20220602112058-2.png||height="292" width="646"]] |
| 132 | |||
| |
72.2 | 133 | |
| |
27.1 | 134 | [[image:image-20220602112106-3.png||height="301" width="643"]] |
| 135 | |||
| 136 | |||
| |
72.2 | 137 | |
| |
70.7 | 138 | Select the (% style="color:red" %)**"1 ext4"** |
| |
27.1 | 139 | |
| 140 | [[image:image-20220602112113-4.png||height="271" width="642"]] | ||
| 141 | |||
| 142 | |||
| |
70.7 | 143 | |
| |
27.1 | 144 | It takes 4-5 minutes to burn from SD card to eMMC |
| 145 | |||
| 146 | [[image:image-20220602112119-5.png||height="309" width="641"]] | ||
| 147 | |||
| |
72.2 | 148 | |
| |
27.1 | 149 | [[image:image-20220602112125-6.png||height="281" width="640"]] |
| 150 | |||
| |
72.2 | 151 | |
| |
27.1 | 152 | [[image:image-20220602112131-7.png||height="241" width="638"]] |
| 153 | |||
| 154 | |||
| 155 | (% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.** | ||
| 156 | |||
| |
28.1 | 157 | |
| |
72.1 | 158 | == 2.4 Default Built Version == |
| |
67.2 | 159 | |
| |
72.2 | 160 | |
| |
72.1 | 161 | [[image:image-20220902155621-1.png]] |
| 162 | |||
| 163 | |||
| |
84.2 | 164 | == 2.5 How to upgrade the nodejs version to the latest. == |
| |
72.1 | 165 | |
| |
78.1 | 166 | |
| 167 | By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old. | ||
| 168 | |||
| 169 | [[image:image-20221112145029-2.png]] | ||
| 170 | |||
| 171 | **If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.** | ||
| 172 | |||
| 173 | |||
| 174 | #install n, which is an Interactively Manage Your Node.js Versions | ||
| 175 | |||
| |
83.1 | 176 | [[image:image-20221112154230-3.png||height="89" width="689"]] |
| |
78.1 | 177 | |
| 178 | (% class="box infomessage" %) | ||
| 179 | ((( | ||
| 180 | **npm install -g n** | ||
| 181 | ))) | ||
| 182 | |||
| 183 | |||
| 184 | #Install the latest LTS Node.js release (downloading if necessary) | ||
| 185 | |||
| |
83.1 | 186 | [[image:image-20221112154418-4.png||height="184" width="893"]] |
| 187 | |||
| |
78.1 | 188 | (% class="box infomessage" %) |
| 189 | ((( | ||
| 190 | **n lts** | ||
| 191 | ))) | ||
| 192 | |||
| 193 | |||
| 194 | #Remove all downloaded versions except the installed version | ||
| 195 | |||
| |
83.1 | 196 | [[image:image-20221112154456-5.png||height="139" width="899"]] |
| |
78.1 | 197 | |
| 198 | (% class="box infomessage" %) | ||
| 199 | ((( | ||
| 200 | **n prune** | ||
| 201 | ))) | ||
| 202 | |||
| 203 | |||
| 204 | (% class="box infomessage" %) | ||
| 205 | ((( | ||
| |
83.1 | 206 | **apt remove nodejs -y && apt autoremove -y && reboot** |
| |
78.1 | 207 | ))) |
| 208 | |||
| 209 | |||
| 210 | Check the current version | ||
| 211 | |||
| |
83.1 | 212 | [[image:image-20221112154724-6.png]] |
| |
78.1 | 213 | |
| 214 | (% class="box infomessage" %) | ||
| 215 | ((( | ||
| 216 | **node -v** | ||
| 217 | ))) | ||
| 218 | |||
| 219 | |||
| |
84.1 | 220 | == 2.6 How to install Grafana and influxdb == |
| 221 | |||
| 222 | |||
| 223 | === **Grafana:** === | ||
| 224 | |||
| 225 | |||
| 226 | (% class="box infomessage" %) | ||
| 227 | ((( | ||
| 228 | curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null | ||
| 229 | 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 | ||
| 230 | apt update && apt install grafana | ||
| 231 | ))) | ||
| 232 | |||
| 233 | |||
| 234 | Check the running status: | ||
| 235 | |||
| 236 | |||
| 237 | (% class="box infomessage" %) | ||
| 238 | ((( | ||
| 239 | systemctl status grafana-server | ||
| 240 | ))) | ||
| 241 | |||
| 242 | |||
| 243 | configuration path: | ||
| 244 | |||
| 245 | |||
| 246 | (% class="box infomessage" %) | ||
| 247 | ((( | ||
| 248 | /etc/grafana/grafana.ini | ||
| 249 | ))) | ||
| 250 | |||
| 251 | |||
| 252 | === **Influxdb:** === | ||
| 253 | |||
| 254 | |||
| 255 | (% class="box infomessage" %) | ||
| 256 | ((( | ||
| 257 | curl https:~/~/repos.influxdata.com/influxdb.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null | ||
| 258 | 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 | ||
| 259 | apt update && apt install influxdb | ||
| 260 | ))) | ||
| 261 | |||
| 262 | |||
| 263 | Check the running status: | ||
| 264 | |||
| 265 | |||
| 266 | (% class="box infomessage" %) | ||
| 267 | ((( | ||
| 268 | systemctl status influxdb | ||
| 269 | ))) | ||
| 270 | |||
| 271 | |||
| 272 | configuration path: | ||
| 273 | |||
| 274 | |||
| 275 | (% class="box infomessage" %) | ||
| 276 | ((( | ||
| 277 | /etc/influxdb/influxdb.conf | ||
| 278 | ))) | ||
| 279 | |||
| 280 | |||
| |
90.1 | 281 | == 2.7 How to install BACnet == |
| |
63.1 | 282 | |
| |
90.1 | 283 | (% class="box infomessage" %) |
| 284 | ((( | ||
| 285 | wget [[http:~~/~~/dragino.vicp.io:6080/bacnet/dragino-bacnet-apps-hp0c-2023-03-01.deb>>url:http://dragino.vicp.io:6080/bacnet/dragino-bacnet-apps-hp0c-2023-03-01.deb]] | ||
| 286 | dpkg -i dragino-bacnet-apps-hp0c-2023-03-01.deb | ||
| 287 | ))) | ||
| 288 | |||
| 289 | [[image:image-20230327152105-1.png||height="163" width="933"]] | ||
| 290 | |||
| 291 | |||
| 292 | === 2.7.1 Configure BACnet === | ||
| 293 | |||
| 294 | |||
| 295 | After BACnet is installed, run commands to modify BACnet configurations | ||
| 296 | |||
| 297 | Note: device_port and bacnet_ip_port are not set to the same | ||
| 298 | |||
| 299 | (% class="box infomessage" %) | ||
| 300 | ((( | ||
| 301 | nano /etc/config/bacnet | ||
| 302 | ))) | ||
| 303 | |||
| 304 | Examples: | ||
| 305 | |||
| 306 | (% class="box infomessage" %) | ||
| 307 | ((( | ||
| 308 | config settings 'general' | ||
| 309 | option bacnet_ip '10.130.2.80' #The IP address of the BACnetIP network, here basically the same IP as the bbmd address below | ||
| 310 | option bacnet_ip_port '47808' #As with bbmd_port, the purpose of this is to register a Bacnet Server application as a bbmd registration server | ||
| 311 | option bbmd_address '10.130.2.80' #bbmd is the BACnet registration server. Only one bbmd server is required in the same ip network | ||
| 312 | option bbmd_port '47808' #In general, 47808 is used as the default port | ||
| 313 | option bacnet_dev_count '2' #Here is the number of BACnet devices that need to be simulated, if the number is 2, then the following settings must have 2, which are bacdev_1, bacdev_2 | ||
| 314 | |||
| 315 | config settings 'bacdev_1' | ||
| 316 | option device_name 'LHT65N-1' #The identification name of the bacnet device | ||
| 317 | option device_id '10001' #The unique identification code in the same network segment of BACnet,Scope is(1 - 4194302) | ||
| 318 | option device_port '47912' #The IP port occupied by Bacnet when it starts, Scope is (1024 - 65535) | ||
| 319 | |||
| 320 | config settings 'bacdev_2' | ||
| 321 | option device_name 'LHT65N-2' | ||
| 322 | option device_id '10002' | ||
| 323 | option device_port '47913' | ||
| 324 | ))) | ||
| 325 | |||
| 326 | === 2.7.2 Run BACnet === | ||
| 327 | |||
| 328 | |||
| 329 | After the configuration is complete, run the following command to start BACnet, The following are two ways to run BACnet: | ||
| 330 | |||
| 331 | (1)With /etc/config/bacnet configuration, and to run the registration server on the current machine, start it with the following command (configure the /etc/config/bacnet file correctly): | ||
| 332 | |||
| 333 | (% class="box infomessage" %) | ||
| 334 | ((( | ||
| 335 | bacserver -c -s | ||
| 336 | ))) | ||
| 337 | |||
| 338 | (2)Without /etc/config/bacnet, and to run the registration server on the current machine, start it with the following command: | ||
| 339 | |||
| 340 | (% class="box infomessage" %) | ||
| 341 | ((( | ||
| 342 | bacserver -s -a 10.130.2.80 -p 47808 | ||
| 343 | ))) | ||
| 344 | |||
| 345 | This command simulates two devices, with device IDs 47910 and 47911 | ||
| 346 | |||
| 347 | Enter bacserver -h to output help | ||
| 348 | |||
| 349 | (% class="box infomessage" %) | ||
| 350 | ((( | ||
| 351 | bacserver -h | ||
| 352 | ))) | ||
| 353 | |||
| 354 | [[image:image-20230327154700-3.png]] | ||
| 355 | |||
| 356 | === 2.7.3 Read devices and modify devices === | ||
| 357 | |||
| 358 | |||
| 359 | Enter baccli -h to output help | ||
| 360 | |||
| 361 | (% class="box infomessage" %) | ||
| 362 | ((( | ||
| 363 | baccli -h | ||
| 364 | ))) | ||
| 365 | |||
| 366 | [[image:image-20230327165836-1.png]] | ||
| 367 | |||
| 368 | Examples: | ||
| 369 | |||
| 370 | |||
| |
85.1 | 371 | = 4. Package Maintain Note = |
| |
67.2 | 372 | |
| |
85.1 | 373 | == 4.1 Default Package Maintain System == |
| |
67.2 | 374 | |
| |
85.1 | 375 | === 4.1.1 How Package-Auto-Update works? === |
| |
67.2 | 376 | |
| |
85.1 | 377 | |
| |
67.2 | 378 | 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. |
| 379 | |||
| 380 | |||
| 381 | (% style="color:blue" %)**When devices will check for updates**? | ||
| 382 | |||
| 383 | * Devices will check for updates for every boot. | ||
| 384 | * Devices will check for updates on every day midnight. | ||
| 385 | |||
| 386 | (% style="color:blue" %)**What packages will be checked for updates**? | ||
| 387 | |||
| 388 | dragino-httpd ~-~- Main Web UI http configuration | ||
| 389 | |||
| 390 | dragino-sid ~-~- SN write and read tool | ||
| 391 | |||
| 392 | dragino-ui ~-~- Gateway Web UI package | ||
| 393 | |||
| 394 | draginofwd ~-~- UDP packet forwarder, LoRa Base Station | ||
| 395 | |||
| 396 | draginoups ~-~- Miscellaneous between different versions | ||
| 397 | |||
| 398 | |||
| |
70.9 | 399 | |
| |
67.2 | 400 | (% style="color:blue" %)**Location and changelog for packages**: |
| 401 | |||
| 402 | * Location: http:~/~/repo.dragino.com/release/tool/ | ||
| 403 | * Changelog: [[http:~~/~~/repo.dragino.com/release/tool/Readme_HP0.txt>>http://repo.dragino.com/release/tool/Readme_HP0.txt]] | ||
| 404 | |||
| 405 | (% style="color:blue" %)**How to view auto-updated log** | ||
| 406 | |||
| 407 | You can view the log on the page of (% style="color:#037691" %)**System ~-~-> Package Management.** | ||
| 408 | |||
| 409 | |||
| 410 | [[image:1661305025451-220.png]] | ||
| 411 | |||
| 412 | |||
| |
70.7 | 413 | |
| |
67.2 | 414 | (% style="color:blue" %)**Can I disable package-auto-update?** |
| 415 | |||
| |
70.8 | 416 | You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. |
| |
67.2 | 417 | |
| 418 | |||
| 419 | [[image:1661305258501-636.png]] | ||
| 420 | |||
| 421 | |||
| 422 | |||
| |
85.1 | 423 | === 4.1.2 How to manually update core packages? === |
| |
67.2 | 424 | |
| 425 | |||
| |
70.8 | 426 | You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. |
| |
67.2 | 427 | |
| 428 | |||
| 429 | [[image:1661305328295-218.png]] | ||
| 430 | |||
| 431 | |||
| 432 | |||
| |
85.1 | 433 | === 4.1.3 How to manually update other packages? === |
| |
67.2 | 434 | |
| 435 | |||
| 436 | For the other packages, you have to access the device's CLI to do it via the apt command. | ||
| 437 | |||
| 438 | |||
| 439 | |||
| |
85.1 | 440 | == 4.2 Set up a 3^^rd^^ party package maintain server == |
| |
67.2 | 441 | |
| |
85.1 | 442 | === 4.2.1 Overview === |
| |
67.2 | 443 | |
| 444 | |||
| 445 | 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. | ||
| 446 | |||
| 447 | |||
| |
85.1 | 448 | === 4.2.2 Install Apache2 HTTP server === |
| |
67.2 | 449 | |
| 450 | |||
| |
70.5 | 451 | (% style="background-color:yellow; color:green" %)**apt install apache2** |
| |
67.2 | 452 | |
| 453 | |||
| |
85.1 | 454 | === 4.2.3 Creating Package Directories === |
| |
67.2 | 455 | |
| 456 | |||
| |
70.5 | 457 | **~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** |
| |
67.2 | 458 | |
| |
70.5 | 459 | **~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** |
| |
67.2 | 460 | |
| |
70.5 | 461 | **~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** |
| |
67.2 | 462 | |
| 463 | |||
| 464 | **Tree Structure:** | ||
| 465 | |||
| 466 | (% style="color:red" %)**Note: If you are not familiar with updating servers, most directory names are not recommended to be changed.** | ||
| 467 | |||
| 468 | |||
| 469 | └── debian | ||
| 470 | |||
| 471 | └── release | ||
| 472 | |||
| 473 | ├── dists | ||
| 474 | |||
| 475 | │ └── stable | ||
| 476 | |||
| 477 | │ └── main | ||
| 478 | |||
| 479 | │ └── binary-armhf | ||
| 480 | |||
| 481 | └── pool | ||
| 482 | |||
| 483 | └── main | ||
| 484 | |||
| 485 | └── d | ||
| 486 | |||
| |
70.5 | 487 | └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** |
| |
67.2 | 488 | |
| 489 | |||
| |
85.1 | 490 | === 4.2.4 Get deb packages === |
| |
67.2 | 491 | |
| 492 | |||
| 493 | The deb packages for auto-update can be placed in** (% style="color:blue" %)/var/www/html/debian/release/pool/main/d/dragino/(%%)** | ||
| 494 | |||
| 495 | Below is an example package(testing-0808.deb) for test purpose: | ||
| 496 | |||
| 497 | |||
| |
70.5 | 498 | **~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** |
| |
67.2 | 499 | |
| |
70.5 | 500 | **~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** |
| |
67.2 | 501 | |
| 502 | |||
| |
85.1 | 503 | === 4.2.5 Generate Package Index file === |
| |
67.2 | 504 | |
| 505 | |||
| |
70.5 | 506 | (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** |
| |
67.2 | 507 | |
| |
70.5 | 508 | (% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** |
| |
67.2 | 509 | |
| |
70.5 | 510 | (% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** |
| |
67.2 | 511 | |
| 512 | |||
| 513 | (% 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.** | ||
| 514 | |||
| 515 | |||
| |
85.1 | 516 | === 4.2.6 Generate Release file === |
| |
67.2 | 517 | |
| 518 | |||
| |
70.10 | 519 | ==== (% style="color:blue" %)**Create the generated script:**(%%) ==== |
| |
67.2 | 520 | |
| 521 | |||
| |
70.5 | 522 | (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** |
| |
67.2 | 523 | |
| 524 | |||
| |
70.5 | 525 | (% 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]]** |
| |
67.2 | 526 | |
| |
70.5 | 527 | (% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** |
| |
67.2 | 528 | |
| |
70.5 | 529 | (% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** |
| |
67.2 | 530 | |
| 531 | |||
| |
85.1 | 532 | === 4.2.7 Sign the Release file with gpg and generating Inrelease file === |
| |
67.2 | 533 | |
| 534 | |||
| |
70.7 | 535 | ==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== |
| |
67.2 | 536 | |
| 537 | |||
| |
70.5 | 538 | (% style="background-color:yellow; color:green" %)**apt install gnupg** |
| |
68.2 | 539 | |
| 540 | |||
| 541 | |||
| |
70.7 | 542 | ==== (% style="color:blue" %)**generate gpg key**(%%) ==== |
| |
67.2 | 543 | |
| 544 | |||
| |
70.5 | 545 | (% style="background-color:yellow; color:green" %)**gpg -gen-key** |
| |
67.2 | 546 | |
| |
68.2 | 547 | |
| |
70.10 | 548 | (% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** |
| |
67.2 | 549 | |
| 550 | |||
| |
68.2 | 551 | |
| |
70.7 | 552 | ==== (% style="color:blue" %)**Check the gen-key**(%%) ==== |
| |
67.2 | 553 | |
| 554 | |||
| |
70.5 | 555 | (% style="background-color:yellow; color:green" %)**gen -list-key** |
| |
67.2 | 556 | |
| |
68.2 | 557 | |
| 558 | |||
| |
70.7 | 559 | ==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== |
| |
67.2 | 560 | |
| 561 | |||
| |
70.5 | 562 | (% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** |
| |
67.2 | 563 | |
| |
70.5 | 564 | (% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** |
| |
67.2 | 565 | |
| 566 | |||
| |
70.5 | 567 | (% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** |
| |
67.2 | 568 | |
| 569 | |||
| |
68.2 | 570 | |
| |
70.7 | 571 | ==== (% style="color:blue" %)**Generate the public key**(%%) ==== |
| |
67.2 | 572 | |
| 573 | |||
| |
70.5 | 574 | (% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** |
| |
67.2 | 575 | |
| |
68.2 | 576 | |
| |
67.2 | 577 | **example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] |
| 578 | |||
| 579 | |||
| 580 | |||
| |
85.1 | 581 | === 4.2.8 Add url as apt source in LPS8v2 / MS20 === |
| |
67.2 | 582 | |
| |
68.2 | 583 | |
| 584 | |||
| |
70.7 | 585 | ==== (% style="color:blue" %)**Add the public key**(%%) ==== |
| |
67.2 | 586 | |
| 587 | |||
| |
70.5 | 588 | (% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** |
| |
67.2 | 589 | |
| |
70.7 | 590 | |
| |
68.2 | 591 | (% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** |
| |
67.2 | 592 | |
| |
68.2 | 593 | |
| 594 | |||
| |
70.7 | 595 | ==== (% style="color:blue" %)**Add the apt source list**(%%) ==== |
| |
67.2 | 596 | |
| |
68.2 | 597 | |
| |
67.2 | 598 | Add the apt source list url and name this as test_server.list |
| 599 | |||
| |
70.5 | 600 | (% 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** |
| |
67.2 | 601 | |
| 602 | |||
| |
68.2 | 603 | |
| |
70.7 | 604 | ==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== |
| |
67.2 | 605 | |
| |
68.2 | 606 | |
| |
67.2 | 607 | Get and install the testing package (download testing-0808.deb and test) |
| 608 | |||
| |
70.5 | 609 | (% style="background-color:yellow; color:green" %)**apt update && apt install testing** |
| |
67.2 | 610 | |
| |
68.2 | 611 | |
| |
67.2 | 612 | Example output: |
| 613 | |||
| |
68.2 | 614 | [[image:1661306420449-569.png]] |
| |
67.2 | 615 | |
| 616 | |||
| |
85.1 | 617 | === 4.2.9 Configure the gateway's auto-upgrade rules === |
| |
67.2 | 618 | |
| 619 | |||
| |
70.7 | 620 | ==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== |
| |
67.2 | 621 | |
| 622 | |||
| |
70.5 | 623 | (% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** |
| |
67.2 | 624 | |
| 625 | |||
| |
70.2 | 626 | [[image:1661306460134-112.png]] |
| |
67.2 | 627 | |
| 628 | |||
| 629 | |||
| |
70.7 | 630 | ==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== |
| |
67.2 | 631 | |
| 632 | |||
| |
70.5 | 633 | (% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** |
| |
67.2 | 634 | |
| |
70.2 | 635 | |
| |
67.2 | 636 | The device performs automatic updates from this script, |
| 637 | |||
| 638 | But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword. | ||
| 639 | |||
| 640 | |||
| |
70.2 | 641 | [[image:1661306487761-768.png]] |