RepAdmin Syntax

Connects to and displays the replication features for a directory partition on a domain controller.

repadmin /bind [DSA]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

Dispays a list of failed replication events detected by the Knowledge Consistency Checker.

repadmin /failcache [DSA]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

Displays changes from a specified directory partition or changes to a specified object. Syntax 1 saves changes to a directory partition. If this information is saved to a file the getchanges operation can be run again for comparison. Syntax 2 shows changes to a specified object.

Syntax 1

repadmin /getchanges NamingContext [SourceDSA] [/cookie: File]

Syntax 2

repadmin /getchanges NamingContext [DestDSA] SourceDSAobjectGUID [/verbose] [/statistics]

Parameters

NamingContext

Specifies the distinguished name of the directory partition.

SourceDSA

Specifies the host name of the domain controller that hosts the directory partition (Directory Server Agent) whose changes you want to view.

/cookie: File

Specifies a name for the file to which list changes are saved.

DestDSA

Specifies the host name of the domain controller that hosts the object (Directory Server Agent) whose changes you want to view.

SourceDSAobjectGUID

Specifies the unique hexadecimal number that identifies the object whose changes will be listed. The objectGUID can be retrieved by using the /showreps operation.

/verbose

Lists detailed information.

/statistics

Displays a summary of information about changes instead of a list of individual changes.

Remarks

• The information from Syntax 1 can be saved to a file for later comparison.

Examples

See Example 6: Create a File to Determine What Changes Have Occurred Over a Period of Time.

Forces the Knowledge Consistency Checker to recalculate replication topology for a specified domain controller. By default this recalculation occurs every 15 minutes.

repadmin /kcc [DSA] [/async]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

/async

Specifies that replication will be asynchronous. This means that RepAdmin will start the replication event, but it does not expect an immediate response from the destination domain controller. Use this parameter when there are slow links between domain controllers.

Compares properties of specified domain controllers to determine if they are up to date with each other. The source domain controller contains the original information that needs to be checked. The destination domain controller data will be compared to the source domain controller data.

repadmin /propcheck NamingContext OriginatingDSAInvocationID OriginatingUSN [DestDSA]

Parameters

NamingContext

Specifies the distinguished name of the directory partition on the source domain controller.

OriginatingDSAInvocationID

Specifies the unique hexadecimal number that identifies an object on a source domain controller. InvocationID can be retrieved by using the /showreps operation.

OriginatingUSN

Specifies the USN for the object on the source domain controller. The USN is for the object whose InvocationID is already listed.

DestDSA

Specifies the host name of the destination domain controller (Directory Server Agent) from which to enumerate the host DSAs.

Displays tasks waiting in the replication queue.

repadmin /queue [DSA]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

Displays the server certificates loaded on a specified domain controller

repadmin /showcert [DSA]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

Displays the connection objects for a specified domain controller. Default is local site.

repadmin /showconn [DSA] [{ContainerDN|DSAGUID}]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

ContainerDN

Specifies the distinguished name of the container.

DSAGUID

Specifies the unique hexadecimal number that identifies the domain controller. The DSA GUID can be retrieved using the /showreps operation.

Examples

See Example 7: Display the Connection Objects for a Server.

Displays a list of computers that have opened sessions with a specified domain controller.

repadmin /showctx [DSA] [/nocache]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

/nocache

Specifies that GUIDs are left in hexadecimal form. By default GUIDs are translated into strings.

Examples

See Example 9: Display the Context Handles for the Replication Process.

Displays intersite messaging routes calculated by the Knowledge Consistency Checker (KCC). This operation cannot be executed remotely.

repadmin /showism [TransportDN] [/verbose]

Parameters

TransportDN

Specifies whether the mail server is using SMTP or RPCs to send messages.

/verbose

Lists detailed information.

Displays the replication metadata for a specified object stored in Active Directory such as attribute ID, version number, originating and local Update Sequence Number (USN), and originating server's GUID and date/time stamp. By comparing the replication metadata for the same object on different domain controllers, an administrator can determine whether replication has taken place.

repadmin /showmeta ObjectDN [DSA] [/nocache]

Parameters

ObjectDN

Specifies the distinguished name of the object.

DSA

Specifies the host name of the domain controller that hosts the object (Directory Server Agent).

