2.3.1.2 NTFRS Replica Set Object

  • Article

Each NTFRS replica set object (class nTFRSReplicaSet) represents a replica set. A replica set consists of a number of replicas, each of which lives on a different computer.

Each NTFRS replica set object MUST be stored in the domain naming context at the following RDN, within the NTFRS settings object that is its parent:

"CN=ReplicaSetName"

Where ReplicaSetName is the name of the replica set.

The attributes of this object that FRS uses are:

fRSReplicaSetType: MUST be set to 0x00000003 for DFS replica sets.

fRSFileFilter: A Unicode string that can specify a comma-separated list of wildcard file name filters for the replica set (* matches 0 or more characters; ? matches exactly 1 character). Any file whose name matches any of the filters SHOULD be excluded from replication. The value of this attribute SHOULD contain, at minimum: "*.tmp,*.bak,~*". The fRSFileFilter attribute is case-insensitive, and a one-space character (" ") can be present after each comma. FRS MUST NOT impose a limit on the maximum length of an extension or the list of extensions. However, the underlying file system or Active Directory can limit the lengths. The server MUST replicate all files if the fRSFileFilter is set to the value ",".<19>

fRSDirectoryFilter: A Unicode string that MAY specify the names of folders whose contents SHOULD be excluded from replication (* matches 0 or more characters; ? matches exactly 1 character). The fRSDirectoryFilter attribute is case-insensitive. FRS MUST NOT impose a limit on the maximum length of an extension or the list of extensions. However, the underlying file system or Active Directory MAY limit the lengths.<20>

fRSFlags: Integer. When FRS has downloaded a file from a remote partner and is trying to use the new content to over-write an existing local file with the same name that has been opened by other processes, fRSFlags specifies whether FRS MUST wait until it can open the file with write access, or FRS MUST rename the opened file out of the way in order to allow the installation of a new updated version of the file.

FRS MUST NOT rename the opened file if FRS does not have permission to delete that file. If the target file is currently open with a sharing mode that denies delete access to other opens, FRS MUST NOT install the updated version until the file is closed. FRS MUST apply this flag only when processing an incoming file, and MUST NOT apply this flag when processing an incoming directory.

Value

Meaning

<Not Set><21>

Same as 0.

The least significant bit is 0

FRS MUST wait until it can open the file with write access before overwriting an opened local file.

The least significant bit is 1

FRS MUST rename the opened file out of the way before overwriting an opened local file.

frsPrimaryMember:  The distinguishedName of the NTFRS member object, as specified in 2.3.1.3, that acts as the primary member of this replica set. The primary member of a replica is usually the first member of the replica set, which acts as the seed to populate the whole replica set. A replica set MUST have exactly one primary member. (See Section 3.3.3).

Schedule: If set, MUST apply to all the NTDS connection objects in the replica set that do not have a schedule attribute.

The schedule attribute defines an 84-byte array that specifies the replication schedule for one week. Each bit in the byte array represents a 15-minute replication period. The possible values for each bit on the array MUST be as follows.

Value

Meaning

0

Do not replicate during this 15-minute period.

1

Replicate during this 15-minute period.

The first bit in the array corresponds to the 15-minute interval between 0:00 A.M. and 0:14 A.M. on Sunday.

Exactly one NTFRS replica set object MUST exist for each replica set within a domain. A domain MUST define zero or more replica sets.

The NTFRS replica set object MUST use the schema definition provided by the nTFRSReplicaSet class definition, as specified in [MS-ADSC] section 2.210.

objectGUID: A unique identifier of the replica set.

Name: Uniquely identifies the replica set and specifies the replica set name.

  • fRSDSPoll: Attribute not used by FRS.

  • fRSExtensions: Attribute not used by FRS.

  • fRSLevelLimit: Attribute not used by FRS.

  • fRSPartnerAuthLevel: Attribute not used by FRS.

  • fRSReplicaSetGUID: Attribute not used by FRS.

  • fRSRootSecurity: Attribute not used by FRS.

  • fRSServiceCommand: Attribute not used by FRS.

  • fRSVersionGUIDmsFRS-Hub-Member: Attribute not used by FRS.

  • msFRS-Topology-Pref: This attribute stores the preferred NTFRS topology setting. When an FRS member is added to or deleted from the replica set, adjustments are made to the connections between the FRS members in the replica set according to the value of this attribute.<22> This attribute MUST be set to one of the following values:

    Value

    Topology Type

    Description

    1

    FRS_RSTOPOLOGYPREF_RING

    FRS sorts members based on their site, such that members on the same site are neighbors. Then, for any two neighbors N1 and N2, it establishes a connection from N1 to N2, and from N2 to N1.

    2

    FRS_RSTOPOLOGYPREF_HUBSPOKE

    FRS establishes a connection between each member M in the replica set, such that M is not a hub node, and the hub node H that is identified by the msFRS-Hub-Member attribute. Connections are also established between H and M.

    3

    FRS_RSTOPOLOGYPREF_FULLMESH

    Connections are established between all pairs of members in the replica set.

    4

    FRS_RSTOPOLOGYPREF_CUSTOM

    Connections are established interactively by the user, through a user interface.