From Fedora Project Wiki

(split media is gone)
(doh)
 
(9 intermediate revisions by 4 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-15-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-15-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|checkisomd5}} 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-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;>
# 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:
<li> The command {{command|checkisomd5}} should either return:
#: <pre>
<pre>The media check is complete, the result is: PASS.
#: The media check is complete, the result is: PASS.
It is OK to use this media.</pre>
#:
or:
#: It is OK to use this media.</pre>
<pre>The media check is complete, the result is: NA.
No checksum information available, unable to verify media.</pre>
</ol>
}}
}}


[[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 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.
Note.png
Associated release criterion
This test case is associated with the Fedora_40_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-40-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-40-i386-CHECKSUM</pre<noinclude></noinclude>>
  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: <pre<noinclude></noinclude>>$ sha256sum -c Fedora-40-i386-CHECKSUM Fedora-40-i386-DVD.iso: OK Fedora-40-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.