Go to main content

Configuring and Managing Network Components in Oracle® Solaris 11.4

Exit Print View

Updated: December 2019

How to Replace a Network Interface Card With Dynamic Reconfiguration

The following procedure applies only to systems that support DR. The procedure specifically refers to configuration steps after DR has completed. You no longer need to reconfigure network links after you complete the DR process. Instead, you just transfer the link configurations of the removed NIC to the replacement NIC.

Note -  This procedure does not describe the steps to perform DR itself. Consult your system documentation for that information.

For an introduction to DR, see Chapter 2, Dynamically Configuring Devices in Managing Devices in Oracle Solaris 11.4.

Before You Begin

Ensure that your role has the appropriate rights profile to perform this procedure. See Using Rights Profiles to Perform Network Configuration.

    Complete the following steps first:

  • Ensure that your system supports DR.

  • Consult the appropriate manual that describes DR on your system.

    To locate current documentation about DR on Sun servers from Oracle, search for "dynamic reconfiguration" on https://docs.oracle.com/en/servers/.

    For information about performing DR in the Oracle Solaris Cluster environment, see Administering an Oracle Solaris Cluster Configuration on Oracle Help Center.

  1. Display information about the physical attributes of datalinks and their respective locations on the system.
    $ dladm show-phys -L
  2. Perform the DR process, as described in your system's documentation.
  3. After you have installed the replacement NIC, do one of the following, depending on the circumstance that applies:
    • If you inserted the replacement NIC into the same slot as the old NIC, proceed to Step 4.

      With the new NIC using the location that was previously occupied by the old NIC, the new NIC inherits the link name and the configuration of the old NIC.

    • If you inserted the replacement NIC into a different slot, and the new NIC needs to inherit the datalink configuration of the removed NIC, rename the link as follows:
      $ dladm rename-link new-datalink old-datalink

      Refers to the datalink of the replacement NIC that is in a different slot than the location from which the old NIC was removed.


      Refers to the datalink name that is associated with the old NIC that was removed.

      Note -  In this scenario, the slot from which the old NIC was removed must remain empty.

      For example, the NIC in slot 1 is removed, and then the new NIC is inserted in slot 2. No NIC is inserted in slot 1. Assume that the datalink in slot 1 is net0, and the datalink in slot 2 is net1. You would specify that the datalink of the new NIC inherit the datalink configuration of the old NIC as follows:

      $ dladm rename-link net1 net0
  4. Complete the DR process by enabling the new NIC's resources so that they are available for use.

    For example, you can use the cfgadm command to configure the NIC. See the cfgadm(8) man page.

  5. Display link information.

    You can use either the dladm show-phys command or the dladm show-link command to display information about the datalinks.

Example 1  Performing Dynamic Reconfiguration by Installing a New Network Card

The following example shows how a bge card with link name net0 is replaced by an e1000g card. The link configurations of net0 are transferred from bge to e1000g after e1000g is connected to the system.

$ dladm show-phys -L
net0     bge0       MB
net1     ibp0       MB/RISER0/PCIE0/PORT1
net2     ibp1       MB/RISER0/PCIE0/PORT2
net3     eoib2      MB/RISER0/PCIE0/PORT1/cloud-nm2gw-2/1A-ETH-2

You can perform the DR-specific steps such as using the cfgadm command to remove the bge card and then installing the e1000g card in its place. After the card is installed, the datalink of e1000g0 automatically assumes the name net0 and inherits the configuration of the link.

$ dladm show-phys -L
net0     e1000g0    MB
net1     ibp0       MB/RISER0/PCIE0/PORT1
net2     ibp1       MB/RISER0/PCIE0/PORT2
net3     eoib2      MB/RISER0/PCIE0/PORT1/cloud-nm2gw-2/1A-ETH-2

$ dladm show-link
net0     phys      9600   up       ---
net1     phys      1500   down     ---
net2     phys      1500   down     --
net3     phys      1500   down     ---