beautypg.com

Polycom SOUNDPOINT SIP 2.2.0 User Manual

Page 103

background image

Troubleshooting Your SoundPoint IP / SoundStation IP Phones

5 - 5

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.

Application Logging Options

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