XenServer 6.0.2 – Reorder NICs

An article by Melvin Koh from Citrix Blogs

If you need to reorder the NIC of a XenServer for whatever reasons, follow the procedures below. Note that XenServer 6.1 has an easier way of reordering the NICs and the instructions are here – http://support.citrix.com/article/CTX135809


1. First step is to add the static mapping of the NIC to the device name to this conf file:

For example, to assign the NIC with MAC address of “00:25:B5:16:01:DF” to device name eth2, add this line to the static-rules.conf file:
eth2: mac = “00:25:B5:16:01:DF”


2. After you have added the static mapping rule, run interface-rename.py:


3. Verify that the mapping is okay by looking at /var/log/interface-rename.log.

If successful, the log will show something like:
INFO [2013-02-28 10:33:02] NIC side-eth2->(00:25:B5:16:01:DF,0000:07:00.0) has moved on the PCI bus from eth2->(00:25:B5:16:01:DF,0000:07:00.0)
INFO [2013-02-28 10:33:02] Successfully renamed link side-eth2 to eth2

Instead if you see error that it is unable to rename like this message:
ERROR [2013-02-28 10:31:27] Unable to rename link side-eth2 to eth1. (Exit 2)

Then try changing the device name (eth) in this file also:

Look for the MAC address of the NIC that you want to change and rename the “ethX”. If you have another NIC that is already using the same device name, you need to change that as well. Rightfully, dynamic-rules.json is updated when interface-rename.py is run, but I always get problems with the script when it tries to do the update. Thus I find that updating the dynamic-rules.json file manually helps to get past the error.

If you need to reorder a few NICs, it is better to add the static mapping one at a time. Do the first NIC, run interface-rename.py, make sure that the mapping is updated correctly in dynamic-rules.json, then proceed to add the next NIC.


4. Once everything is done, do a pif-scan:
xe pif-scan host-uuid=<host uuid>

and reboot the server to make sure the reordering works.

Read More



Comments: 2

Leave a reply »

  • Hello!

    Wanted to inform you of this “bug”

    On the right column I’ve clicked the “XenServer” section

    Next I’ve read all the first results page topics
    At bottom I’ve clicked “Next” but not found page error

    Anyway I’m wondering if you may kindly share an Support Pack with latest Intel NICs igb drivers for a fresh installation of XenServer 6.2.
    If you may address me to an tutorial that works, on how to succeed to self produce the ISO.

    I’ve tried so many: no way.

    Also looks quite crazy on the Citrix perspective that they didn’t provided one on the support website: if you agree, distributing and (maybe? Still investing in?) one product, avoiding people to install it on recent (1 year thoug is not so recent) hardware, is a no sense.
    Yes ’cause the installation of XS stops if no NICs are found.

    Thank you for any kind reply. Thank you much more for any help


  • Needed Intel igb drivers are minimum 5.0.5 (first drivers release that included Intel’s i354 chipset)

    Though current are

    Thank you

  • Leave a Reply
    Your gravatar
    Your Name