User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 361
Dialogic Corporation
CAS, R2MF, tone-on and tone-off has been added. For more information about this
feature, see Section 1.23, “PDK Trace Supports CAS/R2MF/Tone Tracing”, on page
86.
Update to Chapter 26, PSTN Diagnostics Tool Reference
An enhanced version of the PSTN Diagnostics Tool (pstndiag) is provided in the
Service Update. The previous version of the tool is still supported. For information
about the new version, see Section 1.21.1, “PSTN Diagnostics (pstndiag)”, on page
81 of this Release Update.
Update to Chapter 28, Runtime Trace Facility (RTF) Reference (IPY00037518)
The following information about using binary log files should be added to Section
28.3.2, Logfile Tag:
For installations with high channel densities, or which have enabled all or most RTF
trace levels, the volume of logging may result in an increased CPU utilization by the
RtfServer executable as a result of the increased volume of log messages.
As shipped, the RTF log files are generated in ASCII text mode. There is a
configuration parameter in the RTF configuration file (RtfConfigWin.xml for Windows
®
,
RtfConfigLinux.xml for Linux) that allows log files to be generated in either “text” or
“binary” format. Testing on high channel density systems with most or all of the RTF
trace levels enabled has shown that the generation of binary format RTF log files has
less of an impact on CPU usage than does the generation of text format RTF log files.
If the volume of logging results in high CPU usage, then using binary format will
reduce the usage.
Enabling Binary Format RTF Log Files
The XML file contains the following line, which allows changes to log file parameters
to be made:
<Logfile path="$(INTEL_DIALOGIC_DIR)\log" size="300" maxbackups="10"
preserve_size="300" preserve_maxbackups="10"
duplicate_to_debug_console="0" log_format="text" />
The “log_format” value controls the type of log files that are written. Valid values for
this parameter are “text” and “binary”. Once a change has been made to the XML file,
it must be reloaded using the rtftool reload command.
Converting Binary Format RTF Log Files to Text Format
In order for binary log files to be examined, they must be converted into text format.
This can be done by using the rtftool export command.
rtftool export [-d source_dir | -s source_file]
[-f [dest_file] | -m dest_dir]
By default, the name of the text format files generated by this command will be
EXPORT-<RTF binary log file name>. For example, if the binary format file is named
rtflog-LOCAL-20070306-15h09m26.506s.txt, then the default name of the generated
text format file will be EXPORT-rtflog-LOCAL-20070306-15h09m26.506s.txt. This
behavior can be overridden using the -f command line option.