Go to main content

Administering TCP/IP Networks, IPMP, and IP Tunnels in Oracle® Solaris 11.3

Exit Print View

Updated: March 2019

How to Configure an IPMP Group That Uses DHCP

You can configure a multiple-interfaced IPMP group with active-active interfaces or active-standby interfaces. See Types of IPMP Interface Configurations. The following procedure describes how to configure an active-standby IPMP group with DHCP.

Before You Begin

    Before performing the following procedure, do the following:

  • Ensure that the IP interfaces that will be in the prospective IPMP group have been correctly configured over the system's network datalinks. For procedures, see Configuring and Managing Network Components in Oracle Solaris 11.3. You can create an IPMP interface even if you have not created the underlying IP interfaces. However, without creating underlying IP interfaces, subsequent configurations on the IPMP interface will fail.

  • Additionally, if you are using a SPARC based system, you must configure a unique MAC address for each interface. See How to Ensure That the MAC Address of Each Interface Is Unique in Configuring and Managing Network Components in Oracle Solaris 11.3.

  • Finally, if you are using DHCP, make sure that the underlying interfaces have infinite leases. Otherwise, if an IPMP group failure occurs, the test addresses will expire and the in.mpathd daemon will then disable probe-based failure detection and link-based failure detection will then be used. If link-based failure detection discovers that the interface is functioning, the daemon might erroneously report that the interface has been repaired. For more information about configuring DHCP, see Working With DHCP in Oracle Solaris 11.3.

  1. Become the root role.
  2. Create an IPMP interface.
    # ipadm create-ipmp ipmp-interface

    ipmp-interface specifies the name of the IPMP interface. You can assign any meaningful name to the IPMP interface. As with any IP interface, the name consists of a string and a number, for example, ipmp0.

  3. Create the underlying IP interfaces, if they do not yet exist.
    # ipadm create-ip under-interface

    under-interface refers to the IP interface that you will add to the IPMP group.

  4. Add the underlying IP interfaces that will contain test addresses for the IPMP group.
    # ipadm add-ipmp -i under-interface1 [-i under-interface2 ...] ipmp-interface

    You can add as many IP interfaces to the IPMP group as are available on the system.

  5. Specify that DHCP configure and manage the data addresses on the IPMP interface.
    # ipadm create-addr -T dhcp ipmp-interface

    The previous step associates the address that is provided by the DHCP server with an address object. The address object uniquely identifies the IP address by using the format interface/address-type, for example, ipmp0/v4. For more information about the address object, see How to Configure an IPv4 Interface in Configuring and Managing Network Components in Oracle Solaris 11.3.

  6. If you use probe-based failure detection with test addresses, specify that DHCP manage the test addresses on the underlying interfaces.
    # ipadm create-addr -T dhcp under-interface

    The address object that is automatically created in Step 6 uses the format under-interface/address-type, for example, net0/v4.

  7. (Optional) Repeat Step 6 for each underlying interface of the IPMP group.
Example 17  Configuring an IPMP Group With DHCP

The following example shows the configuration of an active-standby IPMP group with DHCP and is based on the following scenario:

  • Three underlying interfaces net0, net1, and net2 are configured into an IPMP group.

  • The IPMP interface ipmp0 shares the same name with the IPMP group.

  • net2 is the designated standby interface.

  • All of the underlying interfaces are assigned test addresses.

The IPMP interface is first created.

# ipadm create-ipmp ipmp0

The underlying IP interfaces are created and added to the IPMP interface.

# ipadm create-ip net0
# ipadm create-ip net1
# ipadm create-ip net2

# ipadm add-ipmp -i net0 -i net1 -i net2 ipmp0

The DHCP-managed IP addresses are assigned to the IPMP interface. IP addresses that are assigned to the IPMP interface are data addresses. In this example, the IPMP interface has two data addresses.

# ipadm create-addr -T dhcp ipmp0
ipadm: ipmp0/v4
# ipadm create-addr -T dhcp ipmp0
ipadm: ipmp0/v4a

Then, the DHCP-managed IP addresses are assigned to the underlying IP interfaces of the IPMP group. IP addresses that are assigned to the underlying interfaces are test addresses that are to be used for probe-based failure detection.

# ipadm create-addr -T dhcp net0
ipadm: net0/v4
# ipadm create-addr -T dhcp net1
ipadm: net1/v4
# ipadm create-addr -T dhcp net2
ipadm net2/v4

Lastly, the net2 interface is configured as a standby interface.

# ipadm set-ifprop -p standby=on -m ip net2