From Fedora Project Wiki

(update example image for the new world order)
(rename "target size" to "maximum size" per https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/thread/ABIGYREPXUPSAMJH3YREQ2PJGXZB4GRF/)
 
(9 intermediate revisions by 3 users not shown)
Line 2: Line 2:


{{QA/Test_Case
{{QA/Test_Case
|description=All ISO images (i.e. {{filename|Server-netinst.iso}}, {{filename|Server-DVD.iso}}, {{filename|Live-Workstation.iso}} and {{filename|Live-KDE.iso}}) must be small enough to fit on the corresponding media. This test does not apply to disk image files (e.g. ARM and Cloud disk images): their compressed size is not relevant to their deployment, and restrictions on their uncompressed size are applied during the compose process.
|description=All ISO images must be small enough to fit on the corresponding media. This test does not apply to disk image files (e.g. ARM and Cloud disk images): their compressed size is not relevant to their deployment, and restrictions on their uncompressed size are applied during the compose process.
|actions=
|actions=
<ol>
==== Automated checking ====
<li>If you have the image downloaded locally, view the size of the file in bytes like this:
You can run this test easily with the {{pkg|relval}} tool. Run {{command|dnf install relval}} to install it, if you do not already have it, on any Fedora system.
 
This will run the size checks for the ''current'' compose, and report them to the wiki:
<pre>$ relval size-check --username <fas_user_name></pre>
 
To run the checks for a specific compose, you can run:
<pre>$ relval size-check --release=NN --milestone=[Alpha,Beta,Final] --compose=COMPOSE --username <fas_user_name></pre>
Example:
<pre>$ relval size-check --release=24 --milestone=Beta --compose=1.6 --username <fas_user_name></pre>
for checking <code>24_Beta-1.6/</code> compose directory.
 
==== Manual checking ====
 
If you have the image downloaded locally, view the size of the file in bytes like this:
<pre>$ du -b Fedora-Server-netinst-x86_64-21_Alpha.iso
<pre>$ du -b Fedora-Server-netinst-x86_64-21_Alpha.iso
419430400 Fedora-Server-netinst-x86_64-21_Alpha.iso</pre></li>
419430400 Fedora-Server-netinst-x86_64-21_Alpha.iso</pre>
<li>If you don't have the image downloaded locally, query the size using HTTP headers like this:
If you don't have the image downloaded locally, query the size using HTTP headers like this:
<pre>$ curl -sI http://server/image.iso | grep Content-Length
<pre>$ curl -sI http://server/image.iso | grep Content-Length
Content-Length: 419430400</pre></li>
Content-Length: 419430400</pre>
<li>Check all ISO files available for this specific compose.</li>
Check all ISO files available for this specific compose.
</ol>
 
|results=
|results=
# The size of '''netinst''' and '''Cloud ISO''' images is less than or equal to '''734,003,200 bytes''' <ref name="700MiB">700 MiB = 700 * 1024^2 bytes = 734003200 bytes (for more information, see [http://en.wikipedia.org/wiki/Mebibyte Mebibyte] and [http://en.wikipedia.org/wiki/CD-ROM#Capacity CD-ROM Capacity])</ref>
# The size of checked images is less than or equal to the size specified as ''maximum size'' at [[Releases/{{FedoraVersionNumber|next}}/ReleaseBlocking]] (or at [[Releases/{{FedoraVersionNumber|next}}/Spins]] for spins not covered on the former page).
# The size of '''DVD''' / '''offline install''' images is less than or equal to '''4,700,000,000 bytes''' <ref name="4.7GB">4.7 GB = 4.7 * 1000^3
bytes = 4700000000 bytes (for more information, see [http://en.wikipedia.org/wiki/Gigabyte Gigabyte] and [http://en.wikipedia.org/wiki/DVD#Capacity DVD Capacity])</ref>
# The size of '''Workstation Live''' images is less than or equal to '''2,000,000,000 bytes''' <ref name="2GB">2 GB = 2000^3 bytes = 2000000000 bytes (for more information, see [http://en.wikipedia.org/wiki/Binary_prefixes#Flash_drives Binary prefixes for Flash drives])</ref><ref>see [[Releases/21/Spins]] for ISO sizes for additional spins</ref>
# The size of '''Multi-Desktop''' DVD images is less than or equal to '''8,500,000,000 bytes''' <ref name="8.5GB">8.5 GB = 8.5 * 1000^3 bytes = 8500000000 bytes (for more information, see [http://en.wikipedia.org/wiki/Gigabyte Gigabyte] and [http://en.wikipedia.org/wiki/DVD#Capacity DVD Capacity])</ref> and is intended for DVD-9 Single-Side (SS) Dual-layer (DL) media
# The size of '''Multi-Install''' DVD installation images is less than or equal to '''8,500,000,000 bytes''' <ref name="8.5GB" /> and is intended for DVD-9 Single-Side (SS) Dual-layer (DL) media
}}
}}
= References =
<references/>


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

Latest revision as of 13:06, 16 September 2019

Associated release criterion
This test case is associated with the Fedora_42_Beta_Release_Criteria#image-size-requirements 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

All ISO images must be small enough to fit on the corresponding media. This test does not apply to disk image files (e.g. ARM and Cloud disk images): their compressed size is not relevant to their deployment, and restrictions on their uncompressed size are applied during the compose process.


How to test

Automated checking

You can run this test easily with the relval tool. Run dnf install relval to install it, if you do not already have it, on any Fedora system.

This will run the size checks for the current compose, and report them to the wiki:

$ relval size-check --username <fas_user_name>

To run the checks for a specific compose, you can run:

$ relval size-check --release=NN --milestone=[Alpha,Beta,Final] --compose=COMPOSE --username <fas_user_name>

Example:

$ relval size-check --release=24 --milestone=Beta --compose=1.6 --username <fas_user_name>

for checking 24_Beta-1.6/ compose directory.

Manual checking

If you have the image downloaded locally, view the size of the file in bytes like this:

$ du -b Fedora-Server-netinst-x86_64-21_Alpha.iso
419430400	Fedora-Server-netinst-x86_64-21_Alpha.iso

If you don't have the image downloaded locally, query the size using HTTP headers like this:

$ curl -sI http://server/image.iso | grep Content-Length
Content-Length: 419430400

Check all ISO files available for this specific compose.

Expected Results

  1. The size of checked images is less than or equal to the size specified as maximum size at Releases/42/ReleaseBlocking (or at Releases/42/Spins for spins not covered on the former page).