1if_mpadm(1M)            System Administration Commands            if_mpadm(1M)
2
3
4

NAME

6       if_mpadm - administer interfaces in an IP multipathing group
7

SYNOPSIS

9       if_mpadm -d | -r ifname
10
11

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

ATTRIBUTES

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

SEE ALSO

92       ifconfig(1M), in.mpathd(1M), ipmpstat(1M), attributes(5)
93

DIAGNOSTICS

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)
Impressum