2.3 Directory Service Schema Elements

DFS-R is configured using Active Directory objects. File replication proceeds between computers within the same forest whose principal names are maintained and authenticated by Active Directory. File ACLs are replicated fully as participating computers are expected to use Active Directory to identify ACLs.

The protocol accesses the following Directory Service schema classes and attributes listed in the following table(s).

For the syntactic specifications of the following <Class> or <Class><Attribute> pairs, refer either to:

Active Directory Domain Services (AD DS) ([MS-ADA1], [MS-ADA2], [MS-ADA3], and [MS-ADSC]).

Or to:

Active Directory Lightweight Directory Services (AD LDS) ([MS-ADLS]).

Class

Attribute

msDFSR-LocalSettings

msDFSR-Version

msDFSR-Subscriber

msDFSR-MemberReference

msDFSR-Subscription

msDFSR-ConflictPath

msDFSR-ConflictSizeInMB

msDFSR-ContentSetGuid

msDFSR-Enabled

msDFSR-Extension

msDFSR-Options

msDFSR-ReadOnly

msDFSR-RootFence

msDFSR-RootPath

msDFSR-StagingPath

msDFSR-StagingSizeInMb

msDFSR-DefaultCompressionExclusionFilter

msDFSR-GlobalSettings

No attribute.

msDFSR-ReplicationGroup

msDFSR-Options

msDFSR-ReplicationGroupType

msDFSR-Schedule

msDFSR-TombstoneExpiryInMin

nTSecurityDescriptor

objectGUID

msDFSR-Content

No attribute.

msDFSR-ContentSet

description

msDFSR-DirectoryFilter

msDFSR-FileFilter

objectGUID

msDFSR-Topology

No attribute.

msDFSR-Member

msDFSR-ComputerReference

msDFSR-Keywords

objectGUID

Computer

DNSHostName

msDFSR-Connection

FromServer

msDFSR-Enabled

msDFSR-Keywords

msDFSR-Options

msDFSR-RdcEnabled

msDFSR-RdcMinFileSizeInKb

msDFSR-Schedule

objectGUID

nTDSConnection

FromServer

enabledConnection

schedule

objectGUID

DFS-R relies on global configuration information (stored in Active Directory) for proper functioning.

These objects prescribe configuration information, in particular the following:

  • replicaSetId:  The GUID of replication groups. They are configured as the GUID of an object under the path msDFSR-GlobalSettings/msDFSR-ReplicationGroup.

  • connectionId: The GUID of connections. They are configured as the GUID of an object under the path msDFSR-GlobalSettings/msDFSR-ReplicationGroup/msDFSR-Member/msDFSR-Connection or msDFSR-GlobalSettings/msDFSR-ReplicationGroup/msDFSR-Member/nTDSConnection.

  • contentSetId: The GUID of a replicated folder. They are configured as the GUID of an object under msDFSR-GlobalSettings/msDFSR-ReplicationGroup/msDFSR-Content/msDFSR-ContentSet.

  • Principal names: The principal authenticated computer names. Computer objects form the basis of an Active Directory configuration.

These are used in the RPC messages and MUST be known to both the server and the client in order for partners to establish trust, communication, and which folders are replicated among them. This section summarizes the set of configuration parameters that are used in Active Directory to configure DFS-R.

An object layout example is illustrated in section 4.3.1.