TROUBLESHOOTING: Run BES Client Diagnostics
Log In or Register to download the BES file, and more.

0 Votes

Description

The BES Client Diagnostics tool is a small command line utility that gathers various statistics and files from BES Clients for analysis. The information provided by the tool is useful in analyzing a BES deployment and troubleshooting client issues.

This task allows you to run the BES Client Diagnostics tool and upload the results to the BES Server through the BES Upload Manager. By default the uploaded files will be placed in a subfolder under "C:\Program Files\BigFix Enterprise\BES Server\UploadManagerData\BufferDir\sha1" on the BES Server.

Each BES Client targeted will upload approximately 1-10MB of data to the BES Server (through the BES Relays). Depending on network speeds, this could take several minutes.

Note: Do not set the "Reapply" behavior when taking this action or you may cause the BES Client to constantly run the diagnostics tool and upload the results.

Note: After execution this action, the "TROUBLESHOOTING: Run BES Client Diagnostics Cleanup" task can be used to remove the diagnostics result files.

Note: If the size of the resulting zip file generated by the tool is larger than 10 MB, it will not be uploaded to the BES Server. The action script can be modified to set a higher limit. Most results are under 5 MB.

File Size:

2.94 MB

Property Details

ID565
TitleTROUBLESHOOTING: Run BES Client Diagnostics
CategoryTroubleshooting
Download Size2941015
SourceBigFix
Source ID<Unspecified>
Source Severity<Unspecified>
KeywordsBES Client Diagnostics Note TROUBLESHOOTING
Added by on 10/17/2012 1:16:13 PM
Last Modified by on 10/17/2012 1:16:13 PM
Counters 7242 Views / 15 Downloads
User Rating 1 star 2 star 3 star 4 star 5 star * Average over 0 ratings. ** Log In or Register to add your rating.

Relevance

Used in 93 fixlets and 2 analyses   * Results in a true/false
Show indented relevance
version of client >= "6.0"
Used in 7 fixlets   * Results in a true/false
Show indented relevance
major version of operating system >= 5
Used in 221 fixlets   * Results in a true/false
Show indented relevance
(if exists property "in proxy agent context" then ( not in proxy agent context ) else true )
Used in 92 fixlets and 24 analyses   * Results in a true/false
Show indented relevance
version of client >= "5.1"
Used in 24 fixlets   * Results in a true/false
Show indented relevance
((if (version of client >= "8.0") then (windows of it) else (name of it starts with "Win")) AND platform id of it != 3) of operating system

Actions

Action 1

Action Link Click here for more information on the BES Upload Manager. (PDF file)
Script Type URL
http://support.bigfix.com/product/documents/UploadManager_4_1.pdf
    

Action 2

Action Link Click here to run the BES Client Diagnostics tool and upload the results.
Script Type BigFix Action Script
//Delete previous files
delete __appendfile
delete rmdir.bat
appendfile @ECHO OFF
appendfile rmdir /s /q "{ pathname of client folder of current site }\__besdiag\" > NUL 2> NUL
move __appendfile rmdir.bat
wait "{pathname of client folder of current site & "\RunQuiet.exe"}" rmdir.bat
//Download and run the Silent Diagnostics
prefetch BESClientDiagnostics.exe sha1:e7d8bd7f665eb3d7a083126d5ab642150f1d79fe size:2703447 http://software.bigfix.com/download/bes/util/BESClientDiagnostics-3.0.2.9.exe
prefetch SiteDataReader.exe sha1:8893e02d001c3a55aa45a1c7b2d458bf7f9d7f8f size:354816 http://software.bigfix.com/download/bes/util/SiteDataReader-8.0.475.0.exe
prefetch ParseRelaysDotDat.exe sha1:09406da1a69524af33937339b4ea8c071ccd99e3 size:320512 http://software.bigfix.com/download/bes/util/ParseRelaysDotDat.exe
delete __appendfile
delete client.bat
appendfile @ECHO OFF
appendfile start ""/min /b /wait "{pathname of client folder of current site & "\__Download\BESClientDiagnostics.exe"}" -o __besdiag > NUL 2> NUL
move __appendfile client.bat
wait {pathname of client folder of current site & "\RunQuiet.exe"} client.bat
// set max size to 20971520 to prevent too much data. If the zip file is to bigger than 20MBs the upload won't occur
setting "_BESClient_ArchiveManager_MaxArchiveSize"="10971520" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_OperatingMode"="2" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_FileSet-client"="{pathname of client folder of current site & "\__besdiag\*.*"}" on "{parameter "action issue date" of action}" for client
// send results
archive now
Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 3

