How to Configure an Active-Standby IPMP Group

Language:

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.

Create an IPMP interface.
```
$ ipadm create-ipmp ipmp-interface
```
ipmp-interface specifies the name of the IPMP interface.
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.
Add the data addresses to the IPMP interface.
```
$ ipadm create-addr -a address ipmp-interface
```
address can be in CIDR notation.
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.
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 192.0.2.5/24 ipmp0
ipadm: ipmp0/v4
$ ipadm create-addr -a 192.0.2.10/24 ipmp0
ipadm: ipmp0/v4a

$ ipadm create-addr -a 192.0.2.15/27 net0
ipadm: net0/v4
$ ipadm create-addr -a 192.0.2.20/27 net1
ipadm: net1/v4
$ ipadm create-addr -a 192.0.2.25/27 net2
ipadm: net2/v4

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

$ ipmpstat -g
GROUP     GROUPNAME   STATE      FDT        INTERFACES
ipmp0     ipmp0      ok         10.00s     net0 net1 (net2)

$ ipmpstat -t
INTERFACE  MODE     TESTADDR        TARGETS
net0       routes   192.0.2.15/27   192.0.2.2/27
net1       routes   192.0.2.20/27   192.0.2.2/17
net2       routes   192.0.2.25/27   192.0.2.5/27