Maintaining IPMP Groups

This section contains tasks for maintaining existing IPMP groups and the interfaces within those groups. The tasks presume that you have already configured an IPMP group, as explained in Configuring IPMP Groups.

How to Add an Interface to an IPMP Group

Before You Begin

Make sure that the interface that you add to the group matches all the constraints to be in the group. For a list of the requirements of an IPMP group, see How to Plan an IPMP Group.

1. Become an administrator.

   For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.

2. If the underlying IP interface does not yet exist, create the interface.

   # ipadm create-ip interface

3. Add the IP interface to the IPMP group.

   # ipadm add-ipmp -i under-interface ipmp-interface

Example 15-3 Adding an Interface to an IPMP Group

To add the interface net4 to the IPMP group itops0, you would type the following commands:

# ipadm create-ip net4
# ipadm add-ipmp -i net4 itops0
# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT       INTERFACES
itops0  itops0      ok         10.00s    net0 net1 net4

How to Remove an Interface From an IPMP Group

1. Become an administrator.

   For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.

2. Remove the interface from the IPMP group.

   # ipadm remove-ipmp -i under-interface[, -i under-interface, ...] ipmp-interface

   You can remove as many underlying interfaces in a single command as required. Removing all underlying interfaces does not delete the IPMP interface. Rather exists as an empty IPMP interface or group.

Example 15-4 Removing an Interface From a Group

To remove the interface net4 from the IPMP group itops0, you would type the following command:

# ipadm remove-ipmp net4 itops0
# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT       INTERFACES
itops0  itops0      ok         10.00s    net0 net1

How to Add or Remove IP Addresses

You use the ipadm create-addr subcommand to add addresses or the ipadm delete-addr subcommand to remove addresses from interfaces. In the current IPMP implementation, test addresses are hosted on the underlying IP interface, while data addresses are assigned to the IPMP interface. The following procedures describes how to add or remove IP addresses that are either test addresses or data addresses.

1. Become an administrator.

   For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.

2. Add or remove data addresses.

   • To add data addresses to the IPMP group, type the following command:

     # ipadm create-addr -T static -a ip-address addrobj

     The addrobj uses the naming convention ipmp-interface/user-string.

   • To remove an address from the IPMP group, type the following command:

     # ipadm delete-addr addrobj

     The addrobj uses the naming convention inder-interface/user-string.

3. Add or remove test addresses.

   • To assign a test address to an underlying interface of the IPMP group, type the following command:

     # ipadm create-addr -T static ip-address adrobj

   • To remove a test address from an underlying interface of the IPMP group, type the following command:

     # ipadm delete-addr addrobj

Example 15-5 Removing a Test Address From an Interface

The following example uses the configuration of itops0 in Example 15-2. The step removes the test address from the interface net1. In this example, assume that the test address is named net1/test1

# ipmpstat -t
INTERFACE      MODE     TESTADDR        TARGETS
net1      routes   192.168.10.30   192.168.10.1

# ipadm show-addr
ADDROBJ           TYPE     STATE     ADDR
lo0               static   ok        127.0.0.1/8
...
net1/test1        static   ok        192.168.10.30

# ipadm delete-addr net1/test1

How to Move an Interface From One IPMP Group to Another Group

You can place an interface in a new IPMP group when the interface belongs to an existing IPMP group. You do not need to remove the interface from the current IPMP group. When you place the interface in a new group, the interface is automatically removed from any existing IPMP group.

1. Become an administrator.

   For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.

2. Move the interface to a new IPMP group.

   # ipadm add-ipmp -i under-interface ipmp-interface

   where under-interface refers to the underlying interface that you want to move and ipmp-interface refers to the IPMP interface or group to which you want to move the underlying interface.

   Placing the interface in a new group automatically removes the interface from any existing group.

Example 15-6 Moving an Interface to a Different IPMP Group

This example assumes that the underlying interfaces of your group are net0, net11, and net2. To move net0 to the IPMP group cs-link1, you would type the following:

# ipadm add-ipmp -i net0 ca-link1

This command removes the net0 interface from IPMP group itops0 and then puts net0 to cs-link1.

How to Delete an IPMP Group

Use this procedure if you no longer need a specific IPMP group.

1. Become an administrator.

   For more information, see How to Obtain Administrative Rights in Oracle Solaris Administration: Security Services.

2. Identify the IPMP group and the underlying IP interfaces.

   # ipmpstat -g

3. Delete all IP interfaces that currently belong to the IPMP group.

   # ipadm remove-ipmp -i under-interface[, -i under-interface, ...] ipmp-interface

   ---

   Note - To successfully delete an IPMP interface, no IP interface must exist as part of the IPMP group.

   ---

4. Delete the IPMP interface.

   # ipadm delete-ipmp ipmp-interface

   After you delete the IPMP interface, any IP address that is associated with the interface is deleted from the system.

Example 15-7 Deleting an IPMP Interface

To delete the interface itops0 that has the underlying IP interface net0 and net1, you would type the following commands:

# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT        INTERFACES
itops0  itops0      ok         10.00s     net0 net1

# ipadm remove-ipmp -i net0 -i net1 itops0

# ipadm delete-ipmp itops0