updatevsdvg Command

Purpose

Changes virtual shared disk global volume group characteristics.

Syntax

updatevsdvg { -a │ -g global_volgrp { -k VSD -p primary_node -b secondary_node │ -k CVSD -l server_list [-c cluster_name] } }

Description

The updatevsdvg command changes virtual shared disk global volume group characteristics. This command allows you to change global volume groups from concurrent virtual shared disk volume groups to serial-access (or nonconcurrent) virtual shared disk volume groups, and the other way around. This command can be used whenever server node numbers change, such as replacing or re-cabling servers where the new server numbers are different, or when you need to delete a server.

This command performs the following operations:
  1. Suspends all virtual shared disks that are part of this volume group
  2. Stops all virtual shared disks that are part of this volume group
  3. Issues the varyoffvg command for the volume group
  4. Verifies that the volume group exists on the new servers and tries to import the volume group if it does not exist
  5. Updates the global volume group characteristics
  6. Issues the varyonvg command for the volume group to the appropriate servers
  7. Starts all virtual shared disks that are part of this volume group
Note:
  1. If you issue this command with the -a flag, the recoverable virtual shared disk subsystem should not be active. Otherwise, this command can be run while the recoverable virtual shared disk subsystem is active, as long as no application is using the virtual shared disks that are part of the volume group being updated.
  2. Concurrent virtual shared disks are supported for disks that have implemented the SCSI-3 persistent reserve model of the AIX® SCSI device drivers, and for SSA (Serial Storage Architecture) disks.

Flags

-a
Specifies that persistent reserve information should be reestablished in the object data manager (ODM) for all VSD volume groups served by this node. This flag is intended for the initial setup phase of allowing multiple clusters to access the same virtual shared disks. It is also useful for recovery after the device ODM entries have been removed inadvertently.

This flag causes all of the volume groups served by the node to be varied offline. The volume groups will be varied offline on this node and on all other servers for the volume groups. For this reason, you should stop the recoverable virtual shared disk subsystem before issuing the updatevsdvg command with this flag.

-b secondary_node
Specifies the secondary node.
-c cluster_name
Specifies the cluster name for the server nodes that will be serving concurrently accessed shared disks. This flag is applicable only for SSA (Serial Storage Architecture) disks, and a cluster_name must be specified for SSA.
-g global_volgrp
Specifies an existing global volume group name.
-k VSD | CVSD
Specifies whether the volume group will be of type concurrent virtual shared disk or serial-access (nonconcurrent) virtual shared disk.
-l server_list
Specifies a colon-separated list of servers for concurrent virtual shared disks.
-p primary_node
Specifies the primary node.

Parameters

vsd_name
Specifies the virtual shared disk whose underlying logical volume you no longer want to be globally accessed by any virtual shared disk nodes.

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

Standard Output

Current RVSD subsystem run level.

Examples

  1. To change the global volume group named ess_gvg from a virtual shared disk global volume group to a concurrent global volume group with three servers, assuming that the disks are cabled correctly and that the disk subsystem supports persistent preserve such as ESS disks, enter: 
    updatevsdvg -g ess_gvg -k CVSD -l 9:17:21
  2. To remove a server from an SSA global volume group named ssa_gvg, where the original server list is 9:10 and belongs to an SSA cluster named cluster9_10, (that is, the command vsdatalst -c shows SSA cluster information), enter: 
    updatevsdvg -g ssa_gvg -k CVSD -l 9 -c cluster9_10
  3. To change a concurrent global volume group named ess_gvg back to a virtual shared disk global volume group, where the original server list is 9:17:21, the new primary node number is 9, and the new secondary node number is 21, enter: 
    updatevsdvg -g ess_gvg -k VSD -p 9 -b 21

Location

/opt/rsct/vsd/bin/updatevsdvg