Technical Support might request debug level log files when troubleshooting an issue:
- Default logging has a value of 1
- Debug level logging requires a value of 2
Debug logging produces more log entries about all MA activity, regardless of whether there is an error. Debug logging provides all communication details needed to troubleshoot common issues such as communication failures, updating failures, and policy management issues.
Guidance for enabling debug logging on non-Windows
- It is important to enable debug logging before you try to reproduce a problem. Enabling debug logging for an issue that can't be reproduced does not provide adequate information for troubleshooting.
- If client and server issues are being investigated, you must enable debug logging on the client, and log level 8 on the ePO server, before you try to reproduce the problem. These actions are needed to successfully capture the additional logging that is needed to help investigate the issue.
- The software IDs for MA for non-Windows are platform-specific.
McAfee Agent 5.x
Log levels are set using the
maconfig command.
Maconfig is located in one of the following places:
| Non-Windows platform |
Fixed path to maconfig |
| Linux |
/opt/McAfee/agent/bin/ |
| macOS |
/Library/McAfee/agent/bin/ |
To enable debug on agents 5.x, run maconfig with the following command:
maconfig -enforce -loglevel XX
Where
XX is the needed log level
The log levels correspond to the following:
| Info |
1 |
Info message mostly localized. |
| Debug |
2 |
Debug logs for all components. |
| Detail |
3 |
Extra trace logs for some components. |
Example command:
maconfig -enforce -loglevel 2
- Restart the McAfee Agent process (needed to enable debug logging on non-Windows):
- For AIX and HP-UX agents, type the following command and press Enter:
/sbin/init.d/cma restart
- For Linux and Solaris agents, type the following command and press Enter:
/etc/init.d/cma restart
- For Mac agents, type the following command and press Enter:
SystemStarter restart cma
- Fully replicate the issue and capture information to the logs.
- Reset the logging level.
IMPORTANT: Follow the procedure in Step 1 and reset the logging level back to 1 after you have successfully replicated the issue and collected the logs. This reset avoids the generation of excessively large log files.
