vsdsklst Command

Purpose

Produces output that shows you the disk resources used by the virtual shared disk subsystem across a peer domain.

Syntax

vsdsklst [-v] [-d] {-a | -n node_number[, node_number2, …]}

Description

Use this command to check disk utilization across a peer domain.

Flags

-v: Displays only disk utilization information about volume groups and the virtual shared disks associated with them.
-d: Displays only disk utilization information about volume groups and the physical disks associated with them.
-a: Displays specified information for all nodes in the system or system partition.
-n node_number: Lists one or more node numbers for which information is to be displayed.

Parameters

node_number

Specifies the node or nodes whose virtual shared disk information is to be set. The value you specify for node_number must match a valid RSCT remote peer domain node number.

adapter_name

Specifies the adapter name to be used for virtual shared disk communications for the nodes specified. The adapter name must already be defined to the nodes. Note that the nodes involved in virtual shared disk support must be fully connected so that proper communications can take place. Use ml0 to specify that the virtual shared disk device driver transmits data requests over the SP Switch. The ml0 adapter will be used the next time the virtual shared disk device driver is loaded.

min_buddy_buffer_size

Specifies the smallest buddy buffer a server uses to satisfy a remote request to a virtual shared disk. This value must be a power of 2 and greater than or equal to 4096. The suggested value is 4096 (4 KB). For a 512 byte request, 4KB is excessive. However, recall that a buddy buffer is only used for the short period of time while a remote request is being processed at the server node.

max_buddy_buffer_size

Specifies the largest buddy buffer a server uses to satisfy a remote noncached request. This value must be a power of 2 and greater than or equal to the min_buddy_buffer_size. The suggested value is 262144 (256 KB). This value depends on the I/O request size of applications using the virtual shared disks and the network used by the virtual shared disk software.

max_buddy_buffers

Specifies the number of max_buddy_buffer_size buffers to allocate. The virtual shared disk device driver will have an initial size when first loaded, and then will dynamically allocate and reclaim additional space as needed. The suggested value is 2000 256KB buffers.

Buddy buffers are only used on the servers. On client nodes you may want to set max_buddy_buffers to 1.

Note: The statvsd command will indicate if remote requests are queueing waiting for buddy buffers.

vsd_max_ip_msg_size

Specifies the maximum message size in bytes for virtual shared disks. This value must not be greater than the maximum transmission unit (MTU) size of the network. The recommended values are:

61440 (60KB) for a switch
8192 (8KB) for jumbo frame Ethernet
1024 (1KB) for 1500-byte MTU Ethernet

cluster_name

A cluster name must be specified for server nodes that will be serving concurrently accessed shared disks. The cluster name can be any user provided name. A node can only belong to one cluster. For example, when you have a concurrent access environment, the two servers for the CVSD must both specify the same cluster name.

Note: The cluster_name is required only for SSA (Serial Storage Architecture) disks.

Security

You must have root authority 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

This command:

vsdsklst -dv -a

displays the following information on a system that has volume groups and virtual shared disks defined on nodes 1 and 2.

c164n12.ppd.pok.ibm.com: Node Number:2; Node Name:c164n12.ppd.pok.ibm.com
c164n12.ppd.pok.ibm.com: Volume group:rootvg; Partition Size:32; Total:271; Free:168
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk0; Total:271; Free:168
c164n12.ppd.pok.ibm.com:     Volume group:testvg is not varied on.
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk5;
c164n12.ppd.pok.ibm.com: Volume group:test1vg; Partition Size:4; Total:537; Free:534
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk2; Total:537; Free:534
c164n12.ppd.pok.ibm.com:         VSD Name:vsd1n2[testnewlv21n2]; Size:1
c164n12.ppd.pok.ibm.com:         VSD Name:vsd2n2[testlv1n2]; Size:346112.25
c164n12.ppd.pok.ibm.com:         VSD Name:vsd3n2[testlv2n2]; Size:346112.25
c164n12.ppd.pok.ibm.com:     Volume group:vg1 is not varied on.
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk9;
c164n12.ppd.pok.ibm.com:     Volume group:sharkvg is not varied on.
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk7;
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk10;
c164n12.ppd.pok.ibm.com: Volume group:bdhclvg; Partition Size:32; Total:134; Free:102
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk13; Total:134; Free:102
c164n12.ppd.pok.ibm.com: Volume group:gpfs0vg; Partition Size:8; Total:536; Free:0
c164n12.ppd.pok.ibm.com:         Physical Disk:hdisk12; Total:536; Free:0
c164n12.ppd.pok.ibm.com:         VSD Name:gpfs0vsd[gpfs0lv]; Size:352256.75
c164n12.ppd.pok.ibm.com:     Not allocated physical disks:
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk1
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk3
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk4
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk6
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk11
c164n12.ppd.pok.ibm.com:         Physical disk:hdisk15
c164n11.ppd.pok.ibm.com: Node Number:1; Node Name:c164n11.ppd.pok.ibm.com
c164n11.ppd.pok.ibm.com: Volume group:rootvg; Partition Size:32; Total:271; Free:172
c164n11.ppd.pok.ibm.com:         Physical Disk:hdisk0; Total:271; Free:172
c164n11.ppd.pok.ibm.com: Volume group:bdhclvg; Partition Size:32; Total:134; Free:102
c164n11.ppd.pok.ibm.com:         Physical Disk:hdisk9; Total:134; Free:102
c164n11.ppd.pok.ibm.com:         VSD Name:bdhcvsd1n1[lvbdhcvsd1n1]; Size:45056
c164n11.ppd.pok.ibm.com: Volume group:testvg; Partition Size:16; Total:134; Free:70
c164n11.ppd.pok.ibm.com:         Physical Disk:hdisk13; Total:134; Free:70
c164n11.ppd.pok.ibm.com:     Not allocated physical disks:
c164n11.ppd.pok.ibm.com:         Physical disk:hdisk1
c164n11.ppd.pok.ibm.com:         Physical disk:hdisk2
c164n11.ppd.pok.ibm.com:         Physical disk:hdisk3

Location

/opt/rsct/vsd/bin/vsdsklst