QA

{{toc}}

# Test results overview

* Latest report based on openQA test results http://s.qa.suse.de/test-status , SLE12: http://s.qa.suse.de/test-status-sle12 , SLE15: http://s.qa.suse.de/test-status-sle15

# QA tools - Team description

## Team responsibilities

* Develop and maintain upstream openQA

* Administration of openqa.suse.de and workers (But not physical hardware, as these belong to the departments that purchased them and we merely facilitate)

* Helps administrating and maintaining openqa.opensuse.org, including coordination of efforts aiming at solving problems affecting o3

* Support colleagues, team members and open source community

## Out of scope

* Maintenance of individual tests

* Maintenance of physical hardware

* Maintenance of special worker addendums needed for tests, e.g. external hypervisor hosts for s390x, powerVM

* Ticket triaging of http://progress.opensuse.org/projects/openqatests/

* Feature development within the backend for single teams (commonly provided by teams themselves)

## How we work

The QA Tools team is following the DevOps approach working using a lightweight Agile approach. We plan and track our works using tickets on https://progress.opensuse.org . We pick tickets based on priority and planning decisions. We use weekly meetings as checkpoints for progress and also track cycle and lead times to crosscheck progress against expectations.

* [Ready Issues](https://progress.opensuse.org/projects/openqav3/issues?query_id=230)

* [what members of the tools team are working on](https://progress.opensuse.org/projects/openqav3/issues?query_id=400)

Also find the custom queries in the right-hand sidebar of https://progress.opensuse.org/projects/openqav3/issues for tickets and their plans.

### Common tasks for team members

This is a list of common tasks that we follow, e.g. reviewing daily based on individual steps in the DevOps Process ![DevOps Process](devops-process_25p.png)

* **Plan**:

 * State daily learning and planned tasks in internal chat room

 * Review backlog for time-critical, triage new tickets, pick tickets from backlog; see https://progress.opensuse.org/projects/qa/wiki#How-we-work-on-our-backlog

* **Code**:

 * See project specific contribution instructions

 * Provide peer-review following https://github.com/notifications based on projects within the scope of https://github.com/os-autoinst/ with the exception of test code repositories, especially https://github.com/os-autoinst/openQA, https://github.com/os-autoinst/os-autoinst, https://github.com/os-autoinst/scripts, https://github.com/os-autoinst/os-autoinst-distri-openQA, https://github.com/os-autoinst/openqa-trigger-from-obs, https://github.com/os-autoinst/openqa_review

* **Build**:

 * See project specific contribution instructions

* **Test**:

 * Monitor failures on https://travis-ci.org/ relying on https://build.opensuse.org/package/show/devel:openQA/os-autoinst_dev for os-autoinst (email notifications)

 * Monitor failures on https://app.circleci.com/pipelines/github/os-autoinst/openQA?branch=master relying on https://build.opensuse.org/project/show/devel:openQA:ci for openQA (email notifications)

* **Release**:

 * By default we use the rolling-release model for all projects unless specified otherwise

 * Monitor https://build.opensuse.org/project/show/devel:openQA (all packages and all subprojects) for failures, ensure packages are published on http://download.opensuse.org/repositories/devel:/openQA/

 * Monitor http://jenkins.qa.suse.de/view/openQA-in-openQA/ for the openQA-in-openQA Tests and automatic submissions of os-autoinst and openQA to openSUSE:Factory through https://build.opensuse.org/project/show/devel:openQA:tested

* **Deploy**:

 * o3 is automatically deployed (daily), see https://progress.opensuse.org/projects/openqav3/wiki/Wiki#Automatic-update-of-o3

 * osd is automatically deployed (weekly), monitor https://gitlab.suse.de/openqa/osd-deployment/pipelines and watch for notification email to openqa@suse.de

* **Operate**:

 * Apply infrastructure changes from https://gitlab.suse.de/openqa/salt-states-openqa (osd) or manually over sshd (o3)

 * Monitor for backup, see gitlab.suse.de/qa-sle/backup-server-salt

config changes in salt (osd), backups, job group configuration changes

* **Monitor**:

 * React on alerts from https://stats.openqa-monitor.qa.suse.de/alerting/list?state=not_ok (emails on osd-admins@suse.de)

 * Look for incomplete jobs or scheduled not being worked on o3 and osd (API or webUI)

 * Be responsive on #opensuse-factory (irc://chat.freenode.net/opensuse-factory) for help, support and collaboration (Unless you have a better solution it is suggested to use [Element.io](https://app.element.io/#/room/%23freenode_%23opensuse-factory:matrix.org) for a sustainable presence)

 * Be responsive on [#testing](https://chat.suse.de/testing) for help, support and collaboration

### How we work on our backlog

* "due dates" are only used as exception or reminders

* every team member can pick up tickets themselves

* everybody can set priority, PO can help to resolve conflicts

#### WIP-limits (reference "Kanban development"):

* global limit of 14 tickets "In Progress"

* personal limit of 3 tickets "In Progress"

To check: Open [query](https://progress.opensuse.org/projects/openqav3/issues?utf8=%E2%9C%93&set_filter=1&type=IssueQuery&sort=id%3Adesc&f%5B%5D=status_id&op%5Bstatus_id%5D=%3D&v%5Bstatus_id%5D%5B%5D=2&f%5B%5D=assigned_to_id&op%5Bassigned_to_id%5D=%3D&v%5Bassigned_to_id%5D%5B%5D=32300&v%5Bassigned_to_id%5D%5B%5D=15&v%5Bassigned_to_id%5D%5B%5D=34361&v%5Bassigned_to_id%5D%5B%5D=23018&v%5Bassigned_to_id%5D%5B%5D=22072&v%5Bassigned_to_id%5D%5B%5D=24624&v%5Bassigned_to_id%5D%5B%5D=17668&v%5Bassigned_to_id%5D%5B%5D=33482&v%5Bassigned_to_id%5D%5B%5D=32669&f%5B%5D=subproject_id&op%5Bsubproject_id%5D=*&f%5B%5D=&c%5B%5D=subject&c%5B%5D=project&c%5B%5D=status&c%5B%5D=assigned_to&c%5B%5D=fixed_version&c%5B%5D=due_date&c%5B%5D=priority&c%5B%5D=updated_on&c%5B%5D=category&group_by=assigned_to&t%5B%5D=) and look for tickets total number of tickets as well as per person

#### Target numbers or "guideline", "should be", in priorities

1. New, untriaged: 0 (daily)

2. Workable (properly defined): 40

3. Overall backlog length: ideally less than 100

#### SLOs (service level objectives)

* for picking up tickets based on priority, first goal is "urgency removal":

 * **immediate**: [<1 day](https://progress.opensuse.org/projects/openqav3/issues?utf8=%E2%9C%93&set_filter=1&f%5B%5D=priority_id&op%5Bpriority_id%5D=%3D&v%5Bpriority_id%5D%5B%5D=7&f%5B%5D=status_id&op%5Bstatus_id%5D=o&f%5B%5D=subproject_id&op%5Bsubproject_id%5D=%3D&v%5Bsubproject_id%5D%5B%5D=125&f%5B%5D=updated_on&op%5Bupdated_on%5D=%3Ct-&v%5Bupdated_on%5D%5B%5D=1&f%5B%5D=&c%5B%5D=subject&c%5B%5D=project&c%5B%5D=status&c%5B%5D=assigned_to&c%5B%5D=fixed_version&c%5B%5D=due_date&c%5B%5D=priority&c%5B%5D=updated_on&c%5B%5D=category&group_by=priority)

 * **urgent**: [<1 week](https://progress.opensuse.org/projects/openqav3/issues?utf8=%E2%9C%93&set_filter=1&f%5B%5D=priority_id&op%5Bpriority_id%5D=%3D&v%5Bpriority_id%5D%5B%5D=6&f%5B%5D=status_id&op%5Bstatus_id%5D=o&f%5B%5D=subproject_id&op%5Bsubproject_id%5D=%3D&v%5Bsubproject_id%5D%5B%5D=125&f%5B%5D=updated_on&op%5Bupdated_on%5D=%3Ct-&v%5Bupdated_on%5D%5B%5D=7&f%5B%5D=&c%5B%5D=subject&c%5B%5D=project&c%5B%5D=status&c%5B%5D=assigned_to&c%5B%5D=fixed_version&c%5B%5D=due_date&c%5B%5D=priority&c%5B%5D=updated_on&c%5B%5D=category&group_by=status)

 * **high**: [<1 month](https://progress.opensuse.org/projects/openqav3/issues?utf8=%E2%9C%93&set_filter=1&f%5B%5D=status_id&op%5Bstatus_id%5D=o&f%5B%5D=priority_id&op%5Bpriority_id%5D=%3D&v%5Bpriority_id%5D%5B%5D=5&f%5B%5D=subproject_id&op%5Bsubproject_id%5D=%3D&v%5Bsubproject_id%5D%5B%5D=125&f%5B%5D=updated_on&op%5Bupdated_on%5D=%3Ct-&v%5Bupdated_on%5D%5B%5D=30&f%5B%5D=&c%5B%5D=subject&c%5B%5D=project&c%5B%5D=status&c%5B%5D=assigned_to&c%5B%5D=fixed_version&c%5B%5D=due_date&c%5B%5D=priority&c%5B%5D=updated_on&c%5B%5D=category&group_by=status)

 * **normal**: [<1 year](https://progress.opensuse.org/projects/openqav3/issues?utf8=%E2%9C%93&set_filter=1&f%5B%5D=priority_id&op%5Bpriority_id%5D=%3D&v%5Bpriority_id%5D%5B%5D=4&f%5B%5D=status_id&op%5Bstatus_id%5D=o&f%5B%5D=subproject_id&op%5Bsubproject_id%5D=%3D&v%5Bsubproject_id%5D%5B%5D=125&f%5B%5D=updated_on&op%5Bupdated_on%5D=%3Ct-&v%5Bupdated_on%5D%5B%5D=365&f%5B%5D=&c%5B%5D=subject&c%5B%5D=project&c%5B%5D=status&c%5B%5D=assigned_to&c%5B%5D=fixed_version&c%5B%5D=due_date&c%5B%5D=priority&c%5B%5D=updated_on&c%5B%5D=category&group_by=status)

 * **low**: undefined

* aim for cycle time of individual tickets (not epics or sagas): 1h-2w

### Historical

Previously the QA tools team used target versions "Ready" (to be planned into individual milestone periods or sprints), "Current Sprint" and "Done". However the team never really did use proper time-limited sprints so the distinction was rather vague. After having tickets "Resolved" after some time the PO or someone else would also update the target version to "Done" to signal that the result has been reviewed. This was causing a lot of ticket update noise for not much value considering that the [Definition-of-Done](https://progress.opensuse.org/projects/openqav3/wiki/#ticket-workflow) when properly followed already has rather strict requirements on when something can be considered really "Resolved" hence the team eventually decided to not use the "Done" target version anymore. Since about 2019-05 (and since okurz is doing more backlog management) the team uses priorities more as well as the status "Workable" together with an explicit team member list for "What the team is working on" to better visualize what is making team members busy regardless of what was "officially" planned to be part of the team's work. So we closed the target version. On 2020-07-03 okurz subsequently closed "Current Sprint" as also this one was in most cases equivalent to just picking an assignee for a ticket or setting to "In Progress". We can just distinguish between "(no version)" meaning untriaged, "Ready" meaning tools team should consider picking up these issues and "future" meaning that there is no plan for this to be picked up. Everything else is defined by status and priority.

# QA SLE Functional - Team description

**QSF (QA SLE Functional)** is a virtual team focusing on QA of the "functional" domain of the SUSE SLE products. The virtual team is mainly comprised of members of [SUSE QA SLE Nbg](https://wiki.suse.net/index.php/SUSE-Quality_Assurance/Organization/Members_and_Responsibilities#QA_SLE_NBG_Team) including members from [SUSE QA SLE Prg](https://wiki.suse.net/index.php/SUSE-Quality_Assurance/Organization/Members_and_Responsibilities#QA_SLE_PRG_Team). The [SLE Departement](https://wiki.suse.net/index.php/SUSE-Quality_Assurance/SLE_Department#QSF_.28QA_SLE_Functional.29) page describes our QA responsibilities. We focus on our automatic tests running in [openQA](https://openqa.suse.de) under the job groups "Functional" as well as "Autoyast" for the respective products, for example [SLE 15 / Functional](https://openqa.suse.de/group_overview/110) and [SLE 15 / Autoyast](https://openqa.suse.de/group_overview/129). We back our automatic tests with exploratory manual tests, especially for the product milestone builds. Additionally we care about corresponding openSUSE openQA tests (see as well https://openqa.opensuse.org).

* long-term roadmap: http://s.qa.suse.de/qa-long-term

* overview of current openQA SLE12SP5 tests with progress ticket references: https://openqa.suse.de/tests/overview?distri=sle&version=12-SP5&groupid=139&groupid=142

* fate tickets for SLE12SP5 feature testing: based on http://s.qa.suse.de/qa_sle_functional_feature_tests_sle12sp5 new report based on all tickets with milestone before SLE12SP5 GM, http://s.qa.suse.de/qa_sle_functional_feature_tests_sle15sp1 for SLE15SP1

* only "blocker" or "shipstopper" bugs on "interesting products" for SLE15 http://s.qa.suse.de/qa_sle_functional_bug_query_sle15_2, http://s.qa/qa_sle_bugs_sle12_2 for SLE12

* Better organization of planned work can be seen at the [SUSE QA](https://progress.opensuse.org/projects/suseqa) project (which is not public).

## Test plan

When looking for coverage of certain components or use cases keep the [openQA glossary](http://open.qa/docs/#concept) in mind. It is important to understand that "tests in openQA" could be a scenario, for example a "textmode installation run", a combined multi-machine scenario, for example "a remote ssh based installation using X-forwarding", or a test module, for example "vim", which checks if the vim editor is correctly installed, provides correct rendering and basic functionality. You are welcome to contact any member of the team to ask for more clarification about this.

In detail the following areas are tested as part of "SLE functional":

* different hardware setups (UEFI, acpi)

* support for localization

* openSUSE: virtualization - some "virtualization" tests are active on o3 with reduced set compared to SLE coverage (on behalf of QA SLE virtualization due to team capacity constraints, clarified in QA SLE coordination meeting 2018-03-28)

* openSUSE: migration - comparable to "virtualization", a reduced set compared to SLE coverage is active on o3 (on behalf of QA SLE migration due to team capacity constraints, clarified in QA SLE coordination meeting 2018-04)

### QSF-y

Virtual team focuses on testing YaST components, including installer and snapper.

Detailed test plan for SLES can be found here: [SLES_Integration_Level_Testplan.md](https://gitlab.suse.de/qsf-y/qa-sle-functional-y/blob/master/SLES_Integration_Level_Testplan.md)

* Latest report based on openQA test results SLE12: http://s.qa.suse.de/test-status-sle12-yast , SLE15: http://s.qa.suse.de/test-status-sle15-yast

### QSF-u

"Testing is the future, and the future starts with you"

* basic operations (firefox, zypper, logout/reboot/shutdown)

* boot_to_snapshot

* functional application tests (kdump, gpg, ipv6, java, git, openssl, openvswitch, VNC)

* NIS (server, client)

* toolchain (development module)

* systemd

* "transactional-updates" as part of the corresponding SLE server role, not CaaSP

* Latest report based on openQA test results SLE12: http://s.qa.suse.de/test-status-sle12-functional , SLE15: http://s.qa.suse.de/test-status-sle15-functional

## Explicitly not covered by QSF

* quarterly updated media: Expected to be covered by Maintenance + QAM

## What we do

We collected opinions, personal experiences and preferences starting with the following four topics: What are fun-tasks ("new tests", "collaborate", "do it right"), what parts are annoying ("old & sporadic issues"), what do we think is expected from qsf-u ("be quick", "keep stuff running", "assess quality") and what we should definitely keep doing to prevent stakeholders becoming disappointed ("build validation", "communication & support").

### How we work on our backlog

* no "due date"

* we pick up tickets that have not been previously discussed

* more flexible choice

* WIP-limits:

 * global limit of 10 tickets "In Progress"

* target numbers or "guideline", "should be", in priorities:

 1. New, untriaged: 0

 2. Workable: 40

 3. New, assigned to [u]: ideally less than 200 (should not stop you from triaging)

* SLAs for priority tickets - how to ensure to work on tickets which are more urgent?

 * "taken": <1d: immediate -> looking daily

 * 2-3d: urgent

 * first goal is "urgency removal": <1d: immediate, 1w: urgent

* our current "cycle time" is 1h - 1y (maximum, with interruptions)

* everybody should set priority + milestone in obvious cases, e.g. new reproducible test failures in multiple critical scenarios, in general case the PO decides

### How we like to choose our battles

We self-assessed our tasks on a scale from "administrative" to "creative" and found in the following descending order: daily test review (very "administrative"), ticket triaging, milestone validation, code review, create needles, infrastructure issues, fix and cleanup tests, find bugs while fixing failing tests, find bugs while designing new tests, new automated tests (very "creative"). Then we found we appreciate if our work has a fair share of both sides. Probably a good ratio is 60% creative plus 40% administrative tasks. Both types have their advantages and we should try to keep the healthy balance.

### What "product(s)" do we (really) *care* about?

Brainstorming results:

* openSUSE Krypton -> good example of something that we only remotely care about or not at all even though we see the connection point, e.g. test plasma changes early before they reach TW or Leap as operating systems we rely on or SLE+packagehub which SUSE does not receive direct revenue from but indirect benefit. Should be "community only", that includes members from QSF though

* openQA -> (like OBS), helps to provide ROI for SUSE

* SLE(S) (in development versions)

* Tumbleweed

* Leap, because we use it

* SLES HA

* SLE migration

* os-autoinst-distri-opensuse+backend+needles

From this list strictly no "product" gives us direct revenue however most likely SLE(S) (as well as SLES HA and SLE migration) are good examples of direct connection to revenue (based on SLE subscriptions). Conducting a poll in the team has revealed that 3 persons see "SLE(S)" as our main product and 3 see "os-autoinst-distri-opensuse+backend+needles" as the main product. We mainly agreed that however we can not *own* a product like "SLE" because that product is mainly not under our control.

Visualizing "cost of testing" vs. "risk of business impact" showed that both metrics have an inverse dependency, e.g. on a range from "upstream source code" over "package self-tests", "openSUSE Factory staging", "Tumbleweed", "SLE" we consider SLE to have the highest business risk attached and therefore defines our priority however testing at upstream source level is considered most effective to prevent higher cost of bugs or issues. Our conclusion is that we must ensure that the high-risk SLE base has its quality assured while supporting a quality assurance process as early as possible in the development process. package self-tests as well as the openQA staging tests are seen as a useful approach in that direction as well as "domain specfic specialist QA engineers" working closely together with according in-house development parties.

## Documentation

This documentation should only be interesting for the team QA SLE functional. If you find that some of the following topics are interesting for other people, please extract those topics to another wiki section.

### QA SLE functional Dashboards

In room 3.2.15 from Nuremberg office are two dedicated laptops each with a monitor attached showing a selected overview of openQA test resuls with important builds from SLE and openSUSE.

Such laptops are configured with a root account with the default password for production machines. First point of contact: [slindomansilla.suse.com](mailto:slindomansilla@suse.com), (okurz@suse.de)[mailto:okurz@suse.de]

* ''dashboard-osd-3215.suse.de'': Showing current view of openqa.suse.de filtered for some job group results, e.g. "Functional"

* ''dashboard-o3-3215.suse.de'': Showing current view of openqa.opensuse.org filtered for some job group results which we took responsibility to review and are mostly interested in

### dashboard-osd-3215

* OS: openSUSE Tumbleweed

* Services: ssh, mosh, vnc, x2x

* Users:

** root

** dashboard

* VNC: `vncviewer dashboard-osd-3215`

* X2X: `ssh -XC dashboard@dashboard-osd-3215 x2x -west -to :0.0`

** (attaches the dashboard monitor as an extra display to the left of your screens. Then move the mouse over and the attached X11 server will capture mouse and keyboard)

#### Content of /home/dashboard/.xinitrc

```

#

# Source common code shared between the

# X session and X init scripts

#

. /etc/X11/xinit/xinitrc.common

xset -dpms

xset s off

xset s noblank

[...]

#

# Add your own lines here...

#

$HOME/bin/osd_dashboard &

```

#### Content of /home/dashboard/bin/osd_dashboard

```

#!/bin/bash

DISPLAY=:0 unclutter &

DISPLAY=:0 xset -dpms

DISPLAY=:0 xset s off

DISPLAY=:0 xset s noblank

url="${url:-"https://openqa.suse.de/?group=SLE+15+%2F+%28Functional%7CAutoyast%29&default_expanded=1&limit_builds=3&time_limit_days=14&show_tags=1&fullscreen=1#"}"

DISPLAY=:0 chromium --kiosk "$url"

```

#### Cron job:

```

Min     H       DoM     Mo      DoW     Command

*	*	*	*	*	/home/dashboard/bin/reload_chromium

```

#### Content of /home/dashboard/bin/reload_chromium

```

#!/bin/bash

DISPLAY=:0 xset -dpms

DISPLAY=:0 xset s off

DISPLAY=:0 xset s noblank

DISPLAY=:0 xdotool windowactivate $(DISPLAY=:0 xdotool search --class Chromium)

DISPLAY=:0 xdotool key F5

DISPLAY=:0 xdotool windowactivate $(DISPLAY=:0 xdotool getactivewindow)

```

#### Issues:

* ''When the screen shows a different part of the web page''

** a simple mouse scroll through vnc or x2x may suffice.

* ''When the builds displayed are freeze without showing a new build, it usually means that midori, the browser displaying the info on the screen, crashed.''

** you can try to restart midori this way:

*** ps aux | grep midori

*** kill $pid

*** /home/dashboard/bin/osd_dashboard

** If this also doesn't work, restart the machine.

### dashboard-o3

* Raspberry Pi 3B+

* IP: `10.160.65.207`

#### Content of /home/tux/.xinitrc

```

#!/bin/bash

unclutter &

openbox &

xset s off

xset -dpms

sleep 5

url="https://openqa.opensuse.org?group=openSUSE Tumbleweed\$|openSUSE Leap [0-9]{2}.?[0-9]*\$|openSUSE Leap.\*JeOS\$|openSUSE Krypton|openQA|GNOME Next&limit_builds=2&time_limit_days=14&&show_tags=1&fullscreen=1#build-results"

chromium --kiosk "$url" &

while sleep 300 ; do

        xdotool windowactivate $(xdotool search --class Chromium)

        xdotool key F5

        xdotool windowactivate $(xdotool getactivewindow)

done

```

#### Content of /usr/share/lightdm/lightdm.conf.d/50-suse-defaults.conf

```

[Seat:*]

pam-service = lightdm

pam-autologin-service = lightdm-autologin

pam-greeter-service = lightdm-greeter

xserver-command=/usr/bin/X

session-wrapper=/etc/X11/xdm/Xsession

greeter-setup-script=/etc/X11/xdm/Xsetup

session-setup-script=/etc/X11/xdm/Xstartup

session-cleanup-script=/etc/X11/xdm/Xreset

autologin-user=tux

autologin-timeout=0

```