Maintaining IPMP

This section contains procedures for maintaining the IPMP group that you have created on the system.

How to Add an Interface to an IPMP Group
How to Remove an Interface From an IPMP Group
How to Add IP Addresses
How to Delete IP Addresses
How to Move an Interface From One IPMP Group to Another IPMP Group
How to Delete an IPMP Group

How to Add an Interface to an IPMP Group

Before You Begin

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

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
If the underlying IP interface does not yet exist, create the interface.
```
# ipadm create-ip under-interface
```
Add the IP interface to the IPMP group.
```
# ipadm add-ipmp -i under-interface ipmp-interface
```
where ipmp-interface refers to the IPMP group to which you want to add the underlying interface.

Example 6-4 Adding an Interface to an IPMP Group

The following example adds the interface net4 to the IPMP group ipmp0:

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

How to Remove an Interface From an IPMP Group

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Remove one or more interfaces from the IPMP group.
```
# ipadm remove-ipmp -i under-interface[ -i under-interface ...] ipmp-interface
```
where under-interface refers to an IP interface that you are removing from the IPMP group and ipmp-interface refers to the IPMP group from which you are removing underlying interfaces.
You can remove as many underlying interfaces in a single command as required. Removing all underlying interfaces does not delete the IPMP interface. Instead, it exists as an empty IPMP interface or group.

Example 6-5 Removing an Interface From an IPMP Group

The following example removes the interface net4 from the IPMP group ipmp0:

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

How to Add IP Addresses

To add IP addresses, you use the ipadm create-addr subcommand. Note that in IPMP, an IP address can be either a data address or a test address. A data address is added to an IPMP interface. A test address is added to an underlying interface of the IPMP interface. The following procedure describes how to add IP addresses that are either test addresses or data addresses.

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
To add data addresses to an IPMP group, type the following command:
```
# ipadm create-addr -a address ipmp-interface
```
An address object is automatically assigned to the IP address that you just created. An address object is a unique identifier of the IP address. The address object's name uses the naming convention interface/random-string. Thus, address objects of data addresses would include the IPMP interface in their names.
To add test addresses to an underlying interface of an IPMP group, type the following command:
```
# ipadm create-addr -a address under-interface
```
An address object is automatically assigned to the IP address that you just created. An address object is a unique identifier of the IP address. The address object's name uses the naming convention interface/random-string. Thus, address objects of test addresses would include the underlying interface in their names.

How to Delete IP Addresses

To remove IP addresses, you use the ipadm delete-addr subcommand. Note that in IPMP, data addresses are hosted on the IPMP interface and test addresses are hosted on underlying interfaces. The following procedure shows how to remove IP addresses that are either data addresses or test addresses.

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Determine the addresses that you want to remove.
- To display a list of data addresses, type the following command:
```
# ipadm show-addr ipmp-interface
```
- To display a list of test addresses, type the following command:
```
# ipadm show-addr
```
  Test addresses are identified by address objects whose names include the underlying interfaces where the addresses are configured.
To remove data addresses from an IPMP group, type the following command:
```
# ipadm delete-addr addrobj
```
where addrobj must include the name of the IPMP interface. If the address object that you type does not include the IPMP interface name, then the address that will be deleted is not a data address.
To remove test addresses from an IPMP group, type the following command:
```
# ipadm delete-addr addrobj
```
where addrobj must include the name of the correct underlying interface to delete the correct test address.

Example 6-6 Removing a Test Address From an Interface

The following example uses the configuration of the active-standby IPMP group ipmp0 in Example 6-3. The example removes the test address from the underlying interface net1.

# ipadm show-addr net1
ADDROBJ           TYPE     STATE     ADDR
net1/v4           static   ok        192.168.10.30

# ipadm delete-addr net1/v4

How to Move an Interface From One IPMP Group to Another IPMP 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.

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
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 to which you want to move the underlying interface.

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

In this example, the underlying interfaces of the IPMP group are net0, net1, and net2. The following command removes the net0 interface from IPMP group ipmp0 and then places net0 in the IPMP group cs-link1:

# ipadm add-ipmp -i net0 ca-link1

How to Delete an IPMP Group

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

Become an administrator.
For more information, see How to Use Your Assigned Administrative Rights in Oracle Solaris 11.1 Administration: Security Services.
Identify the IPMP group and the underlying IP interfaces to be deleted.
```
# ipmpstat -g
```
Remove all IP interfaces that currently belong to the IPMP group.
```
# ipadm remove-ipmp -i under-interface[, -i under-interface, ...] ipmp-interface
```
where under-interface refers to the underlying interface that you want to remove and ipmp-interface refers to the IPMP interface from which you want to remove the underlying interface.

Note - To successfully delete an IPMP interface, no IP interface must exist as part of the IPMP group.
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 6-8 Deleting an IPMP Interface

The following example deletes the interface ipmp0 with the underlying IP interface net0 and net1:

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

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

# ipadm delete-ipmp ipmp0

Skip Navigation Links
Exit Print View
	Managing Oracle Solaris 11.1 Network Performance Oracle Solaris 11.1 Information Library