Using TCPMonitor

TCPMonitor is a swing-based application that lets you watch the request and response flow of HTTP traffic. You can also watch the request and response flow of SOAP traffic. TCPMonitor replaces the Sniffer service formerly used in JRun.

To run TCPMonitor:

  1. On Windows and Unix platforms, you can execute the TCPMonitor by launching the sniffer utility in the jrun_root/bin directory.

    The TCP Monitor main window appears:

    This image shows a screen capture of the TCPMonitor main page.

  2. Enter the values in the main window as described in the following table:
    Field
    Description
    Listen Port#
    Enter a local port number, such as 8123, to monitor for incoming connections. Instead of requesting the usual port on which your server runs, you request this port. TCPMonitor intercepts the request and forwards it to the Target Port.
    Listener
    Select Listener to use TCPMonitor as a sniffer service in JRun.
    Proxy
    Select Proxy to enable proxy support for TCPMonitor.
    Target Hostname
    Enter the target host to which incoming connections are forwarded.
    For example, if you are monitoring a service running on your samples JRun server, the hostname is localhost.
    Target Port#
    Enter the port number on the target machine to which TCPMonitor connects. For example, if you are monitoring a service running on your samples JRun server, the default port number is 8200.
    HTTP Proxy Support
    Select this check box only to configure proxy support for TCPMonitor.

    You can optionally specify the Listen Port#, Target Hostname and Target Port# values when invoking TCPMonitor on the command line. The following is the syntax for TCPMonitor:

    java org.apache.axis.utils.tcpmon [listening_port] [target_host] [target_port]
    
  3. To add this profile to your TCPMonitor session, click Add.

    A tab appears for your new tunneled connection.

  4. Select the new tab. If there are port conflicts, TCPMonitor alerts you in the Request panel.
  5. Request a page using the Listen Port defined in this TCPMonitor session. For example, if you entered 8123 for the Listen Port, enter the following URL in your browser:
    http://localhost:8123/
    

    TCPMonitor displays the current request and response information:

    This image shows a screen capture of the data page in TCPMonitor.

    For each connection, the request appears in the Request panel and the response appears in the Response panel. TCPMonitor keeps a log of all request-response pairs and lets you view any particular pair by selecting an entry in the top panel.

  6. To save results to a file for later viewing, click Save. To clear the top panel of older requests that you do not want to save, click Remove Selected and Remove All.
  7. To resend the request that you are currently viewing and view a new response, click Resend. You can edit the request in the Request panel before resending, and test the effects of different requests.
  8. To change the ports, click Stop, change the port numbers, and click Start.
  9. To add another listener, click the Admin tab and enter the values as described previously.
  10. To end this TCPMonitor session, click Close.

 

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/jrun/4/Programmers_Guide/servletoptimizing6.htm