From Fedora Project Wiki

(adjust associated_release_criterion template invocation)
No edit summary
 
Line 13: Line 13:
# Prepare any non-live media for booting the installer (anything except {{filename|Live.iso}}).
# Prepare any non-live media for booting the installer (anything except {{filename|Live.iso}}).
|actions=
|actions=
# 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.  
# 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


{{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!}}
{{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!}}

Latest revision as of 13:08, 3 July 2017

Associated release criterion
This test case is associated with the Fedora_42_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 nfs-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
.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"