Administering the RVGs using the vxrvg command

Last published : Jul 07, 2026

Use the vxrvg command to perform various operations on RVGs. A specific local disk group can be selected with -g <diskgroup> option. The vxrvg command has a number of keywords enabling it to perform various operations on RVG objects.

The following table lists the keywords that are available with the vxrvg command with their descriptions.

Table: Keywords for vxrvg command

Keyword	Description
`addlog`	Adds DCM log to the volume.
`aslog`	Associates the volume as Replicator Log Volume to the RVG.
`assoc`	Associates a volume as a data volume to the RVG.
`checkend`	Marks the end of the RVG checkpoint operation.
`checkdelete`	Deletes the specified checkpoint.
`checkstart`	Marks the beginning of the RVG checkpoint operation.
`cplist`	Displays a list of RVG checkpoints.
`dis`	Dissociates the volume from the RVG.
`dismount`	Dismounts all the data volumes in an RVG.
`make`	Creates a new RVG based on the specified attributes.
`makeprimary`	Converts an existing Secondary to a Primary. This enables you to convert a Secondary RVG to a Primary using takeover (with or without failback logging) or migration.
`makeSecondary`	Converts an existing Primary to a Secondary.
`recover`	Recovers an RVG.
`rm`	Deletes the specified RVG.
`resync`	Resynchronizes all the Secondary hosts that have the Replicator Log protection set to DCM and the DCM logs are activated due to Replicator Log overflow.
`set`	Sets the attributes for the specified RVG.
`snapshot`	Creates the snapshots for each data volume in the RVG. Each data volume must have a prepared plex associated with it. The Storage Foundation `Prepare` operation can be used to create and attach a prepared plex to the volume.
`snapback`	Reattaches the snapshots back to the original data volumes in an RVG.
`start`	Enables data access to an RVG.
`stats`	Displays the application statistics for the specified RVG.
`stop`	Disables data access to an RVG.

The following table lists the options that are available with the vxrvg command:

Table: vxrvg command options

Option	Description
`-a`	This option is used with the snapback keyword. It is used to reattach all the snapshots of all the data volumes in an RVG at the same time. If there are some data volumes that do not have snapshot volumes, a warning message is displayed.
`-C`	Specifies the number of times the statistics are displayed. This option must be used with the `-i` option.
`-c`	This option is used with the `checkstart` and `checkdelete` keyword. The checkpoint string is associated with the checkstart and checkend marks in the Replicator Log volume.
`-f`	This option forces the specified operation to be performed and can be interpreted differently for different keywords. This option can be used with the keywords: `aslog` , `assoc` , `dis` , `rm` , `set` , `snapshot` , and `snapback` .
	Note: This-foption can cause data corruption because the Secondary may miss the writes that may have been present on the Replicator Log but did not reach the Secondary. Because there is no way of knowing whether the Replicator Log had some pending writes that have not yet been sent to the Secondary, use this option only if you know that the Secondary is completely up-to-date.
`-F`	Enables Failback logging if you want to perform a takeover operation using the`vxrvg`command with the`makeprimary`keyword. To ensure successful failback logging, make sure that\:
	- All the volumes of the new Primary have DCM logs
	- The original Primary is attached to new Primary
`-g`	Specifies the local disk group for the RVG operation.
`-i`	Specifies the time interval in seconds after which the statistics are displayed.
`-M`	Allows the Secondary to become a Primary even when the original Primary host is reachable. This option is useful for planned migration.
	To use this option effectively you are recommended to first use the `vxrvg makesecondary` command to convert an existing Primary to a Secondary and then use the `vxrvg -M makeprimary` .
`-N`	Disables Failback logging when taking over the role of the Primary.
`-P`	This option is used with the `snapshot` and `snapback` keywords. It is used to specify a prefix for the snapshot volumes. This snapshot volume is named as follows\:
	`-`
	The prefix option can be used to specify the exact volumes that need to be used to perform snapback.
`-r`	This option is used to resynchronize the original Primary with the new Primary after it becomes available again, after the takeover.
`-t`	Specifies the frequency at which the system time and date is displayed. For example, if you specify a value five then the time stamp is displayed after every five rows of information. This option must be used with the `-i` option.
`-z`	Resets the statistics for the specified RVG