QA:Testcase Mediakit ISO Checksums

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(Add output when running checkisomd5 against Multi images)
(use templates, simplify md5 expected results according to current Final criterion)
Line 1: Line 1:
 
{{QA/Test_Case
 
{{QA/Test_Case
|description=This test is intended to verify that the posted ISO media matches the published sha256sum <ref>https://secure.wikimedia.org/wikipedia/en/wiki/SHA-2</ref>.  Additionally, for ISO media that includes an embedded MD5 <ref>https://secure.wikimedia.org/wikipedia/en/wiki/MD5</ref> checksum, this test verifies that {{command|checkisomd5}} (used by the installer) correctly locates and verifies the embedded MD5 sum.
+
|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=
 
|setup=
# Download the {{filename|.iso}} media files you wish to test
+
# Download the {{filename|.iso}} media files you need to test
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-{{FedoraVersion}}-i386-CHECKSUM}}.
+
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM}}.
 
|actions=
 
|actions=
# 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-15-i386-CHECKSUM</pre>
+
# 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;>
# For all {{filename|DVD.iso}}, {{filename|boot.iso}} and {{filename|Live.iso}} images, validate the md5sum imprinted inside the ISO image.  When testing {{filename|Multi-Install.iso}} or {{filename|Multi-Desktop.iso}} DVD images, this step does '''not''' apply. First, install the {{package|isomd5sum}} package by typing: {{command|yum install isomd5sum}}.  Next, to check all ISO files using the {{command|checkisomd5}} command, you might type: <pre>for ISO in Fedora-*.iso ; do echo "= $ISO =" ; checkisomd5 $ISO ; echo; done</pre>
+
# 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>
 
|results=
 
|results=
 
<ol>
 
<ol>
 
<li> The command {{command|sha256sum}} should return '''OK''' results.  For example:
 
<li> The command {{command|sha256sum}} should return '''OK''' results.  For example:
<pre>$ sha256sum -c Fedora-15-i386-CHECKSUM
+
<pre&lt;noinclude&gt;&lt;/noinclude&gt;>$ sha256sum -c Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM
Fedora-15-i386-DVD.iso: OK
+
Fedora-{{FedoraVersionNumber|next}}-i386-DVD.iso: OK
Fedora-15-i386-netinst.iso: OK</pre>
+
Fedora-{{FedoraVersionNumber|next}}-i386-netinst.iso: OK</pre&lt;noinclude&gt;&lt;/noinclude&gt;>
<li> The command {{command|checkisomd5}}, when run against installation or Live ISO images should indicate that it is '''OK to use this media''' for each ISO image.  For example:
+
<li> The command {{command|checkisomd5}} should either return:
 
<pre>The media check is complete, the result is: PASS.
 
<pre>The media check is complete, the result is: PASS.
 
 
It is OK to use this media.</pre>
 
It is OK to use this media.</pre>
The command {{command|checkisomd5}}, when run against ISO images that do not embed a MD5 sum, such as {{filename|Multi-Install.iso}} or {{filename|Multi-Desktop.iso}}, should indicate that '''No checksum information available, unable to verify media.'''.  For example:
+
or:
 
<pre>The media check is complete, the result is: NA.
 
<pre>The media check is complete, the result is: NA.
 
 
No checksum information available, unable to verify media.</pre>
 
No checksum information available, unable to verify media.</pre>
 
</ol>
 
</ol>

Revision as of 13:32, 25 October 2012

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.



References