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 System Administration Guide: Security Services.

2. Add the IP interface to the IPMP group.

   # ifconfig interface group group-name

   The interface specified in interface becomes a member of IPMP group group-name.

Example 14-3 Adding an Interface to an IPMP Group

To add the interface hme0 to the IPMP group itops0, you would type the following command:

# ifconfig hme0 group itops0
# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT       INTERFACES
itops0  itops0      ok         10.00s    subitops0 subitops1 hme0

How to Remove an Interface From an IPMP Group

1. Become an administrator.

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

2. Remove the interface from the IPMP group.

   # ifconfig interface group ""

   The quotation marks indicate a null string.

Example 14-4 Removing an Interface From a Group

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

# ifconfig hme0 group ""
# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT       INTERFACES
itops0  itops0      ok         10.00s    subitops0 subitops1

How to Add or Remove IP Addresses

You use the ifconfig addif syntax to add addresses or the ifconfig removeif command 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 System Administration Guide: Security Services.

2. Add or remove data addresses.

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

     # ifconfig ipmp-interface addif ip-address up

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

     # ifconfig ipmp-interface removeif ip-address

3. Add or remove test addresses.

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

     # ifconfig interface addif -failover ip-address up

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

     # ifconfig interface removeif ip-address

Example 14-5 Removing a Test Address From an Interface

The following example uses the configuration of itops0 in Example 14-2. The step removes the test address from the interface subitops0.

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

# ifconfig subitops0 removeif 192.168.85.30

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 System Administration Guide: Security Services.

2. Move the interface to a new IPMP group.

   # ifconfig interface group group-name

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

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

This example assumes that the underlying interfaces of your group are subitops0, subitops1, subitops2, and hme0. To change the IPMP group of interface hme0 to the group cs-link1, you would type the following:

# ifconfig hme0 group cs-link1

This command removes the hme0 interface from IPMP group itops0 and then puts the interface in the group 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 System Administration Guide: 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.

   # ifconfig ip-interface group ""

   Repeat this step for all the IP interfaces that belong to the group.

   ---

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

   ---

4. Delete the IPMP interface.

   # ifconfig ipmp-interface unplumb

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

5. To make the deletion persistent, perform the following additional steps:
   1. Delete the IPMP interface's corresponding hostname file.

      # rm /etc/hostname.ipmp-interface

   2. Remove the “group” keywords in the hostname files of the underlying interfaces.

Example 14-7 Deleting an IPMP Interface

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

# ipmpstat -g
GROUP   GROUPNAME   STATE      FDT        INTERFACES
itops0  itops0      ok         10.00s     subitops0 subitops1

# ifconfig subitops0 group ""
# ifconfig subitops1 group ""
# ifconfig itops0 unplumb
# rm /etc/hostname.itops0

You would then edit the files /etc/hostname.subitops0 and /etc/hostname.subitops1 to remove “group” entries in those files.