/nocache

Specifies that GUIDs are left in hexadecimal form. By default GUIDs are translated into strings.

Displays the error message for a given error number.

repadmin /showmsg Win32Error

Parameters

Win32Error

Specifies the number of the Win32 error.

Displays the replication partners for each directory partition on the specified domain controller. Helps the administrator build a visual representation of the replication topology and see the role of each domain controller in the replication process.

repadmin /showreps [NamingContext] [DSA] [SourceDSAobjectGUID] [/verbose] [/unreplicated] [/nocache]

Parameters

NamingContext

Specifies the distinguished name of the directory partition.

DSA

Specifies the host name of the domain controller (Directory Server Agent).

SourceDSAobjectGUID

Specifies the unique hexadecimal number that identifies the object whose replication events will be listed.

/verbose

Lists detailed information.

/unreplicated

Shows pending changes.

/nocache

Specifies that GUIDs are left in hexadecimal form. By default GUIDs are translated into strings.

Examples

See Example 1: Display the Replication Partners of a Server.

Displays the replication signature for a specified domain controller.

repadmin /showsig [DSA]

Parameters

DSA

Specifies the host name of the domain controller (Directory Server Agent).

Examples

See Example 8: Display the Replication Signature for a Server.

Converts a directory service time value to string format for both the local and the UTC time zones.

repadmin /showtime [DSTimeValue]

Parameters

DSTimeValue

Specifies the time value that needs to be converted.

Remarks

• With parameters omitted, repadmin /showtime displays the current system time in both the directory service format and string format.
• The string format displays both the local and UTC time zones.

Displays the highest Update Sequence Number (USN) for the specified domain controller. This information shows how up to date a replica is with its replication partners.

repadmin /showvector NamingContext [DSA] [/nocache]

Parameters

NamingContext

Specifies the distinguished name of the directory partition.

DSA

Specifies the host name of the domain controller (Directory Server Agent).

/nocache

Specifies that GUIDs are left in hexadecimal form. By default GUIDs are translated into strings.

Examples

See Example 4: Display the Highest Update Sequence Number on a Server.

Starts a replication event for the specified directory partition between the source and destination domain controllers. The source DSA UUID can be determined when viewing the replication partners with the repadmin /showreps command.

repadmin /sync NamingContext DestDSA SourceDSAUUID [/force] [/async] [/full] [/addref] [/allsources]

Parameters

NamingContext

Specifies the distinguished name of the directory partition.

destDSA

Specifies the host name of the domain controller (Directory Server Agent) with which you want to replicate.

SourceDSAUUID

Specifies the unique hexadecimal number that identifies the object whose changes will be listed. The objectGUID can be retrieved using the /showreps operation.

/force

Overrides the normal replication schedule.

/async

Specifies that the replication will be asynchronous. This means that RepAdmin will start the replication event, but it does not expect an immediate response from the destination domain controller. Use this parameter when there are slow links between domain controllers.

/full

Forces a full replication of all objects from the destination domain controller.

/addref

Directs the source to check for a notification entry on the source. If the source does not have a notification entry for this destination, one is added.

/allsources

A given destination may have multiple sources for the same naming context. Directs the destination to sync with all sources instead of just one.

Examples

See Example 2: Force a Replication Event Between Two Replication Partners.

Synchronizes a specified domain controller with all replication partners.

repadmin /syncall DestDSA [NamingContext] [Flags]

Parameters

DestDSA

Specifies the host name of the domain controller (Directory Server Agent) to synchronize with all replication partners.

NamingContext

Specifies the distinguished name of the directory partition.

Flags

Performs specific actions during the replication.

/a	Abort if any server is unavailable
/d	ID servers by DN in messages
/e	Enterprise, cross sites
/h	Print this help screen
/i	Iterate indefinitely
/I	Perform showreps on each server pair in path instead of syncing
/j	Sync adjacent servers only
/p	Pause for possible user abort after every message
/P	Push changes outward from home server
/q	Quiet mode, suppress callback messages
/Q	Very quiet, report fatal errors only
/s	Do not sync
/S	Skip initial server-response check

Examples

See Example 3: Force a Replication Event for a Specified Directory Partition with All of its Replication Partners.