Debugging Script for WSS Agent on Mac Systems
WSS Agenton Mac Systems
For Mac systems,
Symantecprovides 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 Agentstartup process issues requires additional advanced debug logging steps, as outlined in the procedure.
- 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 Agentstartup connection issues, launch the application using the
--rebootcommand 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
--rebootcommand line option or the
WSS Agentis version 6.0.9+,
8in the following procedure are not required.
- OpenTerminal.appandcdto the directory where you saved thewssad-diag.shscript.
- Runchmod +x wssa-diag.shto make the script executable.
- 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:
Read the displayed license. Press<enter>to continue gathering 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
- 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 startupoption in the
WSS Agentand reboot the Mac system again.