Skip to content
This repository has been archived by the owner on May 21, 2024. It is now read-only.

Commit

Permalink
Merge pull request #1660 from advancedtelematic/feat/prep-2020.6
Browse files Browse the repository at this point in the history
Feat/prep 2020.6
  • Loading branch information
pattivacek authored Apr 30, 2020
2 parents 48c5b67 + df92dd9 commit a6392de
Show file tree
Hide file tree
Showing 16 changed files with 31 additions and 32 deletions.
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,13 +6,24 @@ Our versioning scheme is `YEAR.N` where `N` is incremented whenever a new releas

## [??? (unreleased)]


## [2020.6] - 2020-04-30

### Added

- libaktualizr API and aktualizr-primary command line parameter to provide custom hardware information in JSON format: [PR](https://github.com/advancedtelematic/aktualizr/pull/1644)

### Changed

- Improved garage-deploy object fetching performance by reusing the curl handle: [PR](https://github.com/advancedtelematic/aktualizr/pull/1643)
- Added an SQL busy handler with 2 seconds timeout: [PR](https://github.com/advancedtelematic/aktualizr/pull/1648)
- Improved internal exception handling: [PR #1654](https://github.com/advancedtelematic/aktualizr/pull/1654) and [PR #1658](https://github.com/advancedtelematic/aktualizr/pull/1658)

### Fixed

- Prevented more failure states from resulting in an installation loop: [PR #1632](https://github.com/advancedtelematic/aktualizr/pull/1632) and [PR #1635](https://github.com/advancedtelematic/aktualizr/pull/1635)
- Allow installaton of 0-byte binary files: [PR](https://github.com/advancedtelematic/aktualizr/pull/1652)
- Refuse to download OSTree targets with the fake/binary package manager: [PR](https://github.com/advancedtelematic/aktualizr/pull/1653)

### Removed

Expand Down
1 change: 1 addition & 0 deletions docs/README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ The link above is for the doxygen docs on master. Doxygen docs for the following
* https://advancedtelematic.github.io/aktualizr/2020.3/index.html[2020.3]
* https://advancedtelematic.github.io/aktualizr/2020.4/index.html[2020.4]
* https://advancedtelematic.github.io/aktualizr/2020.5/index.html[2020.5]
* https://advancedtelematic.github.io/aktualizr/2020.6/index.html[2020.6]
====

== Release process
Expand Down
2 changes: 1 addition & 1 deletion docs/ota-client-guide/antora.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
name: ota-client
title: OTA Connect Developer Guide
version: latest
display_version: 2020.5 (latest)
display_version: 2020.6 (latest)
nav:
- modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
// the version being viewed, but when we are referencing aktualizr from
// the other, non-versioned docs, we want to make sure we're using the
// latest version.
:aktualizr-version: 2020.5
:aktualizr-version: 2020.6

:yocto-version: 3.0

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

To avoid conflicts and certain classes of bugs, we require the use of `usrmerge`, even on systems that do not use systemd. In the https://www.yoctoproject.org/docs/{yocto-version}/mega-manual/mega-manual.html[Yocto] ecosystem, it is a general best practice to write `do_install()` functions that install to the variable `\{bindir}`, but some recipes still hard-code the location of `/bin`.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

:page-layout: page
:page-categories: [quickstarts]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

:page-layout: page
:page-categories: [client-config]
Expand Down
27 changes: 6 additions & 21 deletions docs/ota-client-guide/modules/ROOT/pages/build-agl.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::ota-client::partial$aktualizr-version.adoc[]


:page-layout: page
:page-categories: [quickstarts]
Expand All @@ -22,7 +24,7 @@ endif::[]

// Most of the content here is the same as the Raspberry Pi instructions, so we re-use the chunks we can.

include::build-raspberry.adoc[tags=prereqs]
include::ota-client::page$build-raspberry.adoc[tags=prereqs]

== Create your AGL Yocto build environment

Expand All @@ -33,7 +35,7 @@ First, use the manifest file for AGL's Itchy Icefish release to download the req
----
mkdir myproject
cd myproject
repo init -b icefish -m icefish_9.0.0.xml -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
repo init -b icefish -m icefish_9.0.1.xml -u https://gerrit.automotivelinux.org/gerrit/AGL/AGL-repo
repo sync
----

Expand All @@ -55,24 +57,7 @@ source meta-agl/scripts/aglsetup.sh -m <target-architecture> agl-sota <1>

IMPORTANT: Only `raspberrypi3` and `qemux86-64` will work out of the box. If you want to create an {product-name-short}-compatible build for one of the other architectures AGL supports, you may need to write a BSP layer for that board. You can take the link:https://github.com/advancedtelematic/meta-updater-raspberrypi/tree/morty/recipes-bsp[Raspberry Pi BSP] as an example of what's needed. You can also link:mailto:otaconnect.support@here.com[contact us directly] to inquire about commercial development of BSP layers for specific boards.

=== Additional configuration for Raspberry Pi 3

As described in the link:https://docs.automotivelinux.org/docs/en/master/getting_started/reference/getting-started/machines/raspberrypi.html#sota[AGL documentation], you will need to edit your `bblayers.conf` to add `meta-updater-raspberrypi`.

=== Additional configuration for QEMU

// This has been moved upstream:
// https://gerrit.automotivelinux.org/gerrit/c/AGL/meta-agl/+/23953
// But it's only in master at present, not even the initial icefish release.
// See 99c55be1635a8ff30317417093da54fbcd8eb250 in the icefish branch of meta-agl.

By default, AGL for QEMU boots into an initrd before loading the root filesystem, but as of thud, meta-updater by default uses an initramfs. You will need to force the build to use an initramfs by adding this to your `local.conf`:

----
AGL_DEFAULT_INITRAMFS_FSTYPES = "cpio.gz"
----

include::build-raspberry.adoc[tags=config]
include::ota-client::page$build-raspberry.adoc[tags=config]

== Bitbake

Expand Down Expand Up @@ -105,4 +90,4 @@ TIP: You can also write the image using `dd`, but since the wrong kind of typo i

You can now run the image in QEMU using the same method as described for a xref:build-qemu.adoc#_run_the_built_image_with_qemu[regular QEMU build]. However, the exact image you'll need will vary depending on the architecture you're building forfootnote:[For example, building the `agl-image-minimal` target for QEMU creates an image at `build/tmp/deploy/images/qemux86-64/agl-image-minimal-qemux86-64.ota-ext4`.], but it will be located in the `/tmp/deploy/images` directory under your build directory.

include::partial$recommended-steps.adoc[tags=firstbuild-nextstep]
include::ota-client::partial$recommended-steps.adoc[tags=firstbuild-nextstep]
1 change: 1 addition & 0 deletions docs/ota-client-guide/modules/ROOT/pages/build-qemu.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::ota-client::partial$aktualizr-version.adoc[]

:page-layout: page
:page-categories: [quickstarts]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

:page-layout: page
:page-categories: [quickstarts]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

In some cases, you might find it useful to include extra metadata about your software inside the signed Uptane metadata that OTA Connect delivers to your device. Some reasons you might want to do this include:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

Every time you bitbake a new image, it is automatically pushed to {product-name}. You can then send the updated image out to any of your devices. In this guide, you learn a few ways to push updated system images from your build machine or workstation to {product-name-short}.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

This is the second step in getting a new board running after xref:add-board-class.adoc[adding a new board class for the new target board in meta-updater].

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

== U-Boot loading the wrong config file

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ We recommend that you link:https://docs.ota.here.com/ota-client/latest/{docname}
====
endif::[]

include::_partials/aktualizr-version.adoc[]
include::partial$aktualizr-version.adoc[]

:page-layout: page
:page-categories: [tips]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ endif::[]

Yocto has a number of release branches. Their details are documented in the https://wiki.yoctoproject.org/wiki/Releases[Yocto wiki]. HERE OTA Connect currently actively supports the following branches:

* dunfell
* zeus
* warrior
* thud
Expand Down

0 comments on commit a6392de

Please sign in to comment.