Symantec logo

vradmin

NAME

vradmin - administer Veritas Volume Replicator (VVR) in a distributed environment

SYNOPSIS

vradmin [-g diskgroup] activatebunker rvg

vradmin [-g diskgroup] -bdg diskgroup
addbunker rvg prihost bunkerhost protocol=STORAGE

vradmin [-g diskgroup] [-bdg diskgroup]
addbunker rvg prihost bunkerhost [protocol=TCP|UDP]

vradmin [-g diskgroup] [-nodcm] [-sdg diskgroup]
addsec rvg prihost sechost [attribute...]

vradmin [-g diskgroup] [-nodcm] [-s] addvol rvg volume|vset

vradmin [-g diskgroup] [-nodcm] [-s] -tovset vset
addvol rvg volume[:index]

vradmin [-g diskgroup] changeip rvg [sechost] [attribute...]

vradmin [-g diskgroup] [-nodcm] createpri rvg volumelist srl

vradmin [-g diskgroup] deactivatebunker rvg

vradmin [-g diskgroup] delbunker rvg [bunkerhost]

vradmin [-g diskgroup] [-f] delpri rvg

vradmin [-g diskgroup] delsec rvg [sechost]

vradmin [-g diskgroup] [-f] delvol rvg volume|vset

vradmin [-g diskgroup] [-f] -fromvset vset
delvol rvg volume

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

vradmin [-g diskgroup] [-all] ibc rvg taskname [sechost] ...

vradmin [-g diskgroup] [-f] makesec rvg prihost

vradmin [-g diskgroup] [-s] migrate rvg [sechost]

vradmin [-g diskgroup] pauserep rvg [sechost]

vradmin [-g diskgroup] [-l] printrvg [rvg...]

vradmin [-g diskgroup] printvol [rvg...]

vradmin [-g diskgroup] [-l] repstatus rvg

vradmin [-g diskgroup] [-f] resizesrl rvg length

vradmin [-g diskgroup] [-f] resizevol rvg volume length

vradmin [-g diskgroup] resumerep rvg [sechost]

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

vradmin [-g diskgroup] set rvg [sechost] attribute...

vradmin [-g diskgroup] { -a | -c checkpoint | -f | -b }
startrep rvg [sechost]

vradmin [-g diskgroup] [-f] [-s] stoprep rvg [sechost]

vradmin [-g diskgroup] -c checkpoint [-full] syncrvg rvg sechost...

vradmin [-g diskgroup] [-s] -verify syncrvg rvg sechost...

vradmin [-g diskgroup] [-full] [-s] syncvol volumelist
host
[:diskgroup[:volumelist]]... [attribute...]

vradmin [-g diskgroup] [-s] -verify syncvol volumelist
host
[:diskgroup[:volumelist]]...

vradmin [-g diskgroup] [-autofb] [-N] takeover rvg

vradmin [-g diskgroup] [-k {snap|cache}] verifydata
rvg sechost {cache=cache-object | cachesize=size}

vradmin help [keyword]

DESCRIPTION

The vradmin utility performs administrative tasks on a Replicated Data Set (RDS) in a Veritas Volume Replicator (VVR) environment. Tasks available in vradmin include configuring, administering and displaying Replicated Data Sets, synchronizing remote volumes or volume sets, and migrating or taking over the Primary role in the RDS.


  Note    vradmin is a VVR-specific utility and requires a valid VVR license.


A Replicated Data Set (RDS) is comprised of a Replicated Volume Group (RVG) on the Primary host and its counterparts on the Secondary hosts.


  Note    An RDS is a concept used in vradmin; it is not a VVR object.


To perform an administrative task, vradmin accesses and changes the VVR configuration on the Primary and the Secondary hosts in an RDS.

The vradmin command can be executed from a Primary or any Secondary host in an RDS.

In a shared diskgroup environment, the vradmin command can be executed on all nodes in the cluster.

In a SAN disk group environment, the vradmin command can be issued on the volume server or volume client, provided the data volumes are attached to the host on which the command is issued (see vxsvmdiag(1M)).

The vradmin keywords specify the operation to perform. Each operation can be performed on only one RDS at a time. The rvg argument is the name of a Replicated Volume Group (RVG) that specifies the RDS on the local host. Because the name of the Primary and Secondary RVG can be different, the same RDS can be represented by different names on different hosts.

The rvg, volume, or vset arguments determine a default local disk group, according to the standard disk group selection rules described in vxintro(1M). You can specify a local disk group using the -g diskgroup option.

KEYWORDS

activatebunker

Activates the Bunker host for SRL replay. The activatebunker command must be run from a Bunker host that needs to be activated.

This command works only when the Primary host in the RDS is down or not reachable from the Bunker Secondary host. The activatebunker command is useful when the Primary host goes down due to an unscheduled problem or due to a disaster. The activatebunker command converts the Bunker Secondary to a Bunker Primary.


  Note    After this command, use the startrep command with the -b option to start the SRL replay.


addbunker

Creates a Secondary Bunker RVG of the same name as the Primary RVG and adds it to the Replicated Data Set (RDS) rvg. The addbunker command also associates existing Storage Replicator Log (SRL) on the Bunker Host with the Bunker Secondary RVG. It creates and associates Primary and Bunker RLINKs (named rlk_bunkerhost_rvg and rlk_prihost_rvg) with the Primary and Bunker Secondary RVGs.

In addition, the command also creates and associates Bunker and Secondary RLINKs (named rlk_remotehost_rvg) with the Bunker and any Secondary RVGs in the RDS.

The addbunker command requires that the SRL should exist on the Bunker with the same name and length as the SRL on the Primary.


  Note    Before adding a bunker that will replicate using the STORAGE protocol, import the bunker disk group (specified with the -bdg option) on the Primary.


