2.3.3 msDFSR-Subscription

  • Article

Each subscription object represents a replicated folder in the replication group that its parent subscribes to. Objects of this class exist on the msDFSR-Subscriber objects and imply that the computer uses the topology specified by the msDFSR-Subscriber object to replicate the folder specified by the attributes of the msDFSR-Subscription object.

The following attributes of this object are relevant to DFS-R:

  • msDFSR-ContentSetGUID: ContentSet object GUID MUST exist.

  • msDFSR-RootPath: Full path of the replicated folder root directory MUST exist.

  • msDFSR-RootFence: Time stamp.

  • msDFSR-StagingPath: Full path of the replicated folder staging directory.

  • msDFSR-StagingSizeInMb: The maximum size of the staging directory, in megabytes. Optional.

  • msDFSR-ConflictPath: Full path of the folder used to store files for which there are replication conflicts.

  • msDFSR-ConflictSizeInMB: The maximum size of the conflicts folder, in megabytes.

  • msDFSR-Enabled: Enable and disable replicated folder without removing it from the system.

  • msDFSR-Options: Bit Flags to control optional behavior. The following bits are used:

    • 0x1: Set if the replicated folder is designated as primary.

    • All other bits are ignored and SHOULD be set to 0.

  • msDFSR-Extension: In version 0x00050000 of the Distributed File System: Replication (DFS-R) Protocol, MUST be set to 0 and MUST be ignored on receipt. In version 0x00050002 or later of DFS-R, contains a string that specifies a file name pattern to be used to exclude some files from data compression.<9>

  • msDFSR-ReadOnly: Specifies whether a replicated folder is configured as read-only. This flag is set to 1 if the replicated folder is configured read-only and set to 0 for regular replicated folders. If this flag is set to 1 for a particular replicated folder, DFS-R will roll back changes that occur locally on that replicated folder, instead of replicating them out to other servers in the replication group. This behavior is also known as read-only replicated folders. <10>

    • This flag is optional and if not set, DFSR MUST default to treating the replicated folder as a read-write replicated folder. <11>

  • msDFSR-DefaultCompressionExclusionFilter: A comma-separated string listing the file extensions that are not to be compressed by DFSR. The extension * is used to specify that all files are not to be compressed by DFSR. The empty string is used to specify that all files are to be compressed by DFSR. <12>

Each msDFSR-Subscription object MUST contain a reference to one msDFSR-Content object. At most, one msDFSR-Content object MUST be referenced from an msDFSR-Subscription object.

The schema definition for this object is as specified by the msDFSR-Subscription class definition in [MS-ADSC].