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 + e-fix PQ87084 or PQ90262, or any subsequent PTF
  • 1.3.26.x: 1.3.26.2 + e-fix PQ87084 or PQ90262 or PK05084, or any subsequent PTF
  • 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 directive after existing LoadModule directives:

    LoadModule net_trace_module libexec/mod_net_trace.so
    

    Add the following directive after existing AddModule directives:

    AddModule mod_net_trace.c
    

    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.

    <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, omit the client IP-address parameter from 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 and AddModule directives for mod_net_trace.