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. On the system with the IPMP group configuration, assume the Primary Administrator role or become superuser.

   The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

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 8–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. On the system with the IPMP group configuration, assume the Primary Administrator role or become superuser.

   The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

2. Remove the interface from the IPMP group.

   # ifconfig interface group ""

   The quotation marks indicate a null string.

Example 8–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. Assume the role of Primary Administrator, or become superuser.

   The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

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 8–5 Removing a Test Address From an Interface

The following example uses the configuration of itops0 in Example 8–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. On the system with the IPMP group configuration, assume the Primary Administrator role or become superuser.

   The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

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 8–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. Assume the role of Primary Administrator, or become superuser.

   The Primary Administrator role includes the Primary Administrator profile. To create the role and assign the role to a user, see Chapter 2, Working With the Solaris Management Console (Tasks), in System Administration Guide: Basic Administration.

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 8–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.