Permalink
Fetching contributors…
Cannot retrieve contributors at this time
176 lines (167 sloc) 11.2 KB

Supported variables per backend

Table 1. COMMON backend
Variable Values allowed Default value Explanation

INCLUDE_MODULES

string

comma separated names or fullnames of test modules to be included while excluding all that do not match, e.g. "boot,mod1"

EXCLUDE_MODULES

string

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

SCHEDULE

string

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_AFTER_SCHEDULE

boolean

0

Exit test execution immediately after evaluation of the test schedule, e.g. to check only which test modules would be executed

_SKIP_POST_FAIL_HOOKS

boolean

0

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.

NOVIDEO

boolean

0

Do not encode video if set

NO_DEBUG_IO

boolean

0

Disable the I/O debug output in case of needle comparison times longer than expected

SCREENSHOTINTERVAL

float

0.5

The interval in seconds at which screenshots are taken internally

VNC_STALL_THRESHOLD

integer

4

Time after which is VNC considered stalled

VNC_TYPING_LIMIT

integer

50

Maximum number of keys per second

_CHKSEL_RATE_WAIT_TIME

integer

30

The ammount of time isotovideo is going to wait for the VNC console to become responsive

_CHKSEL_RATE_HITS

integer

15000

The ammount of times, the select should return the same fileno during the _CHKSEL_RATE_WAIT_TIME seconds, to consider the VNC console unresponsive

TIMEOUT_SCALE

integer

1

This scale parameter can be used based on performance of workers to prevent false positive timeouts based on differing worker performance.
Table 2. IPMI backend
Variable Values allowed Default value Explanation

IPMI_HOSTNAME

string

Hostname/IP for IPMI interface

IPMI_PASSWORD

string

Password for the IPMI interface

IPMI_USER

string

Username for the IPMI interface

IPMI_DO_NOT_POWER_OFF

boolean

undef

Don’t power off the machine after test
Table 3. QEMU backend
Variable Values allowed Default value Explanation

ARCH

x86_64|i686|aarch64|…​

depends on tested medium

Architecture of VM.

AUTO_INST

ATACONTROLLER

see qemu -device ?, e. g. for SATA: ich9-ahci

Controller for ATA devices, needed for connecting disks as SATA.

BIOS

BOOT_HDD_IMAGE

boolean

enables boot from HDD_1 (BOOTFROM has higher priority)

BOOTFROM

chars

undef

Influences order of boot devices. See qemu -boot option

CDMODEL

see qemu -device ?

undef

Storage device for virtualized CD

DELAYED_START

boolean

delay vm cpu start until resume_vm() is called

HDDFORMAT

HDDMODEL

see qemu -device ?

virtio-blk

Storage device for virtualized HDD.

HDDMODEL_$i

see qemu -device ?

virtio-blk

Storage device for virtualized HDD. Overrides global HDDMODEL for HDD_$i

HDDSIZEGB

integer

10

Creates HDD with specified size in GiB

HDD_$i

filename

Filename of HDD image to be used for VM. Up to 9

ISO

filename

Filename of ISO file to be attached to VM

ISO_$i

filename

Aditional ISO to be attached to VM. Up to 9

KEEPHDDS

boolean

Leave created HDD after test finishes. Useful for debugging tests

LAPTOP

boolean or filename

0

If 1, loads Dell E6330 DMI. If filename, loads specified DMI

MAKETESTSNAPSHOTS

boolean

0

Save snapshot for each test module in qcow image

MULTINET

boolean

0

VM will have two virtual NIC. Can’t be used with NICTYPE tap

MULTIPATH

boolean

0

Add HDD drives as multipath devices. Override HDDMODEL to virtio-scsi-pci

NBF

boolean

0

open source network boot firmware e.g. to attach iscsi target on boot http://ipxe.org/

NICMAC

any MAC address

52:54:00:12:34:56

MAC address to be assigned to virtual network card

NICMODEL

see qemu -device ?

virtio-net

Network device virtual NIC.

NICTYPE

user|tap|vde

user

Instruct QEMU to either use user networking or to connect virtual NIC to existin system TAP device

NICTYPE_USER_OPTIONS

string

undef

Arbitrary options for NICTYPE

NICVLAN

integer

undef

network (vlan) number to which the NIC should be connected, assigned by scheduler to jobs with NICTYPE != user

NUMDISKS

integer

1

Number of disks to be created and attached to VM

OFFLINE_SUT

boolean

0

Disable network for a VM

OFW

boolean

0

QEMU Open Firmware is in use

QEMU_OVERRIDE_VIDEO_DEVICE_AARCH64

boolean

undef

If set, for aarch64 systems use VGA as video adapter

QEMU_DISABLE_SNAPSHOTS

boolean

undef

