From Fedora Project Wiki

(Created NFSISO variation test to verify its 'repo=' method)
 
No edit summary
 
(15 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:Associated_release_criterion|Final|package-and-installer-sources}}
{{QA/Test_Case
{{QA/Test_Case
|description=This test verifies that installing using an NFS installation repository that contains the {{filename|DVD.iso}} by <code>'''repo='''</code> boot option works. See [[Anaconda/Options]] for information on supported boot options.
|description=This is to verify that [[Anaconda]]'s <code>inst.repo</code> [[Anaconda Boot Options|boot option]] works together with a {{filename|DVD.iso}} mounted over an [http://en.wikipedia.org/wiki/Network_File_System NFS protocol]. This is called "NFSISO repository", because it uses the DVD-mounted-over-NFS as a repository.
|setup=
# You need to have a {{filename|DVD.iso}} accessible over an NFS protocol. If you do have it, no further setup is needed. If you don't, set up a NFS share this way:
#* Install {{package|nfs-utils}}.
#* Create a directory that will be shared: <code># mkdir /share</code>
#* Let's say your (virtual) test machine is in the <code>192.168.1.0/24</code> subnet. Put the following line into {{filename|/etc/exports}}: <pre>/share    192.168.1.0/24(ro)</pre>
#* Restart the NFS service: {{command|# systemctl restart nfs-server.service}}
#* Copy the {{filename|DVD.iso}} into {{filename|/share}} directory. Make sure the file has world-readable file permissions.
#* The directory is now accessible over NFS via <code>&lt;your_IP&gt;:/share</code>
# Prepare any non-live media for booting the installer (anything except {{filename|Live.iso}}).
|actions=
|actions=
# Boot the installer using any available means ({{filename|netinst.iso}}, pxeboot images or {{filename|DVD.iso}})
# Before booting the installer, specify a target NFSISO repository by adding a following boot option: <pre>inst.repo=nfs[:options]:<server>:/<path></pre> where <code><path></code> can refer to a directory containing a single {{filename|.iso}} file or multiple {{filename|.iso}} files, or to the {{filename|.iso}} file directly.<br/>Example: <pre>inst.repo=nfs:your_IP:/share/DVD.iso</pre> Make sure the {{filename|.iso}} file architecture matches the architecture of your installer media. You may need to add the nfs version in the command: inst.repo=nfs:nfsvers=4:your_IP:/share/DVD.iso
# Direct anaconda to use the package repo from a NFS server where your DVD iso images are stored by <code>repo=</code> boot command. For example: <pre>repo=nfsiso[:options]:<server>:/<path></pre>  
 
{{admon/tip|{{filename|.ISO}} Detection|If no {{filename|.iso}} is specified in <code><path></code>, Anaconda will try to find a {{filename|.iso}} image in your NFS directory matching the same architecture of your installer media (via the .discinfo on the disc). Make sure to ONLY have the latest DVD build for each architecture in the directory or it may pick wrong DVD!}}
# Proceed with installation
# Proceed with installation
|results=
|results=
# Anaconda uses the package repository from the NFS server provided.  
<ol>
# Install completes successfully
<li>The installer auto-selects requested NFSISO repository as the installation source in its GUI</li>
# Package errors (install.log) should not occur
<li>The requested repository is used to download and install required packages. This can be checked by inspecting {{filename|/tmp/packaging.log}}. Example output:
# System boots successfully
<pre>14:44:07,093 INFO packaging: mounting 192.168.1.1:/share on /mnt/install/source
...
14:44:07,545 DEBUG packaging: adding yum repo anaconda with baseurl file:///mnt/install/source and mirrorlist None
14:44:07,568 DEBUG packaging: disabling repo fedora
14:44:07,569 DEBUG packaging: disabling repo updates-testing
14:44:07,569 DEBUG packaging: disabling repo updates</pre></li>
<li>The installation completes and the new system initiates boot properly</li>
</ol>
}}
}}




[[Category:Repository]]
[[Category:Repository]]
[[Category:Installation Repository NFS ISO]]
[[Category:Installation Repository NFSISO]]

Latest revision as of 13:08, 3 July 2017

Note.png
Associated release criterion
This test case is associated with the Fedora_40_Final_Release_Criteria#package-and-installer-sources 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

This is to verify that Anaconda's inst.repo boot option works together with a DVD.iso mounted over an NFS protocol. This is called "NFSISO repository", because it uses the DVD-mounted-over-NFS as a repository.

Setup

  1. You need to have a DVD.iso accessible over an NFS protocol. If you do have it, no further setup is needed. If you don't, set up a NFS share this way:
    • Install Package-x-generic-16.pngnfs-utils.
    • Create a directory that will be shared: # mkdir /share
    • Let's say your (virtual) test machine is in the 192.168.1.0/24 subnet. Put the following line into /etc/exports: 
      /share    192.168.1.0/24(ro)
    • Restart the NFS service: # systemctl restart nfs-server.service
    • Copy the DVD.iso into /share directory. Make sure the file has world-readable file permissions.
    • The directory is now accessible over NFS via <your_IP>:/share
  2. Prepare any non-live media for booting the installer (anything except Live.iso).

How to test

  1. Before booting the installer, specify a target NFSISO repository by adding a following boot option: 
    inst.repo=nfs[:options]:<server>:/<path>
    where <path> can refer to a directory containing a single .iso file or multiple .iso files, or to the .iso file directly.
    Example: 
    inst.repo=nfs:your_IP:/share/DVD.iso
    Make sure the .iso file architecture matches the architecture of your installer media. You may need to add the nfs version in the command: inst.repo=nfs:nfsvers=4:your_IP:/share/DVD.iso
Idea.png
.ISO Detection
If no .iso is specified in <path>, Anaconda will try to find a .iso image in your NFS directory matching the same architecture of your installer media (via the .discinfo on the disc). Make sure to ONLY have the latest DVD build for each architecture in the directory or it may pick wrong DVD!
  1. Proceed with installation

Expected Results

  1. The installer auto-selects requested NFSISO repository as the installation source in its GUI
  2. The requested repository is used to download and install required packages. This can be checked by inspecting /tmp/packaging.log. Example output: 
    14:44:07,093 INFO packaging: mounting 192.168.1.1:/share on /mnt/install/source
...
14:44:07,545 DEBUG packaging: adding yum repo anaconda with baseurl file:///mnt/install/source and mirrorlist None
14:44:07,568 DEBUG packaging: disabling repo fedora
14:44:07,569 DEBUG packaging: disabling repo updates-testing
14:44:07,569 DEBUG packaging: disabling repo updates
  3. The installation completes and the new system initiates boot properly
Retrieved from "https://fedoraproject.org/w/index.php?title=QA:Testcase_install_repository_NFSISO_variation&oldid=496486"