From Fedora Project Wiki

No edit summary
(doh)
 
(12 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 match the downloaded ISO files by running the command {{command|sha256sum}}.  For example, you might type: <pre>sha256sum -c Fedora-12-Beta-i386-CHECKSUM</pre>
# Validate the md5sum imprinted inside the ISO image by running the command {{command|checkisomd5}} (if not available on your system, then "yum install {{package|isomd5sum}}").  For example, to check all ISO files, you might type: <pre>for ISO in Fedora-*.iso ; do echo "= $ISO =" ; checkisomd5 $ISO ; echo; done</pre> (Note: This check is not available for Live images)
<!-- <pre>checkisomd5 Fedora-12-Beta-i386-DVD.iso</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-12-Beta-i386-CHECKSUM
<pre&lt;noinclude&gt;&lt;/noinclude&gt;>$ sha256sum -c Fedora-{{FedoraVersionNumber|next}}-i386-CHECKSUM
#: Fedora-12-Beta-i386-DVD.iso: OK
Fedora-{{FedoraVersionNumber|next}}-i386-DVD.iso: OK
#: Fedora-12-Beta-i386-disc1.iso: OK
Fedora-{{FedoraVersionNumber|next}}-i386-netinst.iso: OK</pre&lt;noinclude&gt;&lt;/noinclude&gt;>
#: Fedora-12-Beta-i386-disc2.iso: OK
<li> The command {{command|checkisomd5}} should either return:
#: Fedora-12-Beta-i386-disc3.iso: OK
<pre>The media check is complete, the result is: PASS.
#: Fedora-12-Beta-i386-disc4.iso: OK
It is OK to use this media.</pre>
#: Fedora-12-Beta-i386-disc5.iso: OK
or:
#: Fedora-12-Beta-i386-netinst.iso: OK</pre>
<pre>The media check is complete, the result is: NA.
# The command {{command|checkisomd5}} 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

Associated release criterion
This test case is associated with the Basic_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.
Associated release criterion
This test case is associated with the Fedora_42_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.


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-42-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: <pre<noinclude></noinclude>>sha256sum -c Fedora-42-i386-CHECKSUM</pre<noinclude></noinclude>>
  2. Validate the md5sum imprinted inside the ISO images. First, install the isomd5sum 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: <pre<noinclude></noinclude>>$ sha256sum -c Fedora-42-i386-CHECKSUM Fedora-42-i386-DVD.iso: OK Fedora-42-i386-netinst.iso: OK</pre<noinclude></noinclude>>
  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.
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_Mediakit_ISO_Checksums&oldid=347372"