The arguments prihost and bunkerhost specify the network connection to use for replication. They are resolvable names or IP addresses of the Primary and the Bunker host.

The addbunker command can be executed from any host in the RDS. If an RDS contains only a Primary host, then addbunker must be executed from the Primary host.

Caution: Do not execute the addbunker command from the Bunker host that is being added to the RDS.

The Bunker can be created only if the /etc/vx/vras/.rdg file on the Bunker host contains an entry for the Primary disk group ID. The addbunker command validates this entry before creating the Bunker. A plus character (+) entry in the /etc/vx/vras/.rdg file on the Bunker host allows addbunker command for any disk group ID from any remote host to proceed.


  Note    While using the protocol=STORAGE option this .rdg file should be present on the Primary Host.


By default, the addbunker command creates a Bunker Secondary RVG in the disk group with the same name as the Primary disk group. To specify a different disk group name on the Bunker, use the option -bdg diskgroup. This option is mandatory in case the protocol=STORAGE option is being used. In such a case, the diskgroup specified for -bdg option should be imported on the Primary Host.

If the SRL on the Bunker has Dirty Region Log (DRL), the DRL is removed before the SRL is associated with the Bunker RVG.


  Note    In case any of the existing Secondaries has a configuration error, this command will not succeed.


addsec

Creates a Secondary RVG of the same name as the Primary RVG and adds it to the Replicated Data Set (RDS) rvg. The addsec command also associates existing data volumes, volume sets, and Storage Replicator Log (SRL) on the Secondary with the Secondary RVG. It creates and associates Primary and Secondary RLINKs (named rlk_sechost_rvg and rlk_prihost_rvg) with the Primary and Secondary RVGs.

Additionally, this command also creates RLINKs between the Secondary sechost being added and the existing Secondaries and Bunker in the configuration.

The addsec command requires that the data volumes and SRL must exist on the Secondary with the same names and lengths as the data volumes and SRL on the Primary. However, if a volume set does not exist on the Secondary, the addsec command creates it and associates the data volumes corresponding to the volume set on the Primary with the newly created volume set on the Secondary.


  Note    All the volumes being added to an RVG should be of the same type, that is, either VxVM ISP volumes or VxVM non-ISP volumes. Similarly, the component volumes of the volume set being added to an RVG also should all be of the same type as those already present in the RVG. A component volume can be either VxVM ISP volume or VxVM non-ISP volume.


In a SAN disk group environment, the Primary volume server must have the network connection to both Secondary volume server and Secondary volume client.

The arguments prihost and sechost specify the network connection to use for replication. They are resolvable names or IP addresses of the Primary and the Secondary host.

The addsec command can be executed from any host in the RDS. If an RDS contains only a Primary host, then addsec must be executed from the Primary host.

Caution: Do not execute the addsec command from the Secondary host that is being added to the RDS.

The Secondary can be created only if the /etc/vx/vras/.rdg file on the Secondary host contains an entry for the Primary disk group ID. Before creating the Secondary, this entry is validated as part of the addsec command. A plus character (+) entry in the /etc/vx/vras/.rdg file on the Secondary host allows addsec command for any disk group ID from any remote host to proceed.

The addsec command creates a Secondary RVG in the disk group with the same name as the Primary disk group. If required, you can use the option -sdg diskgroup to specify a different disk group on the Secondary.

If any of the data volumes or the SRL on the Secondary has Dirty Region Logs (DRL), the DRL is removed before the volume is associated with the Secondary RVG.

By default, the addsec command adds Data Change Maps (DCM) to the Primary and Secondary data volumes. Use the -nodcm option to specify that DCMs are not to be added to the data volumes. When the -nodcm option is used, the addsec command sets the srlprot attribute of the RLINKs to the value off instead of the default value of autodcm.

By default, the addsec command creates RLINKs named rlk_remotehost_rvgname. You can specify Primary and Secondary RLINK names using the prlink and srlink attributes. The expression to assign a value to an attribute takes the form attribute_name=value. For example, the following command creates Primary RLINK to_nyk and Secondary RLINK to_sfo, and adds Secondary nyk to RDS hr_rvg:

vradmin addsec hr_rvg sfo nyk prlink=to_nyk srlink=to_sfo


  Note    In case any of the existing Secondaries has a configuration error, this command will not succeed.


addvol

Adds an existing volume or a volume set, vset, to the Replicated Data Set (RDS) rvg. This command associates an existing volume or vset, with the corresponding RVGs on all hosts in the RDS. The volume must have the same length on the Primary and Secondary hosts in the RDS.


  Note    The volume being added to an RVG should be of the same type as those already present in the RVG. A volume can be either VxVM ISP volume or VxVM non-ISP volume.


If a volume set is being added to the RDS, the component volumes of the vset must have the same length on the Primary and Secondary hosts in the RDS. If the volume set does not exist on the Secondary, the addsec command creates it and associates the data volumes corresponding to the volume set on the Primary with the newly created volume set on the Secondary.


  Note    The component volumes of the volume set being added to an RVG should all be of the same type as those already present in the RVG. A component volume can be either VxVM ISP volume or VxVM non-ISP volume.


If any of the Primary or Secondary data volumes or component volumes of the vset that are to be added to the RDS have Dirty Region Logs (DRL), the addvol command removes the DRLs from these volumes.

By default, the addvol command adds Data Change Maps (DCM) to the Primary and Secondary data volumes, including component volumes of volume sets. Use the -nodcm option if you do not want to add DCM to the volumes.

Specify the -tovset vset option to add the specified volume both to the specified volume set on all the hosts and to the RDS. The :index argument is optional and must be a non-negative integer value. If the index is specified, this value is assigned to the volume in the volume set. If the index is not specified, a default value is assigned.

