From Fedora Project Wiki
(create a draft of this proposed test based on tablepc's draft with cleanups and additions)
 
(hijack Adam's page because it's fun)
 
(4 intermediate revisions by one other user not shown)
Line 4: Line 4:
|description=This test case ensures that disk drive(s) are properly unmounted during a power down or a restart.
|description=This test case ensures that disk drive(s) are properly unmounted during a power down or a restart.
|setup=
|setup=
# Install or deploy the Fedora release media you wish to test. Follow all defaults, except that you can use any file system supported by the installer for the system partitions (ideally, this test should be run at least once with each of them).
# Install or deploy the Fedora release media you wish to test. You can use any allowed configuration by the installer.
# Reboot to the installed system.
# Reboot to the installed system.
# If you are testing a live image, perform the steps below from the live environment before doing the install. After this go ahead with the install. Then perform the steps below from the installed system.
|actions=
|actions=
# On the installed system, run a console and become root with {{command|sudo su}} or {{command|su}}.
# On the installed system, search for disk mount/unmount errors using the following command: <pre>sudo journalctl -b | grep -E 'dirty bit|data may be corrupt|recovery|unmounted|recovering'</pre> If there is no output, there were no such errors and everything seems correct.
# Run the following command: {{command|journalctl -b <nowiki>|</nowiki> grep -E "dirty bit<nowiki>|</nowiki>data may be corrupt<nowiki>|</nowiki>recovery<nowiki>|</nowiki>unmounted<nowiki>|</nowiki>recovering"}} and see whether there is any output.
#* If there was some output from the grep command, save the full journal log using <pre>sudo journalctl -b > journal.log</pre> If the grep output does not show clearly that the output is related to a disk mount/unmount problem, open the {{filename|journal.log}} file, find the relevant lines and verify whether this is an error related to disk mounting or an unrelated message.
# If there was output from the grep command, run the command {{command|journalctl -b -l > journal.log}}. Please file a bug report (the kernel is most likely the correct package to file the report against) and attach the journal.log file to the bug report.
#* If the output is related to disk mounting, please file a bug report (the {{pkg|kernel}} is most likely the correct package to file the report against) and attach the {{filename|journal.log}} file to the bug report.
# Restart the test system using the command {{command|reboot}} on the virtual console.
# Restart the system.
# Repeat steps 1 to 3 above.
# Repeat all the steps above once more (the first pass checks whether the system unmounted disks properly when rebooting from the installer, the second pass checks whether the system unmounted disks properly when rebooting from the installed system).
{{admon/note|Manual error checking|This test relies on specific expected text in error messages. It's possible these messages may change in the future and there may be an error that is not caught by the {{command|grep}} command. Optionally you can examine the {{command|journalctl -b}} output manually for error messages that might indicate a filesystem not being cleanly unmounted at shutdown, and file a bug report if you find any.}}
 
{{admon/note|Manual error checking|This test relies on specific expected text in error messages. It's possible these messages may change in the future and there may be an error that is not caught by the {{command|grep}} command. Optionally you can examine the {{command|sudo journalctl -b}} output manually for error messages that might indicate a filesystem not being cleanly unmounted at shutdown, and file a bug report if you find any. Here are sample error messages from system journal that indicate errors known to us:
<pre>
# FAT fsck
systemd-fsck[681]: 0x41: Dirty bit is set. Fs was not properly unmounted and some data may be corrupt.
 
# FAT kernel
FAT-fs (vdb1): Volume was not properly unmounted. Some data may be corrupt. Please run fsck.
 
# ext4 fsck
systemd-fsck[681]: /dev/vdb2: recovering journal
 
# ext4 kernel
EXT4-fs (vdb2): recovery complete
 
# xfs kernel
XFS (vdb3): Starting recovery (logdev: internal)
</pre>}}
|results=
|results=
# Each {{command|grep}} command should produce no output.
# Each {{command|grep}} command should produce no output.
# Running {{command|reboot}} should cause an orderly shutdown and restart of the system.
# Requesting reboot should cause an orderly shutdown and restart of the system.
}}
}}

Latest revision as of 14:20, 8 January 2020

Associated release criterion
This test case is associated with the Basic_Release_Criteria#shutdown release criterion. If you are doing release validation testing, a failure of this test case may be a breach of that release criterion. If so, please file a bug and nominate it as blocking the appropriate milestone, using the blocker bug nomination page.


Description

This test case ensures that disk drive(s) are properly unmounted during a power down or a restart.

Setup

  1. Install or deploy the Fedora release media you wish to test. You can use any allowed configuration by the installer.
  2. Reboot to the installed system.

How to test

  1. On the installed system, search for disk mount/unmount errors using the following command: 
    sudo journalctl -b | grep -E 'dirty bit|data may be corrupt|recovery|unmounted|recovering'
    If there is no output, there were no such errors and everything seems correct.
    • If there was some output from the grep command, save the full journal log using 
      sudo journalctl -b > journal.log
      If the grep output does not show clearly that the output is related to a disk mount/unmount problem, open the journal.log file, find the relevant lines and verify whether this is an error related to disk mounting or an unrelated message.
    • If the output is related to disk mounting, please file a bug report (the kernel is most likely the correct package to file the report against) and attach the journal.log file to the bug report.
  2. Restart the system.
  3. Repeat all the steps above once more (the first pass checks whether the system unmounted disks properly when rebooting from the installer, the second pass checks whether the system unmounted disks properly when rebooting from the installed system).
Manual error checking
This test relies on specific expected text in error messages. It's possible these messages may change in the future and there may be an error that is not caught by the grep command. Optionally you can examine the sudo journalctl -b output manually for error messages that might indicate a filesystem not being cleanly unmounted at shutdown, and file a bug report if you find any. Here are sample error messages from system journal that indicate errors known to us: 
# FAT fsck
systemd-fsck[681]: 0x41: Dirty bit is set. Fs was not properly unmounted and some data may be corrupt.

# FAT kernel
FAT-fs (vdb1): Volume was not properly unmounted. Some data may be corrupt. Please run fsck.

# ext4 fsck
systemd-fsck[681]: /dev/vdb2: recovering journal

# ext4 kernel
EXT4-fs (vdb2): recovery complete

# xfs kernel
XFS (vdb3): Starting recovery (logdev: internal)

Expected Results

  1. Each grep command should produce no output.
  2. Requesting reboot should cause an orderly shutdown and restart of the system.



Retrieved from "https://fedoraproject.org/w/index.php?title=User:Adamwill/Draft_testcase_reboot&oldid=562745"