| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
Path to test distribution. Can be a git repository URL of a test distribution to checkout with an optional refspec or also git hash into the current directory. It tries to follow the definition of https://docs.npmjs.com/files/package.json#git-urls-as-dependencies (e.g. |
|
|
|
Path to optional "product directory" which includes the test schedule entry point "main.pm" as well as a "needles" subdirectory with the needles to load. Can be relative path. |
|
|
|
Path to needles subdirectory to use, defaults to "needles" within |
|
|
|
comma separated names or fullnames of test modules to be included while excluding all that do not match, e.g. "boot,mod1" |
|
|
|
comma separated names or fullnames of test modules to exclude. Can be combined with INCLUDE_MODULES and has precedence, e.g. to additionally exclude modules based on an include-list |
|
|
|
comma separated list of relative paths to test modules within CASEDIR without the implicit file extension '.pm' to be scheduled instead of evaluating a schedule from the test distributions main.pm file, e.g. "boot,console/mod1" |
|
|
|
|
Exit test execution immediately after evaluation of the test schedule, e.g. to check only which test modules would be executed |
|
|
|
Skip the execution of post_fail_hook methods if set. This can be useful to save test execution time during test development when the post_fail_hook is not expected to provide any value as most likely the test developer already knows what needs to be done as a next step on a test fail. |
|
|
git refspec to checkout within |
|
|
|
git refspec to checkout within |
|
|
|
Specifies the command line for invoking a custom video encoder. It is supposed to accept a sequence of PPM images via stdin. The placeholder |
|
|
|
|
The extension of the output file when |
|
|
|
Whether |
|
|
|
Whether the creation of the video should be disabled and also any |
|
|
|
Disable the I/O debug output in case of needle comparison times longer than expected |
|
|
|
The interval in seconds between "attempts" in osutils, e.g. used for connections to qemu qmp backend |
|
|
|
The interval in seconds at which screenshots are taken internally |
|
|
|
Maximum retries to connect to SSH based console targets |
|
|
|
Interval in seconds between retries to connect to SSH based console targets. Related to SSH_CONNECT_RETRY |
|
|
|
Time after which is VNC considered stalled |
|
|
|
Maximum number of keys per second |
|
|
|
The ammount of time isotovideo is going to wait for the VNC console to become responsive |
|
|
|
The ammount of times, the select should return the same fileno during the _CHKSEL_RATE_WAIT_TIME seconds, to consider the VNC console unresponsive |
|
|
|
This scale parameter can be used based on performance of workers to prevent false positive timeouts based on differing worker performance. |
|
|
Test module (name or fullname) to pause test execution at. To be used together with the openQA developer mode to continue test execution. Be aware that the openQA web UI will only reflect this within the developer mode after confirming to control the test. |
|
|
|
|
Pause test execution on the next screen mismatch. Same notes as for |
|
|
|
Pause test execution on the next test API command. Same notes as for |
|
|
|
Add quiet flag to all the calls to script_run, script_output and validate_script_output. It will omit all the squares "wait_serial expected" on the Details view of the test case. This option might be useful for serial terminal tests. |
|
|
hostname or IP adress of host running the autoinst webserver endpoint, defaults to the local IP adress within the qemu network for the qemu backend or the |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Sets the number of server alive messages which may be sent without receiving any messages back from the server. If this threshold is reached while server alive messages are being sent, ssh will disconnect from the server, terminating the session. The server alive mechanism is valuable when the client or server depend on knowing when a connection has become inactive. |
|
|
|
Sets a timeout interval in seconds after which if no data has been received from the server, client will send a message through the encrypted channel to request a response from the server. |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Hostname/IP for IPMI interface |
|
|
|
Password for the IPMI interface |
|
|
|
Username for the IPMI interface |
|
|
|
Don’t power off the machine after test |
|
|
|
Don’t restart the machine before test |
|
|
|
Reset ipmi main board before test for sol console stability |
|
|
|
Don’t perform BMC selftest |
|
|
|
Hardware used for IPMI interface |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Architecture of VM. |
|
|
Controller for ATA devices, needed for connecting disks as SATA. |
|
|
Set the filename for the BIOS |
||
|
|
enables boot from HDD_1 (BOOTFROM has higher priority) |
|
|
|
|
enables boot menu for selection of boot device |
|
|
|
boot menu timeout in ms. Needs BOOT_MENU |
|
|
|
Influences order of boot devices. See qemu -boot option |
|
|
|
Storage device for virtualized CD |
|
|
delay vm cpu start until resume_vm() is called |
|
|
HDD format |
||
|
|
|
Storage device for virtualized HDD. |
|
|
|
Storage device for virtualized HDD. Overrides global HDDMODEL for HDD_$i |
|
|
|
Creates HDD with specified size in GiB |
|
|
Filename of HDD image to be used for VM. Up to 9 |
|
|
|
|
see qemu-system-x86_64 -device nvme,help - set the number of queues for HDD_$i |
|
|
Filename of ISO file to be attached to VM |
|
|
|
Aditional ISO to be attached to VM. Up to 9 |
|
|
|
Leave created HDD after test finishes. Useful for debugging tests |
|
|
|
|
If 1, loads Dell E6330 DMI. If filename, loads specified DMI |
|
|
|
Save snapshot for each test module in qcow image |
|
|
|
Add HDD drives as multipath devices. Override HDDMODEL to virtio-scsi-pci |
|
|
|
open source network boot firmware e.g. to attach iscsi target on boot http://ipxe.org/ |
|
|
|
MAC address to be assigned to virtual network card |
|
|
|
Network device virtual NIC. |
|
|
|
Instruct QEMU to either use user networking or to connect virtual NIC to existin system TAP device |
|
|
|
Arbitrary options for NICTYPE |
|
|
|
network (vlan) number to which the NIC should be connected, assigned by scheduler to jobs with NICTYPE != user |
|
|
|
Number of disks to be created and attached to VM, can be 0 to disable disks |
|
|
|
Disable network for a VM |
|
|
|
QEMU Open Firmware is in use |
|
|
|
Set debug mode if value is 1 |
|
|
|
If set, only execute the qemu process but return early before connecting to the process. This can be helpful for cutting testing time or to connect to the qemu process manually. |
|
|
|
Only used for internal testing, see comment in t/18-qemu-options.t for details. |
|
|
|
If set, for aarch64 systems use VGA as video adapter |
|
|
|
If set, disable snapshots in QEMU. This needs to be set when using vmdk disk images or in case the worker has slow disks to avoid save_vm calls failing due to timeouts (See bsc#1035453) |
|
|
|
The number of attempts to connect to qemu qmp. Usually used for internal testing |
|
|
|
Number of paths in MULTIPATH scenario |
|
|
|
Boot VM from network, on every boot or only once if set to 'once' |
|
|
|
Filename of QEMU binary to use |
|
|
|
CPU to emulate |
|
|
|
Number of CPUs to assign to VM |
|
|
|
Machine and chipset to emulate |
|
|
|
Port on which QEMU monitor should listen |
|
|
|
Size of RAM of VM in MiB |
|
|
|
Number of cpu threads used by VM |
|
|
|
Configure VM to use a TPM emulator device, with appropriate args for the arch. sysadmin is responsible for running swtpm with a socket at /tmp/mytpmX, where X is the value of QEMUTPM or the worker instance number if QEMUTPM is set to 'instance' |
|
|
|
VGA device to use with VM |
|
|
|
compress qcow2 images intended for upload |
|
|
|
Define number of tries for qemu-img commands |
|
|
|
Define a path to use huge pages (e.g. /dev/hugepages/) |
|
|
|
The VM host IP used in usermode networking. Set |
|
|
|
Maximum time in seconds a migration to file may take for example for snapshot creation before being forcefully aborted. |
|
|
|
Don’t disable the floppy drive. |
|
|
|
Don’t use KVM acceleration. |
|
|
|
Don’t use USB tablet. |
|
|
|
Enable virtio random number generator |
|
|
|
Enable NUMA simulation, requires QEMUCPUS to be greater than one |
|
|
|
pass this value to qemu -smbios |
|
|
|
pass this value to qemu -soundhw (for qemu < 4.2) |
|
|
|
Audio device to use with audiodev to qemu -device (for qemu >= 4.2) |
|
|
|
Audio backend to use with audiodev (for qemu >= 4.2) |
|
|
|
Sets the compression level used for memory dumps and snapshots. Zero turns compression off and 9 is the maximum level. Generally there is little improvement in compression ratio by increasing the level, but the CPU time can be high on some platforms. |
|
|
|
Number of threads used for compressing memory dumps and snapshots. |
|
|
|
Ignore failed dbus calls and ignore instead of fatal exits |
|
|
|
Limits the transfer rate during a snapshot. |
|
|
|
The compression to use during a memory dump. Can be set to xz, bzip2 or internal (QEMU’s internal compression, not compatible with crash or gdb). If xz is set, but not available, it will fallback to bzip2. Also see QEMU_COMPRESSION_LEVEL. |
|
|
Append parameters on qemu command line. The first item will have '-' prepended to it. |
|
|
|
|
Enable/disable virtio console. (@see |
|
|
|
Number of virtio consoles. |
|
|
|
The target guest RAM usage before a snapshot is taken. It is intended to speed up snapshots by forcing the guest to drop various caches. Setting this enables the virtio-balloon device which requires a kernel with a virtio-balloon driver. Setting this far below the RAM required by the guest will probably cause the guest to panic or deadlock. However it should be able to cope with it being set slightly below what is needed. |
|
Set the raid level |
||
|
|
Restore VM from snapshot and continue by running specified test module. Needs HDD image with snapshots present |
|
|
|
|
TAP device name to which virtual NIC should be connected. Usually undef so automatic matching is used |
|
|
|
Script used during the backend network shutdown |
|
Script used during the backend network creation |
||
|
|
|
Enable test debugging: override 'milestone' and 'fatal' test flags to 1. Snapshot are created after each successful test module and each fail aborts test run |
|
|
|
Enable UEFI |
|
|
Specify the file name of the UEFI firmware code which will be loaded onto a read-only PFLASH drive |
|
|
|
Specify the file name which contains the UEFI firmware variables which will be loaded onto a mutable PFLASH drive |
|
|
|
Specify the file name to publish the UEFI vars file as |
|
|
|
|
(Deprecated, use UEFI_PFLASH_VARS) Enable the pflash mode to write the UEFI variables directly into the firmware file instead of NVvars in the EFI system partition |
|
Deprecated, use UEFI_PFLASH_CODE |
||
|
|
|
Mount ISO as USB disk and boot VM from it |
|
|
|
number of vde switch port to connect |
|
|
|
directory where vde_switch control socket is to be found |
|
|
|
whether to start slirpvde |
|
|
|
Display on which VNC server is running. Actual port is 5900 + VNC |
|
Set the keyboard layout if you are not using en-us |
||
|
|
|
qemu system types |
|
|
|
Worker host name |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Disk size in GB |
|
|
|
Number of CPUs to assign to VM |
|
|
|
Size of RAM of VM in MiB |
|
|
SSH Host with virsh |
|
|
|
Password for root account on above host |
|
|
|
Host’s hypervisor ('kvm', 'xen') |
|
|
|
Host’s hypervisor type ('hvm' for full virtualization on 'kvm' and 'xen' families, 'linux' for paravirtualization on 'xen' family) |
|
|
|
Where to look for VNC server (SUT or VM) |
|
|
|
VNC password of the guest |
|
|
|
VM’s instance number on VIRSH_HOSTNAME |
|
|
|
Administrator’s username ('@' is '%40') |
|
|
|
Administrator’s password |
|
|
|
VCS server for autentication |
|
|
|
VMware datastore |
|
|
|
VMware datastore with openQA NFS directories |
|
|
|
TCP port where is VM’s serial port stream to be expected on the ESX server |
|
|
|
VMware’s bridge name (usual default is 'VM Network') |
|
|
|
Set the vmware Virtual Machine Manager |
|
|
|
Administrator account name |
|
|
|
Password for above account |
|
|
|
Windows Server (2008 R2, 2012 R2, or 2016) instance IP address |
|
|
|
TCP port where is VM’s serial port stream to be expected on the Hyper-V server |
|
|
|
ExternalVirtualSwitch |
|
|
|
|
1 |
|
|
|
undef |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Number of CPUs |
|
|
|
Quantity of RAM |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
|
Arquitecture of the pvm backend |
|
|
|
amount of RAM |
|
|
|
LPAR name to be created |
|
|
|
LPAR id |
|
|
|
Number of disks |
|
|
|
Name of the virtual disk to be attached |
|
|
|
Additional disk to be attached |
|
|
|
Disk size in GB |
|
|
|
Type of NIC |
|
|
|
VLAN to attach to |
|
|
|
A virtula switch to connect to |
|
|
|
Number of CPUS for LPAR |
|
|
|
isos from nfs mount on VIO side to VMLibrary |
|
|
|
Virtual Optical Media ISO |
|
|
|
VNC port |
|
|
|
osauto id |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
Hostname of the gadget’s network. If not set, SSH consoles will be used |
|
|
|
Directory with allowed CMD scripts |
|
|
|
Shell Script to output serial output (in CMD_DIR) |
|
|
|
Arguments to pass GENERAL_HW_SOL_CMD Shell script |
|
|
|
Shell Command to power on the SUT (in CMD_DIR) |
|
|
|
Arguments to pass GENERAL_HW_POWERON_CMD Shell script |
|
|
|
Shell Command to power off the SUT (in CMD_DIR) |
|
|
|
Arguments to pass GENERAL_HW_POWEROFF_CMD Shell script |
|
|
|
Shell Command to flash a disk image on SUT (in CMD_DIR), optionnal |
|
|
|
Arguments to pass GENERAL_HW_FLASH_CMD Shell script |
| Variable | Values allowed | Default value | Explanation |
|---|---|---|---|
|
|
Hostname or IP of the target host |
|
|
|
Password for admin AMT user on target host |