If replication is in progress, make sure that the Secondary volume contains the same data as the Primary volume before adding the volume to the RDS. To transfer the data from the Primary volume to the Secondary volume over the network, use the vradmin syncvol command.

At the start of the addvol command, you are asked to confirm that the Primary and Secondary volumes contain the same data. Specifying the -s option skips this confirmation step.

changeip

Changes the network used for the replication between the Primary and Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed by the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The vradmin changeip command changes the hostname or IP address set in the Primary and Secondary RLINKs to the new values specified in the newpri and newsec attributes. These attributes are of the form attribute_name=value.

newpri

Specifies a new hostname or IP address for the Primary host that is to be used to establish a network connection for the replication to the Secondary. This is the new value for the local_host attribute of the Primary RLINK and the remote_host attribute of the corresponding Secondary RLINK.

newsec

Specifies a new hostname or IP address for the Secondary host that is to be used to establish a network connection for the replication. This is the new value for the remote_host attribute of the Primary RLINK and the local_host attribute of the Secondary RLINK.

In a SAN disk group environment, the new Primary and Secondary IP addresses must reside on the same hosts on which the current IP addresses reside.

Refer to vxedit(1M) for more information on the local_host and remote_host attributes of an RLINK.


  Note    The new hostname or IP address of the Primary and Secondary must be resolvable and at least one of the original or new network connections must be available.


createpri

Creates a Primary RVG rvg for the new Replicated Data Set (RDS) rvg. The volumelist argument is a comma-separated list of the existing data volumes and volume sets. The srl argument is the existing volume that is to be used as the Storage Replicator Log (SRL) volume.

In SAN disk group environment, if the application resides on the volume client, all Primary data volumes must be attached to the volume client or unattached from the volume client (see vxsvmdiag(1M)).


  Note    All the datavolumes being added on an RVG should be of the same type , that is, either VxVM ISP volumes or VxVM non-ISP volumes. In addition, the component volumes of all the volume sets being added on an RVG should also be of the same type, that is, either VxVM ISP volumes or VxVM non-ISP volumes.


Before using the createpri command, use the vxassist, vxvset or the vxmake command to create the data volumes, volume sets and SRL with the required layout. Execute the createpri command on the host that is to be configured as the Primary host of the new RDS.

The createpri command starts the Primary RVG and then associates the data volumes, volume sets and the SRL volume with the Primary RVG.

The createpri command removes the Dirty Region Logs (DRL) from the data volumes, component volumes of the volume set and the SRL volume if they have DRLs.

By default, the createpri command adds Data Change Maps (DCM) to the data volumes and the component volumes of the volume sets specified in the command. Use the -nodcm option if you do not want to add DCM to the data volumes and the component volumes of the volume sets.


  Note    You can run the createpri command when the data volumes or the component volumes of the volume set are in use (active).


deactivatebunker

Converts a Bunker Primary to a Bunker Secondary in the Replicated Data Set (RDS) rvg.


  Note    Before using this command, stop the SRL replay from the Bunker host to any secondaries with the stoprep command.



  Note    The Bunker Primary RVG must be deactivated before promoting the Secondary RVG using the takeover command.


delbunker

Deletes the Bunker bunkerhost from the Replicated Data Set (RDS) rvg. The argument bunkerhost is the name of the Bunker host as displayed in the output of the vradmin printrvg command. This is optional if the RDS contains only one Bunker host. The delbunker command dissociates the SRL from the Bunker RVG and deletes the Bunker RVG, the Bunker RLINK, and the RLINKs between the Bunker and the Primary.

In addition, the command also deletes any RLINKs between the Bunker host and any existing Secondaries in the RDS.


  Note    The delbunker command does not delete the SRL.


The delbunker command fails if replication to the Bunker bunkerhost is active. Use the vradmin stoprep command to stop replication to the Bunker.


  Note    If the Bunker host is activated, this command does not work. In addition, this command will also not succeed if any of the existing Secondaries has a configuration error.


delpri

Deletes the Primary RVG (rvg), thereby deleting the corresponding Replicated Data Set (RDS) rvg. This command dissociates the data volumes, including component volumes of the volume sets, and the SRL from the Primary RVG; it does not delete the volumes and the SRL from the Veritas Volume Manager configuration.

The delpri command fails if the Primary RVG to be deleted still has one or more Secondaries. Use the vradmin delsec command to delete all of its Secondaries before using the delpri command to delete the Primary RVG.

Use the -f option to delete a Primary RVG when the Primary data volumes or component volumes are in use.

This command can be run only from the Primary host.

delsec

Deletes the Secondary sechost from the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed in the output of the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host. The delsec command dissociates the data volumes, volume sets and the SRL from the Secondary RVG and deletes the Secondary RVG, the Secondary RLINK, and the Primary RLINK to the Secondary.


  Note    The delsec command does not delete the data volumes, volume sets and SRL.


The delsec command fails if replication to the Secondary sechost is active. Use the vradmin stoprep command to stop replication to the Secondary.


  Note    In case any of the existing Secondaries has a configuration error, this command will not succeed.


delvol

Deletes the data volume, volume, or volume set, vset, from the Replicated Data Set (RDS) rvg. The delvol command dissociates the volume or vset from the Primary and the Secondary RVGs in the RDS. The volumes are not physically deleted from the VxVM configuration.

Use the -f option to delete a volume from the RDS when the Primary RVG is not stopped.

Use the -fromvset vset option to delete the specified volume both from the specified volume set on all the hosts and from the RDS.

fbsync

Converts a failed Primary to a Secondary in the Replicated Data Set (RDS) rvg. It also uses failback logging to synchronize data volumes on the failed Primary with the data volumes on the new Primary.


  Note    This command can be run only if failback logging was enabled during the takeover. Refer to the takeover command for more details on enabling failback logging.


