Specifications

System Software Diagnostics Guide — September 2006 161
Runtime Trace Facility (RTF) Reference
Figure 20. RTF Configuration File Edited to Configure the Client System
28.7.3 Configuring the Server System
To configure the server 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 its value to "server". The value
of
server_name= must be 127.0.0.1.
2. Optionally, you may change the TCP port used by locating the line containing
Server
port_number=
and changing its value to the port number you wish to use. Note that you must
make a corresponding change on the client system(s) (see Configuring the Client System).
3. 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 21 shows a portion of a sample RTF configuration file edited to configure the server system.
Figure 21. RTF Configuration File Edited to Configure the Server System
28.7.4 Cautions
Following are some cautions to keep in mind when configuring remote RTF logging:
1. If the value of the
server_name field is a hostname, the name must be resolvable either via
DNS query or via
/etc/hosts. Failure of hostname resolution will prevent remote logging
from occurring.
2. Depending on the level of RTF logging enabled, application or network performance may be
impacted. The impact may be more significant if VoIP technology is being used.
3. Having multiple client systems log to a central server is possible by setting the
max_connection= parameter in the server's RTF configuration file, but this capability should
be used with caution.