NAME

apconfig - display and manage AP configuration

SYNOPSIS

apconfig -D

apconfig -F

apconfig -N [-u]

apconfig -P meta_netwk_intrfc -a new_phys_path
apconfig -P primary_path -a new_phys_path
apconfig -R
apconfig -S [-u]

DESCRIPTION

The /usr/sbin/apconfig command displays and helps you manage the Alternate Pathing (AP) system configuration.

OPTIONS

-D

Display location and status information for all known copies of the host database.

-F

Force the state (attached or detached) of every committed pathgroup alternate to match the physical state of the system. Use this option if the two states differ. It refreshes the Dynamic Reconfiguration (DR) flags for every disk I/O port and physical network interface defined for all committed pathgroups.

-N [-u]

Display network AP information only. For each pathgroup, apconfig -N displays the meta-network interface and the corresponding physical network interfaces.

If you specify the -u option, apconfig displays uncommitted pathgroup information only. If you do not specify the -u option, apconfig displays committed pathgroup information only. See Letters after names and paths, below.

-P meta_ntwrk_intrfc -a new_phys_path
                Switch to the new physical path specified by -a for the meta-network
                specified by -P.

-P primary_path -a new_phys_path

Switch to the new physical path specified by -a for the primary path specified by -P.

-R

Rebuild the meta-disk device nodes in /dev/ap/dsk and /dev/ap/rdsk. apconfig creates links to /devices for all committed disk pathgroups in the database.

Note:

You must execute drvconfig -i ap_dmd before you can

execute apconfig -R. See drvconfig(1M) and

ap_dmd(7).

-S [-u]

Display alternate pathing information for disk pathgroups only. (S stands for SCSI.) For each pathgroup, apconfig shows the names for the meta-disk, its physical devices, and the disk I/O ports through which

each physical device is accessed.

If you specify the -u option, apconfig displays only uncommitted pathgroup information. Otherwise, it displays only committed pathgroup information. See Letters after names and paths, below.

Letters after names and paths

When you specify -N or -S, one or more of the following letters may be displayed after each meta-network or meta-disk name:

D

Marked for deletion. The meta-disk or meta-network remains in the database and continues to be used by AP until a commit is done. See apdb(1M).

U

Uncommitted. Note that you cannot use a meta-disk or meta-network until a commit has been done.

R

Marked for use as a root device. -S only.

M

Marked as the mirror for a boot device. -S only.

X

The physical paths for this meta-disk lead to different disks (i.e., different SSA's). -S only.

When you specify -N or -S, one or more of the following letters may be displayed after each physical network name or disk I/O port name:

A

The active alternate. To select another interface, use the -P and -a options.

DR

Marked as being drained by Dynamic Reconfiguration. A switch cannot be made to a device path in this state. See the Sun Enterprise Server Alternate Pathing User's Guide.

DE Marked as detached by Dynamic Reconfiguration.
P   The primary path. The primary path cannot be changed.
T   Path has been tried as active.
O Marked as offline. See apdisk(1M) and apnet(1M).

EXAMPLES

apconfig ( 1M ) Example 1

The following example displays all committed disk pathgroups in the AP database:

# apconfig -S

c6      pln0    A
c2      pln3    P
        metadiskname(s):
                mc2t5d0
                mc2t4d0     R
                mc2t3d0
                mc2t2d0
                mc2t1d0
                mc2t0d0

Example 2

The following example displays all uncommitted network pathgroups in the AP database.

# apconfig -N -u

meta-network:        mqe0    U
physical devices:
          qe1
          qe0       P A

Example 3

The following example switches the active alternate of the disk pathgroup for which the primary path is pln1. The new active alternate of that pathgroup is pln0.

# apconfig -P pln1 -a pln0

Example 4

The following example switches the active alternate of the network pathgroup identified by the meta-network interface mqe0 . The new active alternate of that network pathgroup is qe1.

# apconfig -P mqe0 -a qe1

Example 5

The following example displays the location and status information of all known copies of the AP database.

# apconfig -D

path: /dev/rdsk/c3t3d0s1
major: 32
minor: 145
timestamp: Wed Sep 28 18:45:58 1994
checksum: 2636010350
default: yes
corrupt: no
inaccessible: no

path: /dev/rdsk/c3t3d0s6
major: 32
minor: 150
timestamp: Wed Sep 28 18:50:43 1994
checksum: 2636010350
default: no
synced: yes
corrupt: no
inaccessible: no

apconfig ( 1M ) SEE ALSO

Sun Enterprise Server Alternate Pathing User's Guide

apdb(1M), apdisk(1M), apnet(1M), ap_dmd(7) in this reference manual

drvconfig(1M) in man Pages(1M): System Administration Commands of the SunOS Reference Manual