In failback logging mode, VVR uses Data Change Maps (DCM) to track the changes happening on the new Primary while the original Primary is not available. The fbsync command synchronizes the original Primary with the new changes on the new Primary by replaying the DCMs.

This method of failed Primary synchronization is recommended over the difference-based synchronization that is used by the syncrvg command. Failback logging does not require VVR to read all data blocks, nor to compute and compare checksums for the data blocks.

The fbsync keyword can optionally be used with the cache or cachesize attributes to create a space-optimized snapshot of the old Primary's data volumes before starting the resynchronization process.

The cache attribute specifies the name of an existing cache object.


  Note    If the old Primary's data volumes are VxVM ISP volumes, then create a VxVM ISP cache object.


The cachesize attribute specifies a default size for a new cache object with respect to the source volume.


  Note    If the old Primary's data volumes are VxVM ISP volumes, then the cachesize attribute cannot be used.


All the snapshots are created on the cache object. The cache and cachesize attributes are mutually exclusive. If you do not specify either of these attributes, vradmin fbsync resynchronizes the original Primary's data volumes using DCM replay, without creating the snapshots.

The fbsync command returns immediately after starting the synchronization. Use the -wait option if you want the fbsync command to wait until the synchronization is complete.

ibc

Performs off-host processing task on the Secondary sechost in the Replicated Data Set (RDS) rvg using In-Band Control (IBC) Messaging. The argument sechost is the name of the Secondary host as displayed in the output of the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host. To perform the task on multiple Secondaries, specify a space-separated list of their names or IP addresses. Use the -all option to perform the task on all Secondaries in the RDS. The argument taskname identifies the off-host processing task and the corresponding user-defined scripts.

The vradmin ibc command uses IBC Messaging and executes a set of user-defined scripts to perform certain desired off-host processing task. See the Veritas Volume Replicator Administrator's Guide for more information on In-Band Control Messaging.

The vradmin ibc command fails if the RLINKs are not in CONNECT state.

The vradmin ibc command executes the following user-defined scripts:

On the Primary host:

/etc/vx/vvr/ibc_scripts/<taskname>/quiesce /etc/vx/vvr/ibc_scripts/<taskname>/unquiesce

On the Secondary sechost host:

/etc/vx/vvr/ibc_scripts/<taskname>/prefreeze /etc/vx/vvr/ibc_scripts/<taskname>/onfreeze /etc/vx/vvr/ibc_scripts/<taskname>/postfreeze

The onfreeze script is mandatory. The vradmin ibc command fails if the onfreeze script does not exist on the Secondary host. The other scripts are optional. If the quiesce script is provided, the unquiesce script must also be provided and vice versa.

Below is a brief guideline on which operations should be implemented in each script:

quiesce

Quiesce the application running on the Primary data volumes and put the Primary data volumes in application-consistent state.

unquiesce

Unquiesce the application running on the Primary data volumes, that is, put the application back to the normal operating mode.

prefreeze

Perform operations needed on the Secondary RVG in preparation for the execution of the onfreeze script. For example, if the action in the onfreeze script is to take a snapshot of the Secondary data volumes, the prefreeze script can be used to add snapshot plexes to the Secondary data volumes.

onfreeze

Perform desired operation that requires the replication to be frozen on the Secondary RVG such as taking a snapshot of the Secondary data volumes.

postfreeze

Perform any necessary operations after the onfreeze script has completed and the replication on the Secondary RVG has resumed.

In a shared disk group environment, these scripts must reside on the Master and Logowner nodes.

In a SAN disk group environment, these scripts must reside on both volume server and volume client.

See the Veritas Volume Replicator Administrator's Guide for detailed information on how these scripts work in the vradmin ibc command.

makesec

Converts a failed Primary to a Secondary of the new Primary in the Replicated Data Set (RDS) rvg. The argument prihost is the name of the new Primary host that was previously a Secondary of the failed Primary. The vradmin -l printrvg rvg command displays Primary-Primary configuration error if there are multiple Primary nodes in the Replicated Data Set (RDS) rvg. The prihost argument must be the host that is displayed with a Primary-Primary configuration error.


  Note    This command can be run only from failed Primary host when one of its Secondaries has taken over the Primary role.


Use the makesec command to convert a failed Primary RVG to a Secondary in a failback procedure only if failback logging was not enabled during the takeover. To perform failback, first use the vradmin makesec command to convert the failed Primary to a Secondary. Then use the vradmin syncrvg command to synchronize the data volumes on the new Secondary (failed Primary) with the data volumes on the new Primary. Finally, at a scheduled time, use the vradmin migrate command to migrate the Primary role back to the failed Primary.

The -f option is used with the makesec keyword to convert a failed Primary to a Secondary, even when the Secondary data volumes are not up-to-date, or if any of the failed Primary data volumes are open.

migrate

Migrates the Primary role from the Primary host to a Secondary host in the Replicated Data Set (RDS) rvg. The Primary role can only be migrated when all the attached Primary RLINKs are up-to-date, consistent, and not in an error state. The data volumes in the RDS must be inactive, that is, applications involved in replication must be stopped before running the migrate command. After the migration completes, the former Secondary adopts the Primary role, and the former Primary adopts the Secondary role.

By default, the migrate command starts replication from the new Primary to the original Primary, which is now a Secondary. The command issues a warning if the replication does not start (that is, RLINKs do not change to CONNECT state). The migrate command also starts the RVG on the new Primary.

At the start of the migrate command, you are asked to confirm that all the applications using the Primary volumes have been stopped. You can use the -s option to skip this confirmation step.

pauserep

Pauses the replication to the Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed in the output of vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The pauserep command initiates a Primary pause that is independent of the host from which the command is executed. See the vxrlink(1M) manual page for more information on Primary pause and Secondary pause.

printrvg

