Microsoft KB Archive/224967

= How to create file shares on a cluster =

Article ID: 224967

Article Last Modified on 11/1/2006

-

APPLIES TO

 Microsoft Cluster Server 1.1, when used with:  Microsoft Windows Server 2003, Enterprise Edition (32-bit x86)

 Microsoft Windows 2000 Advanced Server

 Microsoft Windows 2000 Datacenter Server

 Microsoft Windows NT Server 4.0 Enterprise Edition</li></ul> </li></ul>

-

<div class="notice_section">

This article was previously published under Q224967

<div class="summary_section">

SUMMARY
To create highly available file shares on a cluster, you should create them using either Cluster Administrator (CluAdmin.exe) or the cluster API set. When the share is placed in a group with other related resources (IP Address, Network Name, and a storage device), the share is available from whichever node in the cluster owns the group of resources. This article lists basic steps for creating a basic File Share resource.

<div class="moreinformation_section">

MORE INFORMATION
To create a file share on a server cluster, follow these steps:

Note The information in this article is also valid for the Windows 2000 Cluster service. <ol> Open Windows Explorer and create a folder on a shared disk that you want to share out for users.</li> Assign the appropriate NTFS file level permissions on the folder. Make sure that the account used to start the Cluster Service has at least READ rights to the folder.

Note Do not share the folder in Windows Explorer as you normally would for a file share. If you do not grant the Cluster account the appropriate permissions or share the folder through Windows Explorer, it may cause the cluster file share to fail. This also includes any administrative shares that already exist, you do not want to create shares for the root of the drive (Q$) for example.</li> Start Cluster Administrator (CluAdmin.exe).</li> Select a group that has an existing IP Address and Network Name resources. If you do not have these resources created, you will need to complete this before continuing. For additional information, click the article number below to view the article in the Microsoft Knowledge Base:

257932 Using Microsoft Cluster Server to create a virtual server

</li> Right-click, and select New, then Resource.</li> Fill in an administrative name and description for the resource. From the Resource Type pull down, select "File Share", click Next.

Note This is the name that will be displayed in Cluster Administrator and is only used for administrative purposes. This is not the share name that users will connect to, give the resource a name that will be easy to identify and manage.</li> Select the nodes that you want to be possible owners of the resource. Click Next to leave all nodes as possible owners.

Note Possible Owners defines whether a resource is ever able to failover to a specific node. Use extreme caution in defining Possible Owners because defining a possible owner for a single resource will effect the failover for the entire group.</li> Select a Network Name and Physical Disk resource that the file share will be dependent on.

Note Dependencies serve two functions.

a. They define the bindings for a resource. You want the file share to be dependent on the Network Name resource that clients are going to use when connecting to the file share. The IP Address resource that the Network Name resource is dependent upon is the IP Address that will be used when connecting to this share. You never want a file share resource to be dependent on the "Cluster Name" resource.

b. They define the start order for a resource. You want to make sure that the network name that the share is going to be created under and the physical disk where the folder resides that is going to be shared are online and available before attempting to bring the File Share online.

When creating a dependency 'Tree' it is best to keep it as simple as possible. A file share resource should always be dependent on a Network Name that the clients will use to connect to this share and Physical disk resource where the folder is located. The Physical Disk resource should never be dependent on anything. The Network Name resource should be dependent on a IP Address resource which the virtual server will be associated with. The IP Address resource should not be dependent on anything. See the following article for additional information:

171791 Creating dependencies in Microsoft Cluster Server

</li> On the File Share Parameters screen fill in the following information and click Finish:

a. The "Share Name" is the name of the share that will be created for the UNC when clients connect. This needs to be a valid NetBIOS name, and is recommended to be a valid URL name as well.

b. The "Path" is the full path on the local node to the shared disk where the folder is located. For example: T:\Users.

c. The "Comment" is the information about the share that will appear when a client browses the share.</li> By default, when resources are created, they are in an offline state. The following steps are a best practice. Follow them to isolate the effect of the resource failure on other production resources. This will help until the resource is ready to be brought into production for users. <ol style="list-style-type: lower-alpha;"> Right-click the resource, and then click Properties.</li> Click the Advanced tab, click to select the Do not restart button, and then click OK.</li> Bring the resource online. Make sure that it functions correctly.</li> After you confirm that the resource functions correctly, and you are ready to bring it into production, take the resource offline. Then, click to select the Restart button.</li> Bring the resource online.</li></ol> </li></ol>