This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
software:oowow:dev:oowow-online-installation-images [2023/07/05 04:46] hyphop [Image Size] |
software:oowow:dev:oowow-online-installation-images [2023/09/26 00:12] (current) hyphop [Armbian external mirrors usage] |
||
---|---|---|---|
Line 1: | Line 1: | ||
- | ~~tag> | + | ~~tag> |
====== OOWOW Online-installation images ====== | ====== OOWOW Online-installation images ====== | ||
Line 6: | Line 6: | ||
WIP: | WIP: | ||
+ | |||
+ | * System must workable for any board revision | ||
+ | * Image writing size small as possible, no need to rewrite the whole eMMC content, same as writing unused empty spaces | ||
+ | * Image writing size not be bigger what's possible smallest storage board configurations | ||
+ | * Any private data not allowed | ||
+ | * Any malware spyware etc ... will be banned | ||
+ | * Clean trash, logs, cache, etc ... before packing installation image | ||
+ | * Use optimal compression via [[#xze]] | ||
+ | * Use meta descriptions for images via [[#xze]] | ||
+ | * Use [[# | ||
+ | * WIP: ... | ||
==== Image Size ==== | ==== Image Size ==== | ||
Line 47: | Line 58: | ||
* Prepare all content on eMMC (clean cached, temp, logs, files manually by hand) | * Prepare all content on eMMC (clean cached, temp, logs, files manually by hand) | ||
- | * Before make dump from eMMC need make some optimization via __ OOWOW => Advanced => __ | + | |
- | * Make a eMMC dump to SD/ | + | |
- | * Repack it by '' | + | * Make an eMMC dump to SD/ |
+ | * Repack it by [[#xze]], if need to use it for online installation | ||
<WRAP important > | <WRAP important > | ||
Be sure your system must resize root-fs back to maximal size automatically at 1st boot, for example '' | Be sure your system must resize root-fs back to maximal size automatically at 1st boot, for example '' | ||
</ | </ | ||
+ | |||
+ | |||
+ | ===== Basic Khadas file-name format ===== | ||
+ | |||
+ | WIP: ... | ||
+ | ``` | ||
+ | SYNTAX: | ||
+ | ``` | ||
+ | |||
+ | All in lowercase only, use ' | ||
+ | |||
+ | Examples: https:// | ||
+ | |||
+ | ===== XZE ===== | ||
+ | |||
+ | We recommend using [[https:// | ||
+ | |||
+ | * Provide additional meta information about images | ||
+ | * Its fully compatible with the common xz format, and same possible to use anywhere | ||
+ | * Fast-checking image integrity before writing it | ||
+ | * Make a warranty it will be suitable for the current board installation | ||
+ | * Fast optimal compression for fastest decompression on SBC | ||
+ | * Image signup | ||
+ | * etc... | ||
+ | |||
+ | ==== XZE usage examples ==== | ||
+ | |||
+ | The packing process is very simple just need to add some additional meta information ... | ||
+ | |||
+ | ```sh pack raw image | ||
+ | xze " | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | ``` | ||
+ | |||
+ | Also, we can get full information about xze-packed image | ||
+ | |||
+ | ```sh check image meta info | ||
+ | |||
+ | ./xze YOUR-IMAGE.img.xz | ||
+ | |||
+ | ``` | ||
+ | |||
+ | Just one more example | ||
+ | |||
+ | ```shell | ||
+ | ~$ ./xze edge2-openfyde-r114.img.xz | ||
+ | Strms Blocks | ||
+ | 2 | ||
+ | [i] blocks: 110 // 1,456.4*MiB // 9,786.1*MiB | ||
+ | ## | ||
+ | FILE: edge2-openfyde-r114.img.xz | ||
+ | UNPACKED_SIZE: | ||
+ | PACKED_SIZE: | ||
+ | FILE_SIZE: 1527140352 | ||
+ | ## | ||
+ | |||
+ | ## | ||
+ | type:xz | ||
+ | label: openFyde | ||
+ | date: Sat Jul 15 04:18:38 UTC 2023 | ||
+ | match: BOARD=Edge2 | ||
+ | builder: openFyde | ||
+ | link: https:// | ||
+ | desc: openFyde for Khadas Edge2 | ||
+ | duration: 60 | ||
+ | image: edge2-openfyde-r114.img | ||
+ | ## | ||
+ | ## | ||
+ | ``` | ||
+ | |||
+ | Last one is web usage | ||
+ | |||
+ | ```shell get meta info | ||
+ | ~$ IMAGE_LINK=https:// | ||
+ | |||
+ | ~$ curl -s -jkLf -r-4096 " | ||
+ | |||
+ | ## | ||
+ | FILE: edge2-openfyde-r114.img.xz | ||
+ | UNPACKED_SIZE: | ||
+ | PACKED_SIZE: | ||
+ | FILE_SIZE: 1527140352 | ||
+ | ## | ||
+ | |||
+ | ## | ||
+ | type:xz | ||
+ | label: openFyde | ||
+ | date: Sat Jul 15 04:18:38 UTC 2023 | ||
+ | match: BOARD=Edge2 | ||
+ | builder: openFyde | ||
+ | link: https:// | ||
+ | desc: openFyde for Khadas Edge2 | ||
+ | duration: 60 | ||
+ | image: edge2-openfyde-r114.img | ||
+ | ## | ||
+ | ## | ||
+ | |||
+ | ``` | ||
+ | |||
+ | |||
+ | |||
+ | ===== Armbian external mirrors usage ===== | ||
+ | |||
+ | [[armbian-images]] | ||
+ | |||
+ | |||
+ | ```shell link setup | ||
+ | @web:/ | ||
+ | edge2-armbian-jammy-legacy-cli.img.xz: | ||
+ | edge2-armbian-jammy-legacy-desktop-xfce.img.xz: | ||
+ | edge2-armbian-jammy-legacy-minimal.img.xz: | ||
+ | |||
+ | @web:/ | ||
+ | |||
+ | |||
+ | ``` | ||
===== See also ===== | ===== See also ===== |