summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRonan <ronan.lemartret@iot.bzh>2016-12-12 21:08:10 +0100
committerRonan <ronan.lemartret@iot.bzh>2016-12-12 21:08:10 +0100
commit73a342a1f0a333fb8553cc07e3ec60ee24c9079c (patch)
tree43b9743af45cb5814a536b1ded2f4f19e954560b
parent9e930f505a214be4a2c5f1a6f68c542d301a62e8 (diff)
update README markdown
Change-Id: I8df2f8cdf75eff6daed1f8e64c748d989f2da887 Signed-off-by: Ronan <ronan.lemartret@iot.bzh>
-rw-r--r--meta-sota/README.md76
1 files changed, 46 insertions, 30 deletions
diff --git a/meta-sota/README.md b/meta-sota/README.md
index 4ea5da5..2e27fd3 100644
--- a/meta-sota/README.md
+++ b/meta-sota/README.md
@@ -4,7 +4,8 @@ meta-sota
This layer enables over-the-air updates with OSTree and RVI SOTA client.
[OSTree](https://github.com/ostreedev/ostree) is a tool for atomic full file
-system upgrades with rollback capability. Main advantage of OSTree compared
+system upgrades with rollback capability.
+Main advantage of OSTree compared
to traditional dual partition model is that OSTree minimizes network bandwidth
and data storage footprint by sharing files with the same contents across file
system deployments.
@@ -17,13 +18,17 @@ Build
-----
With AGL you can just add agl-sota feature while configuring your build
-environment as in
+environment as in:
- source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl-appfw-smack agl-devel agl-sota
+```bash
+source meta-agl/scripts/aglsetup.sh -m porter agl-demo agl-appfw-smack agl-devel agl-sota
+```
-you can then just run
+you can then just run:
- bitbake agl-demo-platform
+```bash
+bitbake agl-demo-platform
+```
and get as a result "ostree_repo" folder in your images directory
(tmp/deploy/images/${MACHINE}/ostree_repo) containing your OSTree repository
@@ -38,12 +43,12 @@ variables you may want to tune some of them.
SOTA-related variables in local.conf
------------------------------------
-* OSTREE_REPO - path to your OSTree repository.
+* OSTREE_REPO - path to your OSTree repository.
Defaults to "${DEPLOY_DIR_IMAGE}/ostree_repo"
-* OSTREE_BRANCHNAME - the branch your rootfs will be committed to.
+* OSTREE_BRANCHNAME - the branch your rootfs will be committed to.
Defaults to "agl-ota"
-* OSTREE_OSNAME - OS deployment name on your target device. For more
- information about deployments and osnames see
+* OSTREE_OSNAME - OS deployment name on your target device.
+ For more information about deployments and osnames see
[OSTree documentation](https://ostree.readthedocs.io/en/latest/manual/deployment/)
Defaults to "agl".
* OSTREE_INITRAMFS_IMAGE - initramfs/initrd image that is used as a proxy while
@@ -57,49 +62,60 @@ Usage
-----
### OSTree ###
-OSTree includes its own simple http server. It just exposes the whole OSTree
+OSTree includes its own simple http server.
+It just exposes the whole OSTree
repository to the network so that any remote device can pull data from it to
-device's local repository. To use OSTree http server you need OSTree installed
+device's local repository.
+To use OSTree http server you need OSTree installed
on your build machine. Alternatively, you could run version built inside Yocto
using bitbake's [devshell](http://www.openembedded.org/wiki/Devshell).
To expose your repo run ostree trivial-httpd using any free port.
- ostree trivial-httpd tmp/deploy/images/qemux86-64/ostree_repo -P 57556
+```bash
+ostree trivial-httpd tmp/deploy/images/qemux86-64/ostree_repo -P 57556
+```
You can then run from inside your device or QEMU emulation, provided your
network is set up correctly.
- # agl-remote identifies the remote server in your local repo
- ostree remote add --no-gpg-verify agl-remote http://192.168.7.1:57556 agl-ota
+```bash
+# agl-remote identifies the remote server in your local repo
+ostree remote add --no-gpg-verify agl-remote http://192.168.7.1:57556 agl-ota
- # agl-ota is a branch name in the remote repo, set in OSTREE_BRANCHNAME
- ostree pull agl-remote agl-ota
+# agl-ota is a branch name in the remote repo, set in OSTREE_BRANCHNAME
+ostree pull agl-remote agl-ota
- # agl is OS name as set in OSTREE_OSNAME
- ostree admin deploy --os=agl agl-remote:agl-ota
+# agl is OS name as set in OSTREE_OSNAME
+ostree admin deploy --os=agl agl-remote:agl-ota
+```
After restart you should boot into the newly deployed OS image.
E.g. for the raspberrypi3 you can try this sequence:
- # add remote
- ostree remote add --no-gpg-verify agl-snapshot https://download.automotivelinux.org/AGL/snapshots/master/latest/raspberrypi3/deploy/images/raspberrypi3/ostree_repo/ agl-ota
+```bash
+# add remote
+ostree remote add --no-gpg-verify agl-snapshot https://download.automotivelinux.org/AGL/snapshots/master/latest/raspberrypi3/deploy/images/raspberrypi3/ostree_repo/ agl-ota
+
+# pull
+ostree pull agl-snapshot agl-ota
- # pull
- ostree pull agl-snapshot agl-ota
-
- # deploy
- ostree admin deploy --os=agl agl-snapshot:agl-ota
+# deploy
+ostree admin deploy --os=agl agl-snapshot:agl-ota
+```
### SOTA tools ###
SOTA tools now contains only one tool, garage-push that lets you push the
-changes in OSTree repository generated by bitbake process. It communicates with
-an http server capable of querying files with HEAD requests and uploading them
-with POST requests. garage-push is used as following:
+changes in OSTree repository generated by bitbake process.
+It communicates with an http server capable of querying files with HEAD requests and uploading them
+with POST requests.
+Garage-push is used as following:
- garage-push --repo=/path/to/ostree-repo --ref=mybranch --credentials=~/.sota-tools.json --user=username --password=
+```bash
+garage-push --repo=/path/to/ostree-repo --ref=mybranch --credentials=~/.sota-tools.json --user=username --password=
+```
You can set OSTREE_PUSH_CREDENTIALS in your local.conf to make your build
-results be automatically synchronized with a remote server.
+results be automatically synchronized with a remote server.
Credentials are stored in JSON format which is described in [sota-tools documentation](https://github.com/advancedtelematic/sota-tools/blob/master/README.adoc)