NAME

apdisk - manage disk pathgroups

SYNOPSIS

apdisk -c -p primary_path -a alternate_path

apdisk -d primary_path
apdisk -z primary_path
apdisk -f io_port
apdisk -n io_port
apdisk -u -p primary_path -a alternate_path
apdisk -w io_port

DESCRIPTION

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

apdisk ( 1M ) OPTIONS

-c -p primary_path -a alternate_path

Create database entries for disks (i.e., a SPARCStorage Arrays) connected to two I/O ports. Give the I/O 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 io_port

Mark the I/O port as offline. Corresponding meta-disks can still be used if the other I/O port in the pathgroup is functioning properly. Note that you cannot mark an I/O port offline if it is currently the active alternate.

-n io_port

Mark the I/O port as online. Note that this operation does not automatically cause the I/O 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.

-w io_port

Clear the tried flag for the specified I/O port.

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 -i ap_dmd
# apconfig -R

Example 2

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

# apdisk -d sf1
# apdb -C

SEE ALSO

Sun Enterprise Server Alternate Pathing User's Guide

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

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