if_mpadm

 

---

 
 
 
 Maintenance Commands                                 if_mpadm(1M)
 
 
 


NAME
      if_mpadm - change operational status of interfaces within  a
      multipathing group
 


SYNOPSIS
      /usr/sbin/if_mpadm -d interface_name
 
      /usr/sbin/if_mpadm -r interface_name
 


DESCRIPTION
      Use the if_mpadm utility to change the operational status of
      interfaces  that  are  part  of a multipathing group. If the
      interface is operational, you can use if_mpadm -d to  detach
      or  off-line  the  interface. If the interface is off-lined,
      use if_mpadm -r to revert it to its original state.
 
      When a network interface is off-lined,  all  network  access
      fails  over  to  a  different  interface in the multipathing
      group. Any addresses that do not failover are brought  down.
      Network  access  includes  unicast, broadcast, and multicast
      for IPv4 and unicast  and  multicast  for  IPv6.   Addresses
      marked  with IFF_NOFAILOVER do not failover; they are marked
      down. After an interface is off-lined, the system  will  not
      use  the  interface for any outbound or inbound traffic, and
      the interface can be safely removed from the system  without
      any loss of network access.
 
      The if_mpadm utility can be applied only to interfaces  that
      are part of a multipathing group.
 


OPTIONS
      The if_mpadm utility supports the following options:
 
      -d interface_name
            Detach  or  off-line  the   interface   specified   by
                interface_name.
 
      -r interface_name
             Reattach or undo  the  previous  detach  or  off-line
            operation    on    the    interface    specified    by
            interface_name. Unless  the  -d  option  was  used  to
            detach  or  off-line  the  interface, this option will
            fail.
 
 EXAMPLES
      Example 1: Detaching an Interface
 
      Use the following command to off-line or detach  the  inter-
      face.  All network access will failback to hme0 from another
      interface in the group.
 
 
 
 
 
 SunOS 5.8           Last change: 11 Sep 2000                    1
 
 
 
 
 
 
 Maintenance Commands                                 if_mpadm(1M)
 
 
 
      example% if_mpadm -d hme0
 
      Example 2: Reattaching an Off-line Interface
 
      Use the following command to undo  the  previous  operation.
      Network  access will failback over to hme0 from an interface
      in the same multipathing group.
 
      example% if_mpdadm -r hme0
 


ATTRIBUTES
      See attributes(5) for descriptions of the  following  attri-
      butes:
 
      ____________________________________________________________
     |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
     |_____________________________|_____________________________|
     | Availability                | SUNWcsu                     |
     |_____________________________|_____________________________|
     | Interface Stability         | Unstable                    |
     |_____________________________|_____________________________|
 
 


SEE ALSO
      ifconfig(1M), in.mpathd(1M), attributes(5)
 


DIAGNOSTICS
   Message Set
      Message Entry
 
           Message:
 
           Message text:  off-line failed as  there  is  no  other
           functional  interface  available  in  the  multipathing
           group for failing over the network access.
 
           This message means that other interfaces in  the  group
           are  failed over already or the multipathing configura-
           tion was not suitable for completing a failover.
 
      Message Entry
 
           Message:
 
           Message text:  off-line cannot be  undone  as  failback
           has been disabled.
 
           FAILBACK is set to "no" in /etc/default/mpathd.
 
      Message Entry
 
 
 
 
 
 SunOS 5.8           Last change: 11 Sep 2000                    2
 
 
 
 
 
 
 Maintenance Commands                                 if_mpadm(1M)
 
 
 
           Message:
 
           Message text:  off-line cannot be undone  because  mul-
           tipathing  configuration  is  not consistent across all
           the interfaces in the group.
 
           This message means that some  interfaces  in  the  mul-
           tipathing  group  are  not configured consistently with
           other interfaces in the group, for example, one of  the
           interfaces in the group does not have an IFF_NOFAILOVER
           address.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 SunOS 5.8           Last change: 11 Sep 2000                    3
 
 
 

---