Go to main content

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

Exit Print View

Updated: November 2020

How to Configure an Active-Standby IPMP Group

The following procedure describes how to configure an IPMP group in which one interface is kept as a standby interface. This interface is deployed only when an active interface in the group fails.

For overview information about standby interfaces, see Types of IPMP Interface Configurations.

Before You Begin

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

  1. Create an IPMP interface.
    $ ipadm create-ipmp ipmp-interface

    ipmp-interface specifies the name of the IPMP interface.

  2. Add the underlying IP interfaces to the group.
    $ ipadm add-ipmp -i under-interface1 [-i underinterface2 ...] ipmp-interface

    under-interface refers to the underlying interface of the IPMP group. You can add as many IP interfaces as are available on the system.

    Note -  In a dual-stack environment, placing the IPv4 instance of an interface under a particular IPMP group automatically places the IPv6 instance under the same group.
  3. Add the data addresses to the IPMP interface.
    $ ipadm create-addr -a address ipmp-interface

    address can be in CIDR notation.

  4. If you use probe-based failure detection with test addresses, add the test addresses on the underlying interfaces.
    $ ipadm create-addr -a address under-interface

    address can be in CIDR notation. All test IP addresses in an IPMP group must belong to a single IP subnet and therefore use the same network prefix.

  5. Configure one of the underlying interfaces as a standby interface.
    $ ipadm set-ifprop -p standby=on -m ip under-interface
Example 15  Configuring an Active-Standby IPMP Group

This example shows how to create an active-standby IPMP configuration.

$ ipadm create-ipmp ipmp0

$ ipadm create-ip net0
$ ipadm create-ip net1
$ ipadm create-ip net2
$ ipadm add-ipmp -i net0 -i net1 -i net2 ipmp0

$ ipadm create-addr -a ipmp0
ipadm: ipmp0/v4
$ ipadm create-addr -a ipmp0
ipadm: ipmp0/v4a

$ ipadm create-addr -a net0
ipadm: net0/v4
$ ipadm create-addr -a net1
ipadm: net1/v4
$ ipadm create-addr -a net2
ipadm: net2/v4

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

$ ipmpstat -g
ipmp0     ipmp0      ok         10.00s     net0 net1 (net2)

$ ipmpstat -t
net0       routes
net1       routes
net2       routes