Troubleshooting Active Directory Replication Problems
Applies to: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows Server 2012 R2, Windows Server 2012
Active Directory replication problems can have several different sources. For example, Domain Name System (DNS) problems, networking issues, or security problems can all cause Active Directory replication to fail.
The rest of this topic explains tools and a general methodology to fix Active Directory replication errors. The following subtopics cover symptoms, causes, and how to resolve specific replication errors:
Introduction and resources for troubleshooting Active Directory replication
Inbound or outbound replication failure causes Active Directory objects that represent the replication topology, replication schedule, domain controllers, users, computers, passwords, security groups, group memberships, and Group Policy to be inconsistent between domain controllers. Directory inconsistency and replication failure cause either operational failures or inconsistent results, depending on the domain controller that is contacted for the operation, and can prevent the application of Group Policy and access control permissions. Active Directory Domain Services (AD DS) depends on network connectivity, name resolution, authentication and authorization, the directory database, the replication topology, and the replication engine. When the root cause of a replication problem is not immediately obvious, determining the cause among the many possible causes requires systematic elimination of probable causes.
For a UI-based tool to help monitor replication and diagnose errors, download and run the Microsoft Support and Recovery Assistant tool, or use the Active Directory Replication Status Tool if you only want to analyze the replication status.
For a comprehensive document that describes how you can use the Repadmin tool to troubleshoot Active Directory replication is available; see Monitoring and Troubleshooting Active Directory Replication Using Repadmin.
For information about how Active Directory replication works, see the following technical references:
- Active Directory Replication Model Technical Reference
- Active Director Replication Topology Technical Reference
Event and tool solution recommendations
Ideally, the red (Error) and yellow (Warning) events in the Directory Service event log suggest the specific constraint that is causing replication failure on the source or destination domain controller. If the event message suggests steps for a solution, try the steps that are described in the event. The Repadmin tool and other diagnostic tools also provide information that can help you resolve replication failures.
For detailed information about using Repadmin for troubleshooting replication problems, see Monitoring and Troubleshooting Active Directory Replication Using Repadmin.
Ruling out intentional disruptions or hardware failures
Sometimes replication errors occur because of intentional disruptions. For example, when you troubleshoot Active Directory replication problems, rule out intentional disconnections and hardware failures or upgrades first.
If replication errors are reported by a domain controller that is attempting replication with a domain controller that has been built in a staging site and is currently offline awaiting its deployment in the final production site (a remote site, such as a branch office), you can account for those replication errors. To avoid separating a domain controller from the replication topology for extended periods, which causes continuous errors until the domain controller is reconnected, consider adding such computers initially as member servers and using the install from media (IFM) method to install Active Directory Domain Services (AD DS). You can use the Ntdsutil command-line tool to create installation media that you can store on removable media (CD, DVD, or other media) and ship to the destination site. Then, you can use the installation media to install AD DS on the domain controllers at the site, without the use of replication.
Hardware failures or upgrades
If replication problems occur as a result of hardware failure (for example, failure of a motherboard, disk subsystem, or hard drive), notify the server owner so that the hardware problem can be resolved.
Periodic hardware upgrades can also cause domain controllers to be out of service. Ensure that your server owners have a good system of communicating such outages in advance.
By default, Active Directory replication remote procedure calls (RPCs) occur dynamically over an available port through the RPC Endpoint Mapper (RPCSS) on port 135. Make sure that Windows Firewall with Advanced Security and other firewalls are configured properly to allow for replication. For information about specifying the port for Active Directory replication and port settings, see article 224196 in the Microsoft Knowledge Base.
For information about the ports that Active Directory replication uses, see Active Directory Replication Tools and Settings.
For information about managing Active Directory replication over firewalls, see Active Directory Replication over Firewalls.
Responding to failure of an outdated server running Windows 2000 Server
If a domain controller running Windows 2000 Server has failed for longer than the number of days in the tombstone lifetime, the solution is always the same:
- Move the server from the corporate network to a private network.
- Either forcefully remove Active Directory or reinstall the operating system.
- Remove the server metadata from Active Directory so that the server object cannot be revived.
You can use a script to clean up server metadata on most Windows operating systems. For information about using this script, see Remove Active Directory Domain Controller Metadata.
By default, NTDS Settings objects that are deleted are revived automatically for a period of 14 days. Therefore, if you do not remove server metadata (use Ntdsutil or the script mentioned previously to perform metadata cleanup), the server metadata is reinstated in the directory, which prompts replication attempts to occur. In this case, errors will be logged persistently as a result of the inability to replicate with the missing domain controller.
If you rule out intentional disconnections, hardware failures, and outdated Windows 2000 domain controllers, the remainder of replication problems almost always have one of the following root causes:
- Network connectivity: The network connection might be unavailable, or network settings are not configured properly.
- Name resolution: DNS misconfigurations are a common cause of replication failures.
- Authentication and authorization: Authentication and authorization problems cause "Access denied" errors when a domain controller tries to connect to its replication partner.
- Directory database (store): The directory database might not be able to process transactions fast enough to keep up with replication time-outs.
- Replication engine: If intersite replication schedules are too short, replication queues might be too large to process in the time that is required by the outbound replication schedule. In this case, replication of some changes can be stalled indefinitely potentially, long enough to exceed the tombstone lifetime.
- Replication topology: Domain controllers must have intersite links in AD DS that map to real wide area network (WAN) or virtual private network (VPN) connections. If you create objects in AD DS for the replication topology that are not supported by the actual site topology of your network, replication that requires the misconfigured topology fails.
General approach to fixing problems
Use the following general approach to fixing replication problems:
Monitor replication health daily, or use Repadmin.exe to retrieve replication status daily.
Attempt to resolve any reported failure in a timely manner by using the methods that are described in event messages and this guide. If software might be causing the problem, uninstall the software before you continue with other solutions.
If the problem that is causing replication to fail cannot be resolved by any known methods, remove AD DS from the server and then reinstall AD DS. For more information about reinstalling AD DS, see Decommissioning a Domain Controller.
If AD DS cannot be removed normally while the server is connected to the network, use one of the following methods to resolve the problem:
- Force AD DS removal in Directory Services Restore Mode (DSRM), clean up server metadata, and then reinstall AD DS.
- Reinstall the operating system, and rebuild the domain controller.
For more information about forcing removal of AD DS, see Forcing the Removal of a Domain Controller.
Using Repadmin to retrieve replication status
Replication status is an important way for you to evaluate the status of the directory service. If replication is working without errors, you know the domain controllers that are online. You also know that the following systems and services are working:
- DNS infrastructure
- Kerberos authentication protocol
- Windows Time service (W32time)
- Remote procedure call (RPC)
- Network connectivity
Use Repadmin to monitor replication status daily by running a command that assesses the replication status of all the domain controllers in your forest. The procedure generates a .csv file that you can open in Microsoft Excel and filter for replication failures.
You can use the following procedure to retrieve the replication status of all domain controllers in the forest.
Membership in Enterprise Admins, or equivalent, is the minimum required to complete this procedure.
- Excel (Microsoft Office)
To generate a repadmin /showrepl spreadsheet for domain controllers
Open a Command Prompt as an administrator: On the Start menu, right-click Command Prompt, and then click Run as administrator. If the User Account Control dialog box appears, provide Enterprise Admins credentials, if required, and then click Continue.
At the command prompt, type the following command, and then press ENTER:
repadmin /showrepl * /csv > showrepl.csv
Click the Office button, click Open, navigate to showrepl.csv, and then click Open.
Hide or delete column A as well as the Transport Type column, as follows:
Select a column that you want to hide or delete.
- To hide the column, right-click the column, and then click Hide.
- To delete the column, right-click the selected column, and then click Delete.
Select row 1 beneath the column heading row. On the View tab, click Freeze Panes, and then click Freeze Top Row.
Select the entire spreadsheet. On the Data tab, click Filter.
In the Last Success Time column, click the down arrow, and then click Sort Ascending.
In the Source DC column, click the filter down arrow, point to Text Filters, and then click Custom Filter.
In the Custom AutoFilter dialog box, under Show rows where, click does not contain. In the adjacent text box, type
delto eliminate from view the results for deleted domain controllers.
Repeat step 11 for the Last Failure Time column, but use the value does not equal, and then type the value 0.
Resolve replication failures.
For every domain controller in the forest, the spreadsheet shows the source replication partner, the time that replication last occurred, and the time that the last replication failure occurred for each naming context (directory partition). By using Autofilter in Excel, you can view the replication health for working domain controllers only, failing domain controllers only, or domain controllers that are the least or most current, and you can see the replication partners that are replicating successfully.
Replication problems and resolutions
Replication problems are reported in event messages and in various error messages that occur when an application or service attempts an operation. Ideally, these messages are collected by your monitoring application or when you retrieve replication status.
Most replication problems are identified in the event messages that are logged in the Directory Service event log. Replication problems might also be identified in the form of error messages in the output of the
repadmin /showrepl command.
repadmin /showrepl error messages that indicate replication problems
To identify Active Directory replication problems, use the
repadmin /showrepl command, as described in the previous section. The following table shows error messages that this command generates, along with the root causes of the errors and links to topics that provide solutions for the errors.
|Repadmin error||Root Cause||Solution|
|The time since last replication with this server has exceeded the tombstone lifetime.||A domain controller has failed inbound replication with the named source domain controller long enough for a deletion to have been tombstoned, replicated, and garbage-collected from AD DS.||Event ID 2042: It has been too long since this machine replicated|
|No inbound neighbors.||If no items appear in the "Inbound Neighbors" section of the output that is generated by repadmin /showrepl, the domain controller was not able to establish replication links with another domain controller.||Fixing Replication Connectivity Problems (Event ID 1925)|
|Access is denied.||A replication link exists between two domain controllers, but replication cannot be performed properly as a result of an authentication failure.||Fixing Replication Security Problems|
|Last attempt at <date - time> failed with the "Target account name is incorrect."||This problem can be related to connectivity, DNS, or authentication issues. If this is a DNS error, the local domain controller could not resolve the globally unique identifier (GUID)-based DNS name of its replication partner.||Fixing Replication DNS Lookup Problems (Event IDs 1925, 2087, 2088) Fixing Replication Security Problems Fixing Replication Connectivity Problems (Event ID 1925)|
|LDAP Error 49.||The domain controller computer account might not be synchronized with the Key Distribution Center (KDC).||Fixing Replication Security Problems|
|Cannot open LDAP connection to local host||The administration tool could not contact AD DS.||Fixing Replication DNS Lookup Problems (Event IDs 1925, 2087, 2088)|
|Active Directory replication has been preempted.||The progress of inbound replication was interrupted by a higher-priority replication request, such as a request that was generated manually with the repadmin /sync command.||Wait for replication to complete. This informational message indicates normal operation.|
|Replication posted, waiting.||The domain controller posted a replication request and is waiting for an answer. Replication is in progress from this source.||Wait for replication to complete. This informational message indicates normal operation.|
The following table lists common events that might indicate problems with Active Directory replication, along with root causes of the problems and links to topics that provide solutions for the problems.
|Event ID and source||Root cause||Solution|
|1311 NTDS KCC||The replication configuration information in AD DS does not accurately reflect the physical topology of the network.||Fixing Replication Topology Problems (Event ID 1311)|
|1388 NTDS Replication||Strict replication consistency is not in effect, and a lingering object has been replicated to the domain controller.||Fixing Replication Lingering Object Problems (Event IDs 1388, 1988, 2042)|
|1925 NTDS KCC||The attempt to establish a replication link for a writable directory partition failed. This event can have different causes, depending on the error.||Fixing Replication Connectivity Problems (Event ID 1925) Fixing Replication DNS Lookup Problems (Event IDs 1925, 2087, 2088)|
|1988 NTDS Replication||The local domain controller has attempted to replicate an object from a source domain controller that is not present on the local domain controller because it may have been deleted and already garbage-collected. Replication does not proceed for this directory partition with this partner until the situation is resolved.||Fixing Replication Lingering Object Problems (Event IDs 1388, 1988, 2042)|
|2042 NTDS Replication||Replication has not occurred with this partner for a tombstone lifetime, and replication cannot proceed.||Fixing Replication Lingering Object Problems (Event IDs 1388, 1988, 2042)|
|2087 NTDS Replication||AD DS could not resolve the DNS host name of the source domain controller to an IP address, and replication failed.||Fixing Replication DNS Lookup Problems (Event IDs 1925, 2087, 2088)|
|2088 NTDS Replication||AD DS could not resolve the DNS host name of the source domain controller to an IP address, but replication succeeded.||Fixing Replication DNS Lookup Problems (Event IDs 1925, 2087, 2088)|
|5805 Net Logon||A machine account failed to authenticate, which is usually caused by either multiple instances of the same computer name or the computer name not replicating to every domain controller.||Fixing Replication Security Problems|
For more information about replication concepts, see Active Directory Replication Technologies.
For more information, including support articles specific to error codes see the support article: How to troubleshoot common Active Directory replication errors