Displays information about all RVGs in the Replicated Data Set (RDS) rvg. The host name, the RVG name, and the disk group are displayed for each RVG in the RDS starting with the Primary RVG. If the argument rvg is not specified, all Replicated Data Sets on the local host are displayed. Use the -g diskgroup option to display Replicated Data Sets in a particular disk group.

The -l option displays information in a long format. This format displays additional information such as number of data volumes, number of volume sets, SRL name, and RLINK-related information for each RVG in the RDS. This option also displays configuration errors in the RDS, if there are any.

printvol

Displays information about data volumes in all RVGs in the Replicated Data Set (RDS) rvg. The host, disk group, RVG, and volume names are displayed for each RVG in the RDS starting with the Primary RVG. If the argument rvg is not specified, the above information is displayed for all Replicated Data Sets on the local host.

You can use the -g diskgroup option to display Replicated Data Sets in a particular disk group.

Information is displayed in a table format. The first column is the type field for each row. The second column contains information about the Primary RVG, if there is one. Information about the Secondary hosts is displayed in subsequent columns. If there are more than two Secondary hosts in the RDS, information tables are repeated with the Primary in the second column.

The name, size (in blocks), plex count, and volume flags are displayed for each volume in the RDS. In addition, if the volume is part of a volume set, the volume set name and the index of the volume within the volume set is also displayed for each such volume in the RDS. The printvol command is useful to view volume mappings between the Primary and the Secondary RVGs. Secondary volumes are displayed on the same row as the corresponding Primary volumes in the output. If a Primary or Secondary volume is not mapped, a dash (-) is displayed.

repstatus

Displays the current replication status of the Replicated Data Set (RDS) rvg. repstatus displays information about each RVG in the RDS starting with the Primary RVG.

Output of the repstatus command contains the following information for the Primary RVG: host name, RVG name, disk group, RVG state, number of data volumes being replicated, number of volume sets being replicated, SRL name, SRL size, and the number of Secondary RVGs configured in the RDS.

For each Secondary RVG in the RDS, the following information is displayed: host name, RVG name, disk group, data status, replication status, current replication mode, type of log currently in use, and the timestamp information of the Secondary RLINK. If the -l option is used, additional information such as RLINK names, replication mode configured in the RLINKs, latency protection setting, SRL protection setting, and bandwidth limit setting is also displayed for all the Secondary RVGs.

Following is a description of the important fields in the output of repstatus command:

RVG state

Indicates the state of the Primary RVG, for example, Primary RVG is currently enabled or disable for I/O.

Data status

Indicates whether the data on this Secondary is consistent or inconsistent with respect to the data on the Primary. If the Secondary is consistent, repstatus also displays whether the Secondary data is up-to-date, behind, or in stale state. A value of N/A indicates if the Secondary data needs recovery or its status cannot be determined (this may be due to a configuration error).

Current replication mode

Displays the current replication mode that is used to replicate data to the Secondary. This value can be different than the replication mode configured in the Primary RLINK if the replication mode configured is synchronous override.

Replication status

Indicates whether Primary data is being replicated to the Secondary. repstatus displays additional information in case data is not replicated.

Logging to

Displays whether updates to the Secondary are tracked using SRL or DCM. If the Secondary is not up-to-date, repstatus shows how far behind the Secondary is with respect to the Primary and the percentage of SRL used by this Secondary.

The repstatus command also displays configuration errors in the RDS, if there are any.


  Note    if the vradmin repstatus command is run from a Secondary which has some configuration error or cannot reach to the Primary, the output of the repstatus command displays the status known to the Secondary before the above condition occurs and thus might be out-of-date.


resizesrl

Increases the size of the SRL in a Replicated Data Set (RDS) specified by rvg to the size specified by length. The size the SRL can be increased while the application is active or while replication is in progress. The resizesrl command only increases the size; it does not allow you to shrink the size of the SRL.

The resizesrl command increases the size of the SRL in the RDS on the Primary, on any valid Secondaries, and on the bunker node, if present. A valid Secondary is one that is correctly configured; that is, it does not have configuration errors. Use the vradmin -l printrvg command to view the configuration status of the RDS. The resizesrl command does not resize the SRL on any Secondary that has configuration errors.

The argument length is the desired size for the SRL. The length can be specified using the standard length convention in VxVM. The argument length can be prefixed by a plus sign (+) to indicate an increase of the size of the SRL by the specified amount.

The resizesrl command checks the Primary, Secondary and Bunker hosts in the RDS to ensure there is enough free space in the disk group to resize the SRL. If any host does not have enough space to resize the SRL, the resizesrl command fails.

Use the -f option for the resizesrl command to resize the Primary SRL even if the Secondary or Bunker hosts do not have enough space to increase the SRL. This option may be necessary to protect the Primary SRL from overflow. When you specify the resizesrl command with the -f option, the command succeeds and resizes the Primary SRL provided that the Primary has enough space. The resizesrl -f command also attempts to resize the Secondary SRL and the Bunker SRL, if present. However, if any Secondary or Bunker host does not have enough free space to increase the SRL size, the resize operation fails on that host.


  Note    using the -f option may result in different SRL sizes on different hosts.


resizevol

Resizes the data volume, volume, in a Replicated Data Set (RDS) rvg to the size specified by length. The resizevol command resizes the Primary data volume volume and the corresponding Secondary data volumes. This command can also be used to resize the component volumes of a volume set in the RDS.

The argument length is the desired size for the data volume. The length can be specified using the standard length convention in VxVM. If the sizes of the Primary and Secondary data volumes are currently the same, the argument length can be prefixed by either plus (+) or minus (-) to indicate whether to increase or decrease the data volume size by the specified amount.

The resizevol command also resizes the file system on the Primary data volume as described in vxresize(1M).

