Below you can find the list of variables which control tests behavior, including schedule. Please, find os-autoinst backend variables which complement the list of variables below.
NOTE: This list is not complete and may contain outdated info. If you face such a case, please, create pull request with required changes.
For a better overview some domain-specific values have been moved to their own section:
| Variable | Type | Default value | Details |
|---|---|---|---|
APACHE2_PKG |
string | apache |
Apache2 package under test (e.g. apache2 or apache2-tls13) |
| AARCH64_MTE_SUPPORTED | boolean | false | Set to 1 if your machine supports Memory Tagging Extension (MTE) |
| ADDONS | string | Comma separated list of addons to be added using DVD. Also used to indicate addons in the SUT. | |
| ADDONURL | string | Comma separated list of addons. Includes addon names to get url defined in ADDONURL_*. For example: ADDONURL=sdk,we ADDONURL_SDK=https://url ADDONURL_WE=ftp://url | |
| ADDONURL_* | string | Define url for the addons list defined in ADDONURL | |
| ASSERT_BSC1122804 | boolean | false | In some scenarios it is necessary to check if the mistyped full name still happens. |
| ASSERT_Y2LOGS | boolean | false | If set to true, we will parse YaST logs after installation and fail test suite in case unknown errors were detected. |
| AUTOCONF | boolean | false | Toggle automatic configuration |
| AUTOYAST | string | Full url to the AY profile or relative path if in data directory of os-autoinst-distri-opensuse repo. If value starts with aytests/, these profiles are provided by support server, source code is available in aytests repo. If value is a folder ending in / rules and classes will be used. |
|
| AUTOYAST_PREPARE_PROFILE | boolean | false | Enable variable expansion in the autoyast profile. |
| AUTOYAST_VERIFY_TIMEOUT | boolean | false | Enable validation of pop-up windows timeout. |
| AY_EXPAND_VARS | string | Commas separated list of variable names to be expanded in the provided autoyast profile. For example: REPO_SLE_MODULE_BASESYSTEM,DESKTOP,... Provided variables will replace {{VAR}} in the profile with the value of given variable. See also AUTOYAST_PREPARE_PROFILE. |
|
| BASE_VERSION | string | ||
| BETA | boolean | false | Enables checks and processing of beta warnings. Defines current stage of the product under test. |
| BCI_DEVEL_REPO | string | This parameter is given to the bci-tests to inject a different SLE_BCI repository url to the container image instead of the default one. Used by bci_test.pm. |
|
| BCI_TEST_ENVS | string | The list of environments to be tested, e.g. base,init,dotnet,python,node,go,multistage. Used by bci_test.pm. Use - to not schedule any BCI test runs. |
|
| BCI_TESTS_REPO | string | Location of the bci-tests repository to be cloned. Used by bci_prepare.pm. |
|
| BCI_TESTS_BRANCH | string | Branch to be cloned from bci-tests. Used by bci_prepare.pm. |
|
| BCI_TIMEOUT | string | Timeout given to the command to test each environment. Used by bci_test.pm. |
|
| BCI_TARGET | string | ibs-cr | Container project to be tested. ibs-cr is the CR project, ibs is the released images project |
| BCI_SKIP | boolean | false | Switch to disable BCI test runs. Necessary for fine-granular test disablement |
| BCI_PREPARE | boolean | false | Launch the bci_prepare step again. Useful to re-initialize the BCI-Test repo when using a different BCI_TESTS_REPO |
| BCI_VIRTUALENV | boolean | false | Use a virtualenv for pip dependencies in BCI tests |
| BCI_OS_VERSION | string | Set the environment variable OS_VERSION to this value, if present | |
| BOOTLOADER | string | grub2 | Which bootloader is used by the image (and in the future also: will be selected during installation) |
| BTRFS | boolean | false | Indicates btrfs filesystem. Deprecated, use FILESYSTEM instead. |
| BUILD | string | Indicates build number of the product under test. | |
| CASEDIR | string | Path to the directory which contains tests. | |
| CHECK_RELEASENOTES | boolean | false | Loads installation/releasenotes test module. |
| CHECKSUM_* | string | SHA256 checksum of the * medium. E.g. CHECKSUM_ISO_1 for ISO_1. | |
| CHECKSUM_FAILED | string | Variable is set if checksum of installation medium fails to visualize error in the test module and not just put this information in the autoinst log file. | |
| CLUSTER_TYPES | string | false | Set the type of cluster that have to be analyzed (example: "drbd hana"). This variable belongs to PUBLIC_CLOUD_. |
| CONTAINER_RUNTIMES | string | Container runtime to be used, e.g. docker, podman, or both podman,docker. In addition, it is also used for other container tests, like kubectl, helm, etc. |
|
| CONTAINERS_CGROUP_VERSION | string | If defined, cgroups version to switch to | |
| CONTAINERS_K3S_VERSION | string | If defined, install the provided version of k3s | |
| CONTAINERS_NO_SUSE_OS | boolean | false | Used by main_containers to see if the host is different than SLE or openSUSE. |
| CONTAINERS_UNTESTED_IMAGES | boolean | false | Whether to use untested_images or released_images from lib/containers/urls.pm. |
| CONTAINERS_CRICTL_VERSION | string | v1.23.0 | The version of CriCtl tool. |
| CONTAINERS_NERDCTL_VERSION | string | 0.16.1 | The version of NerdCTL tool. |
| CPU_BUGS | boolean | Into Mitigations testing | |
| DESKTOP | string | Indicates expected DM, e.g. gnome, kde, textmode, xfce, lxde. Does NOT prescribe installation mode. Installation is controlled by VIDEOMODE setting |
|
| DEPENDENCY_RESOLVER_FLAG | boolean | false | Control whether the resolve_dependecy_issues will be scheduled or not before certain modules which need it. |
| DEV_IMAGE | boolean | false | This setting is used to set variables properly when SDK or Development-Tools are required. |
| DISABLE_ONLINE_REPOS | boolean | false | Enables installation/disable_online_repos test module, relevant for openSUSE only. Test module explicitly disables online repos not to be used during installation. |
| DISABLE_SECUREBOOT | boolean | false | Disable secureboot in firmware of the SUT or in hypervisor's guest VM settings |
| DISABLE_SLE_UPDATES | boolean | false | Disables online updates for the installation. |
| DISTRI | string | Defines distribution. Possible values: sle, opensuse, microos. |
|
| DOCRUN | boolean | false | |
| DUALBOOT | boolean | false | Enables dual boot configuration during the installation. |
| DUD | string | Defines url or relative path to the DUD file if in data directory of os-autoinst-distri-opensuse repo | |
| DUD_ADDONS | string | Comma separated list of addons added using DUD. | |
| DVD | |||
| ENCRYPT | boolean | false | Enables or indicates encryption of the disks. Can be combined with FULL_LVM_ENCRYPT, ENCRYPT_CANCEL_EXISTING, ENCRYPT_ACTIVATE_EXISTING and UNENCRYPTED_BOOT. |
| ENCRYPT_CANCEL_EXISTING | boolean | false | Used to cancel activation of the encrypted partitions |
| SOFTLOCKUP_PANIC_DISABLED | boolean | false | Disables panicking on softlockup, provides a stack trace once a softlockup has been detected (see POO#50345) |
| ETC_PASSWD | string | Sets content for /etc/passwd, can be used to mimic existing users. Is used to test import of existing users on backends which have no shapshoting support (powerVM, zVM). Should be used together with ENCRYPT_ACTIVATE_EXISTING and ETC_SHADOW. |
|
| ETC_SHADOW | string | Sets content for /etc/shadow, can be used to mimic existing users. Is used to test import of existing users on backends which have no shapshoting support (powerVM, zVM). Should be used together with ENCRYPT_ACTIVATE_EXISTING and ETC_PASSWD. |
|
| EVERGREEN | |||
| EXIT_AFTER_START_INSTALL | boolean | false | Indicates that test suite will be finished after installation/start_install test module. So that all the test modules after this one will not be scheduled and executed. |
| EXPECTED_INSTALL_HOSTNAME | string | Contains expected hostname YaST installer got from the environment (DHCP, 'hostname=', as a kernel cmd line argument) | |
| EXTRABOOTPARAMS | string | Concatenates content of the string as boot options applied to the installation bootloader. | |
| EXTRABOOTPARAMS_BOOT_LOCAL | string | Boot options applied during the boot process of a local installation. | |
| EXTRABOOTPARAMS_LINE_OFFSET | integer | Line offset for linux line in grub when EXTRABOOTPARAMS_BOOT_LOCAL is used. |
|
| EXTRABOOTPARAMS_DELETE_CHARACTERS | string | Characters to delete from boot prompt. | |
| EXTRABOOTPARAMS_DELETE_NEEDLE_TARGET | string | If specified, go back with the cursor until this needle is matched to delete characters from there. Needs EXTRABOOTPARAMS_BOOT_LOCAL and should be combined with EXTRABOOTPARAMS_DELETE_CHARACTERS. | |
| EXTRATEST | boolean | false | Enables execution of extra tests, see load_extra_tests |
| FIRST_BOOT_CONFIG | string | combustion+ignition | The method used for initial configuration of MicroOS images. Possible values are: combustion, ignition, combustion+ignition and wizard. For ignition/combustion, the job needs to have a matching HDD attached. |
| FLAVOR | string | Defines flavor of the product under test, e.g. staging-.-DVD, Krypton, Argon, Gnome-Live, DVD, Rescue-CD, etc. |
|
| FULLURL | string | Full url to the factory repo. Is relevant for openSUSE only. | |
| FULL_LVM_ENCRYPT | boolean | false | Enables/indicates encryption using lvm. boot partition may or not be encrypted, depending on the product default behavior. |
| FUNCTION | string | Specifies SUT's role for MM test suites. E.g. Used to determine which SUT acts as target/server and initiator/client for iscsi test suite | |
| GNU_COMPILERS_HPC_VERSION | string | Define the gnu-N-compilers-hpc version to be tested. | |
| GRUB_PARAM | string | A semicolon-separated list of extra boot options. Adds 2 grub meny entries per each item in main grub (2nd entry is the "Advanced options ..." submenu). See add_custom_grub_entries(). |
|
| GRUB_BOOT_NONDEFAULT | boolean | false | Boot grub menu entry added by add_custom_grub_entries (having setup GRUB_PARAM=debug_pagealloc=on;ima_policy=tcb;slub_debug=FZPU, GRUB_BOOT_NONDEFAULT=1 selects 3rd entry, which contains debug_pagealloc=on, GRUB_BOOT_NONDEFAULT=2 selects 5th entry, which contains ima_policy=tcb). NOTE: ARCH=s390x on BACKEND=s390x is not supported. See boot_grub_item(), handle_grub(). |
| GRUB_SELECT_FIRST_MENU | integer | Select grub menu entry in main grub menu, used together with GRUB_SELECT_SECOND_MENU. GRUB_BOOT_NONDEFAULT has higher preference when both set. NOTE: ARCH=s390x on BACKEND=s390x is not supported. See boot_grub_item(), handle_grub(). |
|
| GRUB_SELECT_SECOND_MENU | integer | Select grub menu entry in secondary grub menu (the "Advanced options ..." submenu), used together with GRUB_SELECT_FIRST_MENU. GRUB_BOOT_NONDEFAULT has higher preference when both set. NOTE: ARCH=s390x on BACKEND=s390x is not supported. See boot_grub_item(), handle_grub(). |
|
| HASLICENSE | boolean | true if SLE, false otherwise | Enables processing and validation of the license agreements. |
| HDDVERSION | string | Indicates version of the system installed on the HDD. | |
| HTTPPROXY | |||
| HPC_WAREWULF_CONTAINER | string | Set the container meant for warewulf test suite. | |
| HPC_WAREWULF_CONTAINER_NAME | string | The OS name which is expected to run from HPC_WAREWULF_CONTAINER. | |
| HPC_WAREWULF_CONTAINER_USERNAME | string | Defining username enables authentication for containers, needs valid HPC subscription on SCC for containers from registry.suse.com. If you want use default HPC subscription, just set same value as in SCC_EMAIL | |
| _SECRET_HPC_WAREWULF_CONTAINER_PASSWORD | string | Password for container, needs valid HPC subscription on SCC for containers from registry.suse.com. If not specified it will use code from SCC_REGCODE_HPC | |
| INSTALL_KEYBOARD_LAYOUT | string | Specify one of the supported keyboard layout to switch to during installation or to be used in autoyast scenarios e.g.: cz, fr | |
| INSTALL_SOURCE | string | Specify network protocol to be used as installation source e.g. MIRROR_HTTP | |
| INSTALLATION_VALIDATION | string | Comma separated list of modules to be used for installed system validation, should be used in combination with INSTALLONLY, to schedule only relevant test modules. | |
| INSTALLONLY | boolean | false | Indicates that test suite conducts only installation. Is recommended to be used for all jobs which create and publish images |
| INSTLANG | string | en_US | Installation locale settings. |
| IPERF_REPO | string | Link to repository with iperf tool for network performance testing. Currently used in Public Cloud Azure test | |
| IPXE | boolean | false | Indicates ipxe boot. |
| IPXE_BOOT_FIXED | boolean | false | Indicates to ipxe boot fixed distribution independent on DISTRI and VERSION variables. |
| IPXE_BOOT_FIXED_DISTRI | string | sle | Sets distribution name for fixed ipxe boot. |
| IPXE_BOOT_FIXED_VERSION | string | 15-SP6 | Sets distribution version for fixed ipxe boot. |
| IPXE_SET_HDD_BOOTSCRIPT | boolean | false | Upload second IPXE boot script for booting from HDD after the installation boot script gets executed. This is a workaround for cases where the installer fails to switch default boot order to HDD boot. See also PXE_BOOT_TIME. |
| ISO_MAXSIZE | integer | Max size of the iso, used in installation/isosize.pm. |
|
| IS_MM_SERVER | boolean | If set, run server-specific part of the multimachine job | |
| IS_MM_CLIENT | boolean | If set, run client-specific part of the multimachine job | |
| K3S_SYMLINK | string | Can be 'skip' or 'force'. Skips the installation of k3s symlinks to tools like kubectl or forces the creation of symlinks | |
| K3S_BIN_DIR | string | If defined, install k3s to this provided directory instead of /usr/local/bin/ |
|
| K3S_CHANNEL | string | Set the release channel to pick the k3s version from. Options include "stable", "latest" and "testing" | |
| KERNEL_FLAVOR | string | kernel-default | Set specific kernel flavor for test scenarios |
| KUBECTL_CLUSTER | string | Defines the cluster used to test kubectl. Currently only k3s is supported. |
|
| KUBECTL_VERSION | string | v1.22.12 | Defines the kubectl version. |
| KEEP_DISKS | boolean | false | Prevents disks wiping for remote backends without snapshots support, e.g. ipmi, powerVM, zVM |
| KEEP_ONLINE_REPOS | boolean | false | openSUSE specific variable, not to replace original repos in the installed system with snapshot mirrors which are not yet published. |
| KEEP_PERSISTENT_NET_RULES | boolean | false | Keep udev rules 70-persistent-net.rules, which are deleted on backends with image support (qemu, svirt) by default. |
| LAPTOP | |||
| LIBC_LIVEPATCH | boolean | false | If set, run userspace livepatching tests |
| PATCH_BEFORE_MIGRATION | boolean | false | If set, patch the system before migration/upgrade |
| LINUX_BOOT_IPV6_DISABLE | boolean | false | If set, boots linux kernel with option named "ipv6.disable=1" which disables IPv6 from startup. |
| LINUXRC_KEXEC | integer | linuxrc has the capability to download and run a new kernel and initrd pair from the repository. There are four settings for the kexec option: 0: feature disabled; 1: always restart with kernel/initrd from repository (without bothering to check if it's necessary); 2: restart only if needed - that is, if linuxrc detects that the booted initrd is outdated (this is the default); 3: like kexec=2 but without user interaction. More details here. |
|
| LIVECD | boolean | false | Indicates live image being used. |
| LIVE_INSTALLATION | boolean | false | If set, boots the live media and starts the builtin NET installer. |
| LIVE_UPGRADE | boolean | false | If set, boots the live media and starts the builtin NET installer in upgrade mode. |
| LIVETEST | boolean | false | Indicates test of live system. |
| LTP_COMMAND_FILE | string | The LTP test command file (e.g. syscalls, cve) | |
| LTP_COMMAND_EXCLUDE | string | This regex is used to exclude tests from LTP command file. | |
| LTP_KNOWN_ISSUES | string | Used to specify a url for a json file with well known LTP issues. If an error occur which is listed, then the result is overwritten with softfailure. | |
| LTP_REPO | string | The repo which will be added and is used to install LTP package. | |
| LTP_RUN_NG_BRANCH | string | master | Define the branch of the LTP_RUN_NG_REPO. |
| LTP_RUN_NG_REPO | string | https://github.com/metan-ucw/runltp-ng.git | Define the runltp-ng repo to be used. Default in publiccloud/run_ltp.pm is the upstream master branch from https://github.com/metan-ucw/runltp-ng.git. |
| LTP_PC_RUNLTP_ENV | string | empty | Contains eventual internal environment new parameters for runltp-ng, defined with the --env option, initialized in a column-separated string format: "PAR1=xxx:PAR2=yyy:...". By default it is empty, undefined. |
| LTP_TAINT_EXPECTED | integer | 0x80019801 | Bitmask of expected kernel taint flags. |
| LVM | boolean | false | Use lvm for partitioning. |
| LVM_THIN_LV | boolean | false | Use thin provisioning logical volumes for partitioning, |
| MACHINE | string | Define machine name which defines worker specific configuration, including WORKER_CLASS. | |
| MEDIACHECK | boolean | false | Enables installation/mediacheck test module. |
| MEMTEST | boolean | false | Enables installation/memtest test module. |
| MICRO_INSTALL_IMAGE_TARGET_DEVICE | string | /dev/sda | Target disk device for bare metal SL Micro installation. |
| MIRROR_{protocol} | string | Specify source address | |
| MM_MTU | integer | 1380 | Specifies the MTU to set in SUTs of MM tests usually started with NICTYPE=tap. |
| MOK_VERBOSITY | boolean | false | Enable verbosity feature of shim. Requires preinstalled mokutil. |
| MOZILLATEST | |||
| MOZILLA_NSS_DEVEL_REPO | string | URL of the repository where to install the mozilla-nss packages from. | |
| MU_REPOS_NO_GPG_CHECK | boolean | false | Use -G option in zypper when adding the repositores from OS_TEST_REPOS variable |
| NAME | string | Name of the test run including distribution, build, machine name and job id. | |
| NAMESERVER | string | Can be used to specify a name server's IP or FQDN. | |
| NET | boolean | false | Indicates net installation. |
| NETBOOT | boolean | false | Indicates net boot. |
| NETDEV | string | Network device to be used when adding interface on zKVM. | |
| NFSCLIENT | boolean | false | Indicates/enables nfs client in console/yast2_nfs_client for multi-machine test. |
| NFSSERVER | boolean | false | Indicates/enables nfs server in console/yast2_nfs_server. |
| NICEVIDEO | |||
| NICTYPE_USER_OPTIONS | string | hostname=myguest causes a fake DHCP hostname 'myguest' provided to SUT. It is used as expected hostname if EXPECTED_INSTALL_HOSTNAME is not set. |
|
| NO_ADD_MAINT_TEST_REPOS | boolean | true | Do not add again (and duplicate) repositories that were already added during install |
| NOAUTOLOGIN | boolean | false | Indicates disabled auto login. |
| NOIMAGES | |||
| NOLOGS | boolean | false | Do not collect logs if set to true. Handy during development. |
| NVIDIA_REPO | string | '' | Define the external repo for nvidia driver. Used by nvidia.pm module. |
| OPENSHIFT_CONFIG_REPO | string | '' | Git repo of the OpenShift configuration and packages needed by tests/containers/openshift_setup.pm. |
| OPT_KERNEL_PARAMS | string | Specify optional kernel command line parameters on bootloader settings page of the installer. | |
| PHUB_READY | boolean | true | Indicates PackageHub is available, it may be not ready in early development phase[Before Beta]. |
| PERF_KERNEL | boolean | false | Enables kernel performance testing. |
| PERF_INSTALL | boolean | false | Enables kernel performance testing installation part. |
| PERF_SETUP | boolean | false | Enables kernel performance testing deployment part. |
| PERF_RUNCASE | boolean | false | Enables kernel performance testing run case part. |
| RMT_SERVER | string | Local server to be used in RMT registration. | |
| SALT_FORMULAS_PATH | string | Used to point to a tarball with relative path to /data/yast2 which contains all the needed files (top.sls, form.yml, ...) to support provisioning with Salt masterless mode. | |
| PKGMGR_ACTION_AT_EXIT | string | "" | Set the default behavior of the package manager when package installation has finished. Possible actions are: close, restart, summary. If PKGMGR_ACTION_AT_EXIT is not set in openQA, test module will read the default value from /etc/sysconfig/yast2. |
| PXE_PRODUCT_NAME | string | false | Defines image name for PXE booting |
| PXE_BOOT_TIME | integer | 120 | Approximate time that IPMI worker needs to load and execute PXE boot payload. Should be set in the IPMI worker configuration. |
| QA_TESTSUITE | string | Comma or semicolon separated a list of the automation cases' name, and these cases will be installed and triggered if you call "start_testrun" function from qa_run.pm | |
| QAM_MINIMAL | string | "full" or "small" | Full is adding patterns x11, gnome-basic, base, apparmor in minimal/install_patterns test. Small is just base. |
| RAIDLEVEL | integer | Define raid level to be configured. Possible values: 0,1,5,6,10. | |
| REBOOT_TIMEOUT | integer | 0 | Set and handle reboot timeout available in YaST installer. 0 disables the timeout and needs explicit reboot confirmation. |
| REGISTRY | string | docker.io | Registry to pull third-party container images from |
| CONTAINER_IMAGE_VERSIONS | string | List of comma-separated versions from get_suse_container_urls() |
|
| CONTAINER_IMAGE_TO_TEST | string | Single URL string of a specific container image to test. | |
| REGRESSION | string | Define scope of regression testing, including ibus, gnome, documentation and other. | |
| REMOTE_REPOINST | boolean | Use linuxrc features to install OS from specified repository (install) while booting installer from DVD (instsys) | |
| REPO_* | string | Url pointing to the mirrored repo. REPO_0 contains installation iso. | |
| RESCUECD | boolean | false | Indicates rescue image to be used. |
| RESCUESYSTEM | boolean | false | Indicates rescue system under test. |
| ROOTONLY | boolean | false | Request installation to create only the root account, no user account. |
| RESET_HOSTNAME | boolean | false | If set to true content of /etc/hostname file will be erased |
| SCC_DEBUG_SUSECONNECT | boolean | false | Set to pass debug flag to SUSEConnect |
| SCC_ADDONS | string | Comma separated list of modules to be enabled using SCC/RMT. | |
| SCC_DOCKER_IMAGE | string | The content of /etc/zypp/credentials.d/SCCcredentials used by container-suseconnect-zypp zypper service in SLE base container images | |
| SELECT_FIRST_DISK | boolean | false | Enables test module to select first disk for the installation. Is used for baremetal machine tests with multiple disks available, including cases when server still has previous installation. |
| ENABLE_SELINUX | boolean | false | Explicitly enable SELinux in transactional server environments. |
| SEPARATE_HOME | three-state | undef | Used for scheduling the test module where separate /home partition should be explicitly enabled (if 1 is set) or disabled (if 0 is set). If not specified, the test module is skipped. |
| SES5_CEPH_QA_HEALTH_OK | string | URL for repo containing ceph-qa-health-ok package. | |
| SKIP_CERT_VALIDATION | boolean | false | Enables linuxrc parameter to skip certificate validation of the remote source, e.g. when using self-signed https url. |
| SET_CUSTOM_PROMPT | boolean | false | Set a custom, shorter prompt in shells. Saves screen space but can take time to set repeatedly in all shell sessions. |
| SLE_PRODUCT | string | Defines SLE product. Possible values: sles, sled, sles4sap. Is mainly used for SLE 15 installation flow. |
|
| SLURM_VERSION | string | Defines slurm version (ex: 23_02) for installation. If not set, installation uses the base Slurm version. | |
| SOFTFAIL_BSC1063638 | boolean | false | Enable bsc#1063638 detection. |
| STAGING | boolean | false | Indicates staging environment. |
| SPECIFIC_DISK | boolean | false | Enables installation/partitioning_olddisk test module. |
| SPLITUSR | boolean | false | Enables installation/partitioning_splitusr test module. |
| SUSEMIRROR | string | Mirror url of the installation medium. | |
| SYSAUTHTEST | boolean | false | Enable system authentication test (sysauth/sssd) |
| SYSCTL_IPV6_DISABLED | boolean | undef | Set automatically in samba_adcli tests when ipv6 is disabled |
| SYSTEMD_NSPAWN | boolean | 1 | Run systemd upstream tests in nspawn container rather than qemu |
| SYSTEMD_TESTSUITE | boolean | undef | Enable schedule of systemd upstream tests |
| SYSTEMD_UNIFIED_CGROUP | string | "yes", "no", "hybrid", "default" | systemd currently supports 3 (unified,legacy,hybrid) cgroups configurations |
| TEST | string | Name of the test suite. | |
| TEST_CONTEXT | string | Defines the class name to be used as the context instance of the test. This is used in the scheduler to pass the run_args into the loadtest function. If it is not given it will be undef. |
|
| TEST_TIME | integer | Set time parameter for iperf -t N option. Used in Azure Public Cloud testing of Accelerated NICs |
|
| TOGGLEHOME | boolean | false | Changes the state of partitioning to have or not to have separate home partition in the proposal. |
| TUNNELED | boolean | false | Enables the use of normal consoles like "root-consoles" on a remote SUT while configuring the tunnel in a local "tunnel-console" |
| TYPE_BOOT_PARAMS_FAST | boolean | false | When set, forces bootloader_setup::type_boot_parameters to use the default typing interval. |
| UEFI | boolean | false | Indicates UEFI in the testing environment. |
| ULP_THREAD_COUNT | integer | 1000 | Number of threads to create in ulp_threads test module. |
| ULP_THREAD_SLEEP | integer | 100 | Sleep length after each thread loop iteration in ulp_threads module. High thread-to-CPU ratio needs longer sleep length. |
| UPGRADE | boolean | false | Indicates upgrade scenario. |
| USBBOOT | boolean | false | Indicates booting to the usb device. |
| USEIMAGES | |||
| VALIDATE_ETC_HOSTS | boolean | false | Validate changes in /etc/hosts when using YaST network module. Is used in yast2_lan and yast2_lan_restart test modules which test module in ncurses and x11 respectively. |
| VALIDATE_INST_SRC | boolean | false | Validate installation source in /etc/install.inf |
| VALIDATE_CHECKSUM | boolean | false | Validate checksum of the mediums. Also see CHECKSUM_*. |
| VERSION | string | Contains major version of the product. E.g. 15-SP1 or 15.1 | |
| VIDEOMODE | string | Indicates/defines video mode used for the installation. Empty value uses default, other possible values text, ssh-x for installation ncurses and x11 over ssh respectivelyю |
|
| VIRSH_OPENQA_BASEDIR | string | /var/lib | The OPENQA_BASEDIR configured on the svirt host (only relevant for the svirt backend). |
| UNENCRYPTED_BOOT | boolean | false | Indicates/defines existence of unencrypted boot partition in the SUT. |
| WAYLAND | boolean | false | Enables wayland tests in the system. |
| WIZARD_SKIP_USER | boolean | false | Skip non-root user creation in jeos-firstboot. This feature was added from sle-micro 6.1 |
| XDMUSED | boolean | false | Indicates availability of xdm. |
| XFS_MKFS_OPTIONS | string | Define additional mkfs parameters. Used only in publiccloud test runs. | |
| XFS_TEST_DEVICE | string | Define the device used for xfs tests. Used only in publiccloud test runs. | |
| XFS_TESTS_REFLINK | boolean | false | If set to true, the mkfsoption for using reflink will be added. Used only in publiccloud test runs. |
| XFSTESTS_OVERLAY_BASE_FS | string | xfs | Define the base filesystem type of overlayfs |
| YAML_SCHEDULE_DEFAULT | string | Defines default yaml file to be overridden by test suite schedule. | |
| YAML_SCHEDULE_FLOWS | string | Defines a comma-separated values representing additional flows which overrides steps on the schedule specified in YAML_SCHEDULE_DEFAULT. | |
| YAML_SCHEDULE | string | Defines yaml file containing test suite schedule. | |
| YAML_TEST_DATA | string | Defines yaml file containing test data. | |
| YUI_LOG_LEVEL | string | debug | Allows changing log level for YuiRestClient::Logger. Available options are: debug, info, warning, error, fatal. |
| YUI_PORT | integer | Port being used for libyui REST API. See also YUI_SERVER and YUI_START_PORT. | |
| YUI_SERVER | string | libyui REST API server name or ip address. | |
| YUI_START_PORT | integer | 39000 | Sets starting port for the libyui REST API, on qemu VNC port is then added to this port not to have conflicts. |
| YUI_REST_API | boolean | false | Is used to setup environment for libyui REST API, as some parameters have to be set before the VM is started. |
| YUI_PARAMS | string | libyui REST API params required to open YaST modules | |
| YUPDATE_GIT | string | Github link used by yast help script yupdate, format is repo#branch such as yast/agama#main. | |
| TDUP | boolean | false | Prescribes zypper dup scenario (for transaction-update). |
| ZDUP | boolean | false | Prescribes zypper dup scenario. |
| ZDUP_IN_X | boolean | false | Prescribes zypper dup scenario, run in a graphical session. |
| ZDUPREPOS | string | Comma separated list of repositories to be added/used for zypper dup call, defaults to SUSEMIRROR or attached media, e.g. ISO. | |
| ZFCP_ADAPTERS | string | Comma separated list of available ZFCP adapters in the machine (usually 0.0.fa00 and/or 0.0.fc00) | |
| LINUXRC_BOOT | boolean | true | To be used only in scenarios where we are booting an installed system from the installer medium (for example, a DVD) with the menu option "Boot Linux System" (not "boot From Hard Disk"). This option uses linuxrc. |
| ZYPPER_WHITELISTED_ORPHANS | string | empty | Whitelist expected orphaned packages, do not fail if any are found. Upgrade scenarios are expecting orphans by default. Used by console/orphaned_packages_check.pm |
| PUBLIC_CLOUD_CONTAINER_IMAGES_REPO | string | The Container images repository in CSP | |
| PREPARE_TEST_DATA_TIMEOUT | integer | 300 | Download assets in the prepare_test_data module timeout |
| ZFS_REPOSITORY | string | Optional repository used to test zfs from | |
| TRENTO_HELM_VERSION | string | 3.8.2 | Helm version of the JumpHost |
| TRENTO_CYPRESS_VERSION | string | 9.6.1 | used as tag for the docker.io/cypress/included registry. |
| TRENTO_VM_IMAGE | string | SUSE:sles-sap-15-sp3-byos:gen2:latest | used as --image parameter during the Azure VM creation |
| TRENTO_VERSION | string | (implicit 1.0.0) | Optional. Used as reference version string for the installed Trento |
| TRENTO_REGISTRY_CHART | string | registry.suse.com/trento/trento-server | Helm chart registry |
| TRENTO_REGISTRY_CHART_VERSION | string | Optional. Tag for the chart image | |
| TRENTO_REGISTRY_IMAGE_RUNNER | string | Optional. Overwrite the trento-runner image in the helm chart | |
| TRENTO_REGISTRY_IMAGE_RUNNER_VERSION | string | Optional. Version tag for the trento-runner image | |
| TRENTO_REGISTRY_IMAGE_WANDA | string | Optional. Overwrite the trento-wanda image in the helm chart | |
| TRENTO_REGISTRY_IMAGE_WANDA_VERSION | string | Optional. Version tag for the trento-wand image | |
| TRENTO_REGISTRY_IMAGE_WEB | string | Optional. Overwrite the trento-web image in the helm chart | |
| TRENTO_REGISTRY_IMAGE_WEB_VERSION | string | Optional. Version tag for the trento-web image | |
| TRENTO_GITLAB_REPO | string | gitlab.suse.de/qa-css/trento | Repository for the deployment scripts |
| TRENTO_GITLAB_BRANCH | string | master | Branch to use in the deployment script repository |
| TRENTO_GITLAB_TOKEN | string | from SECRET_TRENTO_GITLAB_TOKEN | Force the use of a custom token |
| TRENTO_DEPLOY_VER | string | Force the Trento deployment script to be used from a release | |
| TRENTO_AGENT_REPO | string | https://dist.suse.de/ibs/Devel:/SAP:/trento:/factory/SLE_15_SP3/x86_64 | Repository where to get the trento-agent installer |
| TRENTO_AGENT_RPM | string | Trento-agent rpm file name | |
| TRENTO_EXT_DEPLOY_IP | string | Public IP of a Trento web instance not deployed by openQA | |
| TRENTO_WEB_PASSWORD | string | Trento web password for the admin user. If not provided, random generated one. | |
| TRENTO_QESAPDEPLOY_CLUSTER_OS_VER | string | OS for nodes in SAP cluster. | |
| TRENTO_QESAPDEPLOY_HANA_ACCOUNT | string | Azure blob server account for the SAP installers for the qe-sap-deployment hana_media.yaml. | |
| TRENTO_QESAPDEPLOY_HANA_CONTAINER | string | Azure blob server container for the qe-sap-deployment hana_media.yaml. | |
| TRENTO_QESAPDEPLOY_HANA_KEYNAME | string | Azure blob server key name used to generate the SAS URI token for the qe-sap-deployment hana_media.yaml. | |
| TRENTO_QESAPDEPLOY_SAPCAR | string | SAPCAR file name for the qe-sap-deployment hana_media.yaml. | |
| TRENTO_QESAPDEPLOY_IMDB_SERVER | string | IMDB_SERVER file name for the qe-sap-deployment hana_media.yaml. | |
| TRENTO_QESAPDEPLOY_IMDB_CLIENT | string | IMDB_CLIENT file name for the qe-sap-deployment hana_media.yaml. | |
| QESAP_CONFIG_FILE | string | filename (of relative path) of the config YAML file for the qesap.py script, within sles4sap/qe_sap_deployment/ subfolder in data. |
|
| QESAP_DEPLOYMENT_DIR | string | /root/qe-sap-deployment | JumpHost folder where to install the qe-sap-deployment code |
| QESAP_ROLES_DIR | string | /root/community.sles-for-sap | JumpHost folder where to install the community.sles-for-sap code |
| QESAP_INSTALL_VERSION | string | If configured, test will run with a specific release of qe-sap-deployment code from https://github.com/SUSE/qe-sap-deployment/releases. Otherwise the code is used from a latest version controlled by QESAP_INSTALL_GITHUB_REPO and QESAP_INSTALL_GITHUB_BRANCH | |
| QESAP_INSTALL_GITHUB_REPO | string | github.com/SUSE/qe-sap-deployment | Git repository where to clone from. Ignored if QESAP_INSTALL_VERSION is configured. |
| QESAP_INSTALL_GITHUB_BRANCH | string | Git branch. Ignored if QESAP_INSTALL_VERSION is configured. | |
| QESAP_INSTALL_GITHUB_NO_VERIFY | string | Configure http.sslVerify false. Ignored if QESAP_VER is configured. | |
| QESAP_ROLES_INSTALL_GITHUB_REPO | string | github.com/sap-linuxlab/community.sles-for-sap | Git repository where to clone from. Ignored if QESAP_ROLES_INSTALL_VERSION is configured. |
| QESAP_ROLES_INSTALL_GITHUB_BRANCH | string | Git branch. Ignored if QESAP_ROLES_INSTALL_VERSION is configured. | |
| SMELT_URL | string | https://smelt.suse.de | Defines the URL for the SUSE Maintenance Extensible Lightweight Toolset, SMELT for short. |
The following variables are relevant for publiccloud related jobs. Keep in mind that variables that start with _SECRET are secret variables, accessible only to the job but hidden in the webui. They will be not present in cloned jobs outside the original instance.
| Variable | Type | Default value | Details |
|---|---|---|---|
| PUBLIC_CLOUD | boolean | false | All Public Cloud tests have this variable set to true. Contact: qa-c@suse.de |
| PUBLIC_CLOUD_ACCOUNT | string | "" | For GCE will set account via gcloud config set account ' . $self->account. |
| PUBLIC_CLOUD_ACCNET | boolean | false | If set, az_accelerated_net test module is added to the job. |
| PUBLIC_CLOUD_AHB_LT | string | "SLES_BYOS" | For Azure, it specifies the license type to change to (and test). |
| PUBLIC_CLOUD_AZ_API | string | "http://169.254.169.254/metadata/instance/compute" | For Azure, it is the metadata API endpoint. |
| PUBLIC_CLOUD_AZ_API_VERSION | string | "2021-02-01" | For Azure, it is the API version used whe querying metadata API. |
| PUBLIC_CLOUD_HDD2_SIZE | integer | "" | If set, the instance will have an additional disk with the given capacity in GB |
| PUBLIC_CLOUD_HDD2_TYPE | string | "" | If PUBLIC_CLOUD_ADDITIONAL_DISK_SIZE is set, this defines the additional disk type (optional). The required value depends on the cloud service provider. |
| PUBLIC_CLOUD_ARCH | string | "x86_64" | The architecture of created VM. |
| PUBLIC_CLOUD_AZURE_PUBLISHER | string | "SUSE" | Specific to Azure. Allows to define the used publisher, if it should not be "SUSE" |
| PUBLIC_CLOUD_AZURE_OFFER | string | "" | Specific to Azure. Allow to query for image based on offer and sku. Should be used together with PUBLIC_CLOUD_AZURE_SKU. |
| PUBLIC_CLOUD_AZURE_SKU | string | "" | Specific to Azure. |
| PUBLIC_CLOUD_BUILD | string | "" | The image build number. Used only when we use custom built image. |
| PUBLIC_CLOUD_BUILD_KIWI | string | "" | The image kiwi build number. Used only when we use custom built image. |
| PUBLIC_CLOUD_CONFIDENTIAL_VM | boolean | false | GCE Confidential VM instance |
| PUBLIC_CLOUD_UPLOAD_IMG | boolean | false | If set, publiccloud/upload_image test module is added to the job. |
| PUBLIC_CLOUD_KEEP_IMG | boolean | false | If set, the uploaded image will be tagged with pcw_ignore=1 |
| PUBLIC_CLOUD_REGISTRATION_TESTS | boolean | false | If set, only the registration tests are added to the job. |
| PUBLIC_CLOUD_CONSOLE_TESTS | boolean | false | If set, console tests are added to the job. |
| PUBLIC_CLOUD_CONTAINERS | boolean | false | If set, containers tests are added to the job. |
| PUBLIC_CLOUD_DOWNLOAD_TESTREPO | boolean | false | If set, it schedules publiccloud/download_repos job. |
| PUBLIC_CLOUD_TOOLS_CLI | boolean | false | If set, it schedules publiccloud_tools_cli job group. |
| PUBLIC_CLOUD_EC2_UPLOAD_AMI | string | "" | Needed to decide which image will be used for helper VM for upload some image. When not specified some predefined value will be used. Overwrite the value for ec2uploadimg --ec2-ami. |
| PUBLIC_CLOUD_EC2_UPLOAD_SECGROUP | string | "" | Allow to instruct ec2uploadimg script to use some existing security group instead of creating new one. If given, the parameter --security-group-ids is passed to ec2uploadimg. |
| PUBLIC_CLOUD_EC2_UPLOAD_VPCSUBNET | string | "" | Allow to instruct ec2uploadimg script to use some existing VPC instead of creating new one. |
| PUBLIC_CLOUD_EC2_BOOT_MODE | string | "uefi-preferred" | The --boot-mode parameter for ec2uploadimg script. Available values: legacy-bios, uefi, uefi-preferred Currently unused variable. Use git blame to get context. |
| PUBLIC_CLOUD_EC2_IPV6_ADDRESS_COUNT | string | 0 | How many IPv6 addresses should the instance have |
| PUBLIC_CLOUD_GCE_STACK_TYPE | string | IPV4_ONLY | Network stack type, possible values: IPV4_IPV6 or IPV4_ONLY |
| PUBLIC_CLOUD_FIO | boolean | false | If set, storage_perf test module is added to the job. |
| PUBLIC_CLOUD_FIO_RUNTIME | integer | 300 | Set the execution time for each FIO tests. |
| PUBLIC_CLOUD_FIO_SSD_SIZE | string | "100G" | Set the additional disk size for the FIO tests. |
| PUBLIC_CLOUD_CLOUD_INIT | boolean | false | If this is true custom cloud-config will be attached to the instance. |
| PUBLIC_CLOUD_FORCE_REGISTRATION | boolean | false | If set, tests/publiccloud/registration.pm will register cloud guest |
| PUBLIC_CLOUD_IGNORE_EMPTY_REPO | boolean | false | Ignore empty maintenance update repos |
| PUBLIC_CLOUD_IMAGE_ID | string | "" | The image ID we start the instance from |
| PUBLIC_CLOUD_IMAGE_URI | string | "" | The URI of the image to be used. Use 'auto' if you want the URI to be calculated. |
| PUBLIC_CLOUD_IMAGE_LOCATION | string | "" | The URL where the image gets downloaded from. The name of the image gets extracted from this URL. |
| PUBLIC_CLOUD_IMAGE_PROJECT | string | "" | Google Compute Engine image project |
| PUBLIC_CLOUD_AZURE_IMAGE_DEFINITION | string | "" | Defines the image definition for uploading Arm64 images to the image gallery. |
| PUBLIC_CLOUD_IMG_PROOF_TESTS | string | "test-sles" | Tests run by img-proof. |
| PUBLIC_CLOUD_IMG_PROOF_EXCLUDE | string | "" | Tests to be excluded by img-proof. |
| PUBLIC_CLOUD_INSTANCE_TYPE | string | "" | Specify the instance type. Which instance types exists depends on the CSP. (default-azure: Standard_A2, default-ec2: t2.large ) |
| PUBLIC_CLOUD_LTP | boolean | false | If set, the run_ltp test module is added to the job. |
| PUBLIC_CLOUD_NEW_INSTANCE_TYPE | string | "t2.large" | Specify the new instance type to check bsc#1205002 in EC2 |
| PUBLIC_CLOUD_NO_CLEANUP_ON_FAILURE | boolean | false | Do not remove the instance when the test fails. |
| PUBLIC_CLOUD_PERF_COLLECT | boolean | 1 | To enable boottime measures collection, at end of create_instance routine. |
| PUBLIC_CLOUD_PERF_DB_URI | string | "http://publiccloud-ng.qe.suse.de:8086" | bootup time measures get pushed to this Influx database url. |
| PUBLIC_CLOUD_PERF_DB | string | "perf_2" | defines the bucket in which the performance metrics are stored on PUBLIC_CLOUD_PERF_DB_URI |
| PUBLIC_CLOUD_PERF_DB_ORG | string | "qec" | defines the organization in which the performance metrics are stored on PUBLIC_CLOUD_PERF_DB_URI |
| _SECRET_PUBLIC_CLOUD_PERF_DB_TOKEN | string | "" | this required variable is the token to access PUBLIC_CLOUD_PERF_DB_URI (defined in salt workerconf) |
| PUBLIC_CLOUD_PERF_PUSH_DATA | boolean | 1 | To enable the test to push it's metrics to the InfluxDB, when PUBLIC_CLOUD_PERF_COLLECT true. |
| PUBLIC_CLOUD_PERF_THRESH_CHECK | boolean | "" | If set to 1 or any not empty value, then the test run will also execute the thresholds check on the collected metrics. By default that check is Not executed. |
| PUBLIC_CLOUD_PREPARE_TOOLS | boolean | false | Activate prepare_tools test module by setting this variable. |
| PUBLIC_CLOUD_GOOGLE_PROJECT_ID | string | "" | GCP only, used to specify the project id. |
| PUBLIC_CLOUD_PROVIDER | string | "" | The type of the CSP (e.g. AZURE, EC2, GCE). |
| PUBLIC_CLOUD_QAM | boolean | false | 1 : to identify jobs running to test "Maintenance" updates; 0 : for jobs testing "Latest" (in development). Used to control all behavioral implications which this brings. |
| PUBLIC_CLOUD_REBOOT_TIMEOUT | integer | 600 | Number of seconds we wait for instance to reboot. |
| PUBLIC_CLOUD_REGION | string | "" | The region to use. (default-azure: westeurope, default-ec2: eu-central-1, default-gcp: europe-west1-b). In upload-img for Azure Arm64 images, multiple comma-separated regions are supported (see lib/publiccloud/azure.pm) |
| PUBLIC_CLOUD_RESOURCE_GROUP | string | "qesaposd" | Allows to specify resource group name on SLES4SAP PC tests. |
| PUBLIC_CLOUD_RESOURCE_NAME | string | "openqa-vm" | The name we use when creating our VM. |
| PUBLIC_CLOUD_SKIP_MU | boolean | false | Debug variable used to run test without maintenance updates repository being applied. |
| PUBLIC_CLOUD_REDOWNLOAD_MU | boolean | false | Debug variable used to redownload the maintenance repositories (as they might be downloaded by parent test) |
| PUBLIC_CLOUD_GOOGLE_ACCOUNT | string | "" | GCE only, used to specify the account id. |
| PUBLIC_CLOUD_TOOLS_REPO | string | false | The URL to the cloud:tools repo (optional). (e.g. http://download.opensuse.org/repositories/Cloud:/Tools/openSUSE_Tumbleweed/Cloud:Tools.repo). |
| PUBLIC_CLOUD_TTL_OFFSET | integer | 300 | This number + MAX_JOB_TIME equals the TTL of created VM. |
| PUBLIC_CLOUD_SLES4SAP | boolean | false | If set, sles4sap test module is added to the job. |
| PUBLIC_CLOUD_AZURE_SUBSCRIPTION_ID | string | "" | Used to create the service account file together with PUBLIC_CLOUD_AZURE_TENANT_ID. |
| PUBLIC_CLOUD_CONTAINER_IMAGES_REGISTRY | string | "" | Name for public cloud registry for the container images used on kubernetes tests. |
| PUBLIC_CLOUD_K8S_CLUSTER | string | "" | Name for the kubernetes cluster. |
| PUBLIC_CLOUD_AZURE_K8S_RESOURCE_GROUP | string | "" | Name for the resource group which is subscribed the kubernetes cluster. |
| PUBLIC_CLOUD_CREDENTIALS_URL | string | "" | Base URL where to get the credentials from. This will be used to compose the full URL together with PUBLIC_CLOUD_NAMESPACE. |
| PUBLIC_CLOUD_NAMESPACE | string | "" | The Public Cloud Namespace name that will be used to compose the full credentials URL together with PUBLIC_CLOUD_CREDENTIALS_URL. |
| PUBLIC_CLOUD_NVIDIA | boolean | 0 | If enabled, nvidia module would be scheduled. This variable should be enabled only sle15SP4 and above. |
| PUBLIC_CLOUD_USER | string | "" | The public cloud instance system user. |
| PUBLIC_CLOUD_XEN | boolean | false | Indicates if this is a Xen test run. |
| PUBLIC_CLOUD_STORAGE_ACCOUNT | string | "" | Storage account used e.g. for custom disk and container images |
| PUBLIC_CLOUD_TERRAFORM_FILE | string | "" | If defined, use this terraform file (from the data/ directory) instead the CSP default |
| TERRAFORM_TIMEOUT | integer | 1800 | Set timeout for terraform actions |
| PUBLIC_CLOUD_INSTANCE_IP | string | "" | If defined, no instance will be created and this IP will be used to connect to |
| _SECRET_PUBLIC_CLOUD_INSTANCE_SSH_KEY | string | "" | The ~/.ssh/id_rsa existing key allowed by PUBLIC_CLOUD_INSTANCE_IP instance |
| PUBLIC_CLOUD_TERRAFORM_DIR | string | "/root/terraform" | Override default root path to terraform directory |
| PUBLIC_CLOUD_SCC_ENDPOINT | string | "registercloudguest" | Name of binary which will be used to register image . Except default value only possible value is "SUSEConnect" anything else will lead to test failure! |
| TERRAFORM_VM_CREATE_TIMEOUT | string | "20m" | Terraform timeout for creating the virtual machine resource. |
| PUBLIC_AZURE_CLI_TEST | string | "vmss" | Azure CLI test names. This variable should list the test name which should be tested. |
| PUBLIC_CLOUD_PY_BACKPORTS_REPO | string | "" | PY Backport repo URL for azure_more_cli_test. |
| PUBLIC_CLOUD_PY_AZURE_REPO | string | "" | PY azure repo URL for azure_more_cli_test. |
| PUBLIC_CLOUD_TOOLS_REPO | string | "" | cloud tools repo URL for azure_more_cli_test. |
| PUBLIC_CLOUD_EMBARGOED_UPDATES_DETECTED | boolean | true | Internal variable written by the code and readed by the code . Should NOT be set manually |
| PUBLIC_CLOUD_INFRA | boolean | false | Would trigger special flow in check_registercloudguest.pm needed for run test against special test infra (DO NOT use the variable if you don't know what is about) |
| PUBLIC_CLOUD_INFRA_RMT_V4 | string | "" | Defines IPv4 registration server in test infra. Must be used together with PUBLIC_CLOUD_INFRA. (DO NOT use the variable if you don't know what is about) |
| PUBLIC_CLOUD_INFRA_RMT_V6 | string | "" | Defines IPv6 registration server in test infra. Must be used together with PUBLIC_CLOUD_INFRA. (DO NOT use the variable if you don't know what is about) |
| PUBLIC_CLOUD_GEN_RESOLVER | boolean | 0 | Control use of --debug-resolver option during maintenance updates testing . In case option was used also controls uploading of resolver case into the test |
| PUBLIC_CLOUD_ROOT_DISK_SIZE | int | Set size of system disk in GiB for public cloud instance. Default size is 30 for Azure and 20 for GCE and EC2 |
The following variables are relevant for the wicked testsuite
| Variable | Type | Default value | Details |
|---|---|---|---|
| WICKED_CHECK_LOG_EXCLUDE | string | @see wickedbase.pm::check_logs() | A CSV of log messages, which doesn't result in a test-module failure. The format is <wicked-binary>=<regex>. |
| WICKED_CHECK_LOG_FAIL | bool | false | If enabled, after each test-module. The journal of each wicked services is checked and the test-module fail if an unknown error was found. |
| WICKED_COMMIT_SHA | string | Can be used with WICKED_REPO. It check the given SHA against the latest changelog entry of wicked. It's used to verify that we run openqa against the version we expect. |
|
| WICKED_EXCLUDE | regex | This exclude given wicked test modules. E.g. WICKED_EXCLUDE='^(?!t01_).*$' would only run the test-module starting with t01_*. |
|
| WICKED_REPO | string | If specified, wicked get installed from this repo before testing. The url should point to the *.repo file. |
|
| WICKED_SKIP_VERSION_CHECK | bool | false | Some test-modules require a specific wicked version. If you don't want this check take place, set this variable to true. |
| WICKED_TCPDUMP | bool | false | If enabled, on each test-module the network interfaces are set into promiscuous mode and a *.pcap file will be captured and uploaded. |
| WICKED_VALGRIND | string | Enable valgind for specified wicked binaries. Multiple values should be separated by ,. If set to all or 1, valgrind is enabled for all binaries(wickedd-auto4, wickedd-dhcp6, wickedd-dhcp4, wickedd-nanny, wickedd and wicked). |
|
| WICKED_VALGRIND | string | /usr/bin/valgrind --tool=memcheck --leak-check=yes | The valgrind command used with WICKED_VALGRIND for each binary. |
Following variables are relevant for filesystem tests xfstests. Contact: kernel-qa@suse.de
Regular setting: some mandatory setting
| Variable | Type | Default value | Details |
|---|---|---|---|
| XFSTESTS_RANGES | string | sub-tests ranges. This setting is mandatory. Support using "-" to define a range, or use "," to list separate subtests(e.g. xfs/001-999,generic/001). But the final test range will also count subtests defined in XFSTESTS_GROUPLIST, a skill to set subtests only by XFSTESTS_GROUPLIST is to set a minimal XFSTESTS_RANGES with XFSTESTS_GROUPLIST | |
| NO_SHUFFLE | boolean | 0 | the default sequence to run all subtests is a random sequence, it's designed to reduce the influence between each subtest. Set NO_SHUFFLE=1 to run in order |
| XFSTESTS_BLACKLIST | string | set the sub-tests will not run. Mostly use in the feature not supported, and exclude some critical issues to make whole tests stable. The final skip test list will also count those defined in XFSTESTS_GROUPLIST. It's also support "-" and "," to set skip range | |
| XFSTESTS_GROUPLIST | string | it's an efficient way to set XFSTESTS_RANGES. Most likely use in test whole range in a single test, such as test special mount option. The range is supported in xfstests upstream, to know the whole range of group names could take a look at xfstests upstream README file. This parameter in openqa supports not only "include" tests, but also "exclude" tests. To add a "!" before a group name to exclude all subtests in that group. Here is an example: e.g. XFSTESTS_GROUPLIST=quick,!fuzz,!fuzzers,!realtime (Add all subtests in quick group, and exclude all dangerous subtests in fuzz, fuzzers, realtime groups) | |
| XFSTESTS_KNOWN_ISSUES | string | Used to specify a url for a json file with well known xfstests issues. If an error occur which is listed, then the result is overwritten with softfailure. |
Run-time related: timeout control to avoid random fails when low performance
| Variable | Type | Default value | Details |
|---|---|---|---|
| XFSTESTS_HEARTBEAT_INTERVAL | integer | 30 | The interval (seconds) of each heartbeat signal |
| XFSTESTS_HEARTBEAT_TIMEOUT | integer | 200 | The timeout (seconds) of not receiving a heartbeat signal |
| XFSTESTS_SUBTEST_MAXTIME | integer | 2400 | Define the max test time (seconds) for a single subtest. The test logic will take the time out as a hang, to reset SUT and continue the rest of the tests. Considering xfstests contain some fuzzing tests which take quite a long time to finish, I suggest this max time don't set too small |
| XFSTESTS_NO_HEARTBEAT | boolean | 0 | set XFSTESTS_NO_HEARTBEAT=1 to enable non-heartbeat mode. The heartbeat mode is default, you could also unset this parameter |
| XFSTESTS_TIMEOUT | integer | 2000 | set de timeout (seconds) for each subtest. It is only used in non-heartbeat mode. And it's the only time control strategy in that mode |
| XFSTESTS_HIGHSPEED | boolean | 0 | set XFSTESTS_HIGHSPEED=1 to reduce the typing and waiting time. Suggest to set also VIRTIO_CONSOLE=1 and XFSTESTS_NO_HEARTBEAT=1 to getting highest performance. But beware system may hang in a crash because send_key 'alt-sysrq-b' not working in virtio console. |
Installation related: some optional setting to solve testsuite installation dependency issue
| Variable | Type | Default value | Details |
|---|---|---|---|
| XFSTESTS_REPO | string | repo to install xfstests package | |
| DEPENDENCY_REPO | string | ibs/obs repo to install related test package to solve dependency issues. e.g. fio | |
| XFSTESTS_DEVICE | string | manually set a test disk for both TEST_DEV and SCRATCH_DEV | |
| XFSTESTS_INSTALL | boolean | false | Install xfstests and dependency package. |
| XFSTESTS_PACKAGES | string | Install additional required packages of xfstests. e.g. 'fsverity-utils libcap-progs' |
Filesystem specific setting:
| Variable | Type | Default value | Details |
|---|---|---|---|
| XFSTEST_MKFS_OPTION | string | BTRFS only, value=. Set the options in mkfs.btrfs. And also set it in xfstests runtime option BTRFS_MKFS_OPTIONS. | |
| XFSTESTS_LOGDEV | boolean | 0 | XFS only, value=0/1. enable log device in testing xfs |
| XFSTESTS_XFS_REPAIR | boolean | 0 | XFS only, value=0/1. enable TEST_XFS_REPAIR_REBUILD=1 in xfstests log file local.config |
| XFSTESTS_NFS_VERSION | string | 4.1 | NFS only, version of test target NFS |
| XFSTESTS_NFS_SERVER | boolean | NFS multimation test only, mandatory. To tag this test job for NFS server in a NFS multimachine test. NFS test in a multimachine test either a client or a server. | |
| NFS_GRACE_TIME | integer | 15 | NFS only, set the nlm_grace_period in /etc/modprobe.d/lockd.conf used in NFS test. |
| PARALLEL_WITH | string | NFS multimation test only, value=. To set the NFS server job name in NFS client job in a NFS multimachine test. e.g. xfstests_nfs4.1-server | |
| XFSTESTS_PART_SIZE | string | Partitions size in MB, separate with commas. Each size is allocated to test_dev, scratch_dev1 and so on in turn. Unconfigured partitions will divide the remaining space equally. E.g, value=5120,10240 then test_dev=5120M, scratch_dev1=10240M, and remain partitions share the rest space. |
Debug setting: advance setting to debugging issues, may cause test fail
| Variable | Type | Default value | Details |
|---|---|---|---|
| XFSTESTS_DEBUG | string | set it to enable debug tools under /proc/sys/kernel/. The value of XFSTESTS_DEBUG could be one or more parameters in the following: [hardlockup_panic hung_task_panic panic_on_io_nmi panic_on_oops panic_on_rcu_stall...] Collect more than 1 value at a time could use to split it. e.g. XFSTESTS_DEBUG='hardlockup_panic panic_on_oops'. BTW, the softlockup_all_cpu_backtrace and softlockup_panic are default enabled | |
| BTRFS_DUMP | boolean | 0 | set BTRFS_DUMP= to collect btrfs dump image. It uses btrfs-image create/restore an image of the filesystem. e.g BTRFS_DUMP=/dev/loop0 |
| RAW_DUMP | boolean | 0 | set RAW_DUMP=1 to collect raw dump. It uses dd to collect start 512k info to dump the superblock of SCRATCH_DEV or SCRATCH_DEV_POOL |
| INJECT_INFO | string | Add 1 or several lines of code into xfstests level test script(not in openqa script). To add some debug or log collect info. This code will be used by the test wrapper, it will influence all subtests in this test, so better to only use it in debug and set XFSTESTS_RANGES to the subtest you want to. It contains 2 parameters split by space, the format: ''. Beware the output may not match after injection, and better not to add space in the |
|
| INJECT_INFO=' xtrace | string | A special inject code is to set xtrace to debug shell script. Set INJECT_INFO=' xtrace' to openqa configure to enable it and start to record command start after injecting line , and redirect debug info to /opt/log/xxx_xtrace.log |
SCC REGCODES: registering product modules in SCC
| Variable | Type | Default value | Details |
|---|---|---|---|
| SCC_RECGODE_LTSS | string | This will hold the registration code for activating the product SLES-LTSS | |
| SCC_RECGODE_LTSS_ES | string | This will hold the registration code for activating the product SLES-LTSS-Extended-Security |