System information

152
Appendices
pma_discovery Windows %Windir%\Logs\pma_discovery.log
pma_problem_monitor Windows %Windir%\Logs\pma_problem_monitor.log
pma_report_tool
Windows
Mac OS X
%Windir%\Logs\pma_report_tool.log
/Users/<user_name>/Library/Logs
pma_agent Mac OS X /Library/Logs/pma_agent.log
pma_agent_ui Mac OS X /Library/Logs/pma_agent_ui.log
A log file is populated with data when an executable is running and performing its tasks. When the
size of a log file exceeds a predefined limit, the file is archived and a new empty log file is created in
its place. This creates a log file rotation set consisting of the current log file and archived files. A log
file rotation set is managed using the following rules:
• Log files are archived using the zlib compression library.
• The archived files in the set are named as follows:
<exec_name.1.log.gz>, <exec_name.2.log.gz>, <exec_name.3.log.gz>, etc.
The <exec_name.1.log.gz> file is the most recently archived log segment. The file with the
largest sequential number in its name is the oldest. When the current log file is archived, it is
named <exec_name.1.log.gz>. The existing archives are renamed by incrementing the
sequential number in their names by 1. The maximum number of files in a rotation set can be
configured (see Changing Log File Rotation Limits below). When the number of files exceeds
the predefined limit, the oldest file is deleted.
• Rotation of each log is performed independently from other logs.
Changing Log File Rotation Limits
Log file rotation limits are configured similarly on both Windows and Mac OS X computers. The
following rules apply when specifying the limits:
• Log file size limit. The default value is 1 MB (specified in bytes). The minimum allowed value is
200 KB. The maximum allowed value is 4 MB. If a value is not set, the default value is used. If
the specified value falls outside the min/max interval, the minimum or the maximum value is
used respectively.
• Maximum number of files in a rotation set. The default value is 10. The minimum value is 1.
The maximum value is 20. If a value is not set, the default value is used. If the specified value
falls outside the min/max interval, the minimum or the maximum value is used respectively.
On Windows computers the log rotation limits are stored in the system registry. To modify the
limits:
• Run "regedit" and search for HKEY_LOCAL_MACHINE\SOFTWARE\Parallels\Parallels
Management Suite for Microsoft SCCM\Preferences.
• To set the log file size limit, modify the value of the "LogFileSizeLimit" parameter. The size is
specified in bytes.