View source for QA:Testcase biosdevname Automated Kickstart Installation

{{QA/Test_Case
|description=This test scenario make sure that <code>ksdevice=<iface></code> format will handle interface names of the form <code>emN</code> and <code>pci<slot>#<port></code>.  For example passing <code>ksdevice=em1</code> will work without issues.
|setup=
# Make sure hardware requirements are met (see [[Test_Day:2011-01-27_Network_Device_Naming_With_Biosdevname#Prerequisite_for_Test_Day|test day requirements]])
# Download, or [[How_to_build_a_Rawhide_ISO_image_for_testing|create]], installation media (either a {{filename|boot.iso}}, PXE images or a {{filename|DVD.iso}}).  If participating during the [[Test_Day:2011-01-27_Network_Device_Naming_With_Biosdevname|biosdevname test day]], a {{filename|boot.iso}} will be provided on the test day wiki page.
|actions=
<ol>
<li> Create a kickstart file to automate a Fedora installation.  The quickest method is to copy the kickstart file {{filename|/root/anaconda-ks.cfg}} that describes the installation for the existing system.  Adjust the kickstart file to ensure the <code>network</code> keyword specifies the configuration parameters for the network interfaces using the new naming convention.  For example, to configure three devices you might use the kickstart sample below.  More information on kickstart options, and creating a kickstart file can be found at [[Anaconda/Kickstart]]. 
<pre>network --onboot yes --device em1 --bootproto dhcp --ipv6 auto
network --onboot yes --device pci1#2 --bootproto dhcp --ipv6 auto
network --onboot no --device pci1#1  --noipv4 --noipv6 --hostname a-valid-hostname.com</pre>
Once completed, upload the kickstart file to a network location accessible to your system under test.  You can [[Special:Upload|upload your file to the Fedora wiki]], a pastebin.com (or similar) service, or another system on your local network.
<li> Initiate a {{FedoraVersion|long|next}} (or [[Releases/Rawhide|Rawhide]]) installation by booting the installer using any available method (e.g. {{filename|boot.iso}}, PXE images or {{filename|DVD.iso}}).  
<li> At the bootloader screen, press <code>Tab</code> to edit the boot arguments and append <code>ksdevice=em1 ks=http://server/path/to/ks.cfg</code>.  Specify the correct <code>ks=</code> parameter that you chose in ''step#1''.  
<li> Complete the installation, login to the system.
</ol>

|results=
<ol>
<li> Make sure {{filename|ks.cfg}} is retrieved over the network through the interface specified with <code>ksdevice</code> option.  Manual inspection of {{filename|/var/log/anaconda.log}} may be required.
<li> Make sure kickstart installation proceeds without any manual intervention required.
<li> Once you login to the system, make sure that onboard device names are of the form <code>emN</code> as described [[QA:Testcase biosdevname on-board network interface names|here]].  You can inspect the contents of {{filename|/sys/class/net/}} to ensure device names are named properly, for example:
<pre># ls /sys/class/net/
em1  em2  em3  em4  lo</pre>
<li> Make sure that PCI add-in device names are of the form <code>pci<slot>#<port></code>.  As described [[QA:Testcase biosdevname add-in network interface names|here]].  You can inspect the contents of {{filename|/sys/class/net/}} to ensure device names are named properly, for example:
<pre># ls /sys/class/net/
lo  pci3#1 pci3#2 pci4#1</pre>
<li> Make sure the configuration parameters specified in the kickstart file are applied to the specified interfaces.  For example, if you specified a device named <code>em1</code> to be setup to boot automatically using DHCP, verify using the {{command|ifconfig}} command as shown below
<pre># ifconfig em1
em1       Link encap:Ethernet  HWaddr 00:24:E8:2E:DE:FF
          inet addr:172.16.65.55  Bcast:172.16.127.255  Mask:255.255.192.0
          inet6 addr: fe80::224:e8ff:fe2e:deff/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:778483 errors:0 dropped:0 overruns:0 frame:0
          TX packets:95453 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000
          RX bytes:133048578 (126.8 MiB)  TX bytes:25692991 (24.5 MiB)
          Interrupt:36 Memory:d6000000-d6012800</pre>
<li> Make sure {{filename|ifcfg-emN}} and {{filename|ifcfg-pci<slot>#<port>}} files are created under the dir {{filename|/etc/sysconfig/network-scripts}} after the installation is complete.
<pre># cat ifcfg-em3
# Please read /usr/share/doc/initscripts-*/sysconfig.txt
# for the documentation of these parameters.
DEVICE=em3
BOOTPROTO=dhcp
TYPE=Ethernet
HWADDR=00:24:e8:2e:df:03
ONBOOT=yes
USERCTL=no
PEERDNS=yes
IPV6INIT=no

# cat ifcfg-pci3#1
# Please read /usr/share/doc/initscripts-*/sysconfig.txt
# for the documentation of these parameters.
DEVICE='pci3#1'
BOOTPROTO=dhcp
TYPE=Ethernet
HWADDR=00:1b:21:44:63:40
ONBOOT=yes
USERCTL=no
PEERDNS=yes
IPV6INIT=no</pre>
</ol>
}}

[[Category: Package biosdevname test cases]]