If replication to any Secondary RVG is in progress, the resizevol command performs a secondary pause, resizes the volume, and then resumes the replication.


  Note    Before increasing a volume size, make sure there is enough free space on the Primary and all the Secondaries to accommodate the growth, and also make sure that the additional portion of the Secondary data volumes is synchronized with the additional portion of the Primary data volume.


The -f option is required if any of the data volumes to be resized are being decreased in size.

If the resizevol command fails on any of the hosts in the RDS during its execution, the original volume sizes are not restored. This results in volume size mismatch between the Primary and its Secondaries. To correct this mismatch, re-issue the resizevol command with an absolute length.

resumerep

Resumes replication to the Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed in the output of the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The resumerep command resumes the Primary RLINK and the corresponding Secondary RLINK to resume replication. The command issues a warning if the replication does not resume (that is, RLINKs do not change to CONNECT state).

resync

Starts replay an active DCM in the Replicated Data Set (RDS) rvg.

The resync command starts replay of a DCM that is active due to SRL overflow or failback logging. Replay occurs for all RLINKs on which the dcm_logging flag is set. If any of these RLINKs are disconnected or paused, resynchronization is delayed until this condition clears. Detaching a disconnected or paused RLINK clears the dcm_logging flag, and allows resynchronization to proceed on any remaining RLINKs.

The resync keyword can optionally be used with the cache or cachesize attributes to to create a space-optimized snapshot of the secondary data volumes before starting the resynchronization process.

The cache attribute specifies the name of an existing cache object.


  Note    If the secondary data volumes are VxVM ISP volumes, then create a VxVM ISP cache object.


The cachesize attribute specifies a default size for a new cache object with respect to the source volume.


  Note    If the secondary data volumes are VxVM ISP volumes, then the cachesize attribute cannot be used.


All the snapshots are created on the cache object. The cache and cachesize attributes are mutually exclusive. If you do not specify either of these attributes, vradmin resync resynchronizes the Secondary volumes using DCM replay, without creating the snapshots.

The resync command returns immediately after starting the synchronization. Use the -wait option if you want the command to wait until the synchronization is complete.

Refer to vxrvg(1M) for more information.

set

Changes the replication attributes for the replication to the Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed by the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The vradmin set command changes the replication attributes on both the Primary and Secondary. These attributes are of the form attribute_name=value.

The following attributes are available:

bandwidth_limit

Sets the maximum network bandwidth (in bits per second) that can be used during replication. The value may be qualified by the suffixes kbps or k for kilobits per second, mbps or m for megabits per second, and gbps or g for gigabits per second. The default value none removes the limit. The minimum allowed value is 56kbps.

latency_high_mark

Sets the maximum number of outstanding requests when latency protection is enabled.

latency_low_mark

After throttling is enabled, sets the level to which the number of outstanding requests must drop before throttling is disabled.

latencyprot

Indicates whether latency protection is enabled for the RLINK. The attribute may have one of following values: fail, off, or override.

Refer to vxedit(1M) for more information on these values.

packet_size

Sets the packet_size value. This is the number of bytes in a packet that is sent to a secondary RLINK.

protocol

Indicates the network transport protocol that is used by RLINKs for communicating between hosts. This attribute can take the value UDP for the UDP protocol, TCP for the TCP protocol or STORAGE for the STORAGE protocol used with bunker. The values TCP, UDP and STORAGE are case sensitive, and must be specified in upper case.


  Note    Ensure that the protocol attributes for the Primary and Secondary RLINKs are set to the same value. When replicating between VVR 3.5 and VVR 4.0, ensure that the vol_vvr_transport tunable is set to the same value on both hosts. In VVR 4.0, the protocol can be set by using the vxedit set command. For more information, refer to the vxedit(1M) manual page.


srlprot

Indicates whether log protection is enabled for the RLINK. Log protection prevents an RLINK from overflowing the SRL, which would cause it to become stale.

This attribute may have one of following values: autodcm, dcm, fail, off, or override.

Refer to vxedit(1M) for more information on these values.

synchronous

Indicates whether replication should operate in synchronous or asynchronous mode.

This attribute may have one of following values: off or override.

Refer to vxedit(1M) for more information on these values.

startrep

Starts replication to the Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed in the output of vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The startrep command attaches RLINKs on the Secondary and Primary to start replication.

The startrep command provides the -a, -c checkpoint, -f and -b options. Only one of these options may be specified with this command.

The -a option starts autosync of the Secondary data volumes on command execution.

The -a option is mandatory while starting the replication from Primary to Bunker host.

The -c checkpoint option attaches the Primary RLINK with the specified checkpoint.

The -f (force) option may be used if the Primary RVG is empty or if the Secondary data volumes contain the exact same data as Primary data volumes.

The -b option starts replication to Secondary from the Bunker after the Bunker is activated.

These options work in the same way as the corresponding options of the vxrlink att command (see vxrlink(1M)).

The startrep command issues a warning if the replication does not start (that is, RLINKs do not change to CONNECT state).

stoprep

Stops replication to the Secondary sechost in the Replicated Data Set (RDS) rvg. The argument sechost is the name of the Secondary host as displayed by the vradmin printrvg command. The argument sechost is optional if the RDS contains only one Secondary host.

The stoprep command stops the replication by detaching the RLINKs on the Primary and the Secondary host.

The stoprep command fails if the Secondary data volumes are not up-to-date with the Primary data volumes or if any of the Primary data volumes are open. Use the -f option to stop replication when the Secondary data volumes are not up-to-date or when any of the Primary data volumes are open.

On invoking the stoprep command, you are asked to confirm that you want to stop the replication. Stopping replication can result in the data on the Secondary volumes being out of date with respect to the Primary volumes. If replication is stopped, an autosync or difference-based synchronization of the Secondary volumes with the Primary volumes is required before replication can be restarted. You can use the -s option to skip this confirmation step.

