mirror of
https://pagure.io/fedora-qa/os-autoinst-distri-fedora.git
synced 2024-09-12 03:27:21 +00:00
94 lines
9.5 KiB
Markdown
94 lines
9.5 KiB
Markdown
List of variables usable in tests
|
|
=================================
|
|
|
|
This list contains variables that are possible to set/redefine in WebUI and get their values in tests.
|
|
This document merges relevant variables from
|
|
[official documentation](https://github.com/os-autoinst/os-autoinst/blob/master/doc/backend_vars.asciidoc)
|
|
(backend variables), variables that control flow through `main.pm` (test variables) and variables that
|
|
are specified when ISO is posted into OpenQA (run variables).
|
|
|
|
Backend variables
|
|
-----------------
|
|
These variables control settings of underlying virtual machine where tests runs on. Some of them (`ARCH`, `QEMURAM`, ...) should be set per machine, others (`HDD_$i`, `HDDMODEL`, ...) should be set per test and some of them (`KEEPHDDS`, `MAKETESTSNAPSHOTS`, `SKIPTO`) should be set only during development and debugging.
|
|
|
|
| Variable | Values allowed | Default value | Explanation |
|
|
| -------- | :------------: | :-----------: | ----------- |
|
|
| `ARCH` | `x86_64`, `i686`, `aarch64`, ... | depends on tested medium | architecture of VM |
|
|
| `BIOS` | filename | `ovmf-x86_64-ms.bin` for `x86_64` UEFI, not set otherwise | set different BIOS |
|
|
| `BOOTFROM` | characters (see man qemu, `-boot order=` option) | not set | boot from different medium than CD |
|
|
| `CDMODEL` | see `qemu-kvm -device help` | not set/Qemu default | type of device for CD |
|
|
| `HDDMODEL` | see `qemu-kvm -device help` (e. g. PATA = `id-hd`, SATA = `ide-hd,bus-ahci0.0`, SCSI = `virtio-scsi-pci`) | `virtio-blk` | type of device for HDD |
|
|
| `HDDSIZEGB` | integer | `10` | size (in GBs) for disks that are created automatically |
|
|
| `HDD_$i` (`HDD_1, HDD_2`, ...) | filename | not set | attach additional HDD to VM |
|
|
| `ISO` | filename | not set | attach CD drive with ISO inserted |
|
|
| `ISO_$i` (`ISO_1`, `ISO_2`, ...) | filename | not set | additional CD drives to by attached |
|
|
| `KEEPHDDS` | boolean | `false`/not set | don't delete HDD after test finishes |
|
|
| `LAPTOP` | boolean or filename | `false`/not set | if `true`, Dell E6330 DMI is used; if set to filename, that file is used for DMI |
|
|
| `MAKETESTSNAPSHOTS` | boolean | `false`/not set | save snapshot for each test |
|
|
| `NOVIDEO` | boolean | `false`/not set | don't create video output if set |
|
|
| `NUMDISKS` | integer | 1 | number of disks to be created and attached to VM |
|
|
| `PART_TABLE_TYPE` | `mbr`, `gpt` | not set | what type of partition table should attached HDD have |
|
|
| `PXEBOOT` | boolean | `false`/not set | boot VM from PXE (network) |
|
|
| `QEMU` | filename, path to Qemu binary | not set | filename of Qemu binary |
|
|
| `QEMUCPU` | see `qemu-kvm -cpu help` | not set | CPU to emulate |
|
|
| `QEMUCPUS` | integer | 1 | number of processor cores to use for Qemu |
|
|
| `QEMURAM` | integer | 1024 | size of RAM to use (in MiB) |
|
|
| `QEMUTHREADS` | integer | 0 | number of CPU threads to use for Qemu |
|
|
| `QEMUVGA` | see `qemu-kvm -device help` | `cirrus` (should be set to `std` on Fedora, cirrus driver [was retired](https://lists.fedoraproject.org/pipermail/devel/2014-May/199459.html)) | display device to use for VM |
|
|
| `QEMU_COMPRESS_QCOW2` | boolean | `false`/not set | compress qcow2 images |
|
|
| `SKIPTO` | name of snapshot | not set | restore VM from given snapshot - better used with `MAKETESTSNAPSHOTS` |
|
|
| `UEFI` | boolean | `false`/not set | whether to use UEFI (UEFI BIOS files should be installed) |
|
|
| `UEFI_BIOS` | filename | `false`/not set, `ovmf-x86_64-ms.bin` when `UEFI` is set | filename of UEFI BIOS |
|
|
| `USBBOOT` | boolean | `false`/not set | if set, mount ISO as USB and boot from it |
|
|
|
|
For additional (kvm2usb, IPMI...) as well as for other Qemu variables, see
|
|
[official documentation](https://github.com/os-autoinst/os-autoinst/blob/master/doc/backend_vars.asciidoc).
|
|
|
|
Test variables
|
|
--------------
|
|
These variables control flow through `main.pm` - by setting them, you can alter what parts will be loaded.
|
|
|
|
There are certain tests that conflict each other. Note that conflict is always mutual, but for simplification
|
|
purposes, only one side of this conflict is shown (that means, if it's shown that `A` conflicts `B`,
|
|
it also means that `B` conflicts `A` even if not shown in the table).
|
|
|
|
| Variable | Values allowed | Default value/behavior | Conflicts | Explanation |
|
|
| -------- | :------------: | ---------------------- | :-------: | ----------- |
|
|
| `LIVE` | boolean | not set | technically `PACKAGE_SET`, `KICKSTART`, `MIRRORLIST_GRAPHICAL`, `REPOSITORY_GRAPHICAL`, `REPOSITORY_VARIATION` | specify that the test is running on Live system - additional steps are required (starting Anaconda...) |
|
|
| `PACKAGE_SET` | string (`minimal`, `default`, ...) | `minimal`; `default` when `LIVE` is set | nothing | sets packageset to install - you have to add appropriate needles, see `tests/_software_selection.pm` |
|
|
| `ENTRYPOINT` | filename | not set | N/A | set `ENTRYPOINT` to load specific test directly (bypass modular structure, mainly usable for testing). If you want to run more than one test, separate them with space. |
|
|
| `UPGRADE` | string (`minimal`, `desktop`, `encrypted`, ...) | not set | all except of `LIVE` and `USER_PASSWORD` | when set, do an upgrade test of specified type |
|
|
| `KICKSTART` | boolean | `false`/not set | all | when specified, do an kickstart installation (you should use `GRUB` variable to specify where kickstart file resides) |
|
|
| `MIRRORLIST_GRAPHICAL` | boolean | `false`/not set | `REPOSITORY_GRAPHICAL` | sets installation source to mirrorlist |
|
|
| `REPOSITORY_GRAPHICAL` | url to repository (without arch and `/os`, for example `http://dl.fedoraproject.org/pub/fedora/linux/development`) | not set | `MIRRORLIST_GRAPHICAL` | sets installation source to repository url in Anaconda |
|
|
| `REPOSITORY_VARIATION` | url to repository (without arch and `/os`, for example `http://dl.fedoraproject.org/pub/fedora/linux/development`) | not set | nothing | sets installation source to repository url in GRUB |
|
|
| `PARTITIONING` | string (`custom_software_raid`, `guided_delete_all`, ...) | `guided_empty` | nothing | load specified test for partitioning part (when `PARTITIONING=guided_delete_all`, `tests/disk_guided_delete_all.pm` is loaded) and optionally post-install partitioning check (if `tests/disk_guided_delete_all_postinstall.pm` exists, it will be loaded after login to the installed system). Also, if value starts with `custom_`, the `select_disks()` method will check the custom partitioning box |
|
|
| `ENCRYPT_PASSWORD` | string | not set | nothing | if set, encrypt disk with given password |
|
|
| `DESKTOP` | boolean | `false`/not set | nothing | set to indicate that Fedora is running with GUI (so for example OpenQA should expect graphical login screen) |
|
|
| `ROOT_PASSWORD` | string | `weakpassword` | nothing | root password is set to this value |
|
|
| `GRUB` | string | not set | nothing | when set, append this string to kernel line in GRUB |
|
|
| `GRUBADD` | string | not set | nothing | when set, append this string to kernel line in GRUB, after the `GRUB` string if that one is set too. This is never set by tests; instead it's provided as a way to e.g. run the normal tests with an `updates.img` to test some anaconda change (the scheduler CLI can help you use this feature) |
|
|
| `USER_LOGIN` | string | not set | should be used with `USER_PASSWORD` (unless `false`) | when set, user login is set to this value. If not set, default value `test` is used for console installs, no login is done for graphical installs. If set to `false`, no user login will be done |
|
|
| `USER_PASSWORD` | string | not set | should be used with `USER_LOGIN` | when set, user password is set to this value. If not set, default value `weakpassword` is used for console installs, no login is done for graphical installs |
|
|
| `TEST_UPDATES` | boolean | `false`/not set | set to indicate that this test checks updates.img loading, so we should check for the expected effect of the updates image used for this testing |
|
|
| `POSTINSTALL` | string | not set | nothing | If set, `tests/(value)_postinstall.pm` will be loaded after install, boot, login, and other postinstall tests
|
|
| `UEFI` | boolean | `false`/not set | nothing | whether to use UEFI, this variable isn't usually set in test suites but in machine definition |
|
|
| `ANACONDA_TEXT` | boolean | `false`/not set | all | when specified, anaconda will run in text mode |
|
|
|
|
Run variables
|
|
-------------
|
|
These variables should be set when tests are scheduled (when running `isos post`).
|
|
|
|
| Variable | Explanation |
|
|
| -------- | ----------- |
|
|
| `ISO` | contains filename of ISO that is used for booting. If ISOURL is not set, file must exist in /var/lib/openqa/share/factory/iso. If ISOURL is set, it will be downloaded to this name instead of its original name |
|
|
| `ISO_URL` | contains URL for ISO to boot, openQA will download it |
|
|
| `DISTRI` | contains distribution name (should be same as in WebUI, probably `fedora`) |
|
|
| `VERSION` | contains version of distribution |
|
|
| `FLAVOR` | indicates what type of distribution is used. Three Pungi properties, joined with `-`: `variant`, `type`, and `format`. e.g.: `Server-dvd-iso`. Special value `universal` is used to schedule the group of tests that should be run once each per arch per compose, against the 'best' available ISO |
|
|
| `ARCH` | is set to architecture that will be used (`x86_64`, `i686`) |
|
|
| `BUILD` | contains Pungi compose_id (something like `Fedora-24-20160121.n.3`) |
|
|
| `CURRREL` | the current stable Fedora release at the time of the test run |
|
|
| `PREVREL` | the previous stable Fedora release at the time of the test run |
|
|
| `LOCATION` | contains Pungi base compose location (something like `https://kojipkgs.fedoraproject.org/compose/branched/Fedora-25-20160901.n.0/compose/`) |
|