Home > Veritas Storage Foundation™ Volume Manager Manual Pages

VXSPCSHOW (1M)

Maintenance Commands

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
NOTES
SEE ALSO

NAME

vxspcshow - add SAL user details or display device properties obtained from SAL

SYNOPSIS

vxspcshow adduser

vxspcshow -u username [-a attribute=value[,attribute=value]]
[-n count] [-c]

vxspcshow -u username [-d disk[,disk]]
[-n count] [-c]

DESCRIPTION

The vxspcshow utility displays complete or partial information about disks that are connected to a host via a storage area network (SAN). The information is obtained from the SAN Access Layer (SAL).

If the keyword adduser is specified as the argument, vxspcshow prompts you to define a SAL user name and password that can be used with the vxassist command. (See the vxassist(1M) manual page for details of the sal_username attribute that is used to specify the user to be authenticated by SAL.) A valid user name must also be specified when using vxspcshow to obtain device properties from SAL. If the user name does not exist in VxVM's database, vxspcshow issues a warning.

vxspcshow can display the properties of a disk in the form of attribute-value pairs, or it can list those disks that have a specified property. If no command-line arguments are specified, vxspcshow displays properties for all disks.

If no applicable record value exists, a dash is displayed in the output.

OPTIONS

-a attribute=value[,attribute=value]...

Lists the disks that have the properties specified by one or more attribute-value pairs.

-c

Displays the output without any headings for use in scripting.
When used with the -d option, vxspcshow displays properties as attribute-value pairs, and separates the properties for each disk by a newline.
When used with the -a option, vxspcshow lists disks that have the specified properties specified by attribute-value pairs, and separates the list of disks for each attribute-value pair by a newline.

-d disk[,disk]...

Displays the properties associated with one or more specified disk devices.

-n count

When used with the -a option, vxspcshow lists count disks that have the specified properties.
When used with the -d option, vxspcshow displays count properties for each disk.

-u username

Specifies a user entry from VxVM's database to be authenticated by SAL. Use vxspcshow adduser to create entries in this database. Note that appropriate SAL user entries must also be created independently on the SAL server.

EXAMPLES

Display the device names of all HITACHI disks:


vxspcshow -a vendor=HITACHI

Display the device names of all HITACHI disks and all disks in location building1 (not necessarily HITACHI):


vxspcshow -a vendor=HITACHI,location=building1

Display the device names of 6 EMC disks in location building2 and all disks with protection type Mirr2 (not necessarily in building2):


vxspcshow -n 6 -a vendor=EMC,location=building2,protection=Mirr2

NOTES

The vxspcshow command requires that Veritas SANPoint Control has been installed, and can only be run on the primary SAL server.

Vendor, location and protection attributes are retrieved from the SAL database. The administrator is expected to use the SANPoint Control console to set the location and protection attributes when configuring storage groups.