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