QA:Testcase install repository NFSISO variation

From FedoraProject

(Difference between revisions)
Jump to: navigation, search
(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

Contents

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 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