apnet(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO

NAME

apnet- manage network pathgroups

SYNOPSIS

apnet -c -p  netwk_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

The following options are supported:

---

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 metanetwork and network pathgroup for the network connected to the specified network controller paths. If -a is given, apnet designates the specified network interface as the alternate for the metanetwork. (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 metanetwork and corresponding network pathgroup. If the pathgroup is currently uncommitted, apnet removes the metanetwork and the pathgroup immediately. If the pathgroup is committed, the metanetwork and pathgroup are only marked for deletion, and the metanetwork interface continues to function until a commit is performed.

-z meta_ntwk_intrfc

Undelete the specified metanetwork 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 metanetwork 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 metanetwork interface.

Note: A network controller path cannot be marked as offline if it is active.

-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 performed before the change takes effect. In practice, the existing metanetwork interface is marked for deletion and a new one is created without affecting usage of the existing interface.

-t meta_ntwk_intrfc

Make the next alternate path (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 Creating a Network Pathgroup and Metanetwork Interface




The following command creates a network pathgroup and a metanetwork 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 Deleting a Network Pathgroup and Metanetwork Interface




The following example deletes the network pathgroup and metanetwork interface mle0:

# apnet -d mle0 # apdb -C

---

SEE ALSO

Sun Enterprise Server Alternate Pathing User's Guide

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

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO