Commands Reference, Volume 3, i - m

lsvsd Command

Purpose

lsvsd - Displays configured virtual shared disks and their characteristics.

Syntax

lsvsd [-l | -s[ vsd_name...]] | [-i]

Description

The lsvsd command displays information about virtual shared disks currently configured on the node on which the command is run. If a list of virtual shared disks follows the flags, information about those virtual shared disks is displayed. lsvsd with no arguments or flags lists the names of all the virtual shared disks currently configured on the node.

The lsvsd command displays information about both the configuration and the usage of a virtual shared disk.

You can use the System Management Interface Tool (SMIT) to run the lsvsd command. To use SMIT, enter:

smit vsd_mgmt

and select the Show All Managed Virtual Shared Disk Characteristics option.

Flags

-l

Lists the name of the virtual shared disk, the minor number, the state, the current server node number, and, at the server only, the major and minor number of the logical volume. (This flag is lowercase l, as in list.)

The state field can have one of the following values:

STP Stopped
SUS Suspended
ACT Active

An asterisk (*) in front of any of these values indicates that the virtual shared disk has been fenced from this node.

This flag is not compatible with the -s flag.

The server_list of the virtual shared disk is listed.

-s

Lists usage statistics about the virtual shared disks. It lists the number of local logical read and write operations, the number of remote logical read and write operations, the number of client logical read and write operations, the number of physical reads and writes, and the number of 512-byte blocks read and written. The number of blocks read and written is cumulative, so issue ctlvsd -V to reset this count before measuring it.

The local logical operations are requests which were made by a process executing at the local node, whereas the remote logical operations were made by a process executing on a remote node. Client operations are those local logical requests that cannot be satisfied locally, and have to be sent to a remote node. Physical operations are those server operations which must be passed to the underlying disk device.

This flag is not compatible with the -l flag.

-i

Lists the "node to IP address" map that is currently used by the virtual shared disk driver.

Parameters

vsd_name: Specifies a virtual shared disk. This parameter is valid only with the -l and -s flags.

Security

You must be in the AIX bin group to run this command.

Exit Status

0: Indicates the successful completion of the command.
nonzero: Indicates that an error occurred.

Restrictions

You must issue this command from a node that is online in the peer domain. To bring a peer domain online, use the startrpdomain command. To bring a particular node online in an existing peer domain, use the startrpnode command. For more information on creating and administering an RSCT peer domain, refer to the RSCT: Administration Guide.

Standard Output

For the following command:

createvsd -n 1/2:hdisk13/ -s 1024 -g testvg -v testvsd -T 16

The messages to standard output will be similar to:

createvsd: calls Getopts.
createvsd: parsing node_list.
createvsd: creates task tables.
createvsd: calls checkclvm.perl on the nodes c164n11.ppd.pok.ibm.com
createvsd: calls domkvglv.perl.
OK:1:mkvg -f -y testvg -s 16 hdisk13
OK:1:mklv -a c -y lvtestvsd1n1 -e x testvg 64 hdisk13
It took about 8 seconds in mkvglv.
createvsd: calls dovaryoffvg.perl testvg on the primary node c164n11.ppd.pok.ibm.com
OK:1:chvg -a n testvg
OK:1:varyoffvg testvg
createvsd: calls doimportvg.perl testvg on the nodes c164n12.ppd.pok.ibm.com with 000048186b991a6f
importvg : testvg
importvg : OK:2:importvg -y testvg hdisk5
importvg : OK:2:chvg -a n testvg
importvg : timestamp 2 testvg 3e036cb33403c8c8
importvg : OK:2:varyoffvg testvg
importvg : It took about 10 seconds.
It took about 12 seconds in importvg.
createvsd: calls vsdvg.
OK:1:vsdvg -g testvgn1b2 testvg 1 2
It took about 12 seconds in vsdvg.
createvsd: calls dovaryonvg.perl testvg on pri nodes c164n11.ppd.pok.ibm.com
OK:1:varyonvg  testvg
createvsd: calls defvsd.
OK:1:defvsd lvtestvsd1n1 testvgn1b2 testvsd1n1
It took about 5 seconds in defvsd.

Examples

To list all virtual shared disks in the system, enter:
```
lsvsd
```
The system displays a message similar to the following:
```
vsd00
 
vsd01
 
.
.
.
```

To list virtual shared disks and their characteristics, enter:

lsvsd -l

The system displays a message similar to the following:

minor  state  server  lv_major  lv_minor  vsd_name  size (MB)
83     STP      -1        0        0      vsdn08v3    20
84     STP      -1        0        0      vsdn08v4    16

To list statistics about virtual shared disks and precede the column output with a header, enter:

lsvsd -s

The system displays a message similar to the following:

lc-rd lc-wt rm-rd rm-wt c-rd c-wt  p-rd  p-wt   br   bw  vsd_name
   84    84  2858   169    0    0   348   253  164  184  vsd.vsd1
    0     0     0     0    0    0     0     0    0    0  vsd.rl01
    0     0     0     0    0    0     0     0    0    0  vsd.rl02

The following table spells out the names of the headers used in the displays for the -l and -s options:

Header: Meaning
minor: Virtual shared disk minor number
state: State of this virtual shared disk:active, stopped, suspended
server: Primary node for this virtual shared disk
lv major: Logical volume major number
lv minor: Logical volume minor number
vsd_name: Name of this virtual shared disk
lc-rd: Local logical reads
lc-wt: Local logical writes
rm-rd: Remote logical reads
rm-wt: Remote logical writes
c-rd: Client logical reads
c-wt: Client logical writes
p-rd: Physical reads
p-wt: Physical writes
br: Blocks read
bw: Blocks written

Location

/opt/rsct/vsd/bin/lsvsd

Related Information

Commands: cfgvsd, preparevsd, resumevsd, startvsd, stopvsd, suspendvsd, ucfgvsd