From Fedora Project Wiki

Revision as of 09:19, 3 November 2016 by Kparal (talk | contribs) (and his name as well)

Better Switchable Graphics Support
Test-days-banner.svg

Date TBA
Time all day

Website QA/Test Days
IRC #fedora-test-day (webirc)
Mailing list test


Note.png
Can't make the date?
If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at Bugzilla, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.

What to test?

Today's installment of Fedora Test Day will focus on Better Switchable Graphics Support - for Fedora 25, there are some changes to switchable graphics support and today we will be testing that it works well enough, especially for Wayland on Fedora Workstation.

Who's available

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...

Prerequisite for Test Day

How to test?

Using an existing Fedora 25 installation

Using an existing Fedora 25 install to test is fine, but please ensure you are using the default GNOME session (listed as just 'GNOME' in the login screen session chooser). Please also ensure you have fully updated the system. Ideally, also run dnf --enablerepo=updates-testing update fedora-release* and ensure that fedora-release-25-0.14 or later is installed. After updating the system, please reboot.

Please disable proprietary drivers, if you use them. If you are not sure how to do this, please test with a live image instead.

It may also be a good idea to create a fresh user account for testing, though issues experienced with your regular user account are also of interest.

Live image

Instead of testing with an installed system, you may download a non-destructive nightly live image for your architecture. Tips on using a live image are available at FedoraLiveCD. Please boot the live image normally without changing kernel parameters etc.

Test Day live image

There is a special Switchable Test Day live image available. The sha256sum is f7e2cababd8b7b859e413e2de2149637e54355f8a2c2ec9970269c3c54d26fcd. This image provides the necessary bits for the Desktop offload test to work out of the box; with a regular live image, that test will not work correctly.

Warning.png
Old live image version
An older version of the live image was briefly linked here, named Fedora-SwitchTestDay-Live-x86_64-25-20161102.n.0.iso. If you have that version, please discard it and download the new one. We apologize for the inconvenience.

Nightly live image

You can also use a regular nightly live image, if you already have a recent one to hand or do not want to use the Test Day live image for some reason. Live image links can be found here: please be sure to download a Fedora 25 Workstation nightly. If you use a regular live image, you will not be able to run the Desktop offload test.

Download switchcheck and get your system profile

For this event we have written a script to gather some information on your system. Before running any tests, please download and run the script.

Note.png
Safety information
The script inspects nothing but your hardware information and whether or not X.org is running, and sends no data out from your system. It is free software and written in Python, so you can easily inspect it before running it if you wish.
  1. Install the script by running, at a console: curl -o /tmp/switchcheck https://pagure.io/fedora-qa/switchcheck/raw/master/f/switchcheck && chmod ugo+x /tmp/switchcheck
  2. Run the script, as a regular user from a terminal in the Workstation desktop: /tmp/switchcheck
    • If it prints an error message with instructions, please follow them.
    • If it prints any other kind of error, please ask for help in IRC.
  3. If you have switchable graphics and the script works correctly, it should display Paste the following line as your 'profile' in the results page:, and then a line of text. That line of text is your profile.

Run the tests

Visit the result page and click on the column title links to see the tests that need to be run. Follow the instructions there, then enter your results by clicking the Enter result button for the test. In the Profile section, please enter the profile text produced by the switchcheck script. You can add your system's model number before or after the profile text if you like. If you test on multiple systems, please enter a new row of results for each tested system, with the correct profile text for each one.

Note.png
'Power' test
The 'Power' test is only useful on certain hardware configurations. When you run the switchcheck script it should tell you whether or not to run that test: please follow the instruction. Of course, you can run all the other tests!
Note.png
'Intel' tests
Some of the test cases used are pre-existing ones written for Intel graphics Test Days, and so they refer specifically to 'Intel display adapter' and so on. Don't worry if the text seems slightly inaccurate for a hybrid graphics system, we are just re-using the test cases for convenience. Just follow the instructions and disregard inaccurate Intel-specific references.
Note.png
Proprietary driver testing
Testing of switchable graphics with the NVIDIA proprietary driver is not officially covered at this event, but if you can run an installation and want to try it out, you may find this blog post a useful reference. It's not possible to test this from the live image, you will have to do a system install. Please ask in the IRC channel if you run into problems or have questions, and if anyone is around who is familiar with this area they will try to help you.

Commonly encountered issues

Here are some bugs which have cropped up a few times already:

  • #1356115 - Some Macbook models with outputs connected to the secondary GPU show graphical glitches on boot and crash on suspend

Reporting bugs

If you have problems with any of the tests, check the list of commonly-encountered issues above and the bugs reported by other testers on the results page. If you see a report that looks the same, add a comment with any useful information you can add.

If you don't find an existing report, report a new bug to Bugzilla. The appropriate component will depend greatly on the nature of the bug. If it seems to be a fundamental hardware support issue, please file the bug on the kernel. If it seems to be more to do with GNOME integration, likely components are mutter, gnome-shell, and gnome-control-center. Please ask in IRC if you encountered an issue but are not sure where to report it. Please include in the bug report:

  1. The output of lshw -c display or lspci -nn
  2. The output of xrandr --listproviders
  3. The output of journalctl -b (you can run journalctl -b > /tmp/journal and then attach /tmp/journal to the bug)
  4. The output of sudo dmidecode (again, you can run sudo dmidecode > /tmp/dmidecode and attach /tmp/dmidecode to the bug)

If you encounter a crash, you should be able to use the ABRT system to file a high-quality bug report. Run gnome-abrt - 'Problem Reporting' in the overview - look for the crash in the list you see, and click the Report button.

Test Results

Results will be transferred here from the result page after testing is complete. Please enter results in the result page.