NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO
The /usr/sbin/apconfig command displays and helps you manage the Alternate Pathing (AP) system configuration.
The following options are supported:
Display location and status information for all known copies of the host database.
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.
Display network AP information only. For each pathgroup, apconfig -N displays the metanetwork 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 "Character flags after meta device names" and "Character flags after physical device paths", below.
Switch to the new physical path specified by -a for the metanetwork specified by -P.
Switch to the new physical path specified by -a for the metadisk associated with the primary path specified by -P.
Rebuild the metadisk device nodes in /dev/ap/dsk and /dev/ap/rdsk. The apconfig command creates links to /devices for all committed disk pathgroups in the database.
You must execute drvconfig -i ap_dmd before you can execute apconfig -R. See drvconfig(1M) and ap_dmd(7).
Display alternate pathing information for disk pathgroups only. For each pathgroup, apconfig shows the names for the metadisk, 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.
When you specify -N or -S, one or more of the following letters may be displayed after each meta-network or meta-disk name:
Marked for deletion. The metadisk or metanetwork remains in the database and continues to be used by AP until a commit is done. See apdb(1M).
Uncommitted. Note that you cannot use a metadisk or metanetwork until a commit has been done.
Marked for use as a root device. -S only.
Marked as the mirror for a boot device. -S only.
The physical paths for this metadisk lead to different disks (that is, different SSAs). -S only.
When you specify -N or -S, one or more of the following letters may be displayed after each physical network path or physical disk I/O port name:
Automatic switching is not allowed for this physical device.
The physical paths for this meta-disk lead to different disks (that is, different SSA's). -S only.
The active alternate. To select another interface, use the -P and -a options.
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.
Marked as detached by Dynamic Reconfiguration.
The primary path. The primary path cannot be changed.
Path has been tried as active.
Marked as offline. See apdisk(1M) and apnet(1M).
The following command displays all of the committed disk pathgroups in the AP database.
# apconfig -S c6 pln0 A c2 pln3 P metadiskname(s): mc2t5d0 mc2t4d0 R mc2t3d0 mc2t2d0 mc2t1d0 mc2t0d0 |
The following example displays all of the uncommitted network pathgroups in the AP database:
# apconfig -N -u metanetwork: mqe0 U physical devices: qe1 qe0 P A |
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 |
The following example switches the active alternate of the network pathgroup identified by the metanetwork interface mqe0. The new active alternate of that network pathgroup is qe1.
# apconfig -P mqe0 -a qe1 |
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 |
Sun Enterprise Server Alternate Pathing User's Guide
apdb(1M), apdisk(1M), apnet(1M), ap_dmd(7) in this reference manual
drvconfig(1M) in the man Pages(1M): System Administration Commands of SunOS Reference Manual
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO