Previous  |  Next  >  
Product: Volume Replicator Guides   
Manual: Volume Replicator 4.1 Administrator's Guide   

Command Reference

VVR Command Command Description

vradmin -g diskgroup createpri rvg_name dv01_name,dv02_name... srl_name

Creates Primary RVG of an RDS.


vradmin -g diskgroup addsec local_rvgname pri_hostname sec_hostname

Adds a Secondary RVG to an RDS.


vradmin -g diskgroup set local_rvgname sec_hostname synchronous=value

Sets up mode of replication:

synchronous=off sets asynchronous
synchronous=override sets synchronous

vradmin command does not allow you to set synchronous=fail. You can do this using the vxedit command. For more information on the vxedit command refer to the vxedit manual page.


vradmin -g diskgroup set local_rvgname sec_hostname latencyprot=value

Sets up Latency Protection:


latencyprot=fail
latencyprot=override
latencyprot=off

vradmin -g diskgroup set local_rvgname sec_hostname latency_high_mark=n

Sets up latency_high_mark:

latency_high_mark=n


vradmin -g diskgroup set local_rvgname sec_hostname latency_low_mark=n

Sets up latency_low_mark:
latency_low_mark=n


vradmin -g diskgroup set local_rvgname sec_hostname srlprot=value

Sets up SRL Overflow Protection:

srlprot=autodcm (default)
srlprot=dcm
srlprot=override


vradmin -g diskgroup set local_rvgname sec_hostname packet_size=n

Sets up the packet size.


vradmin -g diskgroup set local_rvgname sec_hostname protocol=value

Sets the protocol.


vradmin -g diskgroup changeip local_rvgname [sec_hostname] attrs....

Changes the host name or IP address of the Primary and Secondary RLINKs to the new values specified in the newpri and newsec attributes.


vradmin -g diskgroup -l repstatus local_rvgname

Displays consolidated replication-related information about an RDS.


vradmin [-l] printrvg

Displays information for all RDSs on local host.


vradmin -g diskgroup [-l] printrvg local_rvgname

Displays detailed information for a specific RDS.


vradmin printvol

Displays information about data volumes in all RDSs on the local host.


vradmin -g diskgroup printvol local_rvgname

Displays information about data volumes in an RDS.


vradmin -g diskgroup pauserep local_rvgname sec_hostname

Pauses replication to a Secondary.


vradmin -g diskgroup resumerep local_rvgname sec_hostname

Resumes replication to a Secondary.


vradmin -g diskgroup -a startrep local_rvgname sec_hostname

Starts replication and synchronizes the Secondary using autosync.


vradmin -g diskgroup -c checkpt_name startrep local_rvgname sec_hostname

Starts replication and synchronizes the Secondary using a checkpoint.


vradmin -g diskgroup stoprep local_rvgname sec_hostname

Stops replication to a Secondary.


vradmin -g diskgroup -c checkpt_name syncrvg local_rvgname sec_hostname....

Synchronizes the Secondary volumes with the corresponding Primary volumes based on differences when the application is active or inactive.


vradmin -g diskgroup -full -c checkpt_name syncrvg local_rvgname sec_hostname....

Performs full synchronization with checkpoint to the Secondary when the application is active or inactive.


vradmin -g diskgroup -full syncvol local_vols_list remote_hostname....

Synchronizes volumes on local host and remote hosts using full synchronization.


vradmin -g diskgroup -verify syncrvg local_rvgname sec_hostname...

Verifies and reports any data differences between Secondary volumes and the corresponding Primary volumes.


vradmin -g diskgroup -verify syncvol local_vols_list remote_hostname...

Verifies and reports any data differences between remote volumes and the corresponding local volumes.


vradmin -g diskgroup [-k {cache|snap}] verifydata local_rvgname sec_hostname {cache=cacheobj | cachesize=size}

Verifies that the data on the Secondary data volumes is identical to the Primary data volumes.



Note    The -k option cannot be used if you are using the cachesize option to create a cache object as these cache objects are destroyed automatically once the vradmin verifydata command executes successfully.

vradmin -g diskgroup addvol local_rvgname volume_name

Adds a volume to an RDS.


vradmin -g diskgroup [-f] resizevol local_rvgname volume_name length

Resizes a data volume in an RDS.


vradmin -g diskgroup delvol local_rvgname volume_name