syncrvg

Synchronizes or verifies data volumes and component volumes of a volume set on the host sechost in the Replicated Data Set (RDS) rvg with its Primary data volumes. The argument sechost is the name or IP address of the Secondary host as displayed in the output from vradmin printrvg. One or more Secondaries can be synchronized or verified at the same time by specifying a space-separated list of their names or IP addresses.

All volumes associated with Secondary RVGs, including component volumes of volume sets, are synchronized or verified with the corresponding Primary volumes. This is done by transferring the Primary volume data over the network.

There are two types of synchronization: full synchronization and difference-based synchronization.

In full synchronization, all data on Primary volumes is transferred to the corresponding Secondary volumes. Full synchronization is useful for creating the initial volume copies.

In difference-based synchronization, the difference between the Primary and the Secondary volume is first computed, and then only the blocks that are different are transferred to the Secondary volumes. The MD5 checksum is used to calculate the difference between the Primary and the Secondary data volumes. The MD5 checksum is generated using the MD5 Message-Digest Algorithm from RSA Data Security, Inc. For more information on the MD5 checksum, see the md5(1M) manual page.

By default, syncrvg and syncvol use difference-based synchronization. Specify the -full option to perform full synchronization of the Secondary.

Before executing the syncrvg command to perform synchronization, use the vradmin stoprep command to stop replication to the Secondary, sechost.

In a SAN disk group environment, attach all data volumes to the volume client (see vxsvmdiag(1M)).

Always use the -c checkpoint option during the RVG synchronization. When checkpoint is specified, the syncrvg command starts the checkpoint, performs the RVG synchronization, and stops the checkpoint when the synchronization is complete. After the RVG synchronization is complete, start replication by running the vradmin startrep command with the specified checkpoint.

Use the -verify option to verify and report the data differences between Primary data volumes and the corresponding Secondary data volumes. When used with -verify option, the syncrvg command only reports the differences between the Primary and Secondary data volumes; it does not synchronize the Secondary volumes with the Primary volumes. An MD5 checksum is used to calculate the difference between the Primary and the Secondary data volumes.

All applications using the Primary data volumes must be stopped (or quiesced) before running the syncrvg command with the -verify option. At the start of the -verify syncrvg command, you are asked to confirm that the Primary data volumes are not in use. You can use the -s option to skip this confirmation step.

If the bandwidth_limit attribute has been set for the RLINK, it is honored during this operation.

The syncrvg command reports the progress of synchronization or verification with the following column headings:

Eps_time

Total time that has elapsed (hh:mm:ss).

Dest_host

IP address of the host on which the current destination volume resides.

Src_vol

Source volume.

Dest_vol

Destination volume. (Data on the destination volume is synchronized or verified with data on the source volume.)

F'shed/Tot_sz

Amount synchronized or verified so far, and total size of the source volume.

Diff

Percentage of differences found. This percentage is relative to the total amount synchronized or verified so far. For full synchronization, this field is irrelevant and is displayed as "--".

Done

Percentage of the total size synchronized or verified so far.

syncvol

Synchronizes or verifies volumelist on remote host with volumelist on local host. volumelist is a comma-separated list of volume names or volume set names. During synchronization, data on these local volumes is transferred to the remote host. host is the resolvable name or IP address of the remote host. The remote disk group and remote volume names are optional. When not specified, these names default to the same names as on the local host.

To synchronize or verify remote volumes with local volumes having different names, remote diskgroup and volumelist must be specified.

syncvol performs difference-based synchronization by default. To perform full synchronization, specify the -full option. See the syncrvg keyword for a description of sync options.


  Note    syncvol is useful for synchronizing volumes that are not associated with an RVG.


In a SAN disk group environment, perform the syncvol command between the Primary and Secondary volume servers.

Remote volumes can be synchronized or verified with local volumes only if the /etc/vx/vras/.rdg file on the remote host has a local disk group ID entry in it. Before writing to or verifying with remote volumes, this entry is validated as part of the syncvol command. A plus character (+) entry in the /etc/vx/vras/.rdg file on a host allows syncvol command from any remote host to this host to proceed.

The -verify option is used to verify and report data differences between remote data volumes and the corresponding local data volumes. When used with the -verify option, the syncvol command only reports percentage data differences between remote and local volumes; it does not synchronize remote volumes with local volumes.

On invoking the syncvol command, you are asked to confirm that you want to overwrite data on volumes on the remote host with data from volumes on the local host (for synchronization), or that the local and remote volumes are not in use (for verification). You can use the -s option to skip this confirmation step.

You can use the bandwidth_limit attribute to specify the maximum network bandwidth to be used for this operation. See the description of set for an explanation of its usage.

See the description of syncrvg for an explanation of the output from this command.

takeover

Takes over the Primary role in the Replicated Data Set (RDS) rvg. The takeover command must be run from a Secondary host in the RDS. This command works only when the Primary host in the RDS is down or not reachable from the Secondary. The data on the Secondary must be consistent for takeover to work.

The takeover command is useful when the Primary host goes down due to an unscheduled problem or due to a disaster. During takeover the Secondary RVG is converted to a Primary RVG. Volumes associated with Secondary RVG are not accessible during takeover.

It is recommended that Secondary data volumes have Data Change Maps (DCM). This allows the takeover command to enable failback logging on the new Primary (or current Secondary). Once failback logging is enabled, the fbsync command can later be used to synchronize the data volumes on the failed Primary with the data volumes on new Primary.

The takeover command enables failback logging by default. The command fails if any of the data volumes on the Secondary do not have associated DCMs.

Use the -N option to convert Secondary to Primary without enabling failback logging. This requires either full synchronization or difference-based synchronization of the data volumes on failed Primary. Failback logging synchronization is the recommended method of synchronization. Refer to the fbsync command for more details.

