From Fedora Project Wiki

(add set up steps)
(improve instructions)
Line 1: Line 1:
{{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=
|setup=
# Set up a NFS server  
# 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:
# Copy the installation {{filename|DVD.iso}} image into the server directory.
#* Install {{package|nfs-utils}}.
{{admon/important|Don't mix images|When testing DVD ISO images, only copy the DVD ISO image for the exact architecture being tested.  Do not mix ISO images from different architectures.}}  
#* 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 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.
# 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>  
# 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/DVD.iso: 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>
}}
}}


Revision as of 15:10, 13 November 2012

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 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.
  2. 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/DVD.iso: 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=311105"