summaryrefslogtreecommitdiffstats
path: root/docs/modules/ROOT/pages/meta-updater-testing.adoc
diff options
context:
space:
mode:
authorMerlin Carter <merlin.carter@here.com>2019-09-05 15:42:59 +0200
committerMerlin Carter <merlin.carter@here.com>2019-09-05 15:57:12 +0200
commitf2dcc347e576dc30ca1ac750a1c9d341a3d41dd5 (patch)
tree86fbd2516ca6da1753cb9f5909bb2647710e615a /docs/modules/ROOT/pages/meta-updater-testing.adoc
parent948c3ea4e9a7e79d1de4a09e452fbdbbd5772073 (diff)
downloadmeta-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.adoc44
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
7This 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
91. Append the line below to `conf/local.conf` to disable the warning about supported operating systems:
10+
11```
12SANITY_TESTED_DISTROS = ""
13```
14
152. 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```
18IMAGE_INSTALL_append = " dropbear "
19```
20
213. 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
234. 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
255. Run oe-selftest:
26+
27```
28oe-selftest -r updater_native updater_qemux86_64 updater_minnowboard updater_raspberrypi updater_qemux86_64_ptest
29```
30
31For 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
35The 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```
38PTEST_ENABLED_pn-aktualizr = "1"
39IMAGE_INSTALL_append += " aktualizr-ptest ptest-runner "
40```
41
42Be aware that it will add several hundreds of MB to the generated file system.
43
44The 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`.