Administering the RVGs using the vxrvg command


Administering the RVGs using the vxrvg command
Prev	Using the command line interface	Next

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 <count>

Specifies the number of times the statistics are displayed. This option must be used with the -i option.

-c <checkpoint>

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 -f option 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 <diskgroup>

Specifies the local disk group for the RVG operation.

-i <interval>

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 <prefix>

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:

<prefix>-<volume name>

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 <timestamp>

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

Prev	Up	Next
Stopping the Historic Bandwidth Data Collection using the CLI	Home	Adding DCM log