Hello,
to analyze errors in the depth of your X-Applications, it is sometime very useful to have a protocol of the communication between the Java API for Tamino and the HTTP server of Tamino. A tool we already used for that reason is a ?HTTP Sniffer?. The sniffer is a proxy which collects the requests sent to him. It forward the request to the server it is the proxy for, and protocols both request and response.
To install such a sniffer, you can follow the listed steps.
However, the sniffer for the following example is not a “Software AG” tool. You install and use it according to the terms of the sniffer program. Therefore, check the licence conditions of the tool whether the tool is applicable for you.
Using HttpSniffer.pl to trace X-Application:
- Download the sniffer from
http://www.schmerg.com/code.asp.
There is a Link HttpSniffer (in Perl) where you get the perl code.
- Copy the sniffer code into a file HttpSniffer.pl of a directory of your PC. Let?s assume that this PC has the name ?myPC?.
- Since the sniffer is written in Perl, make sure that a Perl interpreter is installed on ?myPC?. Otherwise you can not start the sniffer. For a Perl interpreter have a look at
http://www.perl.com/
- Start the proxy:
- Let?s assume your HTTP server for Tamino is installed on the machine ?taminoPC?. Than, the Tamino URL is ?http://taminoPC/tamino?.
- Open a console window on ?myPC?.
- Change to the directory where you copied the HttpSniffer.pl.
- Invoke the proxy with the following parameters
perl httpSniffer.pl ?body=all -p 3500 -r taminoPC:80 -l protocol.txt
With these parameters the proxy is available by the URL http://myPC:3500/ and it stores the communication protocol into the file protocol.txt.
- Try out the proxy:
- Look into your ?taminoDB? via X-Plorer and look for a existing ?collection? with a document of any ?doctype? and note is ?id?.
- Open an Internet Browser
- Enter the URL http://myPC:3500/tamino/taminoDB/collection/doctype/@id
- For example
http://pcxts/3500/tamino/mydb/xapplication-collection/Property/@2
- Look into the protocol.txt. Here, your should find the GET request for the document and the corresponding response.
- Look into your ?taminoDB? via X-Plorer and look for a existing ?collection? with a document of any ?doctype? and note is ?id?.
- Configure the X-Application for it sends its Tamino request to the Proxy and not to the Tamino Server.
- Open the web.xml file of your X-Application which troubles you with a normal text editor
- replace the paramer value of ?TAMINO_URL? (should be http://taminoPC/tamino) by the URL of the proxy http://myPC:3500/tamino
- Start your application and reproduce the Error.
- Zip the protocol.txt file and post the file to the community.
- Open the web.xml file of your X-Application which troubles you with a normal text editor
If you have problems by tracing the communication, send a post to this topic.
Bye,
Christian.
[This message was edited by Christian Freytag on 20 May 2003 at 11:33.]