Performing RLINK Operations using the vxrlink command


Performing RLINK Operations using the vxrlink command
Prev	Administering the RDS using the vxrds command	Next

RLINK objects are associated with RVGs. Each RLINK on a Primary RVG represents the communication link from the Primary RVG to a corresponding Secondary RVG. An RLINK on a Secondary RVG represents the communication link from the Secondary RVG to the corresponding Primary RVG.

An RLINK reads data from the Replicator Log volume and sends it to the Secondary. All the RLINKs in an RVG share the Replicator Log volume, and each RLINK reads data at its own rate. An update is removed from the Replicator Log volume when all the RLINKs have successfully sent the update to the Secondary.

The vxrlink command along with its keywords and options can be used to perform the Volume Replicator operations on the RLINKS.

The following table lists the keywords that are available with the vxrlink command and their respective descriptions.

Table: Keywords available for vxrlink command

Keyword	Description
assoc	Associates an RLINK to an RVG. See Associating a Secondary.
att	Attaches an RLINK to an RVG. See Attaching a Secondary.
cplist	Displays the list of currently available Secondary checkpoints. See Displaying the list of Secondary checkpoints.
checkdelete	Deletes the specified Secondary checkpoint. See Deleting the Secondary checkpoint.
det	Detaches an RLINK from an RVG. See Detaching an RLINK.
dis	Disassociates an RLINK from an RVG. See Dissociating an RLINK.
make	Creates an RLINK. See Creating new RLINK.
pause	Pauses an RLINK. See Pausing the RLINK.
recover	Recovers an RLINK. See Recovering the RLINK.
restore	Restores an RLINK. See Restoring the RLINK.
resume	Resumes an earlier paused RLINK. See Resuming the RLINK.
rm	Deletes an RLINK with the given name. See Removing the RLINK.
set	Sets the attributes of the specified RLINK. See Setting the RLINK attributes.
stats	Displays the network statistics for the specified Secondary. See Displaying the network statistics for the RLINK.
status	Displays the replication status for a specific Secondary. See Displaying the RLINK status.
updates	Displays the ID of the latest update the Secondary received and the number of updates by which the Primary is ahead. See Identifying the most up-to-date Secondary.
verify	Verifies the specified RLINK or all the RLINKs in the RVG for configuration errors. See Verifying the RLINK.
startstats	Verifies the bandwidth usage by RLINKs in an RDS by starting the historic bandwidth data collection in the form of a graph file. See
stopstats	Verifies the bandwidth usage by RLINKs in an RDS by stopping the historic bandwidth data collection in the form a graph file. See

The following table lists the options that are available with the vxrlink command.

Table: Options available for the vxrlink command

Option

Description

-a

Automatically attaches and synchronizes the Secondary data volumes. Optionally used with the att command on the Primary.

Note:

The autosync operation proceeds only if all the data volumes in an RDS or Primary have DCM logs and if the RLINK is able to connect to the Secondary.

-c <checkpoint>

Attaches an RLINK which is consistent up to the point indicated by the checkpoint string. The -c option can be used with the:

vxrlink restore command to indicate from where to start the restore operation.
vxrlink checkdelete command to specify the checkpoint that needs to be deleted.
vxrlink pause command to mark a point at which a backup of the Secondary has been taken.
vxrlink att command to indicate the point from were to start the synchronization when attaching the RLINK.

-f

Forces the attach of an RLINK to an RVG to succeed, even though the -a or -c <checkpoint> option was not specified.

Note:

This -f option can cause data corruption because the Secondary may miss the writes that may have been present on the Replicator Log but did not reach the Secondary. Because there is no way of knowing whether the Replicator Log had some pending writes that have not yet been sent to the Secondary, use this option only if you know that the Secondary is completely up-to-date.

-g <diskgroup>

Specifies the local disk group for the operation.

-i <interval>

Displays the network statistics or replication status at the specified intervals in seconds specified by this option.

-r <rvg>

Specifies the name of the RVG with which the RLINK is associated. If the RVG name is not specified, the RLINK is examined to retrieve the name of the associated RVG.

-t <timestamp>

This option specifies the number of lines in the output after which the timestamp is displayed.

-T

Displays the actual difference in time by which the Secondary is behind.

-w

Forces a Secondary RLINK into the FAIL state. Used only in special circumstances such as the Secondary online backup. The RLINK status is displayed as inconsistent.

Prev	Up	Next
Taking over the Primary role using the vxrds takeover command	Home	Associating a Secondary