To automatically synchronize the failed Primary once it becomes available, use the -autofb option with the takeover command. This converts the failed Primary to the Secondary once it comes up, and also uses failback logging to synchronize the data volumes on the failed Primary.


  Note    The -autofb option can be used only if Secondary data volumes have DCMs.


verifydata

Verifies the consistency of data between the Primary and Secondary hosts by creating space-optimized instant snapshots on the Primary and specified Secondary hosts. This command ensures that the snapshots are taken only after replication is frozen by using the vxibc commands. The main advantage of this command over the verify syncrvg command is that replication need not be stopped. Verification is possible, even when replication is in progress, because point-in-time snapshots are used for comparison.

The cache attribute specifies the name of an existing cache object.


  Note    If the data volumes on the Primary or the Secondary are VxVM ISP volumes, then create a VxVM ISP cache object.


The cachesize attribute specifies a default size for a new cache object with respect to the source volume.


  Note    If the data volumes on the Primary or the Secondary are VxVM ISP volumes, then the cachesize attribute cannot be used.


All the snapshots for the volumes in the specified RVG are created on the cache object. The cache and cachesize attributes are mutually exclusive.

By default, this command destroys the snapshot volumes and the cache object after data verification has completed successfully.

To preserve the cache object, but not the snapshots that are configured on it, specify the -k cache option.

To preserve both the cache object and the snapshots, specify the -k snap option.

OPTIONS

-a

Starts replication with autosync. This option is used to attach the Primary RLINK as part of the startrep command.

This option is also mandatory while starting replication from Primary to Bunker host.

-all

Performs the specified operation to all the Secondary hosts in the Replicated Data Set. This option can only be used with the ibc command.

-autofb

Automatically uses failback logging to convert and synchronize a failed Primary as soon as the failed Primary comes back up. This option can only be used with the takeover command.

-b

Use this option to start replication from the activated Bunker node to a Secondary node; that is, to start the bunker SRL replay.

-bdg

Specifies the disk group for the addbunker operation, either by disk group ID or by disk group name. This option is mandatory to add a bunker which will replicate using the STORAGE protocol.

-c checkpoint

Starts a checkpoint, transfers the data to remote host, and marks the checkpoint end, if specified with the syncrvg command. This checkpoint can be used to attach the Primary RLINK so that writes made to Primary volumes during synchronization are transferred to Secondary volumes.

This option can also be used with the startrep command to indicate the checkpoint to which the Primary RLINK needs to be attached.

-f

Forces an operation that is usually not allowed by vradmin.

When used with the delvol command, this option removes a volume from the RDS even when the Primary RVG is not stopped.

When used with the startrep command, this option starts replication by attaching the Primary RLINK with the -f option (as done by the vxrlink att command).

When used with the stoprep command, this option stops replication to a Secondary even when the Primary RLINK is not up-to-date.

When used with the delpri command, this option deletes a Primary RVG even when it has not been stopped.

When used with the resizevol command, this option allows shrinking a data volume size in an RDS.

When used with the makesec command, this option converts a failed Primary to a Secondary even if the Secondary data volumes are not up-to-date or any of the failed Primary data volumes are open.

When used with resizesrl, if a Bunker is present in the configuration, only the SRL on Primary will be resized and the SRL on Bunker will not be resized. This will pause the replication to Bunker due to configuration error but protect the Primary SRL from overflow.

-full

Performs full synchronization of volumes on local and remote hosts. This option works only with the syncrvg and syncvol commands.

-g diskgroup

Specifies the disk group for the operation, either by disk group ID or by disk group name. By default, the disk group is chosen based on the RDS rvg (if any).

-k cache

When used with the verifydata keyword, ensures that the cache objects are preserved after data verification has completed successfully.

This option cannot be used with the cachesize option.

-k snap

When used with the verifydata keyword, ensures that both the cache objects and the snapshots that are configured on them are preserved after data verification has completed successfully.

This option cannot be used with the cachesize option.

-l

When used with the printrvg command, this option displays RDS information in long format. In the long format, additional information such as data volume count, SRL name, and RLINK-related information are displayed for each RVG in the RDS. This option also displays any configuration errors in the RDS.

When used with the repstatus command, this option displays additional replication information such as Primary and Secondary RLINK names, replication mode configured, and settings for latency and SRL protection for each Secondary RVG in the RDS.

-N

Allows takeover without failback logging. This option can be used only with the takeover command.

-nodcm

Skip adding DCMs to data volumes. This option can be used with the addsec, addvol, and createpri commands.

-s

Works without prompting the user for confirmation. Specify this option to include the addvol, migrate, stoprep, [-verify] syncrvg and [-verify] syncvol commands in non-interactive shell scripts.

-sdg diskgroup

Specifies the disk group name on the Secondary host for the addsec operation.

-verify

Verifies and reports percentage differences between volumes on local and remote hosts. The volumes are not synchronized. This option works only with syncrvg and syncvol.

-wait

Blocks until synchronization is complete. This option can only be used with the fbsync and resync keywords.

FILES

/etc/vx/vras/.rdg

File containing disk group IDs for authentication in addsec and syncvol.

/etc/vx/vvr/ibc_scripts

Directory containing scripts used in ibc command.

/var/vx/vras/log

Directory containing log files for vradmind server.

EXIT CODES

The vradmin utility exits with a status of 1 if the attempted operation fails. This exit code is the same for all problems.

SEE ALSO

vxassist(1M), vxedit(1M), vxibc(1M), vxintro(1M), vxmake(1M), vxprint(1M), vxresize(1M), vxrlink(1M), vxrvg(1M), vxvol(1M), vxvset(1M) vxsvmdiag(1M)

Veritas Volume Replicator Administrator's Guide