lsvsd Command

Purpose

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.

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 RSCT Administration Guide .

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