Veritas InfoScale™ 7.0 Replication Administrator's Guide - Linux

Last Published:
Product(s): InfoScale & Storage Foundation (7.0)
Platform: Linux
  1. Introducing Veritas Replicator Option
    1.  
      About Veritas Replicator Option
    2.  
      What is VFR?
    3.  
      Features of VFR
    4.  
      What is VVR?
    5.  
      Features of VVR
  2. Section I. Getting started with File Replicator
    1. Introducing File Replicator
      1.  
        About File Replicator
      2.  
        How File Replicator works
      3.  
        File Replicator system requirements
      4.  
        File Replicator limitations
    2. Administering File Replicator
      1.  
        About File Replicator administration
      2.  
        Starting the vxfstaskd and vxfsrepld file replication daemons
      3.  
        Protecting a target file system
      4.  
        Creating a file replication job
      5.  
        Creating a consistency group
      6.  
        Managing a file replication job
      7. Displaying file replication job information
        1.  
          Displaying file replication jobs
        2.  
          Displaying the status of a file replication job
        3.  
          Displaying file replication job statistics
        4.  
          Displaying a file replication Storage Checkpoint
        5.  
          Displaying consistency groups
      8.  
        Modifying a file replication job
      9.  
        Modifying a consistency group
      10.  
        Deleting a file replication job
      11.  
        Deleting a consistency group
      12.  
        About File Replicator log files
      13. About error recovery after a site disaster or network disruption using VFR
        1.  
          Performing a VFR switchover
        2.  
          Performing a VFR failover after a disaster
        3.  
          Recovering a failed site if the failed source node comes up again
        4.  
          Recovering a failed site if a new node is assigned as the target
  3. Section II. Getting started with Volume Replicator
    1. Introducing Volume Replicator
      1.  
        How VVR processes application writes
      2.  
        Components of VVR
      3.  
        Replicated Volume Group (RVG)
      4.  
        Storage Replicator Log (SRL)
      5.  
        Replication Link (RLINK)
      6.  
        Data Change Map (DCM)
      7.  
        Replicated Data Set (RDS)
      8.  
        VVR Replication terms defined
      9.  
        Write-order fidelity
      10.  
        Consistent data versus current or up-to-date data
      11.  
        IPv4-only node
      12.  
        IPv6-only node
      13.  
        Dual-node / Dual-stack
      14.  
        IPv6-enabled node
      15.  
        How the VVR components fit together
      16.  
        VVR at the Primary
      17.  
        VVR at the Secondary
      18.  
        Local host (localhost)
      19.  
        About modes of VVR replication
      20.  
        Introducing the VCS agents for VVR
    2. Understanding how Volume Replicator works
      1.  
        About Volume Replicator concepts
      2.  
        How data flows in VVR asynchronous mode
      3.  
        About secondary logging enabled asynchronous mode
      4.  
        About bulk transfer with secondary logging
      5.  
        How data flows in VVR asynchronous mode with secondary logging
      6.  
        How data flows in VVR synchronous mode
      7.  
        How data flows in an RDS containing multiple Secondary hosts
      8. Replication in a shared disk group environment
        1.  
          The role of the logowner
        2.  
          How VVR processes a write in a shared disk group
        3.  
          How VVR processes a read in a shared disk group
      9.  
        Understanding how VVR logs writes to the SRL
      10.  
        Understanding Storage Checkpoints
      11.  
        Volume sets in VVR
      12.  
        Changing membership of an RVG and a volume set
      13. Using SmartTier with VVR
        1.  
          Best practices for using SmartTier with VVR
      14.  
        Cross-platform Data Sharing in VVR
      15. Understanding the VVR snapshot feature
        1.  
          About snapshots of RVGs containing volume sets
        2.  
          About the traditional snapshot feature
        3. About the instant snapshot feature
          1.  
            About instant full snapshots
          2.  
            About Instant space-optimized snapshots
          3.  
            About Instant plex-breakoff snapshots
        4.  
          How VVR creates instant space-optimized snapshots
        5.  
          Comparing VVR snapshot methods based on different features
      16. About VVR compression
        1.  
          General functionality considerations for VVR compression
    3. Planning and configuring replication
      1.  
        Introduction to planning and configuring replication
      2. Data flow in VVR
        1.  
          About replication in synchronous mode
        2.  
          Data flow when reading back from the SRL
      3. Before you begin configuring
        1.  
          Understanding business needs
        2.  
          Understanding application characteristics
      4. Choosing the mode of volume replication
        1.  
          Asynchronous mode replication considerations
        2. Synchronous mode replication considerations
          1.  
            Synchronous mode considerations when the synchronous attribute is set to fail
        3.  
          Asynchronous volume replication versus synchronous volume replication
      5.  
        Choosing latency and SRL protection
      6. Planning the network
        1. Choosing the network bandwidth
          1.  
            Bandwidth of the available network connection
          2.  
            How network performance depends on the mode of replication
        2.  
          Choosing the network protocol
        3.  
          Choosing the network ports used by VVR
        4.  
          Configuring VVR in a firewall environment
        5.  
          Choosing the packet size
        6.  
          Choosing the network maximum transmission unit
      7. Sizing the SRL
        1.  
          Peak usage constraint for sizing the SRL
        2.  
          Synchronization period constraint for sizing the SRL
        3.  
          Secondary backup constraint for sizing the SRL
        4.  
          Secondary downtime constraint for sizing the SRL
        5.  
          Additional factors for sizing the SRL
        6.  
          Example - Calculating SRL size for a VVR configuration
      8.  
        How the agents for hybrid applications work
      9.  
        Overview of how to configure VVR in a VCS environment
      10.  
        Overview of how to configure the primary-elect feature in a VCS globally clustered environment
      11.  
        Generic VVR setup in a VCS environment
      12.  
        Example VVR configuration in a VCS environment
    4. Understanding replication settings for a Secondary
      1.  
        About replication settings for a Secondary
      2. Modes of VVR replication
        1.  
          About asynchronous volume replication
        2.  
          About synchronous volume replication
        3.  
          About the synchronous attribute
      3. Protecting against SRL overflow
        1.  
          About the srlprot attribute
        2.  
          VVR in a Flexible Storage Sharing environment
      4. Setting up latency protection
        1. About the latencyprot attribute
          1.  
            About Latency protection when Primary and Secondary are connected
          2.  
            About Latency protection when Primary and Secondary are disconnected
      5.  
        Controlling the network bandwidth used for replication
      6. Choosing the VVR compression mode
        1.  
          Enabling compression
        2.  
          Disabling compression
    5. Configuring the agents for high availability
      1. Requirements for configuring VVR in a VCS environment
        1.  
          Best practices for setting up VVR agents
      2.  
        Example RVG configuration for a failover application
      3.  
        Example RVG configuration for a parallel application
      4. Example setting up VVR in a VCS environment
        1.  
          Setting up the VVR configuration
        2.  
          Verifying the VVR replication state
        3. Configuring the VVR agents for failover applications
          1.  
            Configuring the agents when VCS is running
          2.  
            Configuring the agents when VCS is stopped
        4.  
          Configuring the VVR agents for parallel applications
      5. Configuring the agents for a bunker replication configuration
        1. VCS configuration for a bunker using the STORAGE protocol
          1. Sample configuration file for VCS agents in a bunker replication environment
            1.  
              Sample configuration file (failover application)
        2.  
          VCS configuration for a bunker using IP
        3. How the RVGPrimary works in a bunker setup
          1.  
            About bunker SRL overflow
          2.  
            About global clustering with bunker replay
      6. About choosing the Primary site after a site disaster or network disruption
        1.  
          Application availability in the case of a network disruption using the primary-elect feature
        2.  
          Configuring VCS global clustering so you can choose the Primary site
        3. Choosing the Primary site after a site disaster or network disruption
          1.  
            Example - Choosing the original Primary as the Primary going forward
          2.  
            Example - Choosing the original Secondary as the Primary going forward
        4. Troubleshooting the primary-elect feature
          1.  
            Troubleshooting failures in the RVGPrimary online agent function
          2.  
            Troubleshooting failures in VVR ElectPrimary command
      7.  
        Administering VCS service groups
  4. Section III. Analyzing your environment with Volume Replicator Advisor
    1. Introducing Volume Replicator Advisor (VRAdvisor)
      1.  
        Audience
      2.  
        Related Veritas InfoScale documents
      3.  
        Overview of VRAdvisor
      4. How VRAdvisor works
        1.  
          Data collection
        2.  
          Data analysis
        3.  
          What-if analysis
    2. Collecting the sample of data
      1. About collecting the sample of data
        1.  
          Best practices for collecting the sample of data
      2. Collecting the sample of data on UNIX
        1.  
          Prerequisite for collecting the sample of data
        2.  
          Supported locales
        3. Collecting data using the VRAdvisor wizard
          1.  
            Specifying the data to be collected
        4.  
          Collecting data using the vxstat command
        5. Collecting data using the data collection script
          1.  
            Files for the collected data
        6. Examples of collecting data with the data collection script
          1.  
            Example 1
          2.  
            Example 2
          3.  
            Example 3
          4.  
            Example 4
          5.  
            Example 5
      3. Collecting the sample of data on Windows
        1.  
          Prerequisite for collecting the sample of data
        2.  
          Collecting the sample of data using the VRAdvisor wizard
        3.  
          Collecting the sample of data using the diskStats command
    3. Analyzing the sample of data
      1. About analyzing the sample of data
        1.  
          Prerequisites for analyzing the sample of data
      2.  
        Launching the VRAdvisor wizard
      3. Analyzing the collected data
        1. Specifying the data for analysis
          1.  
            Specifying the location of the data files
          2.  
            Selecting the data files to be analyzed
          3.  
            Specifying block size and collection interval for the data files
          4.  
            Selecting volumes or disks for analysis
        2. Specifying the parameters for analysis
          1.  
            Specifying the network parameters for analysis
          2.  
            Specify the RVG-specific parameters
          3.  
            Summary of inputs
      4. Understanding the results of the analysis
        1. Viewing the analysis results
          1.  
            Analysis graph
          2.  
            Analysis results
        2. Recalculating the analysis results
          1.  
            Applying different parameters to the existing sample of data
          2.  
            Performing What-if analysis
          3.  
            Calculating the SRL Size for a specified Network Bandwidth and Outage
          4.  
            Calculating the Network Bandwidth for data loss specified in bytes
          5.  
            Calculating the Network Bandwidth for data loss specified in time duration
          6.  
            Calculating the Network Bandwidth for Bunker and RTO
          7.  
            Changing the value ranges on the slider bar
        3.  
          Recording and viewing the results
    4. Installing Volume Replicator Advisor (VRAdvisor)
      1.  
        VRAdvisor System requirements
      2. Installing VRAdvisor on Solaris
        1.  
          Uninstalling VRAdvisor on Solaris
      3. Installing VRAdvisor on Windows
        1.  
          Uninstalling VRAdvisor on Windows
  5. Section IV. Setting up and administering VVR
    1. Setting up replication
      1.  
        About configuring VVR replication
      2.  
        Best practices for setting up replication
      3. Creating a Replicated Data Set
        1. Creating a Primary RVG of an RDS
          1.  
            Prerequisites for creating a Primary RVG of an RDS
          2.  
            Example - Creating a Primary RVG containing a data volume
          3.  
            Example - Creating a Primary RVG containing a volume set
        2. Adding a Secondary to an RDS
          1.  
            Best practices for adding a Secondary to an RDS
          2.  
            Prerequisites for adding a Secondary to an RDS
        3. Changing the replication settings for a Secondary
          1. Setting the mode of replication for a Secondary
            1.  
              Example - Setting the mode of replication to asynchronous for an RDS
            2.  
              Example - Setting the mode of replication to synchronous for an RDS
          2.  
            Setting the latency protection for a Secondary
          3.  
            Setting the SRL overflow protection for a Secondary
          4.  
            Setting the network transport protocol for a Secondary
          5. Setting the packet size for a Secondary
            1.  
              Example - Setting the packet size between the Primary and Secondary
          6. Setting the bandwidth limit for a Secondary
            1.  
              Example: Limiting network bandwidth between the Primary and the Secondary
            2.  
              Example: Disabling Bandwidth Throttling between the Primary and the Secondary
            3.  
              Example: Limiting network bandwidth used by VVR when using full synchronization
      4. Synchronizing the Secondary and starting replication
        1. Methods to synchronize the Secondary
          1.  
            Using the network to synchronize the Secondary
          2.  
            Using block-level tape backup to synchronize the Secondary
          3.  
            Moving disks physically to synchronize the Secondary
        2. Using the automatic synchronization feature
          1.  
            Notes on using automatic synchronization
        3.  
          Example for setting up replication using automatic synchronization
        4.  
          About SmartMove for VVR
        5.  
          About thin storage reclamation and VVR
        6.  
          Determining if a thin reclamation array needs reclamation
      5. Starting replication when the data volumes are zero initialized
        1.  
          Example: Starting replication when the data volumes are zero initialized
    2. Displaying configuration information
      1. Displaying RVG and RDS information
        1.  
          Displaying RDS information
        2.  
          Displaying individual RVG information
        3.  
          Interpreting RVG flag settings
      2. Displaying information about data volumes and volume sets
        1.  
          Displaying data volumes in a Replicated Data Set
        2.  
          Displaying a list of data volumes
        3.  
          Displaying information about all failed data volumes
        4.  
          Displaying an individual data volume
        5.  
          Displaying a volume set
      3. Displaying information about Secondaries
        1.  
          Displaying consolidated replication status
        2.  
          Displaying a list of RLINKs
        3. Displaying a specific RLINK
          1.  
            Interpreting RLINK flag settings
        4.  
          Displaying the status of a Secondary
      4.  
        Displaying a list of Storage Checkpoints
      5. Displaying statistics with the vrstat display commands
        1.  
          Displaying the consolidated statistics
        2.  
          Displaying the RLINK information for all the hosts in the RDS
        3.  
          Displaying information about all the data volumes for all the hosts in the RDS
        4.  
          Displaying information about the SRL volumes for all the hosts in the RDS
        5.  
          Displaying information about the memory tunable parameters for all the hosts in the RDS
        6.  
          Determining VVR network bandwidth usage and compression ratio
      6. Collecting consolidated statistics of the VVR components
        1. Understanding how VVR stores the statistics
          1.  
            About the VVR statistics Messages heading
          2.  
            About the VVR statistics Errors heading
          3.  
            About the VVR statistics Flow control heading
      7. Displaying network performance data
        1.  
          Displaying extended replication statistics
        2. Identifying the most up-to-date Secondary
          1.  
            Example - to determine the most up-to-date Secondary
          2.  
            Example - to determine the status of the Secondary
      8.  
        VVR event notification
    3. Administering Volume Replicator
      1. Administering data volumes
        1. Associating a volume to a Replicated Data Set
          1.  
            Example - Associating an existing volume to an RDS
          2. Verifying the data on the Primary and Secondary volumes
            1.  
              Example - Verifying the differences between remote volumes on a host
          3. Synchronizing volumes on the local host and remote hosts
            1.  
              Synchronizing volumes using full synchronization
            2.  
              Example - Full synchronization of volumes on local and remote hosts
            3.  
              Synchronizing volumes using difference-based synchronization
        2. Associating a volume set to an RDS
          1.  
            Example:
          2.  
            Example
        3. Associating a Data Change Map to a data volume
          1.  
            Determining the region size
        4. Resizing a data volume in a Replicated Data Set
          1.  
            Important notes on resizing a data volume in a Replicated Data Set
          2.  
            Prerequisites for resizing a data volume in an RDS
        5.  
          Renaming a data volume in a Replicated Data Set
        6.  
          Dissociating a data volume from its Replicated Data Set
      2. Administering the SRL
        1.  
          Protecting from SRL overflow
        2. Incrementally synchronizing the Secondary after SRL overflow
          1.  
            SRL overflow protection with DCM - flags and definitions
          2.  
            Prerequisite for incrementally synchronizing the Secondary
          3.  
            Breaking off mirrors before incremental synchronization
          4.  
            Example - Resynchronizing the Secondary using break off mirrors
          5.  
            Example - Recreating volumes if a disaster occurs during resynchronization
          6.  
            Notes on using incremental synchronization on SRL overflow
        3.  
          Changing the size of the SRL on the Primary and the Secondary
      3. Administering replication
        1.  
          Changing the replication settings
        2.  
          Pausing and resuming replication to a Secondary
        3.  
          Stopping replication to a Secondary
        4. Changing the IP addresses used for replication
          1.  
            Prerequisites for changing the IP addresses used for replication
          2.  
            Example for changing IP addresses to a different IPv4 network
          3.  
            Example for changing IP addresses to a different IPv6 network
        5. Changing the network ports used for replication
          1.  
            Port numbers used by VVR
          2. Displaying and changing the ports used by VVR
            1.  
              Displaying the port used for heartbeats
            2.  
              Example - Changing the replication heartbeat port
            3.  
              Displaying the port used by vradmind
            4.  
              Displaying the port used by in.vxrsyncd
            5.  
              Displaying the ports used to replicate data using UDP
            6.  
              Displaying the ports used to replicate data using TCP
      4. Administering the Replicated Data Set
        1.  
          Removing a Secondary RVG from a Replicated Data Set
        2. Removing a Primary RVG from a Replicated Data Set
          1.  
            Prerequisite for deleting a Primary RVG from a Replicated Data Set
          2.  
            Example - Removing a Primary RVG from an RDS when the application is inactive
          3.  
            Example - Removing a Primary RVG from an RDS when the application is active
      5. Administering Storage Checkpoints
        1.  
          Creating Storage Checkpoints
        2.  
          Ending Storage Checkpoints
        3.  
          Viewing Storage Checkpoints
        4.  
          Deleting Storage Checkpoints
      6. Creating RVG snapshots
        1. Using the instant snapshot feature
          1.  
            Snapshot naming conventions
        2. About instant full snapshots
          1.  
            Prerequisites for creating instant full snapshots
          2.  
            Creating snapshot volumes for data volumes in an RVG
          3. Preparing the volumes prior to using the instant snapshot feature
            1.  
              Upgrading the disk group for an instant snapshot
            2.  
              Preparing volumes for an instant snapshot
          4.  
            Freezing or pausing replication prior to taking a snapshot
          5. Creating instant full snapshots
            1.  
              Example - Specifying a prefix for snapshots of each data volume in an RVG
            2.  
              Example - Creating an instant full snpashot for an RVG
          6.  
            Unfreezing or resuming replication after taking a snapshot
        3. About instant space-optimized snapshots
          1.  
            Preparing the RVG volumes for snapshot operation
          2.  
            Creating the cache object for instant space-optimized snapshots
          3.  
            Freezing or pausing replication prior to creating an instant space-optimized snapshot
          4. Creating instant space-optimized snapshots
            1.  
              Example: Creating instant space-optimized snapshots
          5.  
            Unfreezing or resuming replication after taking an instant space-optimized snapshot
        4. About instant plex-breakoff snapshots
          1.  
            Preparing the RVG volumes for snapshot operation
          2.  
            Creating snapshot plexes for data volumes in an RVG
          3.  
            Freezing or pausing replication prior to creating a plex-breakoff snapshot
          4. Creating instant plex-breakoff snapshots
            1.  
              Prerequisites for creating instant plex-breakoff snapshots
            2.  
              Example - Creating an instant plex-breakoff snapshot
          5.  
            Unfreezing or resuming replication after taking a plex-breakoff snapshot
        5. Administering snapshots
          1.  
            Refreshing snapshots
          2.  
            Reattaching the snapshot plexes to the data volumes (snapback)
          3. Restoring data from the snapshots
            1.  
              Rules for restoring volumes
          4.  
            Displaying the snapshot information
          5.  
            Destroying the snapshots
        6. Using the traditional snapshot feature
          1.  
            Creating snapshot plexes for data volumes in an RVG
          2.  
            Freezing or pausing replication
          3.  
            Taking a snapshot
          4.  
            Unfreezing or resuming replication
          5.  
            Performing the required operations on the snapshot
          6.  
            Reattaching the snapshot plexes to the data volumes (Snapback)
          7. Using snapback with resyncfromreplica option
            1.  
              Using resyncfromreplica option to recover from logical corruption of data
            2.  
              Using resyncfromreplica to recover failed Secondary data volumes
        7. Using Veritas Volume Manager FastResync
          1.  
            Enabling FastResync
      7. Verifying the DR readiness of a VVR setup
        1.  
          Performing a failover
        2. Performing a fire drill
          1.  
            Automating the fire drill procedure
        3. Verifying the data on the Secondary
          1.  
            Performing online data verification
          2. Performing offline data verification
            1.  
              Prerequisites for using the vradmin -verify syncrvg command
      8. Backing up the Secondary
        1.  
          Restoring the Secondary RLINK from a Secondary Storage Checkpoint
        2. Restoring the Secondary from online backup
          1.  
            Restoring from Secondary Storage Checkpoints
          2.  
            Restoring a Secondary RLINK
    4. Using VVR for off-host processing
      1.  
        About using VVR for off-host processing
      2.  
        What is off-host processing?
      3. In-Band Control Messaging overview
        1. How to use the data on the Secondary
          1.  
            Using snapshots of Secondary data volumes
      4.  
        In-BandControl Messaging explained
      5. Performing off-host processing tasks
        1.  
          Tasks to perform for off-host processing
        2. Using the IBC messaging command vradmin ibc
          1. Prerequisites for using vradmin ibc command
            1.  
              Example - Creating a snapshot on the Secondary using the vradmin ibc command
          2. Understanding the scripts used for the vradmin ibc command
            1.  
              Location of the scripts used for the vradmin ibc command
          3.  
            Sample vradmin ibc command scripts
      6. Examples of off-host processing
        1.  
          Example - Decision support using the snapshot feature and the vradmin ibc command
        2.  
          Example - Backing up using the snapshot feature and the vradmin ibc command
        3.  
          Example - Performing block-level backup of the Secondary data using the vradmin ibc command
    5. Transferring the Primary role
      1.  
        About transferring the Primary role
      2. Migrating the Primary
        1.  
          Prerequisites for migrating the Primary
        2.  
          Important notes for migrating the Primary role
        3.  
          Example - Migrating from a healthy Primary
        4.  
          Example - Migrating the Primary role in a setup with multiple Secondaries
      3. About taking over from an original Primary
        1. Important notes about taking over from an original Primary
          1. About fast failback
            1.  
              Taking over from an original Primary
        2.  
          Example -Taking over from an original Primary
        3.  
          Example - Taking over from an original Primary in a setup with multiple Secondaries
      4. Failing back to the original Primary
        1.  
          Fast failback versus difference-based synchronization
        2. Failing back using fast failback synchronization
          1.  
            Example - Failing back to the original Primary using fast failback
          2.  
            Example - Failing back to the original Primary using fast failback in a multiple Secondaries setup
        3. Failing back using difference-based synchronization
          1.  
            Converting an original Primary to a Secondary
          2.  
            Example - Failing back to the original Primary using difference-based synchronization
          3.  
            Example - Failing back to the original Primary using difference-based synchronization in a multiple Secondaries setup
      5.  
        About choosing the Primary site after a site disaster or network disruption
      6.  
        Application availability in the case of a network disruption
      7.  
        Configuring VCS global clustering so you can choose the Primary site
      8. Choosing the Primary site after a site disaster or network disruption
        1.  
          Example - Choosing the original Primary as the Primary going forward
        2.  
          Example - Choosing the original Secondary as the Primary going forward
      9. Troubleshooting the primary-elect feature
        1.  
          Troubleshooting failures in the RVGPrimary online agent function
        2.  
          Troubleshooting failures in VVR ElectPrimary command
      10.  
        Primary-elect configuration limitations
    6. Replication using a bunker site
      1. Introduction to replication using a bunker site
        1.  
          About replication using a bunker site during normal operations
        2.  
          How the bunker site is used for disaster recovery
        3.  
          Best practices for setting up replication using a bunker site
      2.  
        Sample bunker configuration
      3. Setting up replication using a bunker site
        1.  
          Requirements for replication using a bunker site
        2.  
          Best practices for setting up replication using a bunker site
        3.  
          Adding a bunker to an RDS
        4.  
          Changing replication settings for the bunker Secondary
        5.  
          Starting replication to the bunker
        6.  
          Reinitializing the bunker
      4.  
        Administering replication using a bunker site
      5. Using a bunker for disaster recovery
        1. Updating the Secondary from the bunker
          1.  
            Updating the Secondary from the bunker automatically
          2.  
            Updating the Secondary from the bunker manually
        2. Restoring the original Primary in a bunker setup
          1.  
            Recovering the original Primary during bunker replay
          2.  
            Failing back to the original Primary
          3.  
            Restoring the bunker setup after failback to original Primary
      6. Replication using a bunker site in a VCS environment
        1. Automating local cluster failover for a bunker
          1.  
            Using the StorageHostIds attribute
        2.  
          About bunker replay in a VCS environment
      7.  
        Removing a bunker
      8.  
        About bunker commands
    7. Troubleshooting VVR
      1.  
        Recovery from RLINK connect problems
      2. Recovery from configuration errors
        1. Errors during an RLINK attach
          1.  
            Data volume errors during an RLINK attach
          2.  
            Volume set errors during an RLINK attach
        2. Errors during modification of an RVG
          1.  
            Missing data volume error during modifcation of an RVG
          2.  
            Data volume mismatch error during modification of an RVG
          3.  
            Data volume name mismatch error during modification of an RVG
          4. Volume set configuration errors during modification of an RVG
            1.  
              Volume set name mismatch error
            2.  
              Volume index mismatch error
            3.  
              Component volume mismatch error
      3. Recovery on the Primary or Secondary
        1.  
          About recovery from a Primary-host crash
        2. Recovering from Primary data volume error
          1.  
            Example - Recovery with detached RLINKs
          2.  
            Example - Recovery with minimal repair
          3.  
            Example - Recovery by migrating the primary
          4.  
            Example - Recovery from temporary I/O error
        3. Primary SRL volume error cleanup and restart
          1.  
            About RVG PASSTHRU mode
        4.  
          Primary SRL volume error at reboot
        5.  
          Primary SRL volume overflow recovery
        6. Primary SRL header error cleanup and recovery
          1.  
            Recovering from SRL header error
        7. Secondary data volume error cleanup and recovery
          1.  
            Recovery using a Secondary Storage Checkpoint
          2.  
            Cleanup using a Primary Storage Checkpoint
        8.  
          Secondary SRL volume error cleanup and recovery
        9.  
          Secondary SRL header error cleanup and recovery
        10.  
          Secondary SRL header error at reboot
    8. Tuning replication performance
      1.  
        Overview of replication tuning
      2. SRL layout
        1.  
          How SRL affects performance
        2.  
          Striping the SRL
        3.  
          Choosing disks for the SRL
        4.  
          Mirroring the SRL
      3. Tuning Volume Replicator
        1. VVR buffer space
          1.  
            Write buffer space on the Primary
          2.  
            Readback buffer space on the Primary
          3.  
            Buffer space on the Secondary
          4.  
            Tunable parameters for the VVR buffer spaces
          5.  
            Tunable parameters for the write buffer space on the Primary in a private disk group
          6.  
            Tunable parameter for the readback buffer space
          7.  
            Tunable parameters for the buffer space on the Primary in a shared disk group
          8.  
            Tunable parameters for the buffer space on the Secondary
        2.  
          DCM replay block size
        3.  
          Heartbeat timeout
        4.  
          Memory chunk size
        5.  
          UDP replication tuning
        6.  
          Tuning the number of TCP connections
        7.  
          Message slots on the Secondary
        8.  
          VVR and network address translation firewall
        9. Tuning VVR compression
          1.  
            Tunable parameter for enabling compression
          2.  
            Tunable parameter for setting compression threads
          3.  
            Tuning considerations for VVR compression
    9. Appendix A. VVR command reference
      1.  
        VVR command reference
    10. Appendix B. Using the In-band Control Messaging utility vxibc and the IBC programming API
      1.  
        About the IBC messaging utility vxibc
      2.  
        In-band Control Messaging overview
      3. Using the IBC messaging command-line utility
        1.  
          Registering an application name
        2.  
          Displaying the registered application name for an RVG
        3.  
          Receiving an IBC message
        4.  
          Sending an IBC message
        5.  
          Unfreezing the Secondary RVG
        6.  
          Unregistering an application name
        7.  
          Receiving and processing an IBC message using a single command
        8.  
          Sending and processing an IBC message using a single command
      4. Examples - Off-host processing
        1.  
          Example 1 - Decision support using the traditional snapshot feature and the vxibc utility
        2.  
          Example 2 - Backing up using the snapshot feature and the vxibc utility
        3.  
          Example 3 - Trial failover using the snapshot feature
        4.  
          Example 4 - Decision support using the instant full snapshot feature and the vxibc utility
      5. In-band Control Messaging API
        1. IOCTL commands
          1.  
            RV_IBC_REGISTER
          2.  
            RV_IBC_SEND
          3.  
            RV_IBC_RECEIVE
          4.  
            RV_IBC_UNFREEZE
          5.  
            RV_IBC_UNREGISTER
          6.  
            RV_IBC_STATUS
        2.  
          Using the IBC API
    11. Appendix C. Volume Replicator object states
      1. Volume Replicator Kernel State
        1.  
          RVG KSTATEs
        2.  
          RLINK KSTATEs
      2. Volume Replicator utility states
        1.  
          RVG utility states
        2.  
          RLINK utility states
        3.  
          Inactive RLINKs
        4.  
          STALE RLINK state
        5.  
          FAIL RLINK state
        6.  
          Inconsistent RLINKs
        7.  
          Pausing, resuming, and restoring RLINK states
    12. Appendix D. VVR task reference
      1.  
        Mapping the name of a Secondary data volume to a differently named Primary data volume
      2.  
        Mapping disk groups
      3.  
        Decreasing the size of the SRL on the Primary
    13. Appendix E. Alternate methods for synchronizing the Secondary
      1. Using the full synchronization feature
        1.  
          Example - Synchronizing the Secondary using full synchronization with Storage Checkpoint
      2. Using block-level backup and Storage Checkpoint
        1.  
          Example - Synchronizing the Secondary using block-level backup
      3.  
        Using the Disk Group Split and Join feature
      4. Using difference-based synchronization
        1.  
          Example - synchronizing the Secondary based on differences
      5. Examples for setting up a simple Volume Replicator configuration
        1.  
          Creating a Replicated Data Set for the examples
        2.  
          Example for setting up replication using full synchronization
        3.  
          Example for setting up replication using block-level backup and checkpointing
        4.  
          Example for setting up replication using Disk Group Split and Join
        5.  
          Example for setting up replication using differences-based synchronization
        6.  
          Example for setting up replication when data volumes are initialized with zeroes
    14. Appendix F. Migrating VVR from Internet Protocol version 4 to Internet Protocol version 6
      1.  
        Overview of VVR migration from IPv4 to IPv6
      2. About migrating to IPv6 when VCS global clustering and VVR agents are not configured
        1.  
          Understanding the current IPv4 configuration when VCS global clustering and VVR agents are not configured
        2.  
          Migration prerequisites when VCS global clustering and VVR agents are not configured
        3. Migrating to IPv6 when VCS global clustering and VVR agents are not configured
          1.  
            Modifying the failover service group used for replication to IPv6
          2.  
            Migrating the VVR links from IPv4 to IPv6 when VCS global clustering and VVR agents are not configured
          3.  
            Removing the IPv4 resources from the VCS configuration when VCS global clustering and VVR agents are not configured
      3. About migrating to IPv6 when VCS global clustering and VVR agents are configured
        1.  
          Understanding the current IPv4 configuration when VCS global clustering and VVR agents are configured
        2.  
          Migration prerequisites when VCS global clustering and VVR agents are configured
        3.  
          Migrating to IPv6 when VCS global clustering and VVR agents are configured
        4.  
          Migrating the VCS global clustering service group to IPv6 when VCS global clustering and VVR agents are configured
        5.  
          Adding IP and NIC resources for IPv6 addresses in the RVG agent group when VCS global clustering and VVR agents are configured
        6.  
          Migrating VVR RLINKs from IPv4 to IPv6 when VCS global clustering and VVR agents are configured
        7.  
          Removing the IPv4 resources from the VCS configuration when VCS global clustering and VVR agents are configured
      4. About migrating to IPv6 when VCS global clustering and VVR agents are configured in the presence of a bunker
        1.  
          Understanding the current IPv4 configuration when VCS global clustering and VVR agents are configured in the presence of a bunker
        2.  
          Migration prerequisites when VCS global clustering and VVR agents are configured in the presence of a bunker
        3. Migrating to IPv6 when VCS global clustering and VVR agents are configured in the presence of a bunker
          1.  
            Migrating the VCS global clustering service group to IPv6 when VCS global clustering and VVR agents are configured in the presence of a bunker
          2.  
            Adding the IP and NIC resources for IPv6 addresses in the RVG agent group when VCS global clustering and VVR agents are configured in the presence of a bunker
          3.  
            Migrating VVR RLINKs from IPv4 to IPv6 when VCS global clustering and VVR agents are configured in the presence of a bunker
          4.  
            Removing the IPv4 resources from the VCS configuration when VCS global clustering and VVR agents are configured in the presence of a bunker
    15. Appendix G. Sample main.cf files
      1.  
        Globally clustered VCS and VVR main.cf

