Editing Test Day:2011-01-27 Network Device Naming With Biosdevname/ru

{{Infobox_group
| name = Дни Испытаний Fedora
| image = [[File:Echo-testing-48px.png|link=QA/Fedora_15_test_days]]
| caption = [[Features/ConsistentNetworkDeviceNaming|Именование сетевых устройсв с использованием Biosdevname]]
| Дата = Четверг, Январь 27, 2011
| Время = весь день
| 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
}}

{{admon/note | Не та дата? | Если Вы пришли на эту страницу до или после официальной даты тестирования, это не значит, что страница для Вас бесполезно. Вы можете провести тестирование и добавить результаты тестов в таблицу и [http://bugzilla.redhat.com Bugzilla]. Если Вы пришли спустя месяц на данную страницу, то посмотрите, возможно сейчас проводятся или уже проведены дополнительные и/или подобные испытания, но более новые. Посмотреть это можно в [[QA/Test_Days|расписании тестирования]].}}

== Что тестируем? ==

Сегодняшний день испытания будет посвящен тестированию '''[[Features/ConsistentNetworkDeviceNaming#Consistent_Network_Device_Naming|Именованию Сетевых Интерфейсов]] в Fedora Rawhide'''

Традиционно сетевые интерфейсы в Linux называются ethN. С несколькими сетевыми адаптерами (встроенными, дополнительными, одно- и многопортовыми) в современных серверных платформах именование происходит "слепое", не возможно с точностью сказать, какой адаптер будет именоваться eth0 встроенный или PCI-адаптер, что в свою очередь не удобно для администрирования сервера.

Данный вопрос решается путем присвоения имен сетевым интерфейсам, основываясь на их физическое расположение на системной плате.
[http://linux.dell.com/biosdevname/ Biosdevname], это утилита разработанная в Dell, которая предлагает имена сетевым интерфейсам в заивисимости от их физического расположения.

Naming convention followed is:
* Embedded devices: <code>em<port></code>
* Add-in PCI cards: <code>pci<slot>#<port>_<virtual-function-instance></code>

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/files/presentations/Linux_Plumbers_Conf_2010/matt-domsch-network-device-naming.pdf Linux Plumbers Conf 2010 by Matt Domsch]

== Who's available ==


* [[User:Narendrak|Narendra K]] (irc_nick1) will be your host for the day.

The following cast of characters will be available testing, workarounds, bug fixes, and general discussion ...

* Quality Assurance - [[User:Tester1|Tester1]] (irc_nick3), [[User:Tester2|Tester2]] (irc_nick4), [[User:Tester3|Tester3]] (irc_nick5)

== Prerequisite for Test Day == 

; Hardware Requirements
# Computer system (Servers/Laptops/Desktops) with onboard(Lan-On-Motherboard) network adapters and/or add-in network adapters.
# 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]

; Firmware/BIOS requirements
# System firmware/BIOS should implement SMBIOS type 41 record which defines a device type instance and string for onboard devices (network adapters included)or $PIRQ Table(PCI Irq Routing Table).
# System firmware/BIOS should implement SMBIOS type 9 record or implement $PIRQ Table(PCI Irq Routing Table).

; Software Requirements
<ol>
<li> The system should be updated to Fedora Rawhide
</li><li> 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># lspci | grep -i ether
01:00.0 Ethernet controller: Broadcom Corporation NetXtreme II BCM5709 Gigabit Ethernet (rev 20)
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)

# 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

# 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>
</li></ol>

== How to test? ==

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 {{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).

=== '''Update your machine''' / '''Available Rawhide Installation Methods''' ===

There are several ways to upgrade your test system.

; Upgrading From Fedora 14 to Today's Rawhide {{anchor|update}}
: 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 Today's Rawhide {{anchor|install}}
: 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]]

; Boot into a Rawhide Live Image {{anchor|live}}
: 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 ==

'''Upgrade Testing''' - Test cases in this category need to executed when a Fedora 14 system is to be upgraded to Today's Rawhide. Please refer to the section [[#update|Upgrading From Fedora 14 to Today's Rawhide]] above.

* [[QA:Testcase biosdevname NIC rules persist after upgrade]] - Verify upgrade from Fedora 14 to Rawhide

'''Install Time Testing''' - The test cases in this category need to be executed when installation of Rawhide is in progress. Please refer to the section [[#install|Install Today's Rawhide]] above.

* [[QA:Testcase biosdevname NIC naming after install]] - Verify that Onboard and Add-in Interfaces are named as expected during Install Time

'''Run Time Testing''' - The test cases in this category need to be executed when you are booted into Fedora Live Image. Please refer to the section [[#live|Boot into a Rawhide Live Image]] above to download a Fedora Rawhide Live Image.

* [[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, Add-in Virtual Function interfaces can be configured

== Test Results ==

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:

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.

{|
! User
! Smolt Profile
! [[QA:Testcase biosdevname NIC naming after install|names after install]]
! [[QA:Testcase biosdevname NIC rules persist after upgrade|names after upgrade]]
! [[QA:Testcase biosdevname on-board network interface names|on-board ifaces]]
! [[QA:Testcase biosdevname add-in network interface names|add-in ifaces]]
! [[QA:Testcase biosdevname SRIOV virtual function interface names|SRIOV ifaces]]
! [[QA:Testcase biosdevname interface configuration|interface configuration]]
! References
|-
| [[User:SampleUser|Sample User]]
| [http://www.smolts.org/client/show/pub_84465125-1350-4f83-87b9-5f16f7430eb8 HW]
| {{result|pass}} 
| {{result|none}}
| {{result|inprogress}}
| {{result|pass}}
| {{result|warn}} <ref>Test pass, but also encountered {{bz|54321}}</ref>
| {{result|fail}} <ref>{{bz|12345}}</ref>
| <references/>
|-
|}

[[Category:Fedora 15 Test Days]]