Administering the RDS using the vxrds command

Last published : Jun 12, 2026
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 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 The -e 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-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.
-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 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.
Related information
Using the command line interface
Activating the Bunker RVGCreating and adding a Secondary RVGAdding an existing volume to the RDSAdding a Bunker nodeChanging the host name or IPCreating the Primary RVGDeactivating the Bunker RVGDeleting the Bunker nodeDeleting the SecondaryDeleting the PrimaryDissociating data volumesResynchronizing a failed Primary with the new PrimaryConverting a Primary to a SecondaryMigrating the Primary to a SecondaryPausing replication using the vxrds pauserep commandDisplaying the RDSResizing the data volumesGrowing the Replicator Log volumeResuming replication after pausingResynchronizing the SecondarySetting replication attributesStarting replication using the vxrds startrep commandStopping replication using the vxrds stoprep commandTaking over the Primary role using the vxrds takeover commandPerforming RLINK Operations using the vxrlink commandAssociating a SecondaryAttaching a SecondaryDisplaying the list of Secondary checkpointsDeleting the Secondary checkpointDetaching an RLINKDissociating an RLINKCreating new RLINKPausing the RLINKRecovering the RLINKRestoring the RLINKResuming the RLINKRemoving the RLINKSetting the RLINK attributesDisplaying the network statistics for the RLINKDisplaying the RLINK statusIdentifying the most up-to-date SecondaryVerifying the RLINKStarting the Historic Bandwidth Data Collection using the CLIStopping the Historic Bandwidth Data Collection using the CLI