Veritas Cluster Server Bundled Agents Reference Guide

FileShare agents
FileShare agent
75
State definitions
ONLINE
OFFLINE
UNKNOWN
Indicates at least one specified folder is shared.
Indicates no specified folder is shared.
Indicates the agent could not determine the status of the resource.
Note: Sharing a folder with a large number of subfolders and enabling the
ShareSubdirectories attribute may cause increased failover time and high CPU
and memory utilization.
About ForceControl function
ForceControl is a FileShare agent function that allows you to reset the file share
properties as per what is defined in the VCS configuration. The agent overwrites
all modifications made to the file share properties, either externally or from within
VCS, and sets the properties as per what you had defined while configuring the
file shares in VCS. This function overrides the FileShare agent's AutoControl
attribute settings.
You can run the ForceControl function from the command line. To run the
ForceControl function on a fileshare resource, type the following command:
hares -action ForceControl
-sys
Here, is the name of the file share resource for which
you want to reset the properties and is the name of the cluster
node on which that file share resource is online.
For example, to run the ForceControl function on a FileShare resource A_fileshare
that is currently online on a cluster node Node1, type the following:
hares -action A_fileshare ForceControl -sys Node1
The changes take effect on the next agent monitor function.
Resource type definition
type FileShare
static keylist SupportedActions = { ForceControl }
static i18nstr ArgList[] = { PathName, ShareName,
"LanmanResName:VirtualName", MaxUsers, "MountResName:MountPath",
HiddenShare, ShareSubdirectories, HideChildShares, AutoShare,