Microsoft KB Archive/291823

= How to reset the File Replication service staging folder to a different logical drive =

Article ID: 291823

Article Last Modified on 3/2/2007

-

APPLIES TO


 * Microsoft Windows Server 2003, Standard x64 Edition
 * Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)
 * Microsoft Windows Server 2003, Datacenter Edition (32-bit x86)
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Service Pack 3
 * Microsoft Windows 2000 Service Pack 3

-



This article was previously published under Q291823



Important This article contains information about how to modify the registry. Make sure to back up the registry before you modify it. Make sure that you know how to restore the registry if a problem occurs. For more information about how to back up, restore, and modify the registry, click the following article number to view the article in the Microsoft Knowledge Base:

256986 Description of the Microsoft Windows registry



SUMMARY
This article describes how to reset the File Replication service (FRS) staging folder to a different logical drive or folder for existing FRS replica members.



MORE INFORMATION
Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require that you reinstall your operating system. Microsoft cannot guarantee that these problems can be solved. Modify the registry at your own risk.

The FRS is a multi-threaded, multi-master replication engine that replaces the LMRepl service in Microsoft Windows NT version 3.0 and Windows NT version 4.0. Whistler-based and Microsoft Windows 2000-based domain controllers use FRS to replicate policies and logon scripts that reside in the System Volume (SYSVOL) for Whistler-based and down-level clients.

FRS can also replicate the content between servers that host the same fault-tolerant Distributed file system (Dfs) roots or child node replicas.

The FRS staging folder is a temporary store for files that replicate to downstream partners of SYSVOL or Dfs replica sets. Files in the FRS staging folder may consume disk space up to the limit assigned in the Staging Space Limit in KB option [(REG_DWORD) registry entry (Default = 660 MB)], or up to the amount of free disk space on the hosting drive, whichever is less.

For FRS replica sets that host gigabytes of content, it may be necessary to relocate the FRS staging folder to a different logical or physical drive to:
 * Prevent the FRS staging folder from consuming all available disk space on the hosting drive, which can potentially affect the stability of other components including the base operating system.
 * Locate the operating systems on different physical drives to enhance component or operating system performance.
 * Provide sufficient space to host the desired staging space limit.

NOTE: Windows 2000-based and Windows 2000 Service Pack 2-based clients must perform an authoritative restore task to relocate the FRS staging path.

For computers that are running Windows Server 2003, Windows 2000 Service Pack 3 (SP3) or an equivalent (including the Q321557 and Q321557 versions of Ntrfs.exe on Windows 2000-based computers), you can set the staging path by using the Ldp.exe program or the Adsiedit.msc utility by modifying the FrsStagingPath attribute on the NTFRS subscriber object under the host computer account in Active Directory.

To modify the FrsStagingPath attribute using the Adsiedit.msc tool that is included with the Windows. NET Support tools:

WARNING: If you use the ADSI Edit snap-in, the LDP utility, or any other LDAP version 3 client, and you incorrectly modify the attributes of Active Directory objects, you can cause serious problems. These problems may require you to reinstall Microsoft Windows 2000 Server, Microsoft Exchange 2000 Server, or both. Microsoft cannot guarantee that problems that occur if you incorrectly modify Active Directory object attributes can be solved. Modify these attributes at your own risk.  Start the Adsiedit program. Under Domain NC, locate the NTFRS subscriber object under the host computer account in Active Directory. The generic path for this attribute is: CN=, CN=NTFRS Subscriptions, CN= , DC= ,DC=COM

For example, to reset the staging path for the SYSVOL replica set of domain controller \\DC1 in the A.com domain, the Distinguished Name (DN) path for the FrsStagingPath attribute is:

CN=Domain System Volume (SYSVOL share), CN=NTFRS Subscriptions, CN=DC1, DC=A,DC=COM

Where (when you read the DN path from right to left):

DC=A,DC=COM is the domain hosting the computer account.

CN=DC1 is the host computer account in the domain nc (domain naming context).

CN=Domain System Volume (SYSVOL share) is the FRS subscriber object.

CN=NTFRS Subscriptions is the NtfrsSubscriber object that holds the FrsStagingPath attribute. Open the properties for the NTFRS subscriber object [in this example, it is Domain System Volume (SYSVOL share)], by right-clicking the object, and then clicking Properties. Click fRSStagingPath in the list of attributes and click the Edit button. Enter the path to the new location for the FRS staging folder and click OK. Click OK to close the Properties window.</li> Update the staging path in the registry: <ol style="list-style-type: lower-alpha;"> Start Registry Editor (Regedt32.exe) on the server where you are changing the staging path.</li> Locate the following subkey:

