1if_mpadm(1M) System Administration Commands if_mpadm(1M)
2
3
4
6 if_mpadm - administer interfaces in an IP multipathing group
7
9 if_mpadm -d | -r ifname
10
11
13 The if_mpadm utility administers IP interfaces that are part of an IP
14 Multipathing (IPMP) group. Currently, administration is limited to
15 offlining IP interfaces and undoing previous offline operations.
16
17
18 When an IP interface is taken offline, all IP data traffic that was
19 flowing over the IP interface is moved to another IP interface in the
20 IPMP group. In addition, all UP IP addresses hosted on the IP interface
21 are brought down, causing in.mpathd(1M) to stop probe-based failure
22 detection on the IP interface. As a result, an offline IP interface
23 will not be used for any inbound or outbound IP traffic. Only IP inter‐
24 faces that are in an IPMP group may be brought offline. If the IP
25 interface is the last functioning interface in the IPMP group, the off‐
26 line operation will fail.
27
28
29 When an offline operation is undone, any IP addresses hosted on that IP
30 interface are brought UP and will be considered by in.mpathd for probe-
31 based failure detection. In addition, provided the IP interface is oth‐
32 erwise active (see in.mpathd(1M)), it will again be used to send and
33 receive IP data traffic for the IPMP group. Note that not all offline
34 operations can be undone. For instance, in.mpathd may have offlined an
35 IP interface because its hardware address was not unique within its
36 IPMP group. The ipmpstat utility can be used to determine why an IP
37 interface is offline, identify which IP interfaces in a group are being
38 used for inbound and outbound IP traffic, and more; see ipmpstat(1M).
39
41 The if_mpadm utility supports the following options:
42
43 -d ifname Offline the IP interface specified by ifname. If ifname is
44 not in an IPMP group, or the offline would cause the IPMP
45 group to lose network connectivity, the operation will
46 fail.
47
48
49 -r ifname Undo a previous offline of the IP interface specified by
50 ifname. If ifname is not offline, the operation will fail.
51
52
54 Example 1 Offlining an IP Interface
55
56
57 The following command offlines the IP interface under0, causing any IP
58 packets that were being sent and received through it to be handled by
59 another IP interface in its group.
60
61
62 example% if_mpadm -d under0
63
64
65
66 Example 2 Undoing a Previous Offline Operation
67
68
69 Use the following command to undo the operation in the previous exam‐
70 ple:
71
72
73 example% if_mpdadm -r under0
74
75
76
78 See attributes(5) for descriptions of the following attributes:
79
80
81
82
83 ┌─────────────────────────────┬─────────────────────────────┐
84 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
85 ├─────────────────────────────┼─────────────────────────────┤
86 │Availability │SUNWcsu │
87 ├─────────────────────────────┼─────────────────────────────┤
88 │Interface Stability │Unstable │
89 └─────────────────────────────┴─────────────────────────────┘
90
92 ifconfig(1M), in.mpathd(1M), ipmpstat(1M), attributes(5)
93
95 cannot offline: no other functioning interfaces are in its IPMP group.
96 Description:
97
98
99 This message means that offlining the IP interface would leave the
100 IPMP group without network connectivity.
101
102
103
104 cannot offline: not a physical interface or not in an IPMP group
105 Description:
106
107
108 This means that the IP interface is not an underlying interface in
109 an IPMP group, and therefore is not eligible to be offlined.
110
111
112
113
114SunOS 5.11 5 Jan 2009 if_mpadm(1M)