FileShare managers one share and CompositeFileShare manages multiple shares. Note both types can share subdirectories, so you can for instance share out home set "ShareSubdirectories" attribute so that shares are created for all user folders in home directory. See bundled agents guide for more information which gives examples:
Example Fileshare (sharing ONE share "ToShare")
FileShare FileShare_SG-FileShare (
PathName = "\\ToShare"
ShareName = ToShare
LanmanResName = FileShare_SG-Lanman
MaxUsers = 100
MountResName = FileShare_SG-MountV
UserPermissions = { "VCSNET\\Administrator" = READ_ACCESS }
ShareSubdirectories = 1
HideChildShares = 1
AccessBasedEnumeration = 1
)
Example CompositeFileShare (sharing TWO shares - share2 and share3)
CompositeCFS CFS-RES (
Critical = 1
LanmanResName = CFS_SG-Lanman
MountResName = CFS_SG-MountV
UserPermissions = { Everyone = READ_ONLY }
ShareSubdirectories = 1
PathAndShareName = { "\\share2" = share2, "\\share3" = share3 }
AccessBasedEnumeration = 1
)
In essence if you only have a few shares, then create separate resources for each share using FileShare, but if you have lots of shares (like 30+), then you don't really want 30 resources, so then better to create one or more CompositeFileshares.
Shares in VCS should only be created for diskgroups that are shared between nodes in the cluster, so on the inactive node you can't create the share using windows tools as the drive and directory will not exist.
If a service group fails, or if you switch manually, then VCS FileShare agents remove the shares from that node and then creates shares on the new node - i.e VCS makes sure the shares are only shared from one node at a time.
Mike