Removes a data volume from an RDS.


vradmin -g diskgroup ibc local_rvgname task_name [sec_host]...

Performs the specified off-host processing task on the Secondary.


vradmin -g diskgroup migrate local_rvgname newprimary_name

Migrates the Primary role to Secondary newprimary_name.


vradmin -g diskgroup takeover local_rvgname

Takes over the Primary role from an original Primary with fast failback enabled.


vradmin -g diskgroup -autofb takeover local_rvgname

Takes over the Primary role from an original Primary with fast failback enabled and automatically synchronizes the original Primary when it becomes available.


vradmin -g diskgroup -N takeover local_rvgname

Changes the role from Secondary to Primary without enabling fast failback.


vradmin -g diskgroup fbsync local_rvgname [cache=cache-object | cachesize=size]

Converts the original Primary to a Secondary and starts resynchronization of the original Primary using fast-failback. Optionally, it also takes space-optimized snapshots of the original Primary's data volumes before starting the resynchronization.


vradmin -g diskgroup -wait fbsync local_rvgname

Converts the original Primary to a Secondary and starts resynchronization of the original Primary using fast failback. The command returns after resynchronization completes.


vradmin -g diskgroup makesec local_rvgname newprimary_name

Converts an original Primary to a Secondary when fast failback was not enabled.


vradmin -g diskgroup resync local_rvgname [cache=cache-object | cachesize=size]

Replays a DCM that is active due to an SRL overflow to incrementally synchronize the Secondary. Optionally, it also takes space-optimized snapshots of the original Primary's data volumes before starting the resynchronization.


vradmin -g diskgroup -wait resync local_rvgname

Replays a DCM that is active due to an SRL overflow to incrementally synchronize the Secondary. The command returns after resynchronization completes.


vradmin -g diskgroup delsec local_rvgname sec_hostname

Removes a Secondary from an RDS.


vradmin -g diskgroup delpri rvg_name

Removes a Primary when the application is inactive.


vradmin -g diskgroup -f delpri rvg_name

Removes a Primary when the application is active.


vxrvg -g diskgroup [-1] getdatavols rvg_name

Displays the names of all data volumes that are associated with the specified RVG.


vxrvg -g diskgroup [-1] getrlinks rvg_name

Displays the names of all RLINKs that are associated with the specified RVG.


vxrvg -g diskgroup start rvg_name

Enables I/O access to the data volumes associated with the RVG.


vxrvg -g diskgroup stop rvg_name

Disables I/O access to the data volumes associated with the RVG.


vxrvg -g diskgroup recover rvg_name

Recovers the RVG after rebooting a node.


vxrvg -g diskgroup -c checkpt_name checkstart rvg_name

Marks the beginning of a Primary checkpoint by pointing to the current location of the SRL.


vxrvg -g diskgroup checkend rvg_name

Marks the end of a Primary checkpoint by pointing to the current location of the SRL.


vxrvg -c checkpt_name checkdelete rvg_name 

Deletes the specified Primary checkpoint.


vxrvg -g diskgroup cplist rvg_name

Displays information about all existing checkpoints that are associated with the RVG.


vxrvg -g diskgroup [-f] [-p] [-P prefix | -a] snapback rvg_name

Reattaches snapshot volumes to their original volumes in the RVG. This operation is similar to the vxassist snapback command for traditional (third-mirror breakoff) snapshots, and the vxsnap reattach command for instant snapshots.



Note    When reattaching snapshots to an RVG that consists of only VxVM ISP volumes you must use the -f option otherwise the command will fail.

vxrvg -g diskgroup snapprint rvg_name

Displays information on the relationships between the data volumes of an RVG and any corresponding snapshots.


vxrvg -g diskgroup [-P prefix] snaprefresh rvg_name

Refreshes all existing snapshot volumes from the corresponding data volumes in the specified RVG. If a prefix is specified, this command refreshes only the snapshot volumes with that prefix. This creates a new point-in-time image for each snapshot, and the snapshot is immediately available for use with its new contents.


vxrvg -g diskgroup [-f] [-P prefix] snaprestore rvg_name

Restores the contents of all of the data volumes in the specified RVG from the corresponding snapshot volumes. If a prefix is specified, this command restores the contents only from the snapshot volumes with that prefix. The volumes are immediately available with the restored contents.


