From Fedora Project Wiki

m (Added missing category)
(146 intermediate revisions by 16 users not shown)
Line 1: Line 1:
{{autolang|base=yes}}
{{Infobox_group
{{Infobox_group
| name = Fedora Test Days
| name = Consistent Network Device Naming feature
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_15_test_days]]
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_15_test_days]]
| caption = [[Test_Day:2011-01-27_Network_Device_Naming_With_Biosdevname|Network Device Naming With Biosdevname]]
| caption = [[Features/ConsistentNetworkDeviceNaming|Network Device Naming With Biosdevname]]
| date = Thursday, January 27, 2011
| date = ongoing
| time = all day
| website = [[QA/Fedora_15_test_days]]
| irc = [irc://irc.freenode.net/#fedora-test-day #fedora-test-day] ([http://webchat.freenode.net/?channels=fedora-test-day webirc])
| fedora_mailing_list = test
}}
}}


Line 14: Line 12:
== What to test? ==
== What to test? ==


Today's installment of Fedora Test Day will focus on '''Network Interface Naming in Fedora Rawhide'''
Today's installment of Fedora Test Day will focus on '''[[Features/ConsistentNetworkDeviceNaming#Consistent_Network_Device_Naming|Network Interface Naming]]'''.


*[https://fedoraproject.org/wiki/Features/ConsistentNetworkDeviceNaming#Consistent_Network_Device_Naming  Fedora Feature Request]
Traditionally network interfaces in Linux are named ethN. With multiple network adapters, both onboard and add-in, single and multiport, in modern server platforms, the naming of these interfaces is non-deterministic. Specifically, ''eth0'' does not always map to ''Gb1'' or ''Embedded NIC 1'' as named on the server chassis. This makes the existing naming not very user friendly for administration.  


Traditionally network interfaces in Linux are named ethN. With multiple network adapters, both onboard and add-in, single and multiport, in modern Server platforms, the naming of these interfaces is non-deterministic. In specific, 'eth0 does not always map to Gb1 or 'Embedded NIC 1' as named on the server chassis. This makes the existing naming not very user friendly for administration.  
This issue is addressed by assigning names to network interfaces based on their physical location on the system board.  [http://linux.dell.com/biosdevname/ Biosdevname], which is a Dell developed utility, can suggest names to network interfaces, which are physical location based.


This issue is addressed by assigning names to network interfaces based on their physical location on the system board. Biosdevname which is a Dell developed utility, can suggest names to network interfaces, which are physical location based.
The naming convention followed is:
* [http://linux.dell.com/biosdevname/ Biosdevname]
* Embedded devices: <code>em<port></code>  [https://fedoraproject.org/wiki/File:Onboard_Network_Adapters.jpg Image]
* Add-in PCI cards: <code>pci<slot>#<port>_<virtual-function-instance></code> [https://fedoraproject.org/wiki/File:PCI_Addin_Network_Adapters.jpg Image]


Naming convention followed is -
Please find an example {{filename|ifconfig}} output from this naming convention [https://fedoraproject.org/wiki/QA:Testcase_biosdevname_Example_Ifconfig_Output here]
 
* Embedded devices: em<port>
* Add-in PCI cards: pci<slot>#<port>_<virtual function instance>


Please refer to the following link for more details on the issue itself and various solutions we proposed upstream to address this issue which were unsuccessful.
Please refer to the following link for more details on the issue itself and various solutions we proposed upstream to address this issue which were unsuccessful.


* [http://linux.dell.com/wiki/index.php/Oss/libnetdevname#Implementation  Unsuccessful Attempts to Address This Issue]
* [http://linux.dell.com/wiki/index.php/Oss/libnetdevname#Implementation  Unsuccessful Attempts to Address This Issue]
* [http://linux.dell.com/files/presentations/Linux_Plumbers_Conf_2010/matt-domsch-network-device-naming.pdf Linux Plumbers Conf 2010 by Matt Domsch]
* [http://linux.dell.com/files/presentations/Linux_Plumbers_Conf_2010/matt-domsch-network-device-naming.pdf Linux Plumbers Conf 2010 presentation by Matt Domsch]


== Who's available ==
== Prerequisite for Test Day ==  


=== Hardware Requirements ===


* [[User:Narendrak|Narendra K]] (irc_nick1) will be your host for the day.
A [[:File:Biosdevname-support-check.sh|script is available]] to determine whether your system will be impacted by the {{package|biosdevname}} change.  The following example shows how to run the script to determine whether your hardware can be used during the Test Day.('''Ensure that you have dmidecode package installed before running the script''')


The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...
<pre>
$ su -c 'curl -s https://fedoraproject.org/w/uploads/3/38/Biosdevname-support-check.sh | bash'
Password:
Checking hardware requirements                            [  OK  ]
Checking for SMBIOS type 41 support                        [  OK  ]
Checking for SMBIOS type 9 support                        [  OK  ]
Checking for PCI Interrupt Routing support                [  OK  ]
</pre>


* Quality Assurance - [[User:Tester1|Tester1]] (irc_nick3), [[User:Tester2|Tester2]] (irc_nick4), [[User:Tester3|Tester3]] (irc_nick5)
If the output of the script is <code>[ <span style="color:green;">OK</span>  ]</code> and ''any'' of the following checks is <code>[ <span style="color:green;">OK</span>  ]</code>, your hardware is supported by biosdevname and you can take part in the Test Day.


== Prerequisite for Test Day ==
For reference, the hardware requirements are:


* Hardware Requirements
# A system (servers, laptop, or desktop) with one or more onboard network adapter(s) and/or one or more add-in network adapter(s)
** Computer system (Servers/Laptops/Desktops) with onboard(Lan-On-Motherboard) network adapters and/or add-in network adapters.
# System firmware/BIOS should implement an SMBIOS type 41 or type 9 record, or PCI Interrupt Routing
*** Single and multiport add-in network adapters with SRIOV capability
# Requirements for Testing a SR-IOV capable network adapter
## SR-IOV support (enabled in BIOS if BIOS provides the option)
## Single and multiport add-in network adapters with SRIOV capability


* It is strongly advised that your hardware profile uploaded to [http://www.smolts.org Smolt] according to [http://smolts.org/smolt-wiki/Main_Page#Usage these instructions]
For more information on SR-IOV Please see [http://en.community.dell.com/dell-blogs/enterprise/b/tech-center/archive/2010/11/17/rhel-6-up-and-running-with-sr-iov-on-dell-poweredge-servers.aspx here]


It is strongly advised that you upload your hardware profile uploaded to [http://www.smolts.org Smolt] according to [http://smolts.org/smolt-wiki/Main_Page#Usage these instructions]


* Firmware/BIOS requirements
{{admon/important|Smolt not working?|Is smolt crashing or otherwise not working in Rawhide?  A temporary fix is available to address [http://bugzilla.redhat.com/673015 bug#673015].  Packages are [http://koji.fedoraproject.org/koji/taskinfo?taskID{{=}}2745512 available] in the koji build system.  To upgrade the <code>smolt</code> package(s), with <code>root</code> permissions, type:
** System firmware/BIOS should implement SMBIOS version 2.6.
<pre>
** System firmware/BIOS should implement SMBIOS type 41 record which defines a device type instance and string for onboard devices (network adapters included)
yum update "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-1.4.3-2.jlaska.fc15.noarch.rpm" \
  "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-firstboot-1.4.3-2.jlaska.fc15.noarch.rpm" \
  "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-gui-1.4.3-2.jlaska.fc15.noarch.rpm"
</pre>
}}


* Software Requirements
=== Software Requirements ===
** The system should be updated to Fedora Rawhide
** The SMBIOS type 41 device type instance and string should be available in sysfs. Other OEMs might export this information in a different SMBIOS type. If it is exported to sysfs, look for the following sysfs links.


<pre>[root@fedora-14-r710 ~]# lspci | grep -i ether
# Fedora Rawhide
01:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
# ''Optional'' - the SMBIOS type 41 device type instance and string should be available in sysfs. This will be available in sysfs '''only''' when BIOS implements type 41. If type 41 is not implemented, then <code>$PIRQ</code> will be the fallback and this attribute will not be available in sysfs. This attribute is available on kernels with version >= 2.6.36 (includes Rawhide)
01:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
02:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
02:00.1 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
 
[root@fedora-14-r710 ~]# find /sys/ -name index
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0/index
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.1/index
/sys/devices/pci0000:00/0000:00:03.0/0000:02:00.0/index
/sys/devices/pci0000:00/0000:00:03.0/0000:02:00.1/index
 
[root@fedora-14-r710 ~]# find /sys/ -name label
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.0/label
/sys/devices/pci0000:00/0000:00:01.0/0000:01:00.1/label
/sys/devices/pci0000:00/0000:00:03.0/0000:02:00.0/label
/sys/devices/pci0000:00/0000:00:03.0/0000:02:00.1/label
</pre>


== How to test? ==
== How to test? ==
Line 84: Line 77:
# Network interface names ''after'' installation is completed (after you login for first time)
# Network interface names ''after'' installation is completed (after you login for first time)
# Required changes available in {{filename|ifcfg-ethN}} config files
# Required changes available in {{filename|ifcfg-ethN}} config files
# ''Upgrading'' from a previous update (Say Fedora 14) to Fedora [[Releases/Rawhide|Rawhide]] does not affect the naming scheme that existed in the previous update (Say Fedora 14).
# ''Upgrading'' from a previous release (Fedora 14) to Fedora [[Releases/Rawhide|Rawhide]] does not affect the naming scheme that existed in the previous release
 
=== '''Install or upgrade to Rawhide''' ===
 
There are several ways to set up your test system.
 
{{anchor|update}}
==== Upgrading From Fedora 14 to Rawhide ====
 
* You can upgrade an already installed Fedora 14 system using {{command|yum}} - for guidance, see [[Releases/Rawhide#Yum_update_from_previous_release|yum update from previous release]]
 
{{anchor|install}}
==== Install Rawhide ====


=== '''Update your machine''' / '''Available Rawhide Installation Methods''' ===
* You can install Rawhide with [http://fedoraproject.org/get-fedora Fedora 14 ISO media] - for guidance, see [[Releases/Rawhide#Using_a_general_release_Fedora_ISO|Install Rawhide using Fedora 14 ISO]]
* Or you can use a special Rawhide install image provided for this test day - [http://jlaska.fedorapeople.org/test-day/i386 i386] or [http://jlaska.fedorapeople.org/test-day/x86_64 x86_64] {{filename|boot.iso}}. For guidance, see [http://docs.fedoraproject.org/en-US/Fedora/14/html/Installation_Guide/index.html the installation guide]
* NOTE: if you use the rawhide install image, be aware that the 01-27 rawhide repo may be broken, try pointing to the previous day's rawhide repo instead: [http://kojipkgs.fedoraproject.org/mash/rawhide-20110126/rawhide/x86_64/os/ x86_64 01-26 rawhide repo] or [http://kojipkgs.fedoraproject.org/mash/rawhide-20110126/rawhide/i386/os/ i386 01-26 rawhide repo]


There are several ways to upgrade your test system.
{{anchor|live}}
# Upgrade from Fedora 14 to Fedora Rawhide using {{command|yum}} -- for guidance, see [[Releases/Rawhide#Yum_update_from_previous_release|yum update from previous release]]
# Install Fedora Rawhide using [http://fedoraproject.org/get-fedora Fedora 14 ISO media] -- for guidance, see [[Releases/Rawhide#Using_a_general_release_Fedora_ISO|Install rawhide using Fedora 14 ISO]]
# Download and boot a [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ Fedora Rawhide live image] -- for guidance, see [[How_to_create_and_use_Live_USB]]


== Test Cases ==
==== Boot into a Rawhide live image ====


'''Upgrade Testing'''
* You can download and boot a [http://alt.fedoraproject.org/pub/alt/nightly-composes/desktop/ Fedora Rawhide live image] - for guidance, see [[How_to_create_and_use_Live_USB]]
* [[QA:Testcase_Upgrade | Verify upgrade from Fedora 14 to Rawhide]]


'''Install Time Testing'''
=== Complete the Test Cases ===


The test cases in this category need to be executed when installation of Rawhide is in progress.
{{admon/important|Updates required|Due to [http://bugzilla.redhat.com/672603 bug#672603], an updates.img is required to complete a Rawhide installation.  The updates.img is available at http://jlaska.fedorapeople.org/updates/672603.img.  Instructions for using an updates.img are available at [[Anaconda/Updates]].}}


* [[QA:Testcase_Install_Time_Network_Interface_Names | Verify that Onboard and Add-in Interfaces are named as expected during Install Time]]
'''Upgrade Testing''' - These test cases should be executed when upgrading a Fedora 14 system to Rawhide. Please refer to the section [[#update|Upgrading From Fedora 14 to Rawhide]] above.
<ol>
<li> [[QA:Testcase biosdevname NIC rules persist after upgrade]] - Verify upgrade from Fedora 14 to Rawhide
<li> To have your system make use of the "new" names after upgrade, you need to change the device name rules in {{filename|/etc/udev/rules.d/70-persistent-net.rules}} and any references to the old devices in {{filename|/etc/sysconfig/network-scripts/ifcfg-eth*}}.  A [[:File:Biosdevname-upgrade-iface-names.sh|script is available]] to convert device names.
<pre>$ su -c 'curl -s https://fedoraproject.org/w/uploads/d/da/Biosdevname-upgrade-iface-names.sh | bash'</pre>
The script renames the existing ifcfg-ethN files to match the new names, i.e ifcfg-emN and ifcfg-pciM#N names and changes the relevant fields in the ifcfg-emN file such as DEVICE to match the new name. The Script also makes changes to the matching rules in {{filename|/etc/udev/rules.d/70-persistent-net.rules}} so that devices for which biosdevname cannot suggest a name are retained as they are.  After reboot, your system should now be using the new names.
</ol>


'''Run Time Testing'''  
'''Install Time Testing''' - The test cases in this category should be executed when performing a new Rawhide installation. Please refer to the section [[#install|Install Rawhide]] above.


The test cases in this category need to be executed when you are booted into Fedora Live Image.
# [[QA:Testcase biosdevname NIC naming after install]] - Verify that onboard and add-in interfaces are named as expected during install time
# [[QA:Testcase biosdevname Automated Kickstart Installation]] - Unattended/automated kickstart installation using ksdevice=emN option


* [[QA:Testcase_Onboard_Network_Interface_Names | Verify that onboard interfaces are named as emN]]
'''Run Time Testing''' - The test cases in this category should be executed when running a fresh Rawhide - either from the [[#live|live image]], or after performing a [[#install|new Rawhide installation]].
* [[QA:Testcase_PCI_Add-In-Network-Interace_Names | Verify that PCI add-in interfaces are named as pci<slot>#<port>]]
* [[QA:Testcase__SRIOV_Virtual_Function_Interface_Names| Verify that Virtual Function Interfaces are named as pci<slot>#<port>_<virtual function instance>]]
* [[QA:Testcase_Interface_Configuration | Verify that onboard, Add-in, Add-in Virtual Function interfaces can be configured]]


== Test Results ==
# [[QA:Testcase biosdevname on-board network interface names]] - Verify that onboard interfaces are named as <code>emN</code>
# [[QA:Testcase biosdevname add-in network interface names]] - Verify that PCI add-in interfaces are named as <code>pci<slot>#<port></code>
# [[QA:Testcase biosdevname SRIOV virtual function interface names]] - Verify that Virtual Function interfaces are named as <code>pci<slot>#<port>_<virtual-function-instance></code>
# [[QA:Testcase biosdevname interface configuration]] - Verify that onboard, add-in, and add-in Virtual Function interfaces can be configured


Construct a table or list to allow testers to post results.  Each column should be a test case or configuration, and each row should consist of test results. Include some instructions on how to report bugs, and any special instructions. Here's an example, from a Palimpsest test day:
=== Report your results ===


If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=udisks udisks], or [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=13&component=gnome-disk-utility gnome-disk-utility] for bugs in the Palimpsest graphical front end itself. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one, and the second should be a link to the Smolt profile of the system you tested. For each test case, if your system worked correctly, simply enter the word '''PASS'''. If you had trouble, enter the word '''FAIL''', with a footnote indicator, and put a link to the bug report in the References column (as in the example line). For tests you could not perform, enter a dash.
If you have problems with any of the tests, report a bug to [https://bugzilla.redhat.com Bugzilla] usually for the component [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&version=rawhide&component=biosdevname biosdevname]. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one, and the second should be a link to the Smolt profile of the system you tested. For each test case, use the ''result'' template to enter your result, as shown in the example result line.
 
Useful information to include in your bugzilla report include output from:
sudo /sbin/biosdevname -d
sudo /usr/sbin/dmidecode
sudo /usr/sbin/biosdecode
lspci -tv


{|
{|
! User
! User
! Smolt Profile
! Smolt Profile
! [[QA:Testcase_Upgrade | persistent rules]]
! [[QA:Testcase biosdevname NIC naming after install|install]]
! [[QA:Testcase_Onboard_Network_Interface_Names | onboard devices]]
! [[QA:Testcase biosdevname NIC rules persist after upgrade|upgrade]]
! [[QA:Testcase_PCI_Add-In-Network-Interace_Names | add-in devices]]
! [[QA:Testcase_biosdevname_Automated_Kickstart_Installation|kickstart]]
! [[QA:Testcase__SRIOV_Virtual_Function_Interface_Names| virtual iface]]
! [[QA:Testcase biosdevname on-board network interface names|on-board]]
! [[QA:Testcase_Interface_Configuration | device config]]
! [[QA:Testcase biosdevname add-in network interface names|add-in]]
! [[QA:Testcase_Install_Time_Network_Interface_Names | name durint install]]
! [[QA:Testcase biosdevname SRIOV virtual function interface names|SRIOV]]
! [[QA:Testcase biosdevname interface configuration|iface configuration]]
! References
! References
|-
|-
| [[User:SampleUser|Sample User]]
| [[User:SampleUser|Sample User]]
| [http://www.smolts.org/client/show/pub_84465125-1350-4f83-87b9-5f16f7430eb8 HW]
| [http://www.smolts.org/client/show/pub_84465125-1350-4f83-87b9-5f16f7430eb8 HW]
| {{result|none}}  
| {{result|pass}}  
| {{result|pass}}
| {{result|unknown}}
| {{result|inprogress}}
| {{result|inprogress}}
| {{result|none}}
| {{result|pass}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-
|-
| [[User:Shyam Iyer|shyam_iyer]]
| [http://www.smolts.org/client/show/pub_6dcb75bd-1c81-41c0-8654-7bb76f4d1069 HW] <ref>This is a Dell PER 710 with 4 onboard Nics</ref> <ref>Encountered issue in uploading the smolt profile {{bz|673015}}</ref>
| {{result|warn}} <ref>Encountered issue in rawhide installs {{bz|671981}}</ref> <ref> Applied workaround in RH BZ 673192</ref>
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}} <ref> For upgrades to rawhide refer to script for changing to emN naming</ref>
| <references/>
|-
|-
| [[User:Shyam Iyer|shyam_iyer]]
| [HW] <ref>This is a Dell SC 1435 with 2 onboard Nics</ref> <ref>Encountered issue in uploading the smolt profile {{bz|673015}}</ref>
| {{result|warn}} <ref>Encountered issue in rawhide installs {{bz|671981}}</ref> <ref> Applied workaround in RH BZ 673192</ref>
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}} <ref> For upgrades to rawhide refer to script for changing to emN naming</ref>
| <references/>
|-
| [[User:paniraj|Paniraja KM]]
| Tested on Dell PowerEdge R510, R610 and R415
| {{result|fail}}
| {{result|pass}}
| {{result|fail}}
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:Dramsey|David Ramsey]]
| Add 32-bit Smolt Profile HW URL <ref>Dell Precision eight core with i686 support</ref>
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:Dramsey|David Ramsey]]
| Add 64-bit Smolt Profile HW URL <ref>Dell Precision eight core with x86_64 support</ref>
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:Ykopkova|Yulia Kopkova]]
| [http://www.smolts.org/client/show/pub_0b6c3ed0-2ab9-4f0a-a192-3480f0f46611 HW] <ref>Dell OptiPlex GX620</ref>
| {{result|pass}} <ref name="672603"> {{bz|672603}}</ref>
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:Srinivas|Srinivas Gowda]]
| Add Smolt Profile HW URL
| {{result|pass}}
| {{result|pass}}
| {{result|inprogress}}
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:taousif|Taousif Ansari]]
| HW <ref>Dell PER900 with QP LOM BCM5708, Intel 82598EB 10-Gigabit, SP Broadcom BCM5709 10Gig, DP Broadcom BCM57710 1Gig</ref>
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}<ref> </ref>
| <references/>
|-
| [[User:jlaska|James Laska]]
| [http://www.smolts.org/client/show/pub_ae9f18ba-cf95-40f3-9fab-9d5f65ec8586 HW] <ref>KVM guest on F14 host</ref>
| {{result|fail}} <ref name="673192">{{bz|673192}} - initramfs.img not created after install ... attempting to work around ...</ref> <ref>{{bz|673238}} - anaconda creates incorrect udev 70-persistent-net.rules entry for network device</ref>
| {{result|pass}} <ref name="673158">Updates.img required to work around {{bz|673158}}</ref>
| {{result|fail}} <ref name="673160">{{bz|673160}} - Anaconda fails to activate the device when ksdevice=pciM#N is passed</ref>
| {{result|unknown}}
| {{result|warn}} <ref>{{bz|673268}} - Rawhide installer sees pci2#1 and eth1</ref>
| {{result|unknown}}
| {{result|unknown}}
| <references/>
|-
| [[User:ashishbunkar|Ashish Bunkar]]
| HW <ref>Dell PER905 with QP LOM,Intel Sp-10-Gigabit, DP Qlogic 10Gig</ref>
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}<ref> </ref>
| <references/>
|-
| [[User:Elemc|Alexei Panov]]
| [http://www.smolts.org/client/show/pub_beb6303e-5a5e-4d42-98b6-1aa52fb0396e HW]<ref>Core i5 760 on MB Intel DH55HC</ref>
| {{result|pass}}
| {{result|unknown}}
| {{result|unknown}}
| {{result|pass}}
| {{result|pass}}
| {{result|unknown}}
| {{result|pass}}
| <references/>
|-
| [[User:Narendrak|Narendra K]]
| HW
| {{result|pass}}
| {{result|none}}
| {{result|fail}} <ref name="673160">{{bz|673160}} - Anaconda fails to activate the device when ksdevice=pciM#N is passed</ref>
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| {{result|pass}}
| | <references/>
|-
| [[User:Jcm|Jon Masters]]
| Add 64-bit Smolt Profile HW URL
| {{result|none}}
| {{result|warn}} <ref>works as expected, however "Biosdevname-support-check" doesn't catch dmidecode not installed, and "Biosdevname-upgrade-iface-names" did not work - had to manually edit config files and remove udev persistent net configs, let them regenerate.</ref>
| {{result|none}}
| {{result|pass}} <ref>Using Dell PER610, em1-em4 were created successfully.</ref>
| {{result|none}}
| {{result|none}}
| {{result|pass}} <ref>Once I removed the old config files/cleaned up files not handled by the "Biosdevname-upgrade-iface-names" script, it all worked.</ref>
| <references/>
| <references/>
|-
|-
|}
|}


[[Category:Test Days]]
[[Category:Test Days]] [[Category:Fedora 15 Test Days]]
[[Category:QA Templates]]

Revision as of 13:11, 14 June 2013

Consistent Network Device Naming feature
Echo-testing-48px.png
Network Device Naming With Biosdevname

Date ongoing


Note.png
Can't make the date?
If you come to this page before or after the test day is completed, your testing is still valuable, and you can use the information on this page to test, file any bugs you find at Bugzilla, and add your results to the results section. If this page is more than a month old when you arrive here, please check the current schedule and see if a similar but more recent Test Day is planned or has already happened.

What to test?

Today's installment of Fedora Test Day will focus on Network Interface Naming.

Traditionally network interfaces in Linux are named ethN. With multiple network adapters, both onboard and add-in, single and multiport, in modern server platforms, the naming of these interfaces is non-deterministic. Specifically, eth0 does not always map to Gb1 or Embedded NIC 1 as named on the server chassis. This makes the existing naming not very user friendly for administration.

This issue is addressed by assigning names to network interfaces based on their physical location on the system board. Biosdevname, which is a Dell developed utility, can suggest names to network interfaces, which are physical location based.

The naming convention followed is:

  • Embedded devices: em<port> Image
  • Add-in PCI cards: pci<slot>#<port>_<virtual-function-instance> Image

Please find an example ifconfig output from this naming convention here

Please refer to the following link for more details on the issue itself and various solutions we proposed upstream to address this issue which were unsuccessful.

Prerequisite for Test Day

Hardware Requirements

A script is available to determine whether your system will be impacted by the Package-x-generic-16.pngbiosdevname change. The following example shows how to run the script to determine whether your hardware can be used during the Test Day.(Ensure that you have dmidecode package installed before running the script)

$ su -c 'curl -s https://fedoraproject.org/w/uploads/3/38/Biosdevname-support-check.sh | bash' 
Password: 
Checking hardware requirements                             [  OK  ]
Checking for SMBIOS type 41 support                        [  OK  ]
Checking for SMBIOS type 9 support                         [  OK  ]
Checking for PCI Interrupt Routing support                 [  OK  ]

If the output of the script is [ OK ] and any of the following checks is [ OK ], your hardware is supported by biosdevname and you can take part in the Test Day.

For reference, the hardware requirements are:

  1. A system (servers, laptop, or desktop) with one or more onboard network adapter(s) and/or one or more add-in network adapter(s)
  2. System firmware/BIOS should implement an SMBIOS type 41 or type 9 record, or PCI Interrupt Routing
  3. Requirements for Testing a SR-IOV capable network adapter
    1. SR-IOV support (enabled in BIOS if BIOS provides the option)
    2. Single and multiport add-in network adapters with SRIOV capability

For more information on SR-IOV Please see here

It is strongly advised that you upload your hardware profile uploaded to Smolt according to these instructions

Important.png
Smolt not working?
Is smolt crashing or otherwise not working in Rawhide? A temporary fix is available to address bug#673015. Packages are available in the koji build system. To upgrade the smolt package(s), with root permissions, type:
yum update "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-1.4.3-2.jlaska.fc15.noarch.rpm" \
  "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-firstboot-1.4.3-2.jlaska.fc15.noarch.rpm" \
  "http://koji.fedoraproject.org/koji/getfile?taskID=2745512&name=smolt-gui-1.4.3-2.jlaska.fc15.noarch.rpm"

Software Requirements

  1. Fedora Rawhide
  2. Optional - the SMBIOS type 41 device type instance and string should be available in sysfs. This will be available in sysfs only when BIOS implements type 41. If type 41 is not implemented, then $PIRQ will be the fallback and this attribute will not be available in sysfs. This attribute is available on kernels with version >= 2.6.36 (includes Rawhide)

How to test?

At a high level, the testing will focus on

  1. Network interface names during install time
  2. Network interface names after installation is completed (after you login for first time)
  3. Required changes available in ifcfg-ethN config files
  4. Upgrading from a previous release (Fedora 14) to Fedora Rawhide does not affect the naming scheme that existed in the previous release

Install or upgrade to Rawhide

There are several ways to set up your test system.

Upgrading From Fedora 14 to Rawhide

Install Rawhide

Boot into a Rawhide live image

Complete the Test Cases

Important.png
Updates required
Due to bug#672603, an updates.img is required to complete a Rawhide installation. The updates.img is available at http://jlaska.fedorapeople.org/updates/672603.img. Instructions for using an updates.img are available at Anaconda/Updates.

Upgrade Testing - These test cases should be executed when upgrading a Fedora 14 system to Rawhide. Please refer to the section Upgrading From Fedora 14 to Rawhide above.

  1. QA:Testcase biosdevname NIC rules persist after upgrade - Verify upgrade from Fedora 14 to Rawhide
  2. To have your system make use of the "new" names after upgrade, you need to change the device name rules in /etc/udev/rules.d/70-persistent-net.rules and any references to the old devices in /etc/sysconfig/network-scripts/ifcfg-eth*. A script is available to convert device names.
    $ su -c 'curl -s https://fedoraproject.org/w/uploads/d/da/Biosdevname-upgrade-iface-names.sh | bash'

    The script renames the existing ifcfg-ethN files to match the new names, i.e ifcfg-emN and ifcfg-pciM#N names and changes the relevant fields in the ifcfg-emN file such as DEVICE to match the new name. The Script also makes changes to the matching rules in /etc/udev/rules.d/70-persistent-net.rules so that devices for which biosdevname cannot suggest a name are retained as they are. After reboot, your system should now be using the new names.

Install Time Testing - The test cases in this category should be executed when performing a new Rawhide installation. Please refer to the section Install Rawhide above.

  1. QA:Testcase biosdevname NIC naming after install - Verify that onboard and add-in interfaces are named as expected during install time
  2. QA:Testcase biosdevname Automated Kickstart Installation - Unattended/automated kickstart installation using ksdevice=emN option

Run Time Testing - The test cases in this category should be executed when running a fresh Rawhide - either from the live image, or after performing a new Rawhide installation.

  1. QA:Testcase biosdevname on-board network interface names - Verify that onboard interfaces are named as emN
  2. QA:Testcase biosdevname add-in network interface names - Verify that PCI add-in interfaces are named as pci<slot>#<port>
  3. QA:Testcase biosdevname SRIOV virtual function interface names - Verify that Virtual Function interfaces are named as pci<slot>#<port>_<virtual-function-instance>
  4. QA:Testcase biosdevname interface configuration - Verify that onboard, add-in, and add-in Virtual Function interfaces can be configured

Report your results

If you have problems with any of the tests, report a bug to Bugzilla usually for the component biosdevname. If you are unsure about exactly how to file the report or what other information to include, just ask on IRC and we will help you. Once you have completed the tests, add your results to the Results table below, following the example results from the first line as a template. The first column should be your name with a link to your User page in the Wiki if you have one, and the second should be a link to the Smolt profile of the system you tested. For each test case, use the result template to enter your result, as shown in the example result line.

Useful information to include in your bugzilla report include output from:

sudo /sbin/biosdevname -d
sudo /usr/sbin/dmidecode
sudo /usr/sbin/biosdecode
lspci -tv
User Smolt Profile install upgrade kickstart on-board add-in SRIOV iface configuration References
Sample User HW
Pass pass
Inprogress inprogress
none
Pass pass
Warning warn
[1]
Fail fail
[2]
  1. Test pass, but also encountered RHBZ #54321
  2. RHBZ #12345
shyam_iyer HW [1] [2]
Warning warn
[3] [4]
Pass pass
Pass pass
Pass pass
[5]
  1. This is a Dell PER 710 with 4 onboard Nics
  2. Encountered issue in uploading the smolt profile RHBZ #673015
  3. Encountered issue in rawhide installs RHBZ #671981
  4. Applied workaround in RH BZ 673192
  5. For upgrades to rawhide refer to script for changing to emN naming
shyam_iyer [HW] [1] [2]
Warning warn
[3] [4]
Pass pass
Pass pass
Pass pass
[5]
  1. This is a Dell SC 1435 with 2 onboard Nics
  2. Encountered issue in uploading the smolt profile RHBZ #673015
  3. Encountered issue in rawhide installs RHBZ #671981
  4. Applied workaround in RH BZ 673192
  5. For upgrades to rawhide refer to script for changing to emN naming
Paniraja KM Tested on Dell PowerEdge R510, R610 and R415
Fail fail
Pass pass
Fail fail
Pass pass
Pass pass
Pass pass
David Ramsey Add 32-bit Smolt Profile HW URL [1]
Pass pass
Pass pass
Pass pass
Pass pass
  1. Dell Precision eight core with i686 support
David Ramsey Add 64-bit Smolt Profile HW URL [1]
Pass pass
Pass pass
Pass pass
Pass pass
  1. Dell Precision eight core with x86_64 support
Yulia Kopkova HW [1]
Pass pass
Cite error: Invalid <ref> tag; name cannot be a simple integer. Use a descriptive title
Pass pass
Pass pass
Pass pass
  1. Dell OptiPlex GX620
Srinivas Gowda Add Smolt Profile HW URL
Pass pass
Pass pass
Inprogress inprogress
Pass pass
Pass pass
Pass pass
Taousif Ansari HW [1]
Pass pass
Pass pass
Pass pass
Pass pass
Pass pass
Cite error: Invalid <ref> tag; refs with no name must have content
  1. Dell PER900 with QP LOM BCM5708, Intel 82598EB 10-Gigabit, SP Broadcom BCM5709 10Gig, DP Broadcom BCM57710 1Gig
James Laska HW [1]
Fail fail
Cite error: Invalid <ref> tag; name cannot be a simple integer. Use a descriptive title [2]
Pass pass
Cite error: Invalid <ref> tag; name cannot be a simple integer. Use a descriptive title
Fail fail
Cite error: Invalid <ref> tag; name cannot be a simple integer. Use a descriptive title
Warning warn
[3]
  1. KVM guest on F14 host
  2. RHBZ #673238 - anaconda creates incorrect udev 70-persistent-net.rules entry for network device
  3. RHBZ #673268 - Rawhide installer sees pci2#1 and eth1
Ashish Bunkar HW [1]
Pass pass
Pass pass
Pass pass
Pass pass
Pass pass
Cite error: Invalid <ref> tag; refs with no name must have content
  1. Dell PER905 with QP LOM,Intel Sp-10-Gigabit, DP Qlogic 10Gig
Alexei Panov HW[1]
Pass pass
Pass pass
Pass pass
Pass pass
  1. Core i5 760 on MB Intel DH55HC
Narendra K HW
Pass pass
none
Fail fail
Cite error: Invalid <ref> tag; name cannot be a simple integer. Use a descriptive title
Pass pass
Pass pass
Pass pass
Pass pass
Jon Masters Add 64-bit Smolt Profile HW URL
none
Warning warn
[1]
none
Pass pass
[2]
none
none
Pass pass
[3]
  1. works as expected, however "Biosdevname-support-check" doesn't catch dmidecode not installed, and "Biosdevname-upgrade-iface-names" did not work - had to manually edit config files and remove udev persistent net configs, let them regenerate.
  2. Using Dell PER610, em1-em4 were created successfully.
  3. Once I removed the old config files/cleaned up files not handled by the "Biosdevname-upgrade-iface-names" script, it all worked.