NAME

apdisk - manage disk pathgroups

SYNOPSIS

apdisk -c -p primary_path -a alternate_path [-hhostname]

apdisk -d primary_path [-h hostname]

apdisk -z primary_path [-h hostname]

apdisk -f pln_port [-h hostname]

apdisk -n pln_port [-h hostname]

apdisk -u -p primary_path -a alternate_path [-hhostname]s

DESCRIPTION

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

AP Commands..apdisk ( 1M ) OPTIONS

-h hostname

The name of the host on which the AP daemon resides.

-c -p primary_path -a alternate_path

Create database entries for a disk (i.e., a SPARCStorage Array) that is connected to two pln ports. Give the pln port names (e.g., pln0 and pln1) as the primary_path and alternate_path.

-d primary_path

Delete AP information for the specified disk pathgroup. If the existing information is uncommitted, apdisk removes it immediately. If the existing information is already committed, it is only marked for deletion and existing meta-devices continue to function until a commit is done, at which time the information is removed.

-z primary_path Undelete AP information for the specified disk pathgroup. This option

cancels a previous apdisk -d request that marked committed information for deletion.

-f pln_port

Mark the pln port as offline. The corresponding meta-disk can still be used if the other pln port in the pathgroup is functioning properly. Note that you cannot take a pln port offline if it is currently the active alternate.

-n pln_port

Mark the pln port as online. Note that this operation does not automatically cause the pln port to become the active alternate.

-u -p primary_path -a alternate_path

Update existing database entries for the disk pathgroup identified by the primary path (e.g., pln0). Disk targets that are no longer accessible through one or more paths are removed, and new disk targets are added. To update the meta-disk device nodes execute drvconfig -i ap_dmd and apconfig -R. See apconfig(1M) in this document and drvconfig(1M) in man Pages(1M): System Administration Commands of the SunOS Reference Manual.

EXAMPLES

Example 1

The following example creates meta-disk device nodes and AP database entries for disks reachable through pln0 and pln1, with pln0 specified as the primary path.

# apdisk -c -p pln0 -a pln1
# apdb -C
# drvconfig
# apconfig -R

Example 2

The following example deletes the AP database entries for disks with pln1 specified as the primary path.

# apdisk -d pln1
# apdb -C

SEE ALSO

Alternate Pathing 2.0 User's Guide

apdb(1M), apconfig(1M), apinst(1M), apnet(1M) in this reference manual

devlinks(1M), drvconfig(1M) in the SunOS Reference Manual