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.
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.
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.
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.
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 |
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.
Remove the interface from the IPMP group.
# ifconfig interface group "" |
The quotation marks indicate a null string.
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 |
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.
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.
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 |
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 |
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 |
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.
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.
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.
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.
Use this procedure if you no longer need a specific IPMP group.
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.
Identify the IPMP group and the underlying IP interfaces.
# ipmpstat -g |
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.
To successfully delete an IPMP interface, no IP interface must exist as part of the IPMP group.
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.
To make the deletion persistent, perform the following additional steps:
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.