From Fedora Project Wiki

m (Correct references tag)
(rename "target size" to "maximum size" per https://lists.fedoraproject.org/archives/list/test@lists.fedoraproject.org/thread/ABIGYREPXUPSAMJH3YREQ2PJGXZB4GRF/)
 
(36 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Beta|image-size-requirements}}
{{QA/Test_Case
{{QA/Test_Case
|description=This test validates that ISO images ('''CD''', '''netinst''', '''Live''', and '''DVD''') are small enough to fit on the corresponding media.
|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 '''CD''' and '''netinst''' install media. The {{command|du -b}} 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>
 
</ol>
To run the checks for a specific compose, you can run:
{{admon/tip|Check size over HTTP|If you need to check ISO size without downloading the file, you can do that also remotely:
<pre>$ relval size-check --release=NN --milestone=[Alpha,Beta,Final] --compose=COMPOSE --username <fas_user_name></pre>
<pre>$ curl -sI http://server/image.iso | grep Content-Length</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
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 '''CD''' and '''netinst''' images is less than or equal to '''734003200 bytes''' (700 MiB = 700 * 2^20 bytes).
# 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 is less than or equal to '''1000000000 bytes''' (1 GB = 1000^3 bytes) <ref>As of Fedora 13, live media is intended for USB media keys and not for CD images. For more details on this change, see [[Features/DesktopLiveImageTarget]].</ref>.
# The size of '''DVD''' images is less than or equal to '''4700000000 bytes''' (4.7 GB = 4.7 * 1000^3 bytes).
}}
}}
<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).