mod_net_trace

mod_net_trace is a diagnostic module to trace the data which flows between the web server and the network.

Supported server versions:

The following versions on platforms other than Windows:
  • 1.3.19.x: 1.3.19.6 with cumulative e-fix PQ87084 or PQ90262
  • 1.3.26.x: 1.3.26.2 with cumulative e-fix PQ87084, PQ90262, PK05084, PK16139, or later
  • 1.3.28.1

    (Note: The version of this module for IHS 2.0 and above is described here.)

    IBM recommendation

    Enable this module only when gathering information for a suspected IHS or application problem related to the data which is sent between the web server and the client.

    Installation

    Copy mod_net_trace.so for your platform to the libexec directory in the web server installation location (e.g., to /opt/IBMHTTPServer/libexec).

    Activation

    Add the following directives to the end of httpd.conf, replacing 111.222.333.444 with the IP address of the client that will recreate the problem.

    LoadModule net_trace_module libexec/mod_net_trace.so
    <IfModule mod_net_trace.c>
    NetTraceFile /tmp/nettrace
    NetTrace client 111.222.333.444 event senddata=100000 event recvdata=100000
    (entire NetTrace directive on one line)
    </IfModule>
    

    If more than 100,000 bytes of sent or received data needs to be collected, adjust the senddata and recvdata parameters as necessary.

    If you want to trace all clients, specify client * instead of client IP-address on the NetTrace directive.

    If you specify a particular client to be traced but nothing is logged when that client communicates with the web server, the likely cause is that the web server sees a different IP address for the client. Check the access log for the IP address seen by the web server for that client.

    Deactivation

    Comment out the LoadModule directive for mod_net_trace.