wiki.samba.org Open in urlscan Pro
2a01:4f8:192:486::2:5  Public Scan

Form analysis
1 forms found in the DOM

https://wiki.samba.org/index.php

<form action="https://wiki.samba.org/index.php" id="searchform">
  <div id="simpleSearch">
    <div id="searchInput-container"><input type="search" name="search" placeholder="Search SambaWiki" title="Search SambaWiki [alt-shift-f]" accesskey="f" id="searchInput"></div><input type="hidden" value="Special:Search" name="title"><input
      type="submit" name="fulltext" value="Search" title="Search the pages for this text" id="mw-searchButton" class="searchButton mw-fallbackSearchButton"><input type="submit" name="go" value="Go"
      title="Go to a page with this exact name if it exists" id="searchButton" class="searchButton">
  </div>
</form>

Text Content

ANONYMOUS


NOT LOGGED IN

 * Create account
 * Log in

SambaWiki


SEARCH








DRSUAPI

From SambaWiki


NAMESPACES

 * Page
 * Discussion


MORE

 * More
 * Languages


PAGE ACTIONS

 * Read
 * View source
 * History




CONTENTS

 * 1 Introduction
 * 2 DSBind and DSUnbind Functions
 * 3 DSGetNCChanges Function
 * 4 DSReplicaSync Function
 * 5 RepsFrom and RepsTo structures
 * 6 See Also
 * 7 External Links


INTRODUCTION

The IT infrastructure of organizations often needs the existence of more than
one Domain Controller (DC) for it's Active Directory (AD). For keeping an
environment with more than one DC consistent, it is necessary to have the AD
objects replicated through those DCs.

Most of the replication related tasks are specified on the Directory Replication
Service (DRS) Remote Protocol. The Microsoft API which implements such protocol
is called DRSUAPI.

Below we describe some important functions and data structures.


DSBIND AND DSUNBIND FUNCTIONS

Those functions are necessary to manipulate the context handle, which is
necessary to call others functions of the DRSUAPI. DSBind method creates the
context handle, while the DSUnbind destroys an existing context handle.


DSGETNCCHANGES FUNCTION

The client DC sends a DSGetNCChanges request to the server when the first one
wants to get AD objects updates from the second one. The response contains a set
of updates that the client has to apply to its NC replica.

It is possible that the set of updates is too large for only one response
message. In those cases, multiple DSGetNCChanges requests and responses are
done. This process is called replication cycle or simply cycle.


DSREPLICASYNC FUNCTION

When a DC receives a DSReplicaSync Request, then for each DC that it replicates
from (stored in RepsFrom data structure) it performs a replication cycle, where
it behaves like a client and makes DSGetNCChanges requests to that DC. So it
gets up-to-date AD objects from each of the DC's which it replicates from. This
function implements a changes propagation mechanism.


REPSFROM AND REPSTO STRUCTURES

The RepsFrom and RepsTo structures hold metadata information about the NC
replicas that are used during replication.

RepsFrom is a multivalued structure that holds information about the NC replicas
whose the DC has to get information from, when it is replicating (when attending
a DSReplicaSync request).

The RepsTo structure stores information about the NC replicas whose the DC
replicates to. For each DC which has to be informed about changes (using
DSReplicaSync request), there is an attribute value of RepsTo.


SEE ALSO

 * Samba4/ActiveDirectory
 * Samba4/DRS TODO List


EXTERNAL LINKS

 * Stefan Metzmacher Bachelor Thesis about Active Directory Replication (English
   translated version)
 * MS-DRSR: Directory Replication Service (DRS) Remote Protocol Specification at
   msdn.microsoft.com
 * DRS Tutorial about DRSUAPI Implementation in Samba and other stuff (Video)
 * DRS Tutorial about DRSUAPI - Quick guide for the lessons learned during the
   first tutorial

Retrieved from "https://wiki.samba.org/index.php?title=DRSUAPI&oldid=10372"




NAVIGATION


NAVIGATION

 * Main Page
 * User Documentation
 * Developer Documentation
 * Categories
 * Current Events
 * Recent Changes
 * Random Page
 * Report Samba Bug
 * Report Doc Bug


WIKI TOOLS


WIKI TOOLS

 * Special pages


PAGE TOOLS


PAGE TOOLS




USERPAGE TOOLS




MORE

 * What links here
 * Related changes
 * Printable version
 * Permanent link
 * Page information
 * Page logs


 * This page was last edited on 25 July 2015, at 09:13.
 * This page has been accessed 28,642 times.
 * Content is available under CC-BY unless otherwise noted.
 * Privacy policy
 * About SambaWiki
 * Disclaimers