If set, disable snapshots in case the worker has slow disks to avoid save_vm calls failing due to timeouts (See bsc#1035453)

PATHCNT

integer

2

Number of paths in MULTIPATH scenario

PXEBOOT

boolean

0

Boot VM from network

QEMU

QEMU binary filename

undef

Filename of QEMU binary to use

QEMUCPU

see qemu -cpu ?

undef

CPU to emulate

QEMUCPUS

integer

1

Number of CPUs to assign to VM

QEMUMACHINE

see qemu -machine ?

undef

Machine and chipset to emulate

QEMUPORT

integer

20002 + worker instance * 10

Port on which QEMU monitor should listen

QEMURAM

integer

1024

Size of RAM of VM in MiB

QEMUTHREADS

integer

0

Number of cpu threads used by VM

QEMUVGA

see qemu -device ?

cirrus

VGA device to use with VM

QEMU_COMPRESS_QCOW2

boolean

1

compress qcow2 images intended for upload

QEMU_NO_FDC_SET

boolean

0

Don’t disable the floppy drive.

QEMU_NO_KVM

boolean

0

Don’t use KVM acceleration.

QEMU_NO_TABLET

boolean

0

Don’t use USB tablet.

QEMU_VIRTIO_RNG

boolean

0

Enable virtio random number generator

QEMU_NUMA

boolean

0

Enable NUMA simulation, requires QEMUCPUS to be greater than one

QEMU_SMBIOS

see qemu -smbios ?

undef

pass this value to qemu -smbios

QEMU_COMPRESS_LEVEL

integer

6

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.

QEMU_COMPRESS_THREADS

integer

QEMUCPUS

Number of threads used for compressing memory dumps and snapshots.

QEMU_MAX_BANDWIDTH

integer

INT_MAX

Limits the transfer rate during a snapshot.

QEMU_DUMP_COMPRESS_METHOD

string

xz

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.

QEMU_APPEND

string

Append parameters on qemu command line. The first item will have '-' prepended to it.

RAIDLEVEL

SKIPTO

full name of test module

Restore VM from snapshot and continue by running specified test module. Needs HDD image with snapshots present

TAPDEV

device name

undef

TAP device name to which virtual NIC should be connected. Usually undef so automatic matching is used

TAPSCRIPT

TESTDEBUG

boolean

0

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

UEFI

boolean

0

Enable UEFI

UEFI_PFLASH_CODE

string

Specify the file name of the UEFI firmware code which will be loaded onto a read-only PFLASH drive

UEFI_PFLASH_VARS

string

Specify the file name which contains the UEFI firmware variables which will be loaded onto a mutable PFLASH drive

PUBLISH_PFLASH_VARS

string

Specify the file name to publish the UEFI vars file as

UEFI_PFLASH

boolean

0

(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

UEFI_BIOS

Deprecated, use UEFI_PFLASH_CODE

USBBOOT

boolean

0

Mount ISO as USB disk and boot VM from it

VDE_PORT

integer

worker instance + 10

number of vde switch port to connect

VDE_SOCKETDIR

string

.

directory where vde_switch control socket is to be found

VDE_USE_SLIRP

integer

1

whether to start slirpvde

VNC

integer

worker instance + 90

Display on which VNC server is running. Actual port is 5900 + VNC

VNCKB

Table 4. SVIRT backend
Variable Values allowed Default value Explanation

HDDSIZEGB

integer

15

Disk size in GB

QEMUCPUS

integer

1

Number of CPUs to assign to VM

QEMURAM

integer

1024

Size of RAM of VM in MiB

VIRSH_HOSTNAME

string

SSH Host with virsh

VIRSH_PASSWORD

string

Password for root account on above host

VIRSH_VMM_FAMILY

string

Host’s hypervisor ('kvm', 'xen')

VIRSH_VMM_TYPE

string

Host’s hypervisor type ('hvm' for full virtualization on 'kvm' and 'xen' families, 'linux' for paravirtualization on 'xen' family)

VIRSH_GUEST

string

Where to look for VNC server (SUT or VM)

VIRSH_GUEST_PASSWORD

string

VNC password of the guest

VIRSH_INSTANCE

integer

VM’s instance number on VIRSH_HOSTNAME

VMWARE_USERNAME

string

Administrator’s username ('@' is '%40')

VMWARE_PASSWORD

string

Administrator’s password

VMWARE_HOST

string

VCS server for autentication

VMWARE_DATASTORE

string

VMware datastore

VMWARE_NFS_DATASTORE

string

VMware datastore with openQA NFS directories

VMWARE_SERIAL_PORT

string

TCP port where is VM’s serial port stream to be expected on the ESX server

VMWARE_BRIDGE

string

VMware’s bridge name (usual default is 'VM Network')

VMWARE_REMOTE_VMM

string

HYPERV_USERNAME

string

Administrator account name

HYPERV_PASSWORD

string

Password for above account

HYPERV_SERVER

string

Windows Server (2008 R2, 2012 R2, or 2016) instance IP address

HYPERV_SERIAL_PORT

integer

TCP port where is VM’s serial port stream to be expected on the Hyper-V server

HYPERV_VIRTUAL_SWITCH

string

ExternalVirtualSwitch

Name of Hyper-V’s External Virtual Switch

Table 5. PVM backend
Variable Values allowed Default value Explanation

MEM

integer

2048

amount of RAM

LPAR

string

osauto

LPAR name to be created

NUMDISKS

integer

1

Number of disks

HDDSIZEGB

integer

15

Disk size in GB

NICVLAN

integer

1

VLAN to attach to

VSWITCH

string

VSWITCH0

A virtula switch to connect to

CPUS

integer

1

Number of CPUS for LPAR
Table 6. GENERAL_HW backend
Variable Values allowed Default value Explanation

GENERAL_HW_VNC_IP

string

Hostname of the gadget’s network

GENERAL_HW_CMD_DIR

string

Directory with allowed CMD scripts

GENERAL_HW_SOL_CMD

string

Shell Script to output serial output (in CMD_DIR)

GENERAL_HW_POWERON_CMD

string

Shell Command to power on the SUT (in CMD_DIR)

GENERAL_HW_POWEROFF_CMD

string

Shell Command to power off the SUT (in CMD_DIR)
Table 7. AMT backend
Variable Values allowed Default value Explanation

AMT_HOSTNAME

string

Hostname or IP of the target host

AMT_PASSWORD

string

Password for admin AMT user on target host