How to configure client-side caching on a Windows Server 2003 server cluster (841171)


The information in this article applies to:

  • Microsoft Windows Server 2003, Datacenter Edition
  • Microsoft Windows Server 2003, Enterprise Edition

SUMMARY

This article describes how to configure client-side caching for a File Share resource on a Microsoft Windows Server 2003 server cluster. You can configure client-side caching for a File Share resource by using Cluster Administrator (CluAdmin.exe) or by using the Cluster.exe command-line program.

MORE INFORMATION

Windows Server 2003 server clusters support client-side caching for clustered File Share resources. The CSCCache property controls client-side caching for file shares on a server cluster. By using client-side caching, network users can access files on file shares even when the client computer is disconnected from the network. This behavior occurs because the files are cached on the client computer.

Configure client-side caching by using Cluster Administrator (CluAdmin.exe)

To configure client-side caching for a File Share resource by using Cluster Administrator:
  1. Start Cluster Administrator.
  2. In the left pane, click Resources.
  3. Right-click a File Share resource, and then click Properties.
  4. Click the Parameters tab, and then click Caching.
  5. Click to select the Allow caching of files in this shared folder check box.
  6. Under Setting, click one of the following client-side caching settings, depending on your situation, and then click OK:
    • Manual caching of documents
    • Automatic caching of documents
    • Automatic caching of programs and documents

Configure client-side caching by using the Cluster.exe command-line program

To use the Cluster.exe command-line program to configure client-side caching for a File Share resource, run the Cluster.exe command with the CscCache private property. Specify one of the following values for the CscCache private property to set the client-side caching setting that you want:
  • 0: If you set CscCache to 0, the changes in only those files that are specifically identified on the file share are reconciled between the client and the server cluster.
  • 16: if you set CscCache to 16, the changes in all the files that are opened on the client are reconciled between the client and the server cluster.
  • 32: If you set CscCache to 32, client-side caching is disabled for the files that are opened, but they are not modified.
  • 48: If you set CscCache to 48, client-side caching is disabled for all the files that are on the file share.
For example, to automatically reconcile the changes for all the files on a file share resource that is named UserShare, type the following line at the command prompt, and then press ENTER:

cluster.exe resource "usershare" /priv csccache=16

For more information about the Cluster.exe command-line program, visit the following Microsoft Web site:

http://www.microsoft.com/resources/documentation/WindowsServ/2003/enterprise/proddocs/en-us/Default.asp?url=/resources/documentation/windowsserv/2003/enterprise/proddocs/en-us/sag_mscsaclstexe_5.asp

REFERENCES

For more information about how to configure client-side caching for a File Share resource, visit the following Microsoft Web site:

http://www.microsoft.com/resources/documentation/WindowsServ/2003/enterprise/proddocs/en-us/Default.asp?url=/resources/documentation/WindowsServ/2003/enterprise/proddocs/en-us/cluad_pr_100.asp

For more information about the CSCCache property, visit the following Microsoft Web site:

http://msdn.microsoft.com/library/default.asp?url=/library/en-us/mscs/mscs/file_shares_csccache.asp

Modification Type:MajorLast Reviewed:6/15/2004
Keywords:kbClustering kbinfo KB841171 kbAudITPRO
©2004 Microsoft Corporation. All rights reserved.