BBDcDiags
Author | Graeme Shea |
---|---|
Compatibility | Xymon 4.2 |
Requirements | dcdiags and netdiags from the windows support tools and a Xymon client |
Download | None |
Last Update | 2008-08-26 |
Description
Runs the support tools dcdiags.exe and netdiags.exe and reports the results to Big Brother or Xymon. These two tests are the basic tests to confirm the correct operation of Active Directory.
Installation
Client side
Save the script, dcdiags.exe and netdiags.exe into the same folder. Add a sceduled task to run the script as required at your site (once a day?).
Several errors have been hardcoded to be ignored. You may need to comment these out.
Server side
none
Source
Monitor Code
Show Code ⇲
Hide Code ⇱
Option Explicit '****************************************************************************************************** ' Run DcDiag and NetDiag. Report result of tests to Big Brother. ' save copy of output to current folder to help diagnose any errors. ' 17/08/06 Graeme Shea ' Added ignor of dc link test. 05/09/06 Graeme Shea ' Fixed capialisation problem with ignore of dc link test. 07/09/06 Graeme Shea ' V1.3 Added ignore of concerrent error msg with error of dc link test. 14/09/06 Graeme Shea ' V1.4 Added ignore of WAN test. 1/10/06 Graeme Shea ' V1.4.1 Added ignore of FRS events from previous 24hrs. 3/12/06 Graeme Shea ' V1.4.2 Added ignore of a syslog event from previous 24hrs. 20/02 Graeme Shea ' V1.5.0 BBWin compatable. 01/05/08 Graeme Shea '******************************************************************************************************* Dim oShell,oFile,FSO,ExtPath, szResult, szOutPut, szDelay, b64Bit Const Version = "1.4.2" Set FSO= CreateObject("Scripting.FileSystemObject") Set oShell = WScript.CreateObject("WScript.Shell") szDelay = "+27h" 'Sets the PURPLEDELAY for this service check - change to match frequency of defrag szOutput = "" ' Retrieve path to big brother log files ExtPath = GetBigBrotherPath on Error GoTo 0 szResult = runoutput("cmd /C dcdiag.exe",1, "DcDiag.txt") szResult = lCase(szResult) if instr(szResult, "failed test frsevent")>0 Then 'If the FRS is not working now will still raise error. I'm not very concerned ' if there was an error of some sort in the last 24hrs. szResult = Replace (szResult, "failed test frsevent", " ") szResult = Replace (szResult, "failing sysvol replication", " ") szOutPut = szOutPut & vbcrlf & "&yellow FRS Event Ignored. " 'MsgBox "in fail system log" end If if instr(szResult, "failed test systemlog")>0 Then 'If there are errors in the system log you have allready been advised ' no need to have a red dot for the whole day. szResult = Replace (szResult, "failed test systemlog", " ") szOutPut = szOutPut & vbcrlf & "&yellow System Log Error Ignored. " 'MsgBox "in fail system log" if instr(szResult, "browser service has failed to retrieve the")>0 Then 'MsgBox "The browser service has failed to retrieve the" szResult = replace (szResult, " failed to retrieve the", " ") szOutPut = szOutPut & vbcrlf & "&yellow Browser Error Ignored. " end If if instr(szResult, "service failed to see a directory server")>0 Then 'MsgBox "The browser service has failed to retrieve the" szResult = replace (szResult, "service failed to see a directory server", " ") szResult = replace (szResult, "service failed to see a directory server", " ") 'Error often in pairs szOutPut = szOutPut & vbcrlf & "&yellow Syslog reported a service couldnt see the directory server. " end If end If ' msgbox "szOutput = " & szOutPut if instr(szResult, "fail") > 0 Then szOutPut = szOutPut & VbCrLf & "&red DcDiag test failed. " & VbCrLf & VbCrLf else szOutPut = szOutPut & VbCrLf & "&green DcDiag test passed. " & VbCrLf & VbCrLf end If szResult = runoutput("cmd /C netdiag.exe",1, "NetDiag.txt") szResult = lCase(szResult) if instr(szResult, "default gateway test . . . : failed")>0 then 'VicSmart Routers allways seem to fail gateway test so ignore szResult = replace (szResult, "default gateway test . . . : failed", " ") szResult = replace (szResult, "default gateway test . . . . . . . : failed", " ") szOutPut = szOutPut & vbcrlf & "&yellow NetDiag Default Gateway Test Failure Ignored. " & VbCrLf end If if instr(szResult, "domain membership test . . . . . . : failed")>0 Then 'When the Big Brother client is running under the system account it cannot access ' the network to check domain membership. If you run under another account you ' can comment this section out (I think) szResult = replace (szResult, "domain membership test . . . . . . : failed", " ") szOutPut = szOutPut & vbcrlf & "&yellow NetDiag Domain Membership Test Failure Ignored. " & vbcrlf end If if instr(szResult, "dc list test . . . . . . . . . . . : failed")>0 Then 'When the Big Brother client is running under the system account it cannot access ' the network to check domain membership. If you run under another account you ' can comment this section out (I think) szResult = replace (szResult, "dc list test . . . . . . . . . . . : failed", " ") ' This is an error message that occurs concurrntly and causes false detection of error szResult = replace (szResult, "failed to enumerate dcs by using the browser.", " ") szOutPut = szOutPut & VbCrLf & "&yellow NetDiag DC list test Test Failure Ignored. " & VbCrLf end If if instr(szResult, "wan configuration test . . . . . . : failed")>0 Then szResult = replace (szResult, "wan configuration test . . . . . . : failed", " ") szOutPut = szOutPut & VbCrLf & "&yellow NetDiag WAN configuration Test Failure Ignored. " & VbCrLf end If if instr(szResult, "fail")> 0 Then szOutPut = szOutPut & "&red NetDiag test failed. " & VbCrLf else szOutPut = szOutPut & "&green NetDiag test passed. " & vbcrlf end If if instr(szOutPut, "fail")>0 then szOutPut = "red" & szDelay & " " & now & vbcrlf & vbcrlf & szOutPut else szOutPut = "green" & szDelay & " " &Now & vbcrlf & vbcrlf & szOutPut end if Set oFile = FSO.OpenTextFile(ExtPath &"\dcdiags", 2, True) oFile.write(szOutput) oFile.WriteBlankLines(2) oFile.WriteLine "DCDiags Check, BBDCDiags.vbs Version " & Version oFile.close Function RunOutput( cProgram, nWindowType, szTempFileName ) ' Run a program and save results to szTempFileName ' Got this routing of the net somewhere. Apologies to the orginal author Dim oFS Set oFS = CreateObject("Scripting.FileSystemObject") Dim oShell Set oShell = CreateObject( "WScript.Shell" ) oShell.Run cProgram & " > " & szTempFileName, nWindowType, True Dim oFile Set oFile = oFS.OpenTextFile(szTempFileName, 1, True) RunOutput = oFile.ReadAll() oFile.Close Set oShell = Nothing End Function function Convert2Text(sTemp) ' Converts non printable characters to " " , so that Textfile is working dim loopcount, tempwert, inttest tempwert="" for loopcount = 1 to len(sTemp) ' replace all unprintable characters maybe easier and faster with RegEx inttest = ascw(mid(sTemp,loopcount,1)) 'if ((inttest>=32) and (inttest<127)) or (inttest=10) or (inttest=13) or (inttest=9) then if ((inttest>=32) and (inttest<127)) then tempwert = tempwert & chr(inttest) ' printable Character or CR LF TAB else tempwert = tempwert & " " end if 'tempwert = tempwert & chr(ascb(mid(sTemp,loopcount,1))) next Convert2Text = tempwert end function ' Get path to external log files (for BB 1.08d) Function GetBigBrotherPath() Dim ExtPath On Error Resume Next ExtPath = oShell.RegRead("HKLM\SOFTWARE\Quest Software\BigBrother\bbnt\ExternalPath\") If IsEmpty(ExtPath) Then ExtPath = oShell.RegRead("HKLM\SOFTWARE\BBWin\tmppath") End If If Not IsEmpty (ExtPath) Then 'If not empty then we have 32bit machine b64Bit = False End If If IsEmpty(ExtPath) Then ExtPath = oShell.RegRead("HKLM\SOFTWARE\Wow6432node\Quest Software\BigBrother\bbnt\ExternalPath\") End If If IsEmpty(ExtPath) Then ExtPath = oShell.RegRead("HKLM\SOFTWARE\Wow6432node\BBWin\tmppath") End If If Not IsEmpty(ExtPath) And isEmpty(b64Bit) Then b64Bit = True err.clear End If If IsEmpty(ExtPath) Then 'Put exit stuff here End If on Error GoTo 0 GetBigBrotherPath = ExtPath End Function
Known Bugs and Issues
To Do
Credits
Changelog
- 2008-08-26
- Initial release