From Fedora Project Wiki

m (replace 2^20 with 1024^2)
(rename "target size" to "maximum size" per https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/thread/ABIGYREPXUPSAMJH3YREQ2PJGXZB4GRF/)
 
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|image-size-requirements}}
{{QA/Test_Case
{{QA/Test_Case
|description=This test can be used to validate that ISO images (e.g. {{filename|netinst.iso}}, {{filename|DVD.iso}} and Desktop Live Spins <ref>Fedora Desktop Spin images are ''desktop'' (aka GNOME), ''KDE'', ''XFCE'' and ''LXDE''.  For additional information on desktop spins, see http://fedoraproject.org/en/get-fedora-options#desktops.</ref>)  are small enough to fit on the corresponding media.  Depending on the image being tested, there are different constraints for the maximum permitted size (refer to [[#Expected_Results]]).
|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>Inspect the size of '''netinst''' install media.  Either the {{command|du -b}} or the {{command|ls -l}} command can be used to display the sizes of the images in bytes:
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.
<pre>$ du -b Fedora-14-Alpha-x86_64-netinst.iso
 
230686720 Fedora-14-Alpha-x86_64-netinst.iso</pre></li>
This will run the size checks for the ''current'' compose, and report them to the wiki:
<li>Repeat the same inspection, but for the '''Live''' media.</li>
<pre>$ relval size-check --username <fas_user_name></pre> 
<li>Finally, inspect the size of the '''DVD''' media.</li>
 
{{admon/tip|Avoid downloading by inspecting HTTP headers|If you need to check ISO size without downloading the file, you can do that also remotely:
To run the checks for a specific compose, you can run:
<pre>$ curl -sI http://server/image.iso | grep Content-Length</pre>}}
<pre>$ relval size-check --release=NN --milestone=[Alpha,Beta,Final] --compose=COMPOSE --username <fas_user_name></pre>
</ol>
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
419430400 Fedora-Server-netinst-x86_64-21_Alpha.iso</pre>
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
Content-Length: 419430400</pre>
Check all ISO files available for this specific compose.
 
|results=
|results=
# The size of '''netinst''' images is less than or equal to '''734003200 bytes''' <ref name="700MiB">700 MiB = 700 * 1024^2 bytes = 734003200 bytes (for more information, see http://en.wikipedia.org/wiki/Mebibyte and http://en.wikipedia.org/wiki/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 '''Live''' images ...
#* on ''Fedora 16'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/> (see [[Releases/16/Spins]] for ISO sizes for additional spins)
#* on ''Fedora 15'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/> (see [[Releases/15/Spins]] for ISO sizes for additional spins)
#* on ''Fedora 14'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/> (see [[Releases/14/Spins]] for ISO sizes for additional spins)
#* on ''Fedora 13'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/>
# The size of '''DVD''' installation images is less than or equal to '''4700000000 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 and http://en.wikipedia.org/wiki/DVD#Capacity</ref>
<!-- '''734003200 bytes''' (700 MiB = 700 * 1024^2 bytes) -->
<!-- '''1000000000 bytes''' (1 GB = 1000^3 bytes) -->
# The size of '''Multi-Desktop''' DVD images is less than or equal to '''8500000000 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 and http://en.wikipedia.org/wiki/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 '''8500000000 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

Note.png
Associated release criterion
This test case is associated with the Fedora_41_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/41/ReleaseBlocking (or at Releases/41/Spins for spins not covered on the former page).