DFS-N: Folder Target Availability

Microsoft.Windows.FileServer.DFSN.LinkTarget.AccessStateUnitMonitor (UnitMonitor)

When enabled, this object monitors the availability of a DFS folder (link) target and creates an alert if the folder target is not accessible.

Knowledge Base article:

Summary

When enabled, this object monitors the availability of a shared folder that acts as a DFS folder (link) target.

Causes

An unhealthy state indicates that a folder target is offline. A folder target could be offline for the following reasons:

Resolutions

Test network connectivity

To test network connectivity with the affected server, use the following procedure:

1. Open a command prompt window, and then use the ping command to check basic network connectivity. If the ping command fails, it is likely that the server is not running, or has network problems that require local access to resolve. If ping is blocked in your network environment, skip this step.

2. If the ping command is successful, test the server’s registration in DNS by using the nslookup command. If the nslookup command fails, there is likely a problem with DNS. Check the DNS server health or contact the DNS server administrator.

3. If the nslookup command succeeds, it is likely that the shared folder is offline (possibly for maintenance) or there are problems with the permissions on the shared folder.

Verification

To verify that the folder (link) and folder targets are functioning properly, use the following procedure:

1. Open a command prompt window, and then use the Dfsutil link\\[namespace\folder]> command, where [namespace] is the namespace root, and [folder] is the DFS folder whose folder targets you would like to verify are online (this command is not available on Windows Server 2003).

2. Confirm that the state of the folder is OK and that the states of the appropriate targets are Online, and then reset the monitor in the Operations console. The monitor in the Operations console should automatically reset to the Healthy state.

Element properties:

TargetMicrosoft.Windows.FileServer.DFSN.Library.LinkTarget
Parent MonitorSystem.Health.AvailabilityState
CategoryCustom
EnabledFalse
Alert GenerateFalse
Alert Auto ResolveFalse
Monitor TypeMicrosoft.Windows.FileServer.DFSN.Library.LinTargetAvailabilityUnitMonitorType
RemotableTrue
AccessibilityPublic
RunAsMicrosoft.Windows.FileServer.DFSN.DFSTargetAccessAccount

Source Code:

<UnitMonitor ID="Microsoft.Windows.FileServer.DFSN.LinkTarget.AccessStateUnitMonitor" Accessibility="Public" Enabled="false" Target="Microsoft.Windows.FileServer.DFSN.Library.LinkTarget" ParentMonitorID="Health!System.Health.AvailabilityState" Remotable="true" Priority="Normal" RunAs="Microsoft.Windows.FileServer.DFSN.DFSTargetAccessAccount" TypeID="Microsoft.Windows.FileServer.DFSN.Library.LinTargetAvailabilityUnitMonitorType" ConfirmDelivery="true">
<Category>Custom</Category>
<OperationalStates>
<OperationalState ID="UIGeneratedOpStateIdd1d8fd78aaae45eba1edc3c98ef2556c" MonitorTypeStateID="Accessible" HealthState="Success"/>
<OperationalState ID="UIGeneratedOpStateIdf83c5987637544e2a1e8d8d1ce344c00" MonitorTypeStateID="NotAccessible" HealthState="Error"/>
</OperationalStates>
<Configuration>
<IntervalSeconds>18000</IntervalSeconds>
<SyncTime/>
<TargetPath>$Target/Property[Type="Microsoft.Windows.FileServer.DFSN.Library.LinkTarget"]/TargetPath$</TargetPath>
<TimeoutSeconds>300</TimeoutSeconds>
</Configuration>
</UnitMonitor>