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:
- Suspends all virtual shared disks that are part of this volume
group
- Stops all virtual shared disks that are part of this volume group
- Issues the varyoffvg command for the
volume group
- Verifies that the volume group exists on the new servers and tries
to import the volume group if it does not exist
- Updates the global volume group characteristics
- Issues the varyonvg command for the
volume group to the appropriate servers
- Starts all virtual shared disks that are part of this volume group
Note: - 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.
- 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
- 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
- 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
- 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