From Fedora Project Wiki

(add F17, remove older releases)
(use FedoraVersionNumber template for the Spins page link so it stays up to date)
(20 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 '''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 '''Live''' images ...
# 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
#* on ''Fedora 17'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/> (see [[Releases/17/Spins]] for ISO sizes for additional spins)
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>
#* on ''Fedora 16'', is less than or equal to '''734003200 bytes''' <ref name="700MiB"/> (see [[Releases/16/Spins]] for ISO sizes for additional spins)
# 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>
# 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  
# The size of '''KDE Live''' images is less than or equal to '''1,400,000,000 bytes''' <ref name="1.4GB">1.4 GB = 1400^3 bytes = 1400000000 bytes (for more information, see [http://en.wikipedia.org/wiki/Binary_prefixes#Flash_drives Binary prefixes for Flash drives])</ref><ref>see [[Releases/{{FedoraVersionNumber|next}}/Spins]] for ISO sizes for additional spins</ref>
bytes = 4700000000 bytes (for more information, see http://en.wikipedia.org/wiki/Gigabyte and http://en.wikipedia.org/wiki/DVD#Capacity</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
<!-- '''734003200 bytes''' (700 MiB = 700 * 1024^2 bytes) -->
# 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
<!-- '''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 =

Revision as of 09:17, 17 May 2016

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 netinst and Cloud ISO images is less than or equal to 734,003,200 bytes [1]
  2. The size of DVD / offline install images is less than or equal to 4,700,000,000 bytes [2]
  3. The size of Workstation Live images is less than or equal to 2,000,000,000 bytes [3]
  4. The size of KDE Live images is less than or equal to 1,400,000,000 bytes [4][5]
  5. The size of Multi-Desktop DVD images is less than or equal to 8,500,000,000 bytes [6] and is intended for DVD-9 Single-Side (SS) Dual-layer (DL) media
  6. The size of Multi-Install DVD installation images is less than or equal to 8,500,000,000 bytes [6] and is intended for DVD-9 Single-Side (SS) Dual-layer (DL) media



References

  1. 700 MiB = 700 * 1024^2 bytes = 734003200 bytes (for more information, see Mebibyte and CD-ROM Capacity)
  2. 4.7 GB = 4.7 * 1000^3 bytes = 4700000000 bytes (for more information, see Gigabyte and DVD Capacity)
  3. 2 GB = 2000^3 bytes = 2000000000 bytes (for more information, see Binary prefixes for Flash drives)
  4. 1.4 GB = 1400^3 bytes = 1400000000 bytes (for more information, see Binary prefixes for Flash drives)
  5. see Releases/41/Spins for ISO sizes for additional spins
  6. 6.0 6.1 8.5 GB = 8.5 * 1000^3 bytes = 8500000000 bytes (for more information, see Gigabyte and DVD Capacity)