Specifications

160 System Software Diagnostics Guide — September 2006
Runtime Trace Facility (RTF) Reference
The dtintf module is configured to trace “Entry” (from the global section). “dxxxB1C2” in dtintf is
configured to trace “Entry” (from the global section) and “Exit” (from the global client). The other
client “dxxxB2C1” is configured to trace “Entry” (from the global configuration) and “EXCE”
(from the module client section). All other clients of this module are configured to trace “Entry”
(from the global section) since these labels are configured for the module.
28.7 Configuring Remote RTF Logging
This section contains the following information:
• Introduction
• Configuring the Client System
• Configuring the Server System
• Cautions
• Disabling Remote Logging
28.7.1 Introduction
RTF servers can be configured to communicate with each other. This provides remote tracing
capability. A trace produced on one machine can be re-directed and stored on another machine on
the network. This section describes how to configure remote RTF logging.
The terminology used to describe remote RTF logging is as follows:
Client (remote) system
A system that contains System Release software and telephony boards and is running the end-
user telephony application.
Server (management/help desk system)
A system that contains the System Release software and will be used to collect RTF logs from
one or more client systems.
28.7.2 Configuring the Client System
To configure the client system, edit the RTF configuration file (RtfConfigLinux.xml for Linux and
RtfConfigWin.xml for Windows) as follows:
1. Locate the line containing the tag
Network mode= and set it's value to "client".
2. Locate the line containing the tag
server_name= and set its value to either the fully-qualified
domain name or IP address of the server system.
3. Optionally, you may change the TCP port used by locating the line containing
Client
port_number=
and changing its value to the port number you wish to use. Note that you must
make a corresponding change on the server system (see Configuring the Server System).
4. If the System Release has not yet been started, run
dlstart. Otherwise, cause the RTF
program to reload the updated configuration file by running
rtftool reload.
Figure 20 shows a portion of a sample RTF configuration file edited to configure the client system.