Repadmin /replsummary

Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2, Windows Server 2008, Windows Server 2008 R2

Identifies domain controllers that are failing inbound replication or outbound replication, and summarizes the results in a report.

When it begins to collect data for the replication summary, this command displays a series of dots. Each dot represents a domain controller that is specified in the DSA_LIST parameter (plus some extra dots for preprocessing). Fifty dots are displayed on each line of the output. For example, four lines of dots represent about 200 domain controllers that are specified by the DSA_LIST parameter. The dots help you gauge throughput and completion time in large environments.

For examples of how to use this command, see Examples.

Syntax

repadmin /replsummary [DSA_LIST] [/bysrc] [/bydest] [/errorsonly] [/sort:{delta | partners | failures | error | percent | unresponsive}]

Parameters

Parameter Description

DSA_LIST

Specifies the host name of a domain controller or a list of domain controllers. For detailed syntax, see Repadmin.

/bysrc

Summarizes the replication status for all domain controllers that a given source domain controller replicates to. This parameter does not display the destination domain controller.

/bydest

Summarizes the replication status for all domain controllers that a given destination domain controller replicates from. This parameter does not display the source domain controller.

/errorsonly

Shows only the domain controllers where the partner error is non-zero.

/sort

Sorts the output by columns that are in the following list:

  • delta: Sorts the results according to the least current naming context for each source or destination domain controller.

  • partners: Sorts the results list by the number of replication partners for each domain controller.

  • failures: Sorts the results list by the number of partner replication failures for each domain controller.

  • error: Sorts the results list by the last replication result (the error code) that is blocking replication for each domain controller. This helps you troubleshoot the root cause of failure for domain controllers that fail with common errors.

  • percent: Sorts the results list by the partner replication failure percentage for each domain controller. (This is calculated by dividing the number of failures by the total number of attempts, and then multiplying by 100; that is, failures/total attempts * 100.) This helps you prioritize your troubleshooting efforts by identifying the domain controllers that are experiencing the highest frequency of replication errors.

  • unresponsive: Sorts the results list by the names of partners that do not respond to replication requests for each domain controller.

Remarks

  • You can specify the /bysrc and /bydest parameters at the same time. If you do so, then Repadmin displays the /bysrc parameter table first and the /bydest parameter table next.

  • If the parameters /bysrc and /bydest are both absent, Repadmin displays the one with the least number of partner errors.

Examples

The following example targets all domain controllers in the forest to retrieve summary replication status from each. The example lists the output in a table that has columns for source and destination, and sorts the results based on the longest time since the last successful replication:

repadmin /replsum * /bysrc /bydest /sort:delta

Additional references

Command-Line Syntax Key

Repadmin