Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsif_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 interface. All network access will failback to hme0 from another interface in the group.
 
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 attributes:

ATTRIBUTE TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu
Interface StabilityUnstable

SEE ALSO

 

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

DIAGNOSTICS

 

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 configuration was not suitable for completing a failover.

off-line cannot be undone as failback has been disabled.

FAILBACK is set to "no" in /etc/default/mpathd.

off-line cannot be undone because multipathing configuration is not consistent across all the interfaces in the group.

This message means that some interfaces in the multipathing 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.9Go To TopLast Changed 11 Sep 2000

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.