vxrvg -g diskgroup [-i interval]
[-t timestamp_frequency] [-C count] stats rvg_name

Displays the application statistics for the specified RVG. This is only valid on the Primary.


vxrvg -g diskgroup [-P prefix] [-F|-S] snapshot rvg_name
[instantfull=volume_list] [instantso=volume_list] [plexbreakoff=volume_list] [exclude=volume_list] [plexprefix=plex_prefix] [cache=cachename |cachesize=size] [syncing={yes|no}] [comment="comment"]

Creates snapshots for all volumes in the specified RVG. This operation is similar to the vxassist snapshot command for traditional (third-mirror breakoff) snapshots, and the vxsnap make command for instant snapshots.



Note    If the volumes in an RVG are VxVM ISP volumes then only instant full and instant space optimized snapshots are supported.

vxrlink -g diskgroup assoc rvg_name rlink_name

Associates an RLINK with an RVG.


vxrlink -g diskgroup dis rlink_name

Dissociates an RLINK from the RVG with which it is associated.


vxrlink -g diskgroup [-a|-c checkpt_name]|-f] att rlink_name

Enables an RLINK to connect to its remote RLINK by using auto attach, checkpoint attach or force attach.


vxrlink -g diskgroup det rlink_name

Detaches an RLINK.


vxrlink -g diskgroup pause rlink_name

Pauses updates to the Secondary RVG.


vxrlink -g diskgroup resume rlink_name

Resumes updates to the Secondary RVG that has been paused.


vxrlink -g diskgroup recover rlink_name

Recovers the RLINK after rebooting a node.


vxrlink -g diskgroup -c checkpt_name
restore rlink_name

Restores a failed Secondary RVG from a previously taken backup and Secondary checkpoint.


vxrlink -c checkpt_name checkdelete rlink_name 

Deletes the specified Secondary checkpoint.



Note    This command must be run only on the Primary.

vxrlink -g diskgroup verify rlink_name

Displays the configuration status of the given RLINK.


vxrlink -g diskgroup [-e] stats rlink_name

Gives details of the use of the network by VVR. The -e option displays extended statistics.


vxrlink -g diskgroup [-i <interval>] [-T] status rlink_name

Displays how much of the SRL is being used by the RLINK and how much the Secondary is behind. This incremental synchronization status is displayed after an interval of <i> seconds. This command output can also display the status with a timestamp, using the -T option.


vxrlink -g diskgroup cplist rlink_name

Displays information about the existing Secondary checkpoints associated with the RLINK, which includes the name of the checkpoint, its size, and the percentage of SRL used.


vxrlink -g diskgroup [-T] updates rlink_name

Valid on the Secondary only. Displays the update ID received by the Secondary, as well as the number of updates by which the Primary is ahead. This information can be used to determine the most up-to-date Secondary RVG. This command when used with the -T option, displays the exact time in hours by which the Secondary is behind.


vrstat -g diskgroup [-R] [-V] [-M] rvg_name

Valid on the Primary as well as the Secondary. Displays detailed statistics. The output of this command is a combination of the outputs of the vxrlink stats, vxrlink status, vxstat, and vxmemstat commands.


vxprint -V[l]

Displays all RVGs.


vxprint -P[l]

Displays all RLINKS.


vxmake -g diskgroup rlink rlink_name protocol=protocol_name remote_host=sec_hostname remote_rlink=rlink_name

Creates an RLINK with the specified network transport protocol. The attribute
protocol_name can have a value of TCP or UDP.


vxmemstat [-i interval [-t count]] [-e]

Display memory statistics for VERITAS Volume Manager.


vxtune [ -rH ] keyword arg ... 

Modify and display Volume Replicator and VxVM tunables.


vrport [ -a | -r ] keyword arg ...

Perform Volume Replicator port management operations.


vrnotify -g diskgroup [-n number] [-t timeout] [rvg_name ...]

Display VERITAS Volume Replicator (VVR) events.


vxedit -g diskgroup set protocol=protocol_name rlink_name

Allows you to change the specified network transport protocol. The protocol can be set to either TCP or UDP. For more information refer to the vxedit manual page.

 ^ Return to Top Previous  |  Next  >  
Product: Volume Replicator Guides  
Manual: Volume Replicator 4.1 Administrator's Guide  
VERITAS Software Corporation
www.veritas.com