vsdvg Command

Purpose

Defines a virtual shared disk global volume group.

Syntax

vsdvg: [-g global_volume_group ] {-l server_list local_group_name | local_group_name primary_node [secondary node [eio_recovery]]}

Description

Use this command to define volume groups for use by the Virtual shared disk subsystem. This is done by specifying the local volume group name, the node on which it resides, and the name by which the volume group will be known throughout the cluster.

You can use the System Management Interface Tool (SMIT) to run the vsdvg command. To use SMIT, enter the following command and select the Virtual Shared Disk Global Volume Group Information option:

smit vsd_data

Flags

-g global_volume_group: Specifies a unique name for the new global volume group. This name must be unique across the system partition. It should be unique across the SP, to avoid any naming conflicts during future system partitioning operations. The suggested naming convention is vgxxnyy, where yy is the node number, and xx uniquely numbers the volume groups on that node. If this is not specified, the local group name is used for the global name. The length of the name must be less than or equal to 31 characters.
-l server_list: Define the list of servers for CVSD. More than one server indicates the global_volume_group is a concurrent volume group.

Parameters

local_group_name: Specifies the name of a volume group that you want to indicate as being used for virtual shared disks. This name is local to the host upon which it resides. The length of the name must be less than or equal to 15 characters.
primary_node: Specifies the primary server node number on which the volume group resides. The length of the name must be less than or equal to 31 characters.
secondary_node: Specifies the secondary server node number on which the volume group resides. The length of the name must be less than or equal to 31 characters.
eio_recovery: Specifies how the Recoverable virtual shared disk subsystem will respond to EIO errors. If eio_recovery is set to the value 1 (the default), an EIO error will cause the Recoverable virtual shared disk system to flip the current primary node and the secondary node and perform one more retry on the new primary node.

Security

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

Current RVSD subsystem run level.

Examples

The following example defines gpfs1gvg as a virtual shared disk global volume group with the local volume group gpfs1vg accessed from node1 as the primary_node and node2 as the secondary_node.
```
vsdvg -g gpfs1gvg gpfs1vg 1 2
```
The following example defines gpfs3gvg as a virtual shared disk global volume group with the local volume group gpfs3vg concurrently accessed from node1 and node2.
```
vsdvg -g gpfs3gvg -l 1:2 gpfs3vg
```

Location

/opt/rsct/vsd/bin/vsdvg