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:

(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.