Debugging Script for WSS Agent on Mac Systems
WSS Agent
on Mac SystemsFor Mac systems,
Symantec
provides a shell script (wssad-diag.sh
) that gathers debugging, troubleshooting, and trace log information that Technical Support can analyze to assist you in remedying connection issues.This section describes how to run the script. Most issues can be traced and gathered without requiring a reboot. However, debugging
WSS Agent
startup process issues requires additional advanced debug logging steps, as outlined in the procedure.Technical Requirements
- Download the script zip file—Version 1.13.WSSA-macOS-Diags [right-click]
- Put the script on the test system. You can run the script from any location on the local system. The process does not install anything.
Startup/Reboot Diagnostic Issues Only
—If you are diagnosing WSS Agent
startup connection issues, launch the application using the --reboot
command line option. When prompted, save your work and reboot. After you are finished, reboot again to fully stop the debug log. If you use the
--reboot
command line option or the WSS Agent
is version 6.0.9+,Steps 5
and8
in the following procedure are not required.Procedure
- OpenTerminal.appandcdto the directory where you saved thewssad-diag.shscript.
- Runchmod +x wssa-diag.shto make the script executable.
- Run./wssa-diag.sh.
- Optionally, you can pass a/path/to/output.wdbzto specify the output file name. The default file name is derived from your hostname and the time.
- Enter your administrator (sudo) password.
- Skip this step if you are diagnosingStartup/Reboot Issues.When prompted, begin the tracing.
- InWSS Agent, click thePlayicon in the bottom-right corner of theSupporttab.
- InUnified Agent, clickStart Tracingon theAdvancedtab.
- Debug logging/tracing is now active. Perform the steps to reproduce theWSS Agentissue.You must leave the terminal window open until you have fully reproduced the issue.After you reproduce the issue, press Enter in yourTerminal.appwindow to stop tracing and begin gathering additional information
- If you have selected to capture a sysdiagnose (using the--sysdiagcommand line option), the script uses the Apple-providedsysdiagnoseutility to gather system information. According to thesysdiagnoseman page, the script collects the following information:
- A spindump of the system
- Several seconds offs_usageoutput
- Several seconds of top output
- Data about kernel zones
- Status of loaded kernel extensions
- Resident memory usage of user processes
- Recent system logs
- A System Profiler report
- Recent crash reports
- Disk usage information.
- I/O Kit registry information
- Network status
Read the displayed license. Press<enter>to continue gathering information. - Skip this step if you are diagnosingStartup/Reboot Issues.Stop tracing in theWSS Agent.
- Send the.wdbzfile to Symantec Support.
If debugging start up issues—After troubleshooting is complete, clear the
Enable tracing on startup
option in the WSS Agent
and reboot the Mac system again.