Action Link Click here to run the BES Client Diagnostics tool with the relay selection test and upload the results.
Script Type BigFix Action Script
//Delete previous files
delete __appendfile
delete rmdir.bat
appendfile @ECHO OFF
appendfile rmdir /s /q "{ pathname of client folder of current site }\__besdiag\" > NUL 2> NUL
move __appendfile rmdir.bat
wait "{pathname of client folder of current site & "\RunQuiet.exe"}" rmdir.bat
//Download and run the Silent Diagnostics
prefetch BESClientDiagnostics.exe sha1:e7d8bd7f665eb3d7a083126d5ab642150f1d79fe size:2703447 http://software.bigfix.com/download/bes/util/BESClientDiagnostics-3.0.2.9.exe
prefetch SiteDataReader.exe sha1:8893e02d001c3a55aa45a1c7b2d458bf7f9d7f8f size:354816 http://software.bigfix.com/download/bes/util/SiteDataReader-8.0.475.0.exe
prefetch ParseRelaysDotDat.exe sha1:09406da1a69524af33937339b4ea8c071ccd99e3 size:320512 http://software.bigfix.com/download/bes/util/ParseRelaysDotDat.exe
delete __appendfile
delete client.bat
appendfile @ECHO OFF
appendfile start ""/min /b /wait "{pathname of client folder of current site & "\__Download\BESClientDiagnostics.exe"}" -o __besdiag -r > NUL 2> NUL
move __appendfile client.bat
wait {pathname of client folder of current site & "\RunQuiet.exe"} client.bat
// set max size to 20971520 to prevent too much data. If the zip file is to bigger than 20MBs the upload won't occur
setting "_BESClient_ArchiveManager_MaxArchiveSize"="10971520" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_OperatingMode"="2" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_FileSet-client"="{pathname of client folder of current site & "\__besdiag\*.*"}" on "{parameter "action issue date" of action}" for client
// send results
archive now
Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 4

Action Link Click here to run the BES Client Diagnostics tool with the collect all site data option and upload the results.  The upload file will be larger, estimate 10-30 MB.
Script Type BigFix Action Script
//Delete previous files
delete __appendfile
delete rmdir.bat
appendfile @ECHO OFF
appendfile rmdir /s /q "{ pathname of client folder of current site }\__besdiag\" > NUL 2> NUL
move __appendfile rmdir.bat
wait "{pathname of client folder of current site & "\RunQuiet.exe"}" rmdir.bat
//Download and run the Silent Diagnostics
prefetch BESClientDiagnostics.exe sha1:e7d8bd7f665eb3d7a083126d5ab642150f1d79fe size:2703447 http://software.bigfix.com/download/bes/util/BESClientDiagnostics-3.0.2.9.exe
prefetch SiteDataReader.exe sha1:8893e02d001c3a55aa45a1c7b2d458bf7f9d7f8f size:354816 http://software.bigfix.com/download/bes/util/SiteDataReader-8.0.475.0.exe
prefetch ParseRelaysDotDat.exe sha1:09406da1a69524af33937339b4ea8c071ccd99e3 size:320512 http://software.bigfix.com/download/bes/util/ParseRelaysDotDat.exe
delete __appendfile
delete client.bat
appendfile @ECHO OFF
appendfile start ""/min /b /wait "{pathname of client folder of current site & "\__Download\BESClientDiagnostics.exe"}" -o __besdiag -i > NUL 2> NUL
move __appendfile client.bat
wait {pathname of client folder of current site & "\RunQuiet.exe"} client.bat
// set max size to 20971520 to prevent too much data. If the zip file is to bigger than 20MBs the upload won't occur
setting "_BESClient_ArchiveManager_MaxArchiveSize"="43886080" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_OperatingMode"="2" on "{parameter "action issue date" of action}" for client
setting "_BESClient_ArchiveManager_FileSet-client"="{pathname of client folder of current site & "\__besdiag\*.*"}" on "{parameter "action issue date" of action}" for client
// send results
archive now
Success Criteria

This action will be considered successful when the applicability relevance evaluates to false.

Action 5

Action Link Click here for more information on the BES Client Diagnostics Tool.
Script Type URL
http://support.bigfix.com/bes/misc/diagnostics.html
    

Sharing

Social Media:
Share this page on Yammer

Comments

Log In or Register to leave comments!