Recipe 11.27 Triggering the KCC

11.27.1 Problem

You want to trigger the KCC.

11.27.2 Solution Using a graphical user interface
  1. Open the Active Directory Sites and Services snap-in.

  2. In the left pane, browse to the NTDS Settings object for the server you want to trigger the KCC for.

  3. Right-click on NTDS Settings, select All Tasks, and Check Replication Topology.

  4. Click OK. Using a command-line interface
> repadmin /kcc <DomainControllerName> Using VBScript
' This code triggers the KCC on a DC.
strDC = "<DomainControllerName>"  ' e.g. dc01
' ------ END CONFIGURATION ---------

set objIadsTools = CreateObject("IADsTools.DCFunctions")
intRes = objIadsTools.TriggerKCC(Cstr(strDC),0)

if intRes = -1 then
   Wscript.Echo objIadsTools.LastErrorText
   Wscript.Echo "KCC successfully triggered"
end if

11.27.3 Discussion

The KCC runs every 15 minutes by default on all domain controllers to generate the intra-site topology connections. The KCC that runs on the server that is selected as the ISTG generates inter-site topology connections to other sites from the bridgehead servers in its site. In some situations, such as when you create new site, siteLink, or subnet objects, you may want to run the KCC immediately so that any new connections between domain controllers get created.

11.27.4 See Also

Recipe 11.28 for determining if the KCC is completing successfully, for more information on IADsTools see iadstools.doc that is installed with the Support Tools, and MS KB 224815 (The Role of the Inter-Site Topology Generator in Active Directory Replication)

    Chapter 3. Domain Controllers, Global Catalogs, and FSMOs
    Chapter 6. Users
    Appendix A. Tool List