</li> Locate the replica set you are updating the staging area for. All replica sets are displayed as a GUID. If you click a GUID, one of the values on the right is Replica Set Name. After you locate the correct replica set, change the value of Replica Set Stage to the new staging area path.</li></ol> </li></ol>

When the service detects a change in the staging path, the following Event 13563 is logged with a series of self-explanatory steps on how to proceed:

Event Type: Warning

Event Source: NtFrs

Event Category: None

Event ID: 13563

Date: 3/6/2001

Time: 7:13:01 PM

User: N/A

Computer: AC2

Description: The File Replication service has detected that the staging path for the replica set DOMAIN SYSTEM VOLUME (SYSVOL SHARE) has changed.

Current staging path = E:\Windows\Sysvol\Staging\Domain

New staging path = E:\Frsstage

The service will start using the new staging path after it restarts. The service is set to restart after every restart.

It is recommended that you manually restart the service to prevent loss of data in the staging folder.

To manually restart the service do the following:

[1] Run &quot;net stop ntfrs&quot; or use the Services snap-in to stop File Replication service.

[2] Move all the staging files corresponding to replica set DOMAIN SYSTEM VOLUME (SYSVOL SHARE) to the new staging location. If more than one replica set are sharing the current staging folder then it is safer to copy the staging files to the new staging folder.

[3] Run &quot;net start ntfrs&quot; or use the Services snap-in to start File Replication service, followed by &quot;net start ntfrs&quot;.

For more information, visit Help and Support Services at http://search.support.microsoft.com/search/?adv=1.

Microsoft recommends that you follow step 2 in the preceding event message because the FRS staging folder may contain thousands or tens of thousands of files in the original staging folder all of which may be destined for one or more downstream partners. In Windows Explorer, you can view the files in the staging folder. On the Folder Options menu, click the View tab, and then click to select the Show hidden files and folders check box. Copy the files to the new staging folder, and then follow the remaining steps in the event log message.

Update domain junction point
Resetting the FRS staging location also requires that you update the domain junction point under staging areas.

Set the staging area path
Use the following method to modify the fRSStagingPath parameter for a domain controller in Active Directory to change the location of the staging area folder on that domain controller. Perform this procedure at the console of the domain controller that is hosting the SYSVOL that you must reconfigure.

Note The following credentials and tools are required to set the staging area path:
 * Credentials: Domain Administrator
 * Tools: Registry Editor, Active Directory Service Interfaces (ADSI) Edit, Linkd.exe

To set the staging area path, follow these steps: <ol> Click Start, click Run, type Adsiedit.msc and press ENTER.</li> Locate the following object, as follows:

CN=Domain System Volume(SYSVOL share)

<ol style="list-style-type: lower-alpha;"> Expand '''Domain [. . ]'''</li> Expand DC=, DC= </li> Expand OU=Domain Controllers</li> Expand CN= </li> Expand CN=NTFRS Subscriptions.</li></ol> </li> Right-click CN=Domain System Volume(SYSVOL share), and then click Properties</li> Click to select the Show Mandatory attributes check box.</li> Locate and then click fRSStagingPath in the list of attributes, and then click Edit</li> Type the complete path of where you want to locate the Staging Area folder, and then click OK.

This path is the path of the new folder that you created earlier. Include the drive letter.</li> At a command prompt, change the directory to %systemroot%\SYSVOL\staging areas.</li> <li>Type dir in the list the contents. Verify that <JUNCTION> appears in the DIR output.</li> <li>Update the junction so that the junction points to the new location. Type the following command:

linkd

Note  is the same value that you entered for fRSStagingPath.</li> <li>Press ENTER.</li></ol>

Note The Active Directory Product Operations Guide includes these procedures. For more information, visit the following Microsoft Web site:

http://www.microsoft.com/technet/itsolutions/cits/mo/winsrvmg/adpog/adpog5.mspx

For more information, click the following article numbers to view the articles in the Microsoft Knowledge Base:

221111 Description of FRS entries in the registry

265085 Moving FRSStagingPath requires non-authoritative restore

Additional query words: move staging area

Keywords: kbinfo kbenv KB291823

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.