Log Files

The PowerMedia WMS produces several log files.

To view or download log files generated by the PowerMedia WMS, select Logs>Log Files. The Log Files page displays the available log files and the date/time they were last modified. For a list and description of log files, see Checking Log Files.

Downloading a Log File

To download a file from the Log Files page:

Select Logs>Log Files from the Web UI.
Click the checkbox for each file you want to download.
Click DOWNLOAD at the top of the page. The selected files are compressed into a ZIP file and the File Download dialog appears with the name of the ZIP file.
Select the preferred action from the File Download dialog:

Open – Displays a window to enable you to manipulate the log files.
Save – Displays a window to enable you to select a location to save the log file.

Viewing a Log File

To view a log file from the Log Files page:

Select Logs>Log Files from the Web UI.
Click the VIEW button for the file you want to view. The log file is displayed.

Viewing an Audit Log File

To view an audit log from the Log Files page:

Select Logs>Log Files from the Web UI.
Click the VIEW button for audit.log file. This file has a special table view.
To view the details of an entry, click the DETAIL button for that entry.
To search for a particular word or character string, use the browser Find command.

Core Files

To download core files generated by the PowerMedia WMS, select Logs>Core Files. Core files appear in this view when a failure has occurred. The core files contain a memory image of the terminated process. These files are useful in debugging.

Trace Files

To download trace files generated by the PowerMedia WMS, select Logs>Trace Files. This page lists the output files from the trace feature on the PowerMedia WMS (Networks > Utilities > Trace). These files can be opened using network analyzer software.

Configure Logs

The log system is controlled by a set of parameters you configure from the Logs>Configure menu.

Note: Only Administrators can configure the log system.

Log Rotation

The Log Rotation section of the Configure Logs page enables you to configure parameters related to log rotation intervals, size, and maximum rotation.

Note: If you change the log rotation values from the defaults, do not exceed file sizes of 2GB or available disk storage space.

Parameter	Values	Description
Rotation Interval	Monthly Weekly Daily Hourly 30 minutes 15 minutes (Default: Hourly)	Interval at which the log files are checked for rotation. The interval can be: Monthly (at 4:42 AM, the first day of the month) Weekly (at 4:22 AM, first day of the week) Daily (at 4:02 AM) Hourly (at the top of the hour) 30 minutes 15 minutes
Rotation Size	integer: 1–250,000 (Default: 250)	Minimum size (in kilobytes) that a log file must be to be rotated at the next rotation interval. Note: Logs are rotated based on their size when they are checked. If you want the logs to be rotated at the interval chosen, make the rotation size small. Caution: Specifying a large rotation size creates very large log files which take longer to view and download. For maximum system efficiency, set rotation sizes to less than 50,000 KB.
Max Rotations	integer: 1–240 (Default: 10)	Number of rotations allowed for each log file. This determines how many log files are kept on the system before they are deleted.

Log Level

The Log Level section of the Configure Logs page enables you to configure the level of detail to be included in each log. Select the level of detail to record for each log from the drop-down list.

Level	Log Contents
Debug	All messages associated with a process. A log event that denotes information that is only required for component-level debugging.
Info	Informative messages regarding a process.
Warning	All warning messages about normal events associated with a process.
Error	All errors encountered by a process.
Critical	All critical messages generated by a process.
Fatal	Fatal messages associated with a process that denote an error condition that should never happen and that results in the loss of functionality.
None	No information is logged.

Syslog Destination

The Syslog Destination section of the Configure Logs page determines where syslog information will be saved.

Parameter	Description
Log Locally	Logs the syslog information to the message.log file on the PowerMedia WMS.
Log Remotely	Logs the syslog information to a remote system. Enter the IP address of the remote system in the Remote IP Address field.

Generate Accounting Logs

In the Generate Accounting Logs section of the Configure Logs page, the Create button creates the accounting.log and the msaccounting.log files.

The accounting.log is the clear xml formatted ascii text file that stores the PowerMedia WMS’s Accounting Statistics over time.

The msaccounting.log is the encrypted xml formatted Log file used for debug purposes.

Note: When you upgrade to a new version of PowerMedia WMS, accounting data is removed from your system. If you want to save the accounting data, you can generate accounting logs from the Configure Logs page before upgrading. Select Logs>Configure and click Create next to Accounting Logs.

Gather System Information

In the Gather System Information section of the Configure Logs page, the Create button creates the System Configuration Log for the current system. This information includes system and PowerMedia WMS configuration information. Once you click Create, the log file is generated and the Web page is redirected to the log files page. This new log file can be downloaded to aid in debugging software issues.

Log Naming Convention

Logs are configured to rotate based on a size parameter that is set in the Logs>Configure command.

The convention for naming log files is <log file name>.log.n where n is changed every time a new log file is started. The current log file being used does not have an n extension.