Search <book_title>...

Volume Replicator 7.4.1 Administrator's Guide - Windows

Last Published: 2019-02-07

Product(s): InfoScale & Storage Foundation (7.4.1)

Platform: Windows

Administering the RDS using the vxrds command

The vxrds command helps you to perform the various administrative tasks on the Replicated Data Set (RDS). These tasks are performed by using the specific keywords with the vxrds command.

The following table lists the keywords that can be used with the vxrds command.

Table: vxrds command keywords

Keyword	Function
activatebunker	Activates the Bunker RVG to take over the Primary role when the original Primary becomes unavailable. See Activating the Bunker RVG.
addsec	Creates and adds Secondary RVG to an RDS. See Activating the Bunker RVG.
addvol	Associates the specified volume to all RVGs in the RDS. See Adding an existing volume to the RDS.
addBunker	Adds a Bunker to an existing RDS without interrupting replication from the Primary to the Secondary. See Adding a Bunker node.
changeip	Changes the host name or IP address of the Primary and Secondary RLINKs that are part of an RDS. See Changing the host name or IP.
createpri	Creates a Primary RVG on the local system. See Creating the Primary RVG.
deactivatebunker	Deactivates the Bunker to convert the Bunker Primary back to a Bunker Secondary. See Deactivating the Bunker RVG.
delBunker	Delete the Bunker RVG from the RDS configuration. See Deleting the Bunker node.
delsec	Removes the Secondary RVG from the RDS. See Deleting the Secondary.
delpri	Deletes the Primary RVG and the corresponding RDS if no Secondary is configured for the RDS. See Deleting the Primary.
delvol	Dissociates the volume from all the RVGs in an RDS. See Dissociating data volumes.
fbsync	Resynchronizes the original Primary with the new Primary once it becomes available after the takeover with fast-failback. See Resynchronizing a failed Primary with the new Primary.
makesec	Converts the existing Primary RVG to a Secondary RVG after takeover. See Converting a Primary to a Secondary.
migrate	Migrates the Primary RVG of the RDS to the specified Secondary host. See Migrating the Primary to a Secondary.
pauserep	Pauses the replication to the specified Secondary. See Pausing replication using the vxrds pauserep command.
printrvg	Displays the complete or partial information about all the RVGs in the RDS. See Displaying the RDS.
resizevol	Depending on the new volume size specified, the command either grows or shrinks the volume uniformly across the RDS. See Resizing the data volumes.
resizesrl	Grows the Replicator Log volume uniformly across the Primary and the Bunker Secondary. See Growing the Replicator Log volume.
resumerep	Resumes the replication to the specified Secondary. See Resuming replication after pausing.
resync	Resynchronizes the Secondary in case the Replicator Log overflows and DCM is activated. See Resynchronizing the Secondary.
set	Sets the replication attributes on the Secondary and Primary hosts. See Setting replication attributes.
startrep	Starts the replication to the specified Secondary. See Starting replication using the vxrds startrep command.
stoprep	Stops the replication to the specified Secondary. See Stopping replication using the vxrds stoprep command.
takeover	Converts the Secondary RVG to Primary RVG of the RDS. See Taking over the Primary role using the vxrds takeover command.

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

Table: Available options for vxrds command

Options	Description
-autofba	Enables the takeover with automatic resynchronization. The -autofb and -N options are mutually exclusive.
-a or-autosync	Starts the replication with autosynchronization. This option is used to attach the Secondary to the Primary as a part of the startrep command.
-b A	This option is used to replay the pending updates from the Bunker Primary to synchronize the Secondary host when the Bunker acts as Primary.
-c <checkpoint>	This option can be used with the startrep command to indicate the checkpoint with which the Secondary needs to be attached.
-clean	The -clean option deletes the RVG and the RLINKs associated with the RVG.
-e <extended stats>	The-e <extended stats> option is used for diagnostic or analytical purposes.
-f	You can use this option with the vxrds delpri command to force the Primary RVG to be deleted even if the data volumes are used. You can use this option with the startrep command to make it behave like the -forceatt option. The -f option when used with the -r option performs the same function as the -autofb option. 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.
-forceatt	Forces the attach of a Secondary, assuming that the Primary and Secondary are synchronized.
-F	Enables Failback logging when taking over the role of the Primary after the original Primary becomes unavailable due to a disaster or some other problems. To ensure successful failback logging make sure that: All the volumes of the new Primary have DCM logs. The RLINK to the original Primary from the new Primary is attached.
-g <diskgroup>	Specifies the disk group for the various operations.
-N	Disables failback logging when performing takeover.
-wait	Ensures that the vxrds fbsync and vxrds resync command waits until the resynchronization completes.