Name

vxlist — displays records of the Storage Foundation configuration.

SYNOPSIS

vxlist [-option] [keyword] [arguments] [storage_object_names ...]

DESCRIPTION

vxlist lists Storage Foundation objects.

To display the vxlist command output, the vxdclid daemon must be running. If vxdclid is not running, run /opt/VRTSsfmh/adm/dclisetup.sh as a root user.

KEYWORDS

alert

Lists the alerts.

cache

Lists the Volume Manager cache objects.

disk

Lists the disks.

diskgroup|dg

Lists the Volume Manager disk groups.

dmp

Lists the supported Array Support Libraries (ASL).

enclosure|enclr|array

Lists the enclosures.

filesystem|fs

Lists the mounted file systems.

hba|hostport|controller|ctrl

Lists the controllers.

lun

Lists the Storage Insight Add-on information of LUNs. The information is only available if the host has been added to a Management Server domain, and the associated array has been enabled for Storage Insight.

The first use of the lun keyword fetches the array information from Management Server. Any vxlist lun command that is run within the next one hour uses the vxdclid cache. The vxdclid cache may be stale if array parameters have been modified. The vxlist lun command that is run after one hour of the last vxlist lun command fetches the latest array information from Management Server again.

To force the vxlist lun command to fetch the updated array information, use the rescan keyword.

nodeinfo

Lists the Cluster Volume Manager node information.

path

Lists the paths.

plex|pl

Lists the plexes.

rescan

Fetches updated Storage Foundation information.

See the lun keyword.

snapshot|snap

Lists the Volume Manager snapshots.

subdisk|sd

Lists the subdisks.

tag|tags

Lists the volume tags.

targetport|tca

Lists the target ports.

task

Lists the Volume Manager tasks that are running.

umfilesystem|umfs

Lists the unmounted file systems.

volume|vol

Lists the Volume Manager volumes.

vset

Lists the Volume Manager volume sets.

OPTIONS

-a|--all

Displays all fields or sections including those that have no data.

-d|--deliminator string

Uses the specified string instead of spaces to delimit fields in tabular display.

-e|--exact

Displays all size-related numbers in sectors.

See the -u option.

-k|--kilobyte

Displays all size-related numbers in kilobytes.

-g|--diskgroup dg

Lists storage objects in the specified disk group.

-H|--help [objtype]

Displays usage information.

-l|--long

Displays in long format.

-B|--bare field1[,field2...] objtype

Displays bare format. Displays only the specified long format fields

-O|--output [csv|long|table]

Displays information in the selected format. The default is the 'table' format.

-p|--property object_name1 object_name2...

Displays the property pages of the specified LUNs. The sections without data are not displayed unless the --all option is used.

-q|--suppress

Suppresses headers in tabular output format.

-s|--sections sectionname,... object_name

Displays only the specified sections in the property page. Sections with no data are not displayed unless the --all option is used.

-t|--table [default|lun|stats]

Displays LUN information in the specified table format. The default format is 'default'.

-u|--unit [p|t|g|m|k|blocks|bytes|scaled]

Displays all size-related numbers in the specified unit. The default is 'scaled'.

EXAMPLES

This section provides usage examples for vxlist.

EXAMPLE 1:

To display vxlist usage for viewing information on disks.

vxlist -H disk

EXAMPLE 2:

To display the fields Device, Status, Log Info, and VDID for disks, in bare format, delimited by the '++' string.

vxlist -B "Device,Status,Log Info,VDID" -d ++ disk

EXAMPLE 3:

To display only the disks section in the property page for the volume named vol_1.

vxlist -s disks vol vol_1

EXAMPLE 4:

To display the property pages with the disks section for the volumes named vol_1 and vol_2.

vxlist -p -s disks vol vol_1 vol_2

FILES

/etc/vx/dcli/sfm/conf/dcli_conf.ini

The vxlist and vxdclid configuration file

/etc/vx/dcli/log/server_A

The vxdclid log file

NOTES

The default location of vxlist is /opt/VRTSsfmh/bin/vxlist. There is also a vxlist link named /etc/vx/bin/vxlist.

Windows-based Management Server does not support the vxlist command.