VVR command reference

Table: VVR command reference lists the VVR commands and their descriptions.

The vradmin command can be issued from any host in the Replicated Data Set (RDS); the low-level VVR commands must be issued on the host on which the object resides.

Note:

This reference lists command options for frequently used scenarios. For a complete list of options, refer to the respective manual page.

Table: VVR 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 srlprot=fail srlprot=off

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.

protocol=TCP

protocol=UDP

vradmin -g diskgroup set local_rvgname sec_hostname bandwidth_limit=value

Sets the bandwidth limit for replication to the Secondary.

bandwidth_limit=value

bandwidth_limit=none

vradmin -g diskgroup set local_rvgname [sec_hostname] compression=value

Enables or disables compression.

compression=on

compression=off

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 Storage 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 Storage Checkpoint to the Secondary when the application is active or inactive.

vradmin -g diskgroup -full syncvol local_vols_list remote_hostname.... bandwidth_limit=value

Synchronizes volumes on local host and remote hosts using full synchronization. The synchronization uses the specified bandwidth limit.

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... bandwidth_limit=value

Verifies and reports any data differences between remote volumes and the corresponding local volumes. The operation uses the specified bandwidth limit.

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.

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 [pridiskname=primary_disk_names] [secdiskname=secondary_disk_names]

Resizes a data volume in an RDS.

The pridiskname and secdiskname options enable you to specify a comma-separated list of disk names for the resize operation.

vradmin -g diskgroup resizesrl local_rvgname length [pridiskname=primary_disk_names] [secdiskname=secondary_disk_names]

Resizes the SRL in an RDS.

The pridiskname and secdiskname options enable you to specify a comma-separated list of disk names for the resize operation.

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]......[-all]

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.

vradmin -g diskgroup activatebunker local_rvgname

Activates a bunker. This command must be issued on the bunker host.

vradmin -g diskgroup deactivatebunker local_rvgname

Deactivates a bunker. This command must be issued on the bunker host.

vradmin -g diskgroup -bdg bunkerdgname addbunker local_rvgname pri_hostname bunker_hostname protocol=value

Creates a bunker RVG on the bunker host.

protocol=TCP
protocol=UDP
protocol=STORAGE

vradmin -g diskgroup delbunker local_rvgname bunker_hostname

Deletes a bunker RVG from an RDS.

vradmin -g diskgroup addvol local_rvgname volumeset_name

Adds a volume set to an RDS.

vradmin -g diskgroup -tovset volumeset_name addvol local_rvgname volume_name

Adds a volume to a volume set that is associated with an RDS.

vradmin -g diskgroup delvol local_rvgname volumeset_name

Removes a volume set from an RDS.

vradmin -g diskgroup -fromvset volumeset_name delvol local_rvgname volume_name

Removes a volume from both the volume set and an RDS.

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 Storage Checkpoint by pointing to the current location of the SRL.

vxrvg -g diskgroup checkend rvg_name

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

vxrvg -c checkpt_name checkdelete rvg_name

Deletes the specified Primary Storage Checkpoint.

vxrvg -g diskgroup cplist rvg_name

Displays information about all existing Storage 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.

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. The -P option can be used to select the snapshot volume names that begin with the specified prefix for the refresh operation. The prefix "SNAP" is used if no prefix is specified. 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.

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, Storage 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 Storage Checkpoint.

vxrlink -c checkpt_name checkdelete rlink_name

Deletes the specified Secondary Storage 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 [-i <interval>] [-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 Storage Checkpoints associated with the RLINK, which includes the name of the Storage 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.

vxmake -g diskgroup rlink rlink_name compression=value

Enables or disables compression.

compression=on

compression=off

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

vxedit -g diskgroup set bunker_target=on RLINK_from_secondary_ to_bunker

Sets the bunker_target flag on the RLINK from the Secondary to the bunker node. You must run this command on the Secondary for global clustering to automatically replay the bunker to the Secondary.

You only need to run this command when you are upgrading from Release 5.1 to 5.1 SP1.

vxedit -g diskgroup set compression=value rlink_name

Enables or disables compression.

compression=on

compression=off

In a shared disk group environment, commands must be issued from the CVM master. However, the RLINK informational and administrative commands, vxrlink pause, vxrlink resume, vxrlink status, and vxrlink stats can be issued on any node in the cluster.