Changing the ethX to Ethernet Device Mapping in EL6 and Fedora 12 to 14: Difference between revisions

From Alteeve Wiki
Jump to navigation Jump to search
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{howto_header}}
{{howto_header}}


When you have two or more ethernet devices in one machine, the Fedora install may not install them in the order you want. This document will show you how to change the <span class="code">ethX</span> to ethernet device mapping.
{{note|1=This applies up to Fedora 14. Fedora 15 works quite differently now that it uses <span class="code">biosdevname</span>. Please follow [[Changing Ethernet Device Names in EL7 and Fedora 15+|this tutorial]] for Fedora 15 and newer.}}
 
When you have two or more ethernet devices in one machine, the [[EL6]] or Fedora install may not install them in the order you want. This document will show you how to change the <span class="code">ethX</span> to physical ethernet device mapping.
 
This is desirable in cases where specific network cards need to be used on specific networks, and you are interested in maintaining common <span class="code">ethX</span> names across servers. A practical example is found in the [[2-Node Red Hat KVM Cluster Tutorial]].


= For the Impatient =
= For the Impatient =


Assuming that <span class="code">NetworkManager</span> is already removed.
Assuming that <span class="code">NetworkManager</span> is already removed.  This example will swap <span class="code">eth0</span> and <span class="code">eth1</span>.


<source lang="bash">
<source lang="bash">
# Stop the network daemon
/etc/init.d/network stop
/etc/init.d/network stop
cd /etc/sysconfig/network-scripts
# Move your ifcfg files to the device names you desire
mv ifcfg-eth0 ifcfg-temp
mv ifcfg-eth1 ifcfg-eth0
mv ifcfg-temp ifcfg eth1
# Modify DEVICE lines to match new file names
vim /etc/sysconfig/network-scripts/ifcfg-eth*
vim /etc/sysconfig/network-scripts/ifcfg-eth*
# Make changes as needed
# Make changes as needed
vim /etc/udev/rules.d/70-persistent-net.rules
# Remove udev rules file
# Make changes as needed
rm /etc/udev/rules.d/70-persistent-net.rules
start_udev
start_udev
/etc/init.d/network start
/etc/init.d/network start
Line 22: Line 33:


I find it easier to follow instructions when I have an example to follow, so let me provide one here:
I find it easier to follow instructions when I have an example to follow, so let me provide one here:
I've got the same hardware in the same configuration in both of my storage nodes. To keep things simple, I want to make sure that both nodes use the same <span class="code">ethX</span> name for the network devices on each of the given networks.


== Desired Mapping ==
== Desired Mapping ==
Line 28: Line 41:


* <span class="code">eth0</span>
* <span class="code">eth0</span>
** MAC: <span class="code">90:E6:BA:71:82:D8</span>
** MAC: <span class="code">90:E6:BA:71:82:EA</span>
* <span class="code">eth1</span>
* <span class="code">eth1</span>
** MAC: <span class="code">00:21:91:19:96:5A</span>
** MAC: <span class="code">00:21:91:19:96:53</span>
* <span class="code">eth2</span>
* <span class="code">eth2</span>
** MAC: <span class="code">00:0E:0C:59:45:78</span>
** MAC: <span class="code">00:0E:0C:59:46:E4</span>


== Initial Mapping ==
== Initial Mapping ==


Now lets assume you got this:
When the Fedora install finished, you may have gotten this:


* <span class="code">eth0</span>
* <span class="code">eth0</span>
** MAC: <span class="code">00:21:91:19:96:5A</span>
** MAC: <span class="code">00:21:91:19:96:53</span>
* <span class="code">eth1</span>
* <span class="code">eth1</span>
** MAC: <span class="code">90:E6:BA:71:82:D8</span>
** MAC: <span class="code">90:E6:BA:71:82:EA</span>
* <span class="code">eth2</span>
* <span class="code">eth2</span>
** MAC: <span class="code">00:0E:0C:59:45:78</span>
** MAC: <span class="code">00:0E:0C:59:46:E4</span>


