Data Domain: How to Break and Resync Directory Replication

Summary: How to perform a replication resynchronization (resync) procedure on a system configured for directory replication.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Break and Resync Replication.

 

PURPOSE

This article lists steps on how to perform a replication resynchronization (resync) procedure on a system configured for directory or pool replication. For a more in-depth explanation of the purpose of a resync procedure, see Data Domain: Replication Resync Explanation.

Here is a list of some reasons why a break and resync procedure must be performed:
 
APPLIES TO
  • All Data Domain models configured for Directory or Pool Replication
  • All Software Releases
 

SOLUTION

The steps listed in this solution assume a basic replication configuration where a source Data Domain is configured to write to a destination Data Domain. Replication configurations can be more complex consisting of bi-directional replication and chained configurations involving multiple systems.

If a context is broken, the partner system must also have the related context broken.

The break and resynchronization procedure requires that the file system to be temporarily unavailable for all systems involved.

Note: Do not disable any unrelated replication contexts as they recover automatically when the file system is re-enabled.
 
 

This procedure can be performed using the Enterprise Manager UI (Option 1) or the command-line (Option 2).

The EM process is simpler, and can be completed with a few clicks.

 

Option 1: Break the existing replication and resync using the Enterprise Manager:

a. Break existing replication:

This removes the context from both the source and destination DDRs.

i. Go to the Enterprise Manager page for the source Data Domain, then choose "Replication"

ii. Select the context to break.

iii. Select "Delete Pair"

iv. Click "OK"

b. Resync the context:

This adds the context back to both the source and destination DDRs and start the resync process. The resync process can between several hours and several days, depending on the size of the system and current load factors.

i. From the same Replication tab in the Enterprise Manager, click "More", then choose "Start Resync".

ii. Select the Replication Type.

iii. Select the source and destination host names.

iv. Path out the replicated directory or mtree on both the source and destination DDRs

v. Click "OK"

-- Or --

Option 2. Command-line manual break and resync option:

a. Copy and save the existing replication configuration information from the source and destination systems.

At the command prompt on both the source and destination type:

# replication show config

CTX   Source                                                   Destination                                            Connection Host and Port                 Enabled
---   ------------------------------------------------------   ----------------------------------------------------   --------------------------------------   -------
1     dir://testdatadomain.company.com/backup/monthly          dir://test2datadomain.company.com/backup/monthlytest   testdatadomain.company.com   (default)   yes
2     dir://testdatadomain.company.com/backup/weekly           dir://test2datadomain.company.com/backup/weeklytest    testdatadomain.company.com   (default)   yes
---   ------------------------------------------------------   ----------------------------------------------------   --------------------------------------   -------

Copy both outputs temporarily to a text editor (such as notepad) and label each section appropriately. This information is needed when re-creating the replication contexts. Record the context numbers if targeting specific contexts.

b. Verify the status of both systems: It should show idle.

(Ensure that backups have been paused (or any other systems using the Data Domain) and cleaning is not running.)

# system show stats

07/15 15:04:40

INTERVAL: 5 secs
--------------------------------------------------------------
CPU  FS    FS   Net MB/s    Disk KiB/s      Disk NVRAM  Repl
busy ops/s proc in    out   read    write   busy KiB/s  KB/s
---- ----- ---- ----- ----- ------- ------- ---- ------ ------
  0%     0   0%     0     0       0       0   0%      0      0

The system should show as idle.

c. Verify the cleaning status of both systems. It should show finished:

# filesys clean status
Cleaning finished at 2012/04/10 06:01:30

Cleaning should indicate finished.

d. Disable the file system on the source system, if systems are running DDOS version 4.7 and below: This is an optional step for DDOS version 4.8 and above.

# filesys disable
 

e. Break the replication on the source system:

# replication break rctx://<context number>

Example:

# replication break rctx://2
 
Warning: Some situations (for example Data Domain - Replication Context is Disabled Due to Potential NVRAM Loss) may require all contexts to be broken.
 
 

All contexts can be broken with the following command:

# replication break context all
 

f. Disable the file system on the destination system, if systems are running DDOS version 4.7 and below: This is an optional step for DDOS version 4.8 and above.

# filesys disable
 

g. Break related contexts on the destination system.

If the destination system is the sole replication partner, follow the same procedure in the previous step (step 2).

If the destination system is configured with contexts involving other systems, break only the shared contexts using following command:

# replication break rctx://<context number>
 

h. Enable the file system on the source and destination systems.

At the command prompt on the source and destination systems type:

# filesys enable
 

i. Re-create replication contexts on the source and destination systems. Use the previously saved configuration information to rebuild the deleted replication contexts:

# replication add source dir://<source directory> destination dir://<destination directory>

 

Tip: Copy the command from the source clipboard and paste it in the destination clipboard as same command is used on both source and destination systems.

j. Resynchronize the replication contexts from only source system using following command:

 # replication resync rctx://<context number>
 
Caution: This command is run on the source system only.
 

k. Confirm that replication resynchronization is working.

 

Here is a list of commands that show the status of the replication resynchronization:

# replication watch rctx://<context number>
# replication show performance [all | rctx://<context number>]
# iostat 2 (CTRL+C to quit)
Note: The iostat command displays a wider system view. The display window may require maximizing to prevent the text from wrapping and distorting the output.
 

If the source directory is empty, the resynchronization occurs quickly, and may not be represented in the output. In addition, if no data is being written to the source, directory throughput numbers will be low (or non-existent).

Note: From DDOS version 5.1, Pool replication is not available, it changed to Mtree Replication.
 

If problems persist after performing the steps in this article, Create a service request and Upload a Support Bundle (SUB) Data Domain: How to collect and upload a support bundle (SUB) from a Data Domain Restorer (DDR)

     

    REFERENCES

     

     

     

    Additional Information

     

      Affected Products

      Data Domain

      Products

      Data Domain
      Article Properties
      Article Number: 000012071
      Article Type: How To
      Last Modified: 29 May 2025
      Version:  11
      Find answers to your questions from other Dell users
      Support Services
      Check if your device is covered by Support Services.