Changes for page Armbian OS instruction
Last modified by Edwin Chen on 2025/02/26 08:18
From version 67.2
edited by Xiaoling
on 2022/08/24 09:53
on 2022/08/24 09:53
Change comment:
There is no comment for this version
To version 122.1
edited by Kilight Cao
on 2025/02/24 11:49
on 2025/02/24 11:49
Change comment:
Uploaded new attachment "image-20250224114945-1.png", version {1}
Summary
-
Page properties (2 modified, 0 added, 0 removed)
-
Attachments (0 modified, 31 added, 0 removed)
- 1661306420449-569.png
- 1661306460134-112.png
- 1661306487761-768.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. Xiaoling1 +XWiki.Kilight - Content
-
... ... @@ -15,174 +15,450 @@ 15 15 * LPS8v2 16 16 * MS20 17 17 18 - =2. Development Guide=18 +(% style="display:none" %) 19 19 20 20 21 - Foradvancedusers to developDriver/ Linuxetc21 += 2. Development Guide = 22 22 23 23 24 +For advanced users to develop Driver/ Linux etc. 24 24 26 + 25 25 == 2.1 How to recompile LoRaWAN Concentrator Driver ( dragino-fwd package). == 26 26 27 27 28 - 29 29 === (% style="color:blue" %)**Step 1. Clone dragino-fwd package**(%%) === 30 30 31 31 32 - (% style="color:red" %)**Requirements:**33 +**Requirements:** 33 33 34 -(% class="box infomessage" %) 35 -((( 36 -sudo apt install -y libsqlite3-dev 37 -sudo apt install -y libftdi1-dev 38 -))) 35 +**~ (% style="background-color:yellow; color:green" %)sudo apt install -y libsqlite3-dev(%%)** 39 39 37 +**~ (% style="background-color:yellow; color:green" %)sudo apt install -y libftdi1-dev(%%)** 40 40 41 -(% style="color:red" %)**Run command clone dragino-fwd package:** 42 42 43 -(% class="box infomessage" %) 44 -((( 45 -git clone https:~/~/github.com/dragino/dragino_fwd_src.git 46 -))) 40 +**Run command clone dragino-fwd package: (% style="background-color:yellow; color:green" %)git clone https:~/~/github.com/dragino/dragino_fwd_src.git(%%)** 47 47 42 + 48 48 [[image:image-20220527151010-1.png]] 49 49 50 50 51 - 52 52 === (% style="color:blue" %)**Step 2. Compile dragino_fwd**(%%) === 53 53 54 54 55 - (% style="color:red" %)**After cloning is complete, Run the command starts compiling:**49 +**After cloning is complete, Run the command starts compiling:** 56 56 57 -(% class="box infomessage" %) 58 -((( 59 -Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c 60 -))) 51 +(% style="background-color:yellow; color:green" %)**Compile HP0C/HP0A fwd: ./hp0z-make-deb.sh c** 61 61 53 + 62 62 The following example compilers HP0C fwd. 63 63 64 64 [[image:image-20220527153913-3.png]] 65 65 66 66 67 -**When the compilation is complete a draginofwd-*.deb package is generated.** 68 68 60 +When the compilation is complete a** (% style="color:blue" %)draginofwd-*.deb(%%) **package is generated. 61 + 69 69 [[image:image-20220527154311-4.png||height="385" width="773"]] 70 70 71 71 72 - 73 73 === (% style="color:blue" %)**Step 3. Install the dragino_fwd**(%%) === 74 74 75 75 76 - (% style="color:red" %)**Run command:**68 +**Run command:** 77 77 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 +User Name: **root** 249 + 250 +Password: **dragino** (default) 251 + 252 +//After logging in, you will be in the gateway CLI and can enter commands as shown below.// 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 + 256 +**Run command:** 257 + 258 +**nand-sata-install** 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"]] 261 + 262 +Select the **"Boot from eMMC - system on eMMC".** 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"]] 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"]] 267 + 268 +Select the **"1 ext4"** 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"]] 271 + 272 +It takes 4-5 minutes to burn from SD card to eMMC 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"]] 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 + 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"]] 279 + 280 +**Note: After the flash is complete, power off the device and then remove the SD card.** 281 + 282 + 283 +== 2.4 How to extend the gateway size of memory with SD card == 284 + 285 + 286 +Users can use the SD card slot to expand the gateway memory size by following the steps below 287 + 288 + 289 +=== 2.4.1 View SD card information === 290 + 78 78 (% class="box infomessage" %) 79 79 ((( 80 -d pkg-i draginofwd-*.deb293 +fdisk -l 81 81 ))) 82 82 83 -[[image:image-202 20527154811-5.png]]296 +[[image:image-20230831150518-3.png]] 84 84 85 85 299 +=== 2.4.2 Displays the current file system disk usage statistics on Linux systems === 86 86 87 -=== (% style="color:blue" %)**Step 4. Test**(%%) === 88 88 302 +(% class="box infomessage" %) 303 +((( 304 +df -h 305 +))) 89 89 90 - Check the dragino_fwd log:307 +[[image:image-20230831150341-2.png]] 91 91 309 + 310 +=== 2.4.3 Mount SD card === 311 + 312 + 92 92 (% class="box infomessage" %) 93 93 ((( 94 -journalctl -u draginofwd -f 315 +mkdir /mnt/sd 316 + 317 +mount /dev/mmcblk0p1 /mnt/sd 95 95 ))) 96 96 97 - [[image:image-20220527165221-7.png||height="182"width="931"]]320 +After the mount is successful to check the file system disk usage on the Linux system again: 98 98 322 +[[image:image-20230831151432-4.png]] 99 99 100 -Start/stop dragino_fwd via systemctl: 101 101 325 +If the mount fails, you can format the file system and try the mount again 326 + 102 102 (% class="box infomessage" %) 103 103 ((( 104 -systemctl start draginofwd 105 -systemctl stop draginofwd 329 +mkfs.ext4 /dev/mmcblk0p1 106 106 ))) 107 107 332 +== 2.5 Default Built Version == 108 108 109 109 110 - == 2.2 How to cloneComplete OS onthe EMMC to SD card ==335 +[[image:image-20220902155621-1.png]] 111 111 112 112 338 +== 2.6 How to upgrade the nodejs version to the latest. == 113 113 114 -== 2.3 How to flash SD card to (eMMC) device's built-in Memory == 115 115 341 +By default, the nodejs uses the pre-install version v12 which is due to Debian the ultra-stable via ultra-old. 116 116 117 - === 2.3.1 PrepareSD card with OS ===343 +[[image:image-20221112145029-2.png]] 118 118 345 +**If you want to upgrade the nodejs to the latest, please follow to use these commands on the gateway CIL.** 119 119 120 - //**Preparations:**// 121 121 122 - ~1. PrepareanSDcardanda//card reader device//348 +#install n, which is an Interactively Manage Your Node.js Versions 123 123 124 - 2. FormattingtheSD card (//Makesure theSD cardisempty//)350 +[[image:image-20221112154230-3.png||height="89" width="689"]] 125 125 126 -3. //Download the OS image from **[[release.image>>url:http://repo.dragino.com/release/hp0c-image/]]**: ( File format **dragino-lps8v2-1.7.img** )// 352 +(% class="box infomessage" %) 353 +((( 354 +**npm install -g n** 355 +))) 127 127 128 -4. //A Flash software tool ( Such as v1.7.9 from **[[balenaEtcher>>url:https://www.balena.io/etcher/]]** )// 129 129 358 +#Install the latest LTS Node.js release (downloading if necessary) 130 130 360 +[[image:image-20221112154418-4.png||height="184" width="893"]] 131 131 132 -=== 2.3.2 Flash SD card to device's eMMC === 362 +(% class="box infomessage" %) 363 +((( 364 +**n lts** 365 +))) 133 133 134 134 135 - //1. Open the device's enclosure, andput theSD cardinto the SD card slot//368 +#Remove all downloaded versions except the installed version 136 136 137 - //2. Power on the devicend access theateway'sCLI viathe serial port.//370 +[[image:image-20221112154456-5.png||height="139" width="899"]] 138 138 139 -//3. Login and run the below command to flash.// 372 +(% class="box infomessage" %) 373 +((( 374 +**n prune** 375 +))) 140 140 141 141 142 -(% style="color:red" %)**Run command:** 378 +(% class="box infomessage" %) 379 +((( 380 +**apt remove nodejs -y && apt autoremove -y && reboot** 381 +))) 143 143 383 + 384 +Check the current version 385 + 386 +[[image:image-20221112154724-6.png]] 387 + 144 144 (% class="box infomessage" %) 145 145 ((( 146 -n and-sata-install390 +**node -v** 147 147 ))) 148 148 149 -[[image:image-20220602112051-1.png]] 150 150 394 +== 2.7 How to install Grafana and influxdb == 151 151 152 -Select the "Boot from eMMC - system on eMMC" 153 153 154 - [[image:image-20220602112058-2.png||height="292"width="646"]]397 +=== **Grafana:** === 155 155 156 -[[image:image-20220602112106-3.png||height="301" width="643"]] 157 157 400 +(% class="box infomessage" %) 401 +((( 402 +curl https:~/~/packages.grafana.com/gpg.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/grafana-archive-keyrings.gpg >/dev/null 403 +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 404 +apt update && apt install grafana 405 +))) 158 158 159 -Select the "1 ext4" 160 160 161 - [[image:image-20220602112113-4.png||height="271"width="642"]]408 +Check the running status: 162 162 163 163 164 -It takes 4-5 minutes to burn from SD card to eMMC 411 +(% class="box infomessage" %) 412 +((( 413 +systemctl status grafana-server 414 +))) 165 165 166 -[[image:image-20220602112119-5.png||height="309" width="641"]] 167 167 168 - [[image:image-20220602112125-6.png||height="281" width="640"]]417 +configuration path: 169 169 170 -[[image:image-20220602112131-7.png||height="241" width="638"]] 171 171 420 +(% class="box infomessage" %) 421 +((( 422 +/etc/grafana/grafana.ini 423 +))) 172 172 173 -(% style="color:red" %)**Note: After the flash is complete, power off the device and then remove the SD card.** 174 174 426 +=== **Influxdb:** === 175 175 176 176 177 -= 3. Package Maintain Note = 429 +(% class="box infomessage" %) 430 +((( 431 +curl https:~/~/repos.influxdata.com/influxdata-archive_compat.key | gpg ~-~-dearmor | sudo tee /usr/share/keyrings/influxdb-archive-keyring.gpg >/dev/null 432 +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 433 +apt update && apt install influxdb 434 +))) 178 178 179 179 180 - == 3.1 Default PackageMaintainSystem ==437 +Check the running status: 181 181 182 182 183 -=== 3.1.1 How Package-Auto-Update works? === 440 +(% class="box infomessage" %) 441 +((( 442 +systemctl status influxdb 443 +))) 184 184 185 185 446 +configuration path: 447 + 448 + 449 +(% class="box infomessage" %) 450 +((( 451 +/etc/influxdb/influxdb.conf 452 +))) 453 + 454 + 455 += 3. Package Management = 456 + 457 +== 3.1 Default Package Maintain System == 458 + 459 +=== 3.1.1 How Package-Auto-Update works? === 460 + 461 + 186 186 By default, LPS8v2 / MS20 series products have an auto-update feature for main packages. The device will connect to Dragino's auto-update server and check for updates. 187 187 188 188 ... ... @@ -204,6 +204,7 @@ 204 204 draginoups ~-~- Miscellaneous between different versions 205 205 206 206 483 + 207 207 (% style="color:blue" %)**Location and changelog for packages**: 208 208 209 209 * Location: http:~/~/repo.dragino.com/release/tool/ ... ... @@ -217,25 +217,24 @@ 217 217 [[image:1661305025451-220.png]] 218 218 219 219 497 + 220 220 (% style="color:blue" %)**Can I disable package-auto-update?** 221 221 222 -You can check the checkbox and click the(% style="color: #037691" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update.500 +You can check the checkbox and click the(% style="color:red" %)** ‘SAVE’ **(%%)button to enable or disable the auto-update. 223 223 224 224 225 225 [[image:1661305258501-636.png]] 226 226 227 227 228 - 229 229 === 3.1.2 How to manually update core packages? === 230 230 231 231 232 -You can click the (% style="color: #037691" %)**‘Manual Update’**(%%) to update the dragino's packages.509 +You can click the (% style="color:red" %)**‘Manual Update’**(%%) to update the dragino's packages. 233 233 234 234 235 235 [[image:1661305328295-218.png]] 236 236 237 237 238 - 239 239 === 3.1.3 How to manually update other packages? === 240 240 241 241 ... ... @@ -242,10 +242,8 @@ 242 242 For the other packages, you have to access the device's CLI to do it via the apt command. 243 243 244 244 245 - 246 246 == 3.2 Set up a 3^^rd^^ party package maintain server == 247 247 248 - 249 249 === 3.2.1 Overview === 250 250 251 251 ... ... @@ -252,22 +252,20 @@ 252 252 Customers can use their own package maintenance system instead of using the default one from Dragino. They need to set up a package maintenance system for Debian. Lots of instructions are available in Internet, below is a reference instruction. 253 253 254 254 255 - 256 256 === 3.2.2 Install Apache2 HTTP server === 257 257 258 258 259 -(% style="background-color:yellow" %)**apt install apache2** 532 +(% style="background-color:yellow; color:green" %)**apt install apache2** 260 260 261 261 262 - 263 263 === 3.2.3 Creating Package Directories === 264 264 265 265 266 -**~ (% style="background-color:yellow" %)cd /var/www/html/(%%)** 538 +**~ (% style="background-color:yellow; color:green" %)cd /var/www/html/(%%)** 267 267 268 -**~ (% style="background-color:yellow" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 540 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/dists/stable/main/binary-armhf/ -p(%%)** 269 269 270 -**~ (% style="background-color:yellow" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 542 +**~ (% style="background-color:yellow; color:green" %)mkdir debian/release/pool/main/d/dragino/ -p(%%)** 271 271 272 272 273 273 **Tree Structure:** ... ... @@ -293,10 +293,9 @@ 293 293 294 294 └── d 295 295 296 - └── dragino ~-~-> (% style="background-color:yellow" %)**This is the directory to store the packages. User can change it to other name.** 568 + └── dragino ~-~-> (% style="background-color:yellow; color:green" %)**This is the directory to store the packages. User can change it to other name.** 297 297 298 298 299 - 300 300 === 3.2.4 Get deb packages === 301 301 302 302 ... ... @@ -305,129 +305,142 @@ 305 305 Below is an example package(testing-0808.deb) for test purpose: 306 306 307 307 308 -**~ (% style="background-color:yellow" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 579 +**~ (% style="background-color:yellow; color:green" %)wget http:~/~/repo.dragino.com/release/tool/unimportant/testing-0808.deb(%%)** 309 309 310 -**~ (% style="background-color:yellow" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 581 +**~ (% style="background-color:yellow; color:green" %)cp ./testing-0808.deb /var/www/html/debian/release/pool/main/d/dragino/(%%)** 311 311 312 312 313 - 314 314 === 3.2.5 Generate Package Index file === 315 315 316 316 317 -(% style="background-color:yellow" %)**cd /var/www/html/debian/release/** 587 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/** 318 318 319 -(% style="background-color:yellow" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 589 +(% style="background-color:yellow; color:green" %)**dpkg-scanpackages pool/ > dists/stable/main/binary-armhf/Packages** 320 320 321 -(% style="background-color:yellow" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 591 +(% style="background-color:yellow; color:green" %)**cat dists/stable/main/binary-armhf/Packages | gzip -9 > dists/stable/main/binary-armhf/Packages.gz** 322 322 323 323 324 324 (% style="color:red" %)**Note: Every time a package has been update, above comments need to be executed in the server to get the up-to-date package list.** 325 325 326 326 327 - 328 328 === 3.2.6 Generate Release file === 329 329 330 330 331 -==== Create the generated script: ==== 600 +==== (% style="color:blue" %)**Create the generated script:**(%%) ==== 332 332 333 333 334 -cd /var/www/html/debian/release/dists/stable 603 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 335 335 336 336 337 -wget [[http:~~/~~/repo.dragino.com/release/tool/unimportant/generate-release.sh>>url:http://repo.dragino.com/release/tool/unimportant/generate-release.sh]] 606 +(% 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]]** 338 338 339 -chmod + x ./generate-release.sh 608 +(% style="background-color:yellow; color:green" %)**chmod + x ./generate-release.sh** 340 340 341 -./generate-release.sh > Release 610 +(% style="background-color:yellow; color:green" %)**./generate-release.sh > Release** 342 342 343 343 344 - 345 345 === 3.2.7 Sign the Release file with gpg and generating Inrelease file === 346 346 347 347 348 -==== Make sure auto-update server has gnupg ==== 616 +==== (% style="color:blue" %)**Make sure auto-update server has gnupg**(%%) ==== 349 349 350 -apt install gnupg 351 351 352 - ====generategpgkey ====619 +(% style="background-color:yellow; color:green" %)**apt install gnupg** 353 353 354 -gpg -gen-key 355 355 356 356 357 - **((% style="color:red" %)Note: Fill inthecontent asrequiredand rememberthenameandemail address)(%%)**623 +==== (% style="color:blue" %)**generate gpg key**(%%) ==== 358 358 359 359 360 - ====Checkthe gen-key====626 +(% style="background-color:yellow; color:green" %)**gpg -gen-key** 361 361 362 -gen -list-key 363 363 629 +(% style="color:red" %)**Note: Fill in the content as required and remember the name and email address.** 364 364 365 -==== Generate the release.gpg ==== 366 366 367 -cd /var/www/html/debian/release/dists/stable 368 368 369 - gpg~-~-armor~-~-detach-sign -oRelease.gpgRelease633 +==== (% style="color:blue" %)**Check the gen-key**(%%) ==== 370 370 371 371 372 - gpg~-~-clearsignInReleaseRelease636 +(% style="background-color:yellow; color:green" %)**gen -list-key** 373 373 374 374 375 375 640 +==== (% style="color:blue" %)**Generate the release.gpg**(%%) ==== 376 376 377 -==== Generate the public key ==== 378 378 643 +(% style="background-color:yellow; color:green" %)**cd /var/www/html/debian/release/dists/stable** 379 379 380 -gpg ~-~-armor ~-~- output <name>.asc~-~-export<emailddress>645 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-detach-sign -o Release.gpg Release** 381 381 382 -**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 383 383 648 +(% style="background-color:yellow; color:green" %)**gpg ~-~-clearsign -o InRelease Release** 384 384 385 385 386 386 652 +==== (% style="color:blue" %)**Generate the public key**(%%) ==== 653 + 654 + 655 +(% style="background-color:yellow; color:green" %)**gpg ~-~-armor ~-~-output <name>.asc ~-~-export <email address>** 656 + 657 + 658 +**example: gpg ~-~-armor ~-~-output xiao.asc ~-~-export **[[xiaoye@dragino.cc>>mailto:xiaoye@dragino.cc]] 659 + 660 + 661 + 387 387 === 3.2.8 Add url as apt source in LPS8v2 / MS20 === 388 388 389 -==== Add the public key ==== 390 390 391 -cp xiao.asc /etc/apt/trusted.gpg.d/ 392 392 393 -(% style="color: red" %)Note: First need to transfer the public keyfrom auto-update server to device.666 +==== (% style="color:blue" %)**Add the public key**(%%) ==== 394 394 395 395 396 - ====Addthept source list====669 +(% style="background-color:yellow; color:green" %)**cp xiao.asc /etc/apt/trusted.gpg.d/** 397 397 671 + 672 +(% style="color:red" %)**Note: First need to transfer the public key from auto-update server to device.** 673 + 674 + 675 + 676 +==== (% style="color:blue" %)**Add the apt source list**(%%) ==== 677 + 678 + 398 398 Add the apt source list url and name this as test_server.list 399 399 400 -echo "deb http:~/~/<IP_address or hostname>/debian/release stable main" | tee /etc/apt/sources.list.d/test_server.list 681 +(% 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** 401 401 402 402 403 -==== Validate the apt repository ==== 404 404 685 +==== (% style="color:blue" %)**Validate the apt repository**(%%) ==== 686 + 687 + 405 405 Get and install the testing package (download testing-0808.deb and test) 406 406 407 -apt update && apt install testing 690 +(% style="background-color:yellow; color:green" %)**apt update && apt install testing** 408 408 692 + 409 409 Example output: 410 410 411 -[[image: file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image008.jpg]]695 +[[image:1661306420449-569.png]] 412 412 413 413 698 +=== 3.2.9 Configure the gateway's auto-upgrade rules === 414 414 415 415 416 -=== 3.2.9Configurethegateway‘sauto-upgraderules===701 +==== (% style="color:blue" %)**Remove dragino apt source**(%%) ==== 417 417 418 -==== Remove dragino apt source ==== 419 419 420 -/etc/apt/sources.list 704 +(% style="background-color:yellow; color:green" %)**/etc/apt/sources.list** 421 421 422 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image010.jpg]] 423 423 707 +[[image:1661306460134-112.png]] 424 424 425 425 426 426 711 +==== (% style="color:blue" %)**Set up automatic updates**(%%) ==== 427 427 428 -==== Set up automatic updates ==== 429 429 430 -Path :/usr/lib/dragino/dragino-apt-updates 714 +(% style="background-color:yellow; color:green" %)**Path : /usr/lib/dragino/dragino-apt-updates** 431 431 432 432 433 433 The device performs automatic updates from this script, ... ... @@ -434,6 +434,8 @@ 434 434 435 435 But it will now only look for dragino as a keyword, so you need to replace the keyword dragino with your own keyword. 436 436 437 -[[image:file:///C:/Users/93456/AppData/Local/Temp/msohtmlclip1/01/clip_image012.jpg]] 438 438 722 +[[image:1661306487761-768.png]] 723 + 724 + 439 439
- 1661306420449-569.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +237.0 KB - Content
- 1661306460134-112.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +146.8 KB - Content
- 1661306487761-768.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoling - Size
-
... ... @@ -1,0 +1,1 @@ 1 +291.9 KB - Content
- 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
- image-20230327152105-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +27.5 KB - Content
- image-20230327152431-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +47.5 KB - Content
- image-20230327154700-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +26.7 KB - Content
- image-20230327165836-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +17.1 KB - Content
- image-20230327171824-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +46.1 KB - Content
- image-20230327174537-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +8.8 KB - Content
- image-20230327174556-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +16.0 KB - Content
- image-20230327174853-5.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +20.0 KB - Content
- image-20230508155357-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +24.3 KB - Content
- image-20230712201032-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +872.4 KB - Content
- image-20230712201424-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +872.4 KB - Content
- image-20230712201458-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +854.1 KB - Content
- image-20230831144800-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +86.9 KB - Content
- image-20230831150341-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +30.7 KB - Content
- image-20230831150518-3.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +89.9 KB - Content
- image-20230831151432-4.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +37.7 KB - Content
- image-20241008091544-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +36.1 KB - Content
- image-20241008091850-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +36.2 KB - Content
- image-20241107100901-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +66.7 KB - Content
- image-20241107100929-2.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Xiaoye - Size
-
... ... @@ -1,0 +1,1 @@ 1 +33.3 KB - Content
- image-20250224114945-1.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.Kilight - Size
-
... ... @@ -1,0 +1,1 @@ 1 +21.6 KB - Content