Spectralink 84-Series Series Wireless Telephones Administration Guide
1725-86984-000_P.docx
September 2016
276
Log Files
Spectralink handsets will log various events to files stored in the flash file system and will
periodically upload these log files to the provisioning server. The files are stored in the handset
’s
home directory or a user-configurable directory. You can also configure a handset to send log
messages to a syslog server.
There is one log file for the Updater and one for the Spectralink Software. When a handset
uploads its log files, they are saved on the provisioning server with the MAC address of the
handset prepended to the file name. For example,
00907a0e360b-boot.log
and
00907a0e360b-app.log
are the files associated with MAC address 00907a0e360b. The
Updater (boot) log file is uploaded to the provisioning 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
. The handset uploads four files, namely, <
mac>-boot.log
, <mac
>
-
app.log
,
mac-now-boot.log
, and
mac-now-app.log
. The
-now-
logs are uploaded manually
unless they are empty. Spectralink 84-Series handset use the 1, 5, and 9 dial pad keys to force
log file uploads.
The amount of logging that the handset performs can be tuned for the application to provide
more or less detail on specific components of the handset
’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 Configuration Utility. You should not
modify the default logging levels unless directed to by Spectralink Customer Support.
Inappropriate logging levels can cause performance issues on the handset.
In addition to logging events, the handset 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 Spectralink Customer Support.
Logging Options
Each of the components of the Spectralink Software is capable of logging events of different
severity. This allows you to capture lower severity events in one part of the application, and high
severity events for other components.
The parameters for log level settings are found in the log.cfg template. Log levels range from 0
to 6 (0 for the most detailed (Debug) logging, 6 for the least detailed (fatal errors only). There
are many different log types or categories that can be adjusted to assist with the investigation of
different problems.
When testing is complete, remember to remove the special troubleshooting configuration
parameters from the configuration files.
There are other logging parameters, described next, that you may wish to modify. Changing
these parameters will not have the same impact as changing the logging levels, but you should
still understand how your changes will affect the handset and the network.