TROUBLESHOOTING: Run BES Client Diagnostics (Linux/UNIX/Mac)
Log In or Register to download the BES file, and more.

0 Votes

Description

The BES Client Diagnostics task will create an archive of useful information for analyzing a BES deployment and troubleshooting client issues.

This task allows you to run the BES Client Diagnostics 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-40MB 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 (Non-Windows)" 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 40 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 20 MB.


Property Details

ID231
TitleTROUBLESHOOTING: Run BES Client Diagnostics (Linux/UNIX/Mac)
CategoryTroubleshooting
Download Size0
SourceBigFix
Source ID<Unspecified>
Source Severity<Unspecified>
KeywordsBES Client Diagnostics Note TROUBLESHOOTING
Added by on 10/17/2012 1:14:36 PM
Last Modified by on 10/17/2012 1:14:36 PM
Counters 7297 Views / 6 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 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 2 fixlets   * Results in a true/false
Show indented relevance
not ((if (version of client >= "8.0") then (windows of it) else (name of it starts with "Win")) of operating system)
Used in 2 fixlets   * Results in a true/false
Show indented relevance
(if exists property "android" of type "operating system" then (not android of operating system) else true)

Actions

Action 1

Action Link Click here to run the BES Client Diagnostics tool and upload the results.
Script Type BigFix Action Script
// Remove previous runs client diagnostics if found
delete "{(preceding text of last "/" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
delete "{(preceding text of last "/BESClient" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
delete "{(preceding text of last "/" of (client folder of current site as string)) & "/__Global/Archive/Last/client_0_ClientDiagnostics_" & computer name & ".tar.gz"}"
delete "{(preceding text of last "/" of (client folder of current site as string)) & "/__Global/Archive/Last/client_1_ClientDiagnostics_" & computer name & ".tar.gz"}"
delete "{(client folder of current site as string) & "/Exclude.txt"}"
delete "{(client folder of current site as string) & "/__appendfile"}"
appendfile #!/bin/sh
if {name of operating system starts with "Mac"}
appendfile tar -czf "{(preceding text of last "/" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}" --exclude='*.tar.gz' "{preceding text of last "__BESData" of (client folder of current site as string)}" /Library/Preferences/com.bigfix.BESAgent.plist
elseif {name of operating system starts with "HP-UX"}
appendfile tar cf - "{preceding text of last "__BESData" of (client folder of current site as string)}" | "/usr/contrib/bin/gzip" -c > "{(preceding text of last "/BESClient" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
else
appendfile cat "{(preceding text of last "/" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}" >> "{(client folder of current site as string) & "/Exclude.txt"}"
appendfile cat "{(preceding text of last "/" of (client folder of current site as string)) & "/__Global/Archive/Last/client_0_ClientDiagnostics_" & computer name & ".tar.gz"}" >> "{(client folder of current site as string) & "/Exclude.txt"}"
appendfile cat "{(client folder of current site as string) & "/Exclude.txt"}" >> "{(client folder of current site as string) & "/Exclude.txt"}"
if {name of operating system starts with "SunOS 5.7"}
appendfile tar cfX - "{(client folder of current site as string) & "/Exclude.txt"}" "{preceding text of last "/__BESData" of (client folder of current site as string)}" | "/usr/local/bin/gzip" -c > "{(preceding text of last "/BESClient" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
else
appendfile tar cfX - "{(client folder of current site as string) & "/Exclude.txt"}" "{preceding text of last "__BESData" of (client folder of current site as string)}" | gzip -c > "{(preceding text of last "/BESClient" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
endif
endif
wait chmod +x "{(client folder of current site as string) & "/__appendfile"}"
wait "{(client folder of current site as string) & "/__appendfile"}"
if {name of operating system does not start with "Mac"}
move "{(preceding text of last "/BESClient" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}" "{(preceding text of last "/" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}"
endif
// set max size to 41943040 to prevent too much data. If the zip file is to bigger than 40MBs the upload won't occur
setting "_BESClient_ArchiveManager_MaxArchiveSize"="41943040" 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"="{(preceding text of last "/" of (client folder of current site as string)) & "/ClientDiagnostics_" & computer name & ".tar.gz"}" 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 2

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
    

Sharing

Social Media:
Share this page on Yammer

Comments

Log In or Register to leave comments!