QA:Testcase Mediakit ISO Checksums

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Reworded to make non-live ISO note more clear)
(doh)
 
(11 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
{{Template:Associated_release_criterion|Alpha|correct-checksums}}
 +
{{Template:Associated_release_criterion|Final|image-consistency-verification}}
 +
 
{{QA/Test_Case
 
{{QA/Test_Case
|description=This test is intended to verify that the posted ISO media matches the published sha256sum.
+
|description=This test is intended to verify that the posted ISO media matches the published [https://secure.wikimedia.org/wikipedia/en/wiki/SHA-2 SHA-256] checksum.  Additionally, for ISO media that includes an embedded [https://secure.wikimedia.org/wikipedia/en/wiki/MD5 MD5] checksum, this test verifies that {{command|checkisomd5}} (used by the installer) correctly locates and verifies the embedded MD5 sum.
 +
|setup=
 +
# Download the {{filename|.iso}} media files you need to test
 +
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM}}.
 
|actions=
 
|actions=
# Download the {{filename|.iso}} media files you wish to test
+
# Validate that the published CHECKSUM matches the downloaded ISO files by running the command {{command|sha256sum}}.  For example, you might type: <pre&lt;noinclude&gt;&lt;/noinclude&gt;>sha256sum -c Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM</pre&lt;noinclude&gt;&lt;/noinclude&gt;>
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-12-Beta-i386-CHECKSUM}}.
+
# Validate the md5sum imprinted inside the ISO images. First, install the {{package|isomd5sum}} package and then check all ISO files using the {{command|checkisomd5}} command, for example: <pre>for ISO in Fedora-*.iso ; do echo "= $ISO =" ; checkisomd5 $ISO ; echo; done</pre>
# Validate that the published CHECKSUM matches the downloaded ISO files by running the command {{command|sha256sum}}.  For example, you might type: <pre>sha256sum -c Fedora-12-Beta-i386-CHECKSUM</pre>
+
# For all installation ISO images (does '''not''' include Live ISO images), validate the md5sum imprinted inside the ISO image. First, install the {{package|isomd5sum}} package by typing: {{command|yum install isomd5sum}}.  Next, to check all ISO files using the {{command|sha256sum}} command, you might type: <pre>for ISO in Fedora-*.iso ; do echo "= $ISO =" ; checkisomd5 $ISO ; echo; done</pre>
+
 
|results=
 
|results=
# The command {{command|sha256sum}} should return '''OK''' results.  For example:
+
<ol>
#: <pre>
+
<li> The command {{command|sha256sum}} should return '''OK''' results.  For example:
#: $ sha256sum -c Fedora-14-i386-CHECKSUM
+
<pre&lt;noinclude&gt;&lt;/noinclude&gt;>$ sha256sum -c Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM
#: Fedora-14-i386-DVD.iso: OK
+
Fedora-{{FedoraVersionNumber|next}}-i386-DVD.iso: OK
#: Fedora-14-i386-disc1.iso: OK
+
Fedora-{{FedoraVersionNumber|next}}-i386-netinst.iso: OK</pre&lt;noinclude&gt;&lt;/noinclude&gt;>
#: Fedora-14-i386-disc2.iso: OK
+
<li> The command {{command|checkisomd5}} should either return:
#: Fedora-14-i386-disc3.iso: OK
+
<pre>The media check is complete, the result is: PASS.
#: Fedora-14-i386-disc4.iso: OK
+
It is OK to use this media.</pre>
#: Fedora-14-i386-disc5.iso: OK
+
or:
#: Fedora-14-i386-netinst.iso: OK</pre>
+
<pre>The media check is complete, the result is: NA.
# The command {{command|checkisomd5}}, when run against installation ISO images ('''not''' Live ISO images) should indicate that it is '''OK to use this media''' for each ISO image. For example:
+
No checksum information available, unable to verify media.</pre>
#: <pre>
+
</ol>
#: The media check is complete, the result is: PASS.
+
#:
+
#: It is OK to use this media.</pre>
+
 
}}
 
}}
  
 
[[Category:Installer_Image_Sanity_Test_Cases]]
 
[[Category:Installer_Image_Sanity_Test_Cases]]

Latest revision as of 20:51, 30 July 2013

Note.png
Associated release criterion
This test case is associated with the Fedora_21_Alpha_Release_Criteria#correct-checksums 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.
Note.png
Associated release criterion
This test case is associated with the Fedora_21_Final_Release_Criteria#image-consistency-verification 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.


Contents

Description

This test is intended to verify that the posted ISO media matches the published SHA-256 checksum. Additionally, for ISO media that includes an embedded MD5 checksum, this test verifies that checkisomd5 (used by the installer) correctly locates and verifies the embedded MD5 sum.

Setup

  1. Download the .iso media files you need to test
  2. Download the matching CHECKSUM file. For example, Fedora-21-i386-CHECKSUM.

How to test

  1. Validate that the published CHECKSUM matches the downloaded ISO files by running the command sha256sum. For example, you might type:
    sha256sum -c Fedora-21-i386-CHECKSUM
  2. Validate the md5sum imprinted inside the ISO images. First, install the Package-x-generic-16.pngisomd5sum package and then check all ISO files using the checkisomd5 command, for example:
    for ISO in Fedora-*.iso ; do echo "= $ISO =" ; checkisomd5 $ISO ; echo; done

Expected Results

  1. The command sha256sum should return OK results. For example:
    $ sha256sum -c Fedora-21-i386-CHECKSUM
    Fedora-21-i386-DVD.iso: OK
    Fedora-21-i386-netinst.iso: OK
  2. The command checkisomd5 should either return:
    The media check is complete, the result is: PASS.
    It is OK to use this media.

    or:

    The media check is complete, the result is: NA.
    No checksum information available, unable to verify media.