diff options
author | Merlin Carter <merlin.carter@here.com> | 2019-09-05 15:42:59 +0200 |
---|---|---|
committer | Merlin Carter <merlin.carter@here.com> | 2019-09-05 15:57:12 +0200 |
commit | f2dcc347e576dc30ca1ac750a1c9d341a3d41dd5 (patch) | |
tree | 86fbd2516ca6da1753cb9f5909bb2647710e615a /docs/modules/ROOT/pages/meta-updater-testing.adoc | |
parent | 948c3ea4e9a7e79d1de4a09e452fbdbbd5772073 (diff) | |
download | meta-updater-f2dcc347e576dc30ca1ac750a1c9d341a3d41dd5.tar.gz |
OTA-3682: Remove the existing doc
Removing the existing meta-updater doc so it can
be moved into the aktualizr repo.
Also updated README to point to same files in aktualizr repo.
Signed-off-by: Merlin Carter <merlin.carter@here.com>
Diffstat (limited to 'docs/modules/ROOT/pages/meta-updater-testing.adoc')
-rw-r--r-- | docs/modules/ROOT/pages/meta-updater-testing.adoc | 44 |
1 files changed, 0 insertions, 44 deletions
diff --git a/docs/modules/ROOT/pages/meta-updater-testing.adoc b/docs/modules/ROOT/pages/meta-updater-testing.adoc deleted file mode 100644 index 1e20c87..0000000 --- a/docs/modules/ROOT/pages/meta-updater-testing.adoc +++ /dev/null | |||
@@ -1,44 +0,0 @@ | |||
1 | = Testing | ||
2 | |||
3 | //MC: No overlap with any content currently in the developer guide, but probably useful content to clean up and include. | ||
4 | |||
5 | == QA with oe-selftest | ||
6 | |||
7 | This layer relies on the test framework oe-selftest for quality assurance. Currently, you will need to run this in a build directory with `MACHINE` set to `qemux86-64`. Follow the steps below to run the tests: | ||
8 | |||
9 | 1. Append the line below to `conf/local.conf` to disable the warning about supported operating systems: | ||
10 | + | ||
11 | ``` | ||
12 | SANITY_TESTED_DISTROS = "" | ||
13 | ``` | ||
14 | |||
15 | 2. If your image does not already include an ssh daemon such as dropbear or openssh, add this line to `conf/local.conf` as well: | ||
16 | + | ||
17 | ``` | ||
18 | IMAGE_INSTALL_append = " dropbear " | ||
19 | ``` | ||
20 | |||
21 | 3. Some tests require that `SOTA_PACKED_CREDENTIALS` is set in your `conf/local.conf`. See the xref:dev@ota-build::sota-variables.adoc[SOTA-related variables in local.conf]. | ||
22 | |||
23 | 4. To be able to build an image for the GRUB tests, you will need to install the `ovmf` package as described in the xref:dev@ota-build::build.adoc#_dependencies[dependencies section]. | ||
24 | |||
25 | 5. Run oe-selftest: | ||
26 | + | ||
27 | ``` | ||
28 | oe-selftest -r updater_native updater_qemux86_64 updater_minnowboard updater_raspberrypi updater_qemux86_64_ptest | ||
29 | ``` | ||
30 | |||
31 | For more information about oe-selftest, including details about how to run individual test modules or classes, please refer to the https://wiki.yoctoproject.org/wiki/Oe-selftest[Yocto Project wiki]. | ||
32 | |||
33 | == Aktualizr test suite with ptest | ||
34 | |||
35 | The meta-updater layer includes support for running parts of the aktualizr test suite on deployed devices through link:https://wiki.yoctoproject.org/wiki/Ptest[Yocto's ptest functionality]. Since it adds significant build time cost, it is currently disabled by default. To enable it, add the following to your `conf/local.conf`: | ||
36 | |||
37 | ``` | ||
38 | PTEST_ENABLED_pn-aktualizr = "1" | ||
39 | IMAGE_INSTALL_append += " aktualizr-ptest ptest-runner " | ||
40 | ``` | ||
41 | |||
42 | Be aware that it will add several hundreds of MB to the generated file system. | ||
43 | |||
44 | The aktualizr tests will now be part of the deployed ptest suite, which can be run by calling `ptest-runner`. Alternatively, the required files and run script can be found in `/usr/lib/aktualizr/ptest`. | ||