| Skip Navigation Links | |
| Exit Print View | |
![]() | man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- administer interfaces in an IP multipathing group
if_mpadm-d |-rifname
Theif_mpadm utility administers IP interfaces that are part of an IPMultipathing (IPMP) group. Currently, administration is limited to offlining IP interfaces andundoing previous offline operations.
When an IP interface is taken offline, all IP data traffic thatwas flowing over the IP interface is moved to another IP interfacein the IPMP group. In addition, allUP IP addresses hosted onthe IP interface are brought down, causingin.mpathd(1M) to stop probe-based failuredetection on the IP interface. As a result, an offline IP interfacewill not be used for any inbound or outbound IP traffic. OnlyIP interfaces that are in an IPMP group may be brought offline. Ifthe IP interface is the last functioning interface in the IPMP group,the offline operation will fail.
When an offline operation is undone, any IP addresses hosted on thatIP interface are broughtUP and will be considered byin.mpathd forprobe-based failure detection. In addition, provided the IP interface is otherwise active(seein.mpathd(1M)), it will again be used to send and receive IPdata traffic for the IPMP group. Note that not all offline operationscan be undone. For instance,in.mpathd may have offlined an IP interface becauseits hardware address was not unique within its IPMP group. Theipmpstatutility can be used to determine why an IP interface is offline,identify which IP interfaces in a group are being used for inboundand outbound IP traffic, and more; seeipmpstat(1M).
Theif_mpadm utility supports the following options:
Offline the IP interface specified byifname. Ififname is not in an IPMP group, or the offline would cause the IPMP group to lose network connectivity, the operation will fail.
Undo a previous offline of the IP interface specified byifname. Ififname is not offline, the operation will fail.
Example 1 Offlining an IP Interface
The following command offlines the IP interfaceunder0, causing any IP packetsthat were being sent and received through it to be handled byanother IP interface in its group.
example%if_mpadm -d under0
Example 2 Undoing a Previous Offline Operation
Use the following command to undo the operation in the previous example:
example%if_mpdadm -r under0
Seeattributes(5) for descriptions of the following attributes:
|
ifconfig(1M),in.mpathd(1M),ipmpstat(1M),attributes(5)
cannot offline: no other functioning interfaces are in its IPMP group.
Description: This message means that offlining the IP interface would leave the IPMPgroup without network connectivity.
cannot offline: not a physical interface or not in an IPMP group
Description: This means that the IP interface is not an underlying interface inan IPMP group, and therefore is not eligible to be offlined.
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices | ![]() ![]() |