== The Problem ==
== The Problem ==
Line 51: Line 64:
== The Fix ==
== The Fix ==


First, stop <span class="code">network</span>. This is important because if you change the MAC address to <span class="code">ethX</span> mapping while the network is still up, the <span class="code">initd</span> script will fail to bring down the network devices and you will need to reboot for the changes to take effect.
What we need to do is modify the <span class="code">DEVICE=...</span> line in each <span class="code">ifcfg-ethX</span> file to reflect the order we want.
 
To avoid confusion later on, we should also rename the files to reflect the new device names.
 
=== Stopping the Network ===
 
First, stop the <span class="code">network</span>. This is important because if you change the MAC address mapping while the network is still up, the <span class="code">init.d</span> script will fail to bring down the network devices and you will need to reboot for the changes to take effect.


<source lang="bash">
<source lang="bash">
Line 57: Line 76:
</source>
</source>


We'll need to work in two directories;
=== Interface Configuration ===
* <span class="code">/etc/sysconfig/network-scripts/</span>
** Where the interface configuration files exist.
* <span class="code">/etc/udev/rules.d/</span>
** Where the <span class="code">udev</span> configuration files exist.


=== Interface Configuration ===
Go to the <span class="code">/etc/sysconfig/network-scripts/</span> directory and then use <span class="code">cat</span> to see the contents of the <span class="code">ifcfg-eth*</span> network configuration files:


