(#biosdevname channel is no more) |
(fix bad ref tags, drop direct test days category membership) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 217: | Line 217: | ||
| [[User:Ykopkova|Yulia Kopkova]] | | [[User:Ykopkova|Yulia Kopkova]] | ||
| [http://www.smolts.org/client/show/pub_0b6c3ed0-2ab9-4f0a-a192-3480f0f46611 HW] <ref>Dell OptiPlex GX620</ref> | | [http://www.smolts.org/client/show/pub_0b6c3ed0-2ab9-4f0a-a192-3480f0f46611 HW] <ref>Dell OptiPlex GX620</ref> | ||
| {{result|pass}} <ref | | {{result|pass}} <ref>{{bz|672603}}</ref> | ||
| {{result|pass}} | | {{result|pass}} | ||
| {{result|unknown}} | | {{result|unknown}} | ||
Line 250: | Line 250: | ||
| [[User:jlaska|James Laska]] | | [[User:jlaska|James Laska]] | ||
| [http://www.smolts.org/client/show/pub_ae9f18ba-cf95-40f3-9fab-9d5f65ec8586 HW] <ref>KVM guest on F14 host</ref> | | [http://www.smolts.org/client/show/pub_ae9f18ba-cf95-40f3-9fab-9d5f65ec8586 HW] <ref>KVM guest on F14 host</ref> | ||
| {{result|fail}} <ref | | {{result|fail}} <ref>{{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 | | {{result|pass}} <ref>Updates.img required to work around {{bz|673158}}</ref> | ||
| {{result|fail}} <ref | | {{result|fail}} <ref>{{bz|673160}} - Anaconda fails to activate the device when ksdevice=pciM#N is passed</ref> | ||
| {{result|unknown}} | | {{result|unknown}} | ||
| {{result|warn}} <ref>{{bz|673268}} - Rawhide installer sees pci2#1 and eth1</ref> | | {{result|warn}} <ref>{{bz|673268}} - Rawhide installer sees pci2#1 and eth1</ref> | ||
Line 285: | Line 285: | ||
| {{result|pass}} | | {{result|pass}} | ||
| {{result|none}} | | {{result|none}} | ||
| {{result|fail}} <ref | | {{result|fail}} <ref>{{bz|673160}} - Anaconda fails to activate the device when ksdevice=pciM#N is passed</ref> | ||
| {{result|pass}} | | {{result|pass}} | ||
| {{result|pass}} | | {{result|pass}} | ||
Line 295: | Line 295: | ||
| Add 64-bit Smolt Profile HW URL | | Add 64-bit Smolt Profile HW URL | ||
| {{result|none}} | | {{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|warn}} <ref group="long">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|none}} | ||
| {{result|pass}} <ref>Using Dell PER610, em1-em4 were created successfully.</ref> | | {{result|pass}} <ref>Using Dell PER610, em1-em4 were created successfully.</ref> | ||
Line 304: | Line 304: | ||
|- | |- | ||
|} | |} | ||
== Long comments == | |||
<references group="long" /> | |||
[[Category:Fedora 15 Test Days]] | [[Category:Fedora 15 Test Days]] |
Latest revision as of 23:58, 18 June 2015
Consistent Network Device Naming feature | |
---|---|
![]() | |
Network Device Naming With Biosdevname | |
Date | ongoing |
What to test?[edit]
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[edit]
Hardware Requirements[edit]
A script is available to determine whether your system will be impacted by the
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)
biosdevname
$ 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:
- A system (servers, laptop, or desktop) with one or more onboard network adapter(s) and/or one or more add-in network adapter(s)
- System firmware/BIOS should implement an SMBIOS type 41 or type 9 record, or PCI Interrupt Routing
- 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
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
Software Requirements[edit]
- Fedora Rawhide
- 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?[edit]
At a high level, the testing will focus on
- Network interface names during install time
- Network interface names after installation is completed (after you login for first time)
- Required changes available in
ifcfg-ethN
config files - 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[edit]
There are several ways to set up your test system.
Upgrading From Fedora 14 to Rawhide[edit]
- You can upgrade an already installed Fedora 14 system using
yum
- for guidance, see yum update from previous release
Install Rawhide[edit]
- You can install Rawhide with Fedora 14 ISO media - for guidance, see Install Rawhide using Fedora 14 ISO
- Or you can use a special Rawhide install image provided for this test day - i386 or x86_64
boot.iso
. For guidance, see 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: x86_64 01-26 rawhide repo or i386 01-26 rawhide repo
Boot into a Rawhide live image[edit]
- You can download and boot a Fedora Rawhide live image - for guidance, see How_to_create_and_use_Live_USB
Complete the Test Cases[edit]
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.
- QA:Testcase biosdevname NIC rules persist after upgrade - Verify upgrade from Fedora 14 to Rawhide
- 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.
- 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
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.
- QA:Testcase biosdevname on-board network interface names - Verify that onboard interfaces are named as
emN
- QA:Testcase biosdevname add-in network interface names - Verify that PCI add-in interfaces are named as
pci<slot>#<port>
- QA:Testcase biosdevname SRIOV virtual function interface names - Verify that Virtual Function interfaces are named as
pci<slot>#<port>_<virtual-function-instance>
- QA:Testcase biosdevname interface configuration - Verify that onboard, add-in, and add-in Virtual Function interfaces can be configured
Report your results[edit]
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 | ![]() |
![]() |
![]() |
![]() |
![]() |
|||
shyam_iyer | HW [1] [2] | ![]() |
![]() |
![]() |
![]() |
||||
shyam_iyer | [HW] [1] [2] | ![]() |
![]() |
![]() |
![]() |
||||
Paniraja KM | Tested on Dell PowerEdge R510, R610 and R415 | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
David Ramsey | Add 32-bit Smolt Profile HW URL [1] | ![]() |
![]() |
![]() |
![]() |
| |||
David Ramsey | Add 64-bit Smolt Profile HW URL [1] | ![]() |
![]() |
![]() |
![]() |
| |||
Yulia Kopkova | HW [1] | ![]() |
![]() |
![]() |
![]() |
||||
Srinivas Gowda | Add Smolt Profile HW URL | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
Taousif Ansari | HW [1] | ![]() |
![]() |
![]() |
![]() |
![]() <ref> tag; refs with no name must have content
|
| ||
James Laska | HW [1] | ![]() |
![]() |
![]() |
![]() |
| |||
Ashish Bunkar | HW [1] | ![]() |
![]() |
![]() |
![]() |
![]() <ref> tag; refs with no name must have content
|
| ||
Alexei Panov | HW[1] | ![]() |
![]() |
![]() |
![]() |
| |||
Narendra K | HW | ![]() |
![]() |
![]() |
![]() |
![]() |
![]() |
||
Jon Masters | Add 64-bit Smolt Profile HW URL | ![]() |
![]() |
![]() |
Long comments[edit]
- ↑ 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.