NAME

apnet - manage network pathgroups

SYNOPSIS

apnet -c -p ntwk_intrfc [-a ntwk_intrfc]

apnet -d meta_ntwk_intrfc
apnet -z meta_ntwk_intrfc
apnet -f ntwk_intrfc
apnet -n ntwk_intrfc
apnet -m meta_ntwk_intrfc -a ntwk_intrfc
apnet -m meta_ntwk_intrfc -r ntwk_intrfc
apnet -t meta_ntwk_intrfc
apnet -w meta_ntwk_intrfc

DESCRIPTION

The /usr/sbin/apnet command helps you manage network pathgroups in the Alternate Pathing (AP) system.

OPTIONS

Note:

The parameters meta_ntwk_intrfc and ntwk_intrfc are strings of the form type instance_#, but with no space between them; for example, mle0 and mle1.

-c -p ntwk_intrfc [-a ntwk_intrfc]

Create a meta-network interface and network pathgroup for the specified network. If -a is given, apnet designates the specified network interface as the alternate for the meta-network interface. (If you initially create a network pathgroup with only one path, you can later add an additional path using apnet -m.)

-d meta_ntwk_intrfc

Delete the specified meta-network interface and corresponding network pathgroup. If the pathgroup is currently uncommitted, apnet removes the interface and the pathgroup immediately. If the pathgroup is committed, the interface and pathgroup are only marked for deletion, and the interface continues to function until a commit is performed.

-z meta_ntwk_intrfc

Undelete the specified meta-network interface and pathgroup. This option cancels a previous apnet -d request that marked a committed pathgroup for deletion.

-f ntwk_intrfc

Mark the specified network interface as offline and therefore inaccessible through its meta-network interface.

Note:

An interface cannot be marked as offline if it is active.

-n ntwk_intrfc

Mark the specified network interface as online and therefore accessible through its meta-network interface.

-m meta_ntwk_intrfc -a ntwk_intrfc

Add the specified network interface as the alternate for the specified network pathgroup. You can use this option only if the network pathgroup currently contains exactly one path.

-m meta_ntwk_intrfc -r ntwk_intrfc

Remove the specified network interface from the specified network pathgroup.

Note:

When an alternate is added (-a )or removed (-r) from a committed network pathgroup, a commit operation must be done for the change to take effect. In practice, the existing meta-network interface is marked for deletion and a new one is created without affecting current usage of the interface.

-t meta_ntwk_intrfc

Make the next alternate path in sequence (after the primary) the temporary active path. This option is intended for scripts that are trying alternate paths in sequence until a working path is found. The command returns an error if the sequencing wraps back to the original primary.

-w meta_ntwk_intrfc

Make the current temporary active path the actual active path.

EXAMPLES

Example 1

The following example creates a network pathgroup and a meta-network interface, mle0, which has le0 as its primary physical network interface and le1 as its alternate physical network interface.

# apnet -c -p le0 -a le1
# apdb -C

Example 2

The following example deletes the network pathgroup and meta-network interface mle0:

# apnet -d mle0
# apdb -C

apnet ( 1M ) SEE ALSO

Sun Enterprise Server Alternate Pathing User's Guide

apconfig(1M), apdb(1M), apdisk(1M)