Editing Test Day:2013-10-13 SSD Cache

{{Infobox_group
| name = Fedora Test Days
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_20_test_days]]
| caption = [[Features/SSD_cache|SSD Cache]]
| date = 2013-10-13
| time = all day
| website = [[QA/Fedora_20_test_days]]
| irc = [irc://irc.freenode.net/#fedora-test-day #fedora-test-day] ([http://webchat.freenode.net/?channels=fedora-test-day webirc])
| fedora_mailing_list = test
}}

{{admon/note | 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 [http://bugzilla.redhat.com 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 [[QA/Test_Days|current schedule]] and see if a similar but more recent Test Day is planned or has already happened.}}

== What to test? ==

Today's instalment of Fedora Test Day will focus on bcache based SSD Caching in Fedora 20.

=== General test objective ===
The objective of this Test day is to demonstrate a working Fedora 20 system using bcache. Te be more specific:
* The system boots OK; after booting bcache is operating as expected
* The system updates ("yum update") OK. After updating specifically the kernel the system boots OK.
* The system is bootable when the caching device is disabled.

=== Scope ===

SSD caching is a new feature (since kernel 3.9) and should be considered experimental. The focus of this Test day is to evaluate the alignment of bcache-tools with other relevant Fedora packages to support a good basis for experimenting with SSD caching:

* bcache-tools
* util-linux
* dracut
* lvm2
* kernel

Anaconda support for bcache is expected to be available not until Fedora 21, so this is not in scope for the test day.

In general issues related to the bcache kernel driver are not in scope; SSD caching is not production yet so they should be addressed in the regular development process. This includes performance related issues. Only when the Test day demonstrates a unworkable situation, issues related to the bcache driver in the kernel are in scope on the Test day.

== Who's available ==

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
* Development - [[User:ignatenkobrain|Igor Gnatenko]] (ignatenkobrain), [[User:rolffokkens|Rolf Fokkens]] (rolffokkens)
* Quality Assurance - [[User:jreznik|Jaroslav Reznik]] (jreznik)

== Prerequisite for Test Day == 

=== Physical or Virtual ===
Although performance (of course) is a very important aspect of SSD caching, testing it is not required on the test day. Because of this testing can be done both on physical and virtual hardware, on a true SSD or a HDD. There is however a slight preference to do the testing on real hardware, with a real SSD.

Whenever the terms HDD or SDD are used below, they can be both physical and virtual. The same is true for the terms "system", "CPU", "RAM`and "bootable media".

=== Hardware & Software requirements ===
* A fresh system:
  * 10GB+ HDD
  * 2GB+ SSD
  * 256MB+ RAM
  * x86 CPU (32bit or 64bit)
  * internet connection

* bootable media containg Rawhide/F20 (?) netinst (?) image.

=== Other requirements ===
* Knowledge on how to build physical or virtual machines
* Knowledge how to use the Linux command line (There's no graphical installer yet)
* A desire to break software

=== Further reading ===

Here's a chunk which is commonly used for most Test Days. Replace XX with whatever Fedora release is pending:

* An updated [http://fedoraproject.org/get-prerelease Fedora 20 pre-release], [[Releases/Rawhide|Rawhide]] (tips on installing Rawhide below), or a [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ nightly live image]

== How to test? ==



High level details on how a contributor can get involved.  This can include (but not limited to):

* Areas to target with exploratory testing
* A list of pre-defined test cases to execute
* How to report back results

Here's another common chunk (again, replace XX as above):

=== '''Update your machine''' ===

If you're running Fedora XX, make sure you have all the current updates for it installed, using the update manager. If you want to try Rawhide, see the instructions on the [[Releases/Rawhide|Rawhide]] page on the various ways in which you can install or update to Rawhide. Or:

=== '''Live image''' ===

Optionally, you may download a non-destructive Rawhide live image for your architecture. Tips on using a live image are available at [[FedoraLiveCD]]. Live images can be found [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ here].

== Test Cases ==

Provide a list of test areas or test cases that you'd like contributors to execute.  For other examples, see [[:Category:Test_Cases]].

== Test Results ==

Construct a table or list to allow testers to post results.  Each column should be a test case or configuration, and each row should consist of test results. Include some instructions on how to report bugs, and any special instructions. Here's an example, from a Palimpsest test day:

If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=udisks udisks], or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=gnome-disk-utility gnome-disk-utility] for bugs in the Palimpsest graphical front end itself. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the [[Template:result|result template]] to enter your result, as shown in the example result line.

{|
! User
! [[QA:Testcase_sample_1|Sample test 1]]
! [[QA:Testcase_sample_2|Sample test 2]]
! [[QA:Testcase_sample_3|Sample test 3]]
! [[QA:Testcase_sample_4|Sample test 4]]
! References
|-
| [[User:SampleUser|Sample User]]
| {{result|none}} 
| {{result|pass}}
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-
|}

[[Category:Test Days]] [[Category:Fedora 20 Test Days]]
@@ Line 14: / Line 14: @@
 == What to test? ==
-Today's instalment of Fedora Test Day will focus on SSD Caching in Fedora 20, specifically bcache. SSD Caching allows you to speedup your disk access by combining your slow HDD with a fast SSD. The SSD will be used to store copies of frequently accessed blocks on your HDD, so you'll experience a good performance while also having the large storage capacity of your HDD.
+Today's instalment of Fedora Test Day will focus on bcache based SSD Caching in Fedora 20.
-Although dm-cache is another SSD caching implementation, today we'll only focus on the bcache implementation.
 === General test objective ===
@@ Line 26: / Line 24: @@
 === Scope ===
-The bcache implementation of SSD caching is a new feature (since kernel 3.9) and should be considered experimental. The focus of this Test day is to evaluate the alignment of bcache-tools with other relevant Fedora packages to support a good basis for experimenting with SSD caching:
+SSD caching is a new feature (since kernel 3.9) and should be considered experimental. The focus of this Test day is to evaluate the alignment of bcache-tools with other relevant Fedora packages to support a good basis for experimenting with SSD caching:
-* bcache-tools (version 0-0.14.20130909git or later)
+* bcache-tools
-* util-linux (version 2.24-0.1 or later)
+* util-linux
-* dracut (version 034 or later)
+* dracut
-* lvm2 (version 2.02.102-1 or later)
+* lvm2
-* kernel (version 3.9 or later)
+* kernel
 Anaconda support for bcache is expected to be available not until Fedora 21, so this is not in scope for the test day.
@@ Line 41: / Line 39: @@
 The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
-* Development - Kent Overstreet (py1hon)
+* Development - [[User:ignatenkobrain|Igor Gnatenko]] (ignatenkobrain), [[User:rolffokkens|Rolf Fokkens]] (rolffokkens)
-* Quality Assurance - [[User:ignatenkobrain|Igor Gnatenko]] (ignatenkobrain), [[User:rolffokkens|Rolf Fokkens]] (rolffokkens)
+* Quality Assurance - [[User:jreznik|Jaroslav Reznik]] (jreznik)
-== External documentation ==
-You can find some relevant documentation at bcache.evilpiepirate.org[[http://bcache.evilpiepirate.org/]].
-== Prerequisites for the Test Day ==
-=== Limitations ===
-There's no "easy way" yet to convert an existing filesystem to a bcache based filesystem: bcache is an additional block layer that writes its own superblock on the underlying block devices. There is a blocks [[https://github.com/g2p/blocks]] tool under development, but for now the only solution is to backup your data some where, recreate your filesystem on a bcache device, and then restore the data.
-Another limitation is the fact that bcache is EXPERIMENTAL. Although it works really well in general, you should be careful to store important data on it.
+== Prerequisite for Test Day ==
 === Physical or Virtual ===
@@ Line 67: / Line 57: @@
    * internet connection
-* bootable media containg (one of):
+* bootable media containg Rawhide/F20 (?) netinst (?) image.
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-x86_64-DVD.iso Fedora 20 Beta TC2 x86_64 DVD]
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-i386-DVD.iso Fedora 20 Beta TC2 i386 DVD]
-Because doing updates (particularly the kernel) is part of the test, it's best not to install latest and greatest.
-=== Disk partitioning ===
-To prepare for the test cases, it is important to use the following partitioning:
-  sda:
-  sda1 500MB  /boot
-  sda2 2GB    /home
-  sda3 2GB    /
-  sda4 (>4G)  free space (only used when testing in combination with LVM)
-  sdb:
-  sdb1 >2GB   (caching device)
-sda is (or models) the rotational disk device, sdb is (or models) the solid state disk device. It would be best to have sdb (on) a true SSD, but if you don't have an SSD then an ordinary disk will do as well for the testing (except for performance testing)
-When using a VM sda may and sdb may be read as vda and vdb.
-=== SElinux ===
-Please disable SElinux. There's some copying involved in the testcases, and SElinux may break the testcases when the copied data is not accessible.
-To disable SElinux you should edit your /etc/selinux/config and set SELINUX=permissive instead of SELINUX=enforcing.
 === Other requirements ===
 * Knowledge on how to build physical or virtual machines
-* Knowledge on how to use the Linux command line (There's no graphical installer yet)
+* Knowledge how to use the Linux command line (There's no graphical installer yet)
 * A desire to break software
-== How to test? ==
+=== Further reading ===
-Because Anaconda does not support bcache yet, the test may be executed following certain steps: preparation and test case 1 to test case 3. The end result will be a F20 system running its root filesystem on bcache. These steps are merely suggestions, to allow testing in limited time. Of course testers are free to choose other ways of testing. As a suggestion, testers can focus on the following criteria:
-* Do the tools to create / manage bcache operate as expected?
+Here's a chunk which is commonly used for most Test Days. Replace XX with whatever Fedora release is pending:
-* Are your 'bcached' filesystems automatically operational after a reboot?
-* Are your 'bcached' filesystems automatically operational after a kernel update?
-Each demonstrates the proper allignment of dracut, util-linux, lvm2 (when used), bcache-tools and the kernel.
+* An updated [http://fedoraproject.org/get-prerelease Fedora 20 pre-release], [[Releases/Rawhide|Rawhide]] (tips on installing Rawhide below), or a [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ nightly live image]
-=== Preparation: install F20 ===
+== How to test? ==
-The first step is to do a minimal install:
-* this is the fastest install
-* it also saves time when copying the root filesystem during later test cases
-* it allows to install other packages later (yum groupinstall) as part of the test activities.
-Use bootable media containg
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-x86_64-DVD.iso Fedora 20 Beta TC2 x86_64 DVD]
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-i386-DVD.iso Fedora 20 Beta TC2 i386 DVD]
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-x86_64-netinst.iso Fedora 20 Beta TC2 x86_64 netinstall]
-[http://dl.fedoraproject.org/pub/alt/stage/20-Beta-TC2/Fedora/x86_64/iso/Fedora-20-Beta-TC2-x86_64-netinst.iso Fedora 20 Beta TC2 i386 netinstall] to install Fedora 20. This does not contain the most recent packages, so lateron <code>yum update</code> can be used as a test.
-== Test Cases ==
+High level details on how a contributor can get involved.  This can include (but not limited to):
-=== Test case 1.A: /home on bcache (no LVM)===
+* Areas to target with exploratory testing
+* A list of pre-defined test cases to execute
+* How to report back results
-Once your fresh Fedora 20 system is running, we will "move" /home to a bcache device without using LVM.
+Here's another common chunk (again, replace XX as above):
-Step by step instructions are available on [[QA:Testcase_bcache-tools_home_on_bcache_(no_LVM)|this page]]
+=== '''Update your machine''' ===
-=== Test case 1.B: / on bcache (no LVM) ===
+If you're running Fedora XX, make sure you have all the current updates for it installed, using the update manager. If you want to try Rawhide, see the instructions on the [[Releases/Rawhide|Rawhide]] page on the various ways in which you can install or update to Rawhide. Or:
-Now we have a stable system with /home on bcache, we can go forward and have / on bcache without using LVM.
-Step by step instructions are available on [[QA:Testcase_bcache-tools_root_on_bcache_(no_LVM)|this page]].
+=== '''Live image''' ===
-=== Test case 2.A: /home on bcache (LVM)===
+Optionally, you may download a non-destructive Rawhide live image for your architecture. Tips on using a live image are available at [[FedoraLiveCD]]. Live images can be found [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ here].
-Once your fresh Fedora 20 system is running, we will "move" /home to a Logical Volume (LVM) on a bcache device. Because of the flexibility that LVM provides the approach is quite different from page 1.A, for example we'll start by using sda4!
+== Test Cases ==
-Step by step instructions are available on [[QA:Testcase_bcache-tools_home_on_bcache_(LVM)|this page]]
-=== Test case 2.B: / on bcache (LVM) ===
-Now we have a stable system with /home on LVM on bcache, we can go forward and have / on bcache.
-Step by step instructions are available on [[QA:Testcase_bcache-tools_root_on_bcache_(LVM)|this page]]
-== Participants ==
+Provide a list of test areas or test cases that you'd like contributors to execute.  For other examples, see [[:Category:Test_Cases]].
-{|
-! User
-! IRC nickname
-|-
-| Kent Overstreet
-| py1hon
-|-
-| [[User:ignatenkobrain|Igor Gnatenko]]
-| ignatenkobrain
-|-
-| [[User:rolffokkens|Rolf Fokkens]]
-| rolffokkens
-|-
-|}
 == Test Results ==
-<!-- metadata: https://fedoraproject.org/wiki/User:Jskladan/Sandbox:F20SSDCacheTestday
+Construct a table or list to allow testers to post results.  Each column should be a test case or configuration, and each row should consist of test results. Include some instructions on how to report bugs, and any special instructions. Here's an example, from a Palimpsest test day:
-     To update the results tool, put the metadata url in the following form and submit: http://testdays.qa.fedoraproject.org/testdays/admin/update_testday
-'''We are tracking test results in a web application [http://testdays.qa.fedoraproject.org/testdays/show_event?event_id=8 over here]'''
-Results from this web application will be automatically transferred to the Wiki a week after the test day, and the reporting system will be shutdown. Feel free to continue testing and filling the wiki even after this date.
-Should you encounter any problem while using the web application, please contact jskladan on #fedora-qa channel at freenode, or send an email to jskladan@fedoraproject.org
--->
-If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=bcache-tools bcache-tools]. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the [[Template:result|result template]] to enter your result, as shown in the example result line.
+If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=udisks udisks], or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=gnome-disk-utility gnome-disk-utility] for bugs in the Palimpsest graphical front end itself. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one. For each test case, use the [[Template:result|result template]] to enter your result, as shown in the example result line.
 {|
 ! User
-! [[QA:Testcase_bcache-tools_home_on_bcache_(no_LVM)|/home on bcache (no LVM)]]
+! [[QA:Testcase_sample_1|Sample test 1]]
-! [[QA:Testcase_bcache-tools_root_on_bcache_(no_LVM)|/ on bcache (no LVM)]]
+! [[QA:Testcase_sample_2|Sample test 2]]
-! [[QA:Testcase_bcache-tools_home_on_bcache_(LVM)|/home on bcache (LVM)]]
+! [[QA:Testcase_sample_3|Sample test 3]]
-! [[QA:Testcase_bcache-tools_root_on_bcache_(LVM)|/ on bcache (LVM)]]
+! [[QA:Testcase_sample_4|Sample test 4]]
 ! References
 |-
-| [[User:werkman|werkman]]
+| [[User:SampleUser|Sample User]]
-| {{result|pass}}
+| {{result|none}}
-| {{result|none}}
+| {{result|pass}}
-| {{result|none}}
+| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
-| {{result|none}}
+| {{result|fail}} <ref>{{bz|12345}}</ref>
-| <references/>
-|-
-| [[User:ambush|PAVLEG]]
-| {{result|warn}}<ref>Test pass, but nothing works. {{bz|1018615}}</ref>
-| {{result|none}}
-| {{result|none}}
-| {{result|none}}
-| <references/>
-|-
-| [[User:roshi|roshi]]
-| {{result|warn||1018615}}
-| {{result|warn}} <ref>Hit this bug with wget {{bz|1018615}}</ref>
-| {{result|none}}
-| {{result|none}}
 | <references/>
 |-
 |}
-=== Mock tests (optional) ===
+[[Category:Test Days]] [[Category:Fedora 20 Test Days]]
-{|
-! User
-! [[QA:Testcase_bcache-tools_mock_on_bcache_(no_LVM)|mock on bcache (no LVM)]]
-! References
-|-
-| [[User:Sampleuser|Sample User]]
-| {{result|inprogress}}
-| <references/>
-|-
-|}
- [[Category:Fedora 20 Test Days]]