Application Logging Options

Troubleshooting Your SoundPoint IP / SoundStation IP Phones

MAC address 00f4f200360b. The bootROM log file is uploaded to the boot server after every reboot. The application log file is uploaded periodically or when the local copy reaches a predetermined size.

Both log files can be uploaded on demand using a multiple key combination described in Multiple Key Combinations on page C-9. The phone uploads four files, namely, mac-boot.log, app-boot.log, mac-now-boot.log, and mac-now-app.log. The “now_” logs are uploaded manually.

The amount of logging that the phone performs can be tuned for the application to provide more or less detail on specific components of the phone’s software. For example, if you are troubleshooting a SIP signaling issue, you are not likely interested in DSP events. Logging levels are adjusted in the configuration files or via the web interface. You should not modify the default logging levels unless directed to by Polycom Technical Support. Inappropriate logging levels can cause performance issues on the phone.

In addition to logging events, the phone can be configured to automatically execute command-line instructions at specified intervals that output run-time information such as memory utilization, task status, or network buffer contents to the log file. These techniques should only be used in consultation with Polycom Technical Support.

Each of the components of the application software is capable of logging events of different severity. This allows you to capture lower severity events in one part of the application, while still only getting high severity event for other components.

The parameters for log level settings are found in the sip.cfg configuration file. They are log.level.change.module_name. Log levels range from 1 to 6 (1 for the most detailed logging, 6 for critical errors only).

When testing is complete, remember to return all logging levels to the default value of 4.

There are other logging parameters that you may wish to modify. Changing these parameters does not have the same impact as changing the logging levels, but you should still understand how your changes will affect the phone and the network.

•log.render.level—Sets the lowest level that can be logged (default=1)

•log.render.file.size—Maximum size before log file is uploaded (default=16 kb)

•log.render.file.upload.period—Frequency of log uploads (default is 172800 seconds = 48 hours)

•log.render.file.upload.append—Controls if log files on the boot server are overwritten or appended, not supported by all servers

5 - 5