Managing a file replication job

You can manage a replication job from using the vfradmin job start, vfradmin job sync, vfradmin job stop, and vfradmin job abort commands. The commands are required only on the source system.

The vfradmin job start command starts replication immediately and initiates replication after every subsequent set frequency interval.

To start a replication job, type the following command:

# vfradmin job start job_name mntpt

where job_name is the name of the replication job you want to start and mntpt is the mount point on the source system.

At each frequency interval, a fresh file system Storage Checkpoint is taken and replication is started against the new Storage Checkpoint. If a previous replication run has not completed, a new Storage Checkpoint is not taken and the current run is skipped.

Note:

Running the vfradmin job start command on a previously aborted replication job will automatically restart the job.

The vfradmin job sync command lets you start a replication job, but then stops the replication job after one iteration (full or incremental) is complete. You can use this command to recover from the secondary site in the event that the primary file system is completely destroyed. This command can also be used if you want to run a replication job as a pre-defined time using a script or a cron job.

The vfradmin job stop command drops the replication job from the schedule and waits for any already running iterations to complete. This can take some time if the network is slow or if a large amount of data has changed since the last replication run. The -n option initiates the replication job stop without waiting for it to complete.

To stop a replication job, type the following command:

# vfradmin job stop [-n] job_name mntpt

where job_name is the name of the replication job you want to stop and mntpt is the mount point on the source system.

The vfradmin job abort command forcefully cancels a replication job even if it is in progress. Aborting a replication job may leave Storage Checkpoints mounted on the source system and the target file system may be left in an intermediate state.

To abort a replication job, type the following command:

# vfradmin job abort job_name mntpt

where job_name is the name of the replication job you want to abort and mntpt is the mount point on the source system.

The vfradmin job wait command will wait for the current iteration of a replication job to complete. This command can be used if a script requires the completion of the current replication cycle.