TCPMon Tutorial

TCPMon Tutorial explains step by step details of How to debugging web service using TCPMon.

What is TCPMon & How to Use TCPMon?

Apache TCPMon is an open-source tool / debugger for checking the data flowing through TCP network. TCPMon placed intermediate to a consumer and a server. The consumer is made to contact with TCPMon, and TCPMon further send the data to the server and will shows on in its Graphical User Interface(GUI).

Apache TCPMon utility is using for monitoring soap message

You can also configure, TCPMon with Apache AXIS in order to monitor the traffic

For example if you, created webservice is deployed using Apache CXF or Apache AXIS, you can able to monitor traffic on TCP connections by using this tool  


1) If you need JAX-WS example, You can follow Trace SOAP request/response using JAX-WS

2) If you need Eclipse IDE example, You can follow Trace SOAP message Using Eclipse IDE

Required Libraries

Install / Configure TCPMon

Thinking that webservice is already up and is available on the port 8080 (My server is Tomcat, So Tomcat default port). If not, please check this article CXF Web Service Tutorial

Steps (Please see the following screen shot)

  1. Set Listen Port # as 8081 ( Assuming that port 8081 is free on your system )
  2. Leave Target Hostname as
  3. Set Target Port # as 8080

Configure TCPMon

Now add the button, We get a new tab opened with as "port 8081". For monitoring the request/response we need to invoke the service. So just run the following client for simulating.


Please check that client is calling listening port (8081) and not Tomcat port where web service is running (8080)

Simulate / Monitor TCPMon

package com.client;

import org.apache.cxf.ext.logging.LoggingInInterceptor;
import org.apache.cxf.ext.logging.LoggingOutInterceptor;
import org.apache.cxf.jaxws.JaxWsProxyFactoryBean;

import com.student.ChangeStudentDetails;
import com.student.Student;

// Monitor SOAP Message using TCPMon

public class StudentClient {

public static void main(String args[]) throws Exception {

JaxWsProxyFactoryBean factoryBean = new JaxWsProxyFactoryBean();

().add(new LoggingInInterceptor());
().add(new LoggingOutInterceptor());
      ChangeStudentDetails client =
(ChangeStudentDetails) factoryBean.create();
      Student student =
new Student();
      Student changeName = client.changeName
("Server response: " + changeName.getName());


Running TCPMon

Running TCPMon

3 Responses to "TCPMon Tutorial"
  1. Glapy 2011-10-12 09:03:52.0
  1. admin 2011-10-13 09:03:52.0
  1. Paul Caruana 2011-10-16 09:03:52.0

Your email address will not be published. Required fields are marked *