From Fedora Project Wiki

(Corrected list display)
(Updated instructions to exclude Multi-Spin DVD images when testing checkisomd5)
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.
|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.
|setup=
# Download the {{filename|.iso}} media files you wish to test
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-{{FedoraVersion}}-i386-CHECKSUM}}.
|actions=
|actions=
# Download the {{filename|.iso}} media files you wish to test
# Download the matching CHECKSUM file.  For example, {{filename|Fedora-15-i386-CHECKSUM}}.
# 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>sha256sum -c Fedora-15-i386-CHECKSUM</pre>
# For all installation ISO images (including 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>
# 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>
|results=
|results=
<ol>
<ol>
Line 12: Line 13:
Fedora-15-i386-DVD.iso: OK
Fedora-15-i386-DVD.iso: OK
Fedora-15-i386-netinst.iso: OK</pre>
Fedora-15-i386-netinst.iso: OK</pre>
<li> The command {{command|checkisomd5}}, when run against installation ISO images (including Live ISO images) should indicate that it is '''OK to use this media''' for each ISO image.  For example:
<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:
<pre>The media check is complete, the result is: PASS.
<pre>The media check is complete, the result is: PASS.


Line 18: Line 19:
</ol>
</ol>
}}
}}
= References =
<references/>


[[Category:Installer_Image_Sanity_Test_Cases]]
[[Category:Installer_Image_Sanity_Test_Cases]]

Revision as of 19:45, 18 May 2011

Description

This test is intended to verify that the posted ISO media matches the published sha256sum [1]. Additionally, for ISO media that includes an embedded MD5 [2] 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 wish to test
  2. Download the matching CHECKSUM file. For example, Fedora-41-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-15-i386-CHECKSUM
  2. For all DVD.iso, boot.iso and Live.iso images, validate the md5sum imprinted inside the ISO image. When testing Multi-Install.iso or Multi-Desktop.iso DVD images, this step does not apply. First, install the isomd5sum package by typing: yum install isomd5sum. Next, to check all ISO files using the checkisomd5 command, you might type: 
    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-15-i386-CHECKSUM
Fedora-15-i386-DVD.iso: OK
Fedora-15-i386-netinst.iso: OK
  2. The 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: 
    The media check is complete, the result is: PASS.

It is OK to use this media.



References

  1. ↑ https://secure.wikimedia.org/wikipedia/en/wiki/SHA-2
  2. ↑ https://secure.wikimedia.org/wikipedia/en/wiki/MD5
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_Mediakit_ISO_Checksums&oldid=236827"