Go to <span class="code">/etc/sysconfig/network-scripts/</span> and then use <span class="code">cat</span> to see the contents of the <span class="code">ifcfg-eth*</span> network configuration files:
{{note|1=The <span class="code">cat</span> output below only shows the lines we're interested in. You will likely see several more lines not shown below.}}


<source lang="bash">
<source lang="bash">
cd /etc/sysconfig/network-scripts/
cd /etc/sysconfig/network-scripts
cat ifcfg-eth0
cat ifcfg-eth0
</source>
<source lang="text">
DEVICE="eth0"
HWADDR="00:21:91:19:96:53"
</source>
<source lang="bash">
cat ifcfg-eth1
cat ifcfg-eth1
</source>
<source lang="text">
DEVICE="eth1"
HWADDR="90:E6:BA:71:82:EA"
</source>
<source lang="bash">
cat ifcfg-eth2
cat ifcfg-eth2
</source>
</source>
<source lang="text">
DEVICE="eth2"
HWADDR="00:0E:0C:59:46:E4"
</source>
The important lines are the <span class="code">DEVICE=...</span> and <span class="code">HWADDR=...</span> lines. The rest of the lines will very likely differ from the output above. It is outside the scope of this tutorial to cover the various settings.  For an exhaustive list of available options, please see the [https://access.redhat.com/knowledge/docs/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/s1-networkscripts-interfaces.html Red Hat EL6] or the [http://docs.fedoraproject.org/en-US/Fedora/12/html/Deployment_Guide/s1-networkscripts-interfaces.html Fedora 12] documentation.


This will produce output something like this:
First, change the file names to reflect the device order that you want.  In this example we need to swap <span class="code">eth0</span> and <span class="code">eth1</span>.


<source lang="bash">
<source lang="bash">
cd /etc/sysconfig/network-scripts
cd /etc/sysconfig/network-scripts
cat ifcfg-eth*
mv ifcfg-eth0 ifcfg-temp
mv ifcfg-eth1 ifcfg-eth0
mv ifcfg-temp ifcfg-eth1
</source>
</source>
<source lang="text">
# D-Link System Inc DGE-560T PCI Express Gigabit Ethernet Adapter
HWADDR=00:21:91:19:96:5A
DEVICE=eth0
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=192.168.1.71
NETMASK=255.255.255.0
GATEWAY=192.168.1.1
DNS1=192.139.81.117
DNS2=192.139.81.1
DEFROUTE=yes


# Realtek Semiconductor Co., Ltd. RTL8111/8168B PCI Express Gigabit Ethernet controller
Using your editor of choice, open each file and change the <span class="code">DEVICE=...</span> to match the new filename.
HWADDR=90:E6:BA:71:82:D8
DEVICE=eth1
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=10.0.0.71
NETMASK=255.255.255.0


# Intel Corporation 82540EM Gigabit Ethernet Controller
Here is the updated files with updated network settings:
HWADDR=00:0E:0C:59:45:78
DEVICE=eth2
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=10.0.1.71
NETMASK=255.255.255.0
</source>
 
The important lines are the <span class="code">DEVICE=...</span> and <span class="code">HWADDR=...</span> lines. The rest of the lines will very likely differ from the output above, and most will likely be set to <span class="code">BOOTPROTO=static</span>. One or more may also be set to <span class="code">ONBOOT=yes</span>. It is outside the scope of this tutorial to cover the various settings
 
With networking stopped, all we need to do is change the <span class="code">HWADDR=...</span> lines in <span class="code">ifcfg-eth0</span> to have the MAC address from <span class="code">ifcfg-eth2</span> and vice-versa. For an exhaustive list of available options, please [http://docs.fedoraproject.org/en-US/Fedora/12/html/Deployment_Guide/s1-networkscripts-interfaces.html see the Fedora documentation].
 
To rearrange the mappings, simply change around the <span class="code">HWADDR=...</span> values in the <span class="code">ifcfg-eth*</span> files so that the desired MAC address and <span class="code">DEVICE=...</span> are in the same file. Personally, I like to move around the comment at the top that names the NICs, also. Here is the updated files:


<source lang="bash">
<source lang="bash">
cat ifcfg-eth*
cd /etc/sysconfig/network-scripts
cat ifcfg-eth0
</source>
</source>
<source lang="text">
<source lang="text">
# Realtek Semiconductor Co., Ltd. RTL8111/8168B PCI Express Gigabit Ethernet controller
DEVICE="eth0"
HWADDR=90:E6:BA:71:82:D8
HWADDR="90:E6:BA:71:82:EA"
DEVICE=eth0
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=192.168.1.71
NETMASK=255.255.255.0
GATEWAY=192.168.1.1
DNS1=192.139.81.117
DNS2=192.139.81.1
DEFROUTE=yes
 
# D-Link System Inc DGE-560T PCI Express Gigabit Ethernet Adapter
HWADDR=00:21:91:19:96:5A
DEVICE=eth1
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=10.0.0.71
NETMASK=255.255.255.0
 
# Intel Corporation 82540EM Gigabit Ethernet Controller
HWADDR=00:0E:0C:59:45:78
DEVICE=eth2
BOOTPROTO=static
ONBOOT=yes
TYPE=Ethernet
IPADDR=10.0.1.71
NETMASK=255.255.255.0
</source>
</source>
=== 'udev' Configuration ===
The user-space device manager, [http://en.wikipedia.org/wiki/Udev udev], maintains a list of configuration files that help ensure that hardware to <span class="code">/dev</span> (software) mappings stay consistent, even when hardware is hot swapped or moved between physical connections. For networking hardware, this mapping is recorded in the <span class="code">70-persistent-net.rules</span>.
Here, all that needs to be done is for the <span class="code">NAME="..."</span> entry to be changed to reflect what you want. Note that the entries do not need to be in any particular order.
<source lang="bash">
<source lang="bash">
cd /etc/udev/rules.d/
cat ifcfg-eth1
cat ifcfg-eth*
</source>
</source>
<source lang="text">
<source lang="text">
# This file was automatically generated by the /lib/udev/write_net_rules
DEVICE="eth1"
# program, run by the persistent-net-generator.rules rules file.
HWADDR="00:21:91:19:96:53"
#
# You can modify it, as long as you keep each rule on a single
# line, and change only the value of the NAME= key.
 
# PCI device 0x10ec:0x8168 (r8169) (custom name provided by external tool)
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="90:e6:ba:71:82:d8", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth1"
 
# PCI device 0x1186:0x4b00 (sky2) (custom name provided by external tool)
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:21:91:19:96:5a", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"
 
# PCI device 0x8086:0x100e (e1000) (custom name provided by external tool)
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:0e:0c:59:45:78", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth2"
</source>
</source>
Make the changes and save the file. Continuing with this example, the file should now look like this:
<source lang="bash">
<source lang="bash">
cd /etc/udev/rules.d/
cat ifcfg-eth2
cat ifcfg-eth*
</source>
</source>
<source lang="text">
<source lang="text">
# This file was automatically generated by the /lib/udev/write_net_rules
DEVICE="eth2"
# program, run by the persistent-net-generator.rules rules file.
HWADDR="00:0E:0C:59:46:E4"
#
</source>
# You can modify it, as long as you keep each rule on a single
 
# line, and change only the value of the NAME= key.
=== 'udev' Configuration ===


# PCI device 0x10ec:0x8168 (r8169) (custom name provided by external tool)
The user-space device manager, [http://en.wikipedia.org/wiki/Udev udev], maintains a list of configuration files that help ensure that hardware to <span class="code">/dev</span> (software) mappings stay consistent, even when hardware is hot swapped or moved between physical connections. For networking hardware, this mapping is recorded in the <span class="code">70-persistent-net.rules</span>.
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="90:e6:ba:71:82:d8", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth0"


# PCI device 0x1186:0x4b00 (sky2) (custom name provided by external tool)
Simply delete this file.
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:21:91:19:96:5a", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth1"


# PCI device 0x8086:0x100e (e1000) (custom name provided by external tool)
<source lang="bash">
SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:0e:0c:59:45:78", ATTR{dev_id}=="0x0", ATTR{type}=="1", KERNEL=="eth*", NAME="eth2"
rm /etc/udev/rules.d/70-persistent-net.rules
</source>
</source>



Latest revision as of 02:37, 20 November 2012

 AN!Wiki :: How To :: Changing the ethX to Ethernet Device Mapping in EL6 and Fedora 12 to 14

Note: This applies up to Fedora 14. Fedora 15 works quite differently now that it uses biosdevname. Please follow this tutorial for Fedora 15 and newer.

When you have two or more ethernet devices in one machine, the EL6 or Fedora install may not install them in the order you want. This document will show you how to change the ethX to physical ethernet device mapping.

This is desirable in cases where specific network cards need to be used on specific networks, and you are interested in maintaining common ethX names across servers. A practical example is found in the 2-Node Red Hat KVM Cluster Tutorial.

For the Impatient

Assuming that NetworkManager is already removed. This example will swap eth0 and eth1.

# Stop the network daemon
/etc/init.d/network stop
cd /etc/sysconfig/network-scripts
# Move your ifcfg files to the device names you desire
mv ifcfg-eth0 ifcfg-temp
mv ifcfg-eth1 ifcfg-eth0
mv ifcfg-temp ifcfg eth1
# Modify DEVICE lines to match new file names
vim /etc/sysconfig/network-scripts/ifcfg-eth*
# Make changes as needed
# Remove udev rules file
rm /etc/udev/rules.d/70-persistent-net.rules
start_udev
/etc/init.d/network start

Thanks for fenris02 and mutk

Example

I find it easier to follow instructions when I have an example to follow, so let me provide one here:

I've got the same hardware in the same configuration in both of my storage nodes. To keep things simple, I want to make sure that both nodes use the same ethX name for the network devices on each of the given networks.

Desired Mapping

Let's assume that you want this:

  • eth0
    • MAC: 90:E6:BA:71:82:EA
  • eth1
    • MAC: 00:21:91:19:96:53
  • eth2
    • MAC: 00:0E:0C:59:46:E4

Initial Mapping

When the Fedora install finished, you may have gotten this:

  • eth0
    • MAC: 00:21:91:19:96:53
  • eth1
    • MAC: 90:E6:BA:71:82:EA
  • eth2
    • MAC: 00:0E:0C:59:46:E4

The Problem

In the above example, eth2 is where we want it, so we leave it alone. The problem is that eth0 and eth1 are reversed.

The Fix

What we need to do is modify the DEVICE=... line in each ifcfg-ethX file to reflect the order we want.

To avoid confusion later on, we should also rename the files to reflect the new device names.

Stopping the Network

First, stop the network. This is important because if you change the MAC address mapping while the network is still up, the init.d script will fail to bring down the network devices and you will need to reboot for the changes to take effect.

/etc/init.d/network stop

Interface Configuration

Go to the /etc/sysconfig/network-scripts/ directory and then use cat to see the contents of the ifcfg-eth* network configuration files:

Note: The cat output below only shows the lines we're interested in. You will likely see several more lines not shown below.
cd /etc/sysconfig/network-scripts
cat ifcfg-eth0
DEVICE="eth0"
HWADDR="00:21:91:19:96:53"
cat ifcfg-eth1
DEVICE="eth1"
HWADDR="90:E6:BA:71:82:EA"
cat ifcfg-eth2
DEVICE="eth2"
HWADDR="00:0E:0C:59:46:E4"

The important lines are the DEVICE=... and HWADDR=... lines. The rest of the lines will very likely differ from the output above. It is outside the scope of this tutorial to cover the various settings. For an exhaustive list of available options, please see the Red Hat EL6 or the Fedora 12 documentation.

First, change the file names to reflect the device order that you want. In this example we need to swap eth0 and eth1.

cd /etc/sysconfig/network-scripts
mv ifcfg-eth0 ifcfg-temp
mv ifcfg-eth1 ifcfg-eth0
mv ifcfg-temp ifcfg-eth1

Using your editor of choice, open each file and change the DEVICE=... to match the new filename.

Here is the updated files with updated network settings:

cd /etc/sysconfig/network-scripts
cat ifcfg-eth0
DEVICE="eth0"
HWADDR="90:E6:BA:71:82:EA"
cat ifcfg-eth1
DEVICE="eth1"
HWADDR="00:21:91:19:96:53"
cat ifcfg-eth2
DEVICE="eth2"
HWADDR="00:0E:0C:59:46:E4"

'udev' Configuration

The user-space device manager, udev, maintains a list of configuration files that help ensure that hardware to /dev (software) mappings stay consistent, even when hardware is hot swapped or moved between physical connections. For networking hardware, this mapping is recorded in the 70-persistent-net.rules.

Simply delete this file.

rm /etc/udev/rules.d/70-persistent-net.rules

Making the Changes Take Effect

First, you need to reload udev so that it updates the mapping in memory. This is done using the start_udev program:

start_udev
Starting udev:                                             [  OK  ]

With udev updated, the last step is to restart the network daemon:

/etc/init.d/network start
Bringing up loopback interface:                            [  OK  ]
Bringing up interface eth0:                                [  OK  ]
Bringing up interface eth1:                                [  OK  ]
Bringing up interface eth2:                                [  OK  ]

Done! use ifconfig to verify that the network cards are properly assigned to the specified ethX names.

Caveat!

NOTE: If you are using a vlan, the device facing the vlan can not have the HWADDR=... value set! Set the others and leave this commented out. Otherwise, because of how the vlan loads, the OS will not see the physical device and will fail to bring up the interface at all.

 

Any questions, feedback, advice, complaints or meanderings are welcome.
Alteeve's Niche! Enterprise Support:
Alteeve Support
Community Support
© Alteeve's Niche! Inc. 1997-2024   Anvil! "Intelligent Availability®" Platform
legal stuff: All info is provided "As-Is". Do not use anything here unless you are willing and able to take responsibility for your own actions.