What is it?

This program is dedicated to the powerful Jigsaw Web Server. ICP is an inter-proxy communication protocol. Jigsaw use a multicast version of this protocol (mICP). The goal of MICPLog is to log mICP packets into a Common Log Format file. You can use LA, FLA or any other programs to produce logs statistics.

How to use?

You will need jdk1.1 or better and several java classes of Jigsaw (w3c.www.protocol.http.micp package at least). Set your classpath, then launch MICPLog. You have to use a command line like this one:

	export CLASSPATH=/Jigsaw/classes/jigsaw.zip:/LA/classes/micp.jar
	java MICPLog -a <micpAddress> -p <micpPort> -l <micpLogsFile>
	

You can download Jigsaw's classes from http://www.w3.org/jigsaw

Most important command line options are:

• -a: mICP address.
• -p: mICP port.
• -l: your logs.
• --help: help on the other options.

MICP and Common Log Format

The access log in CLF records the raw information for each access, including:

• Host name/IP address - Host name is the name of the computer used to send a MICP packet. IP address is the numerical equivalent of the host name and is reported if no name is assigned to that particular machine (e.g. 141.142.20.84).
• Login name - If the web server requires or allows users to log in (by mean of login and password) to gain access to server information, the login name of the user will be reported.
• Date and time of access - Reports the date when the logger has received the micp packet.
• File accessed - Report action, url and protocol. MICPLog uses MICPGET for a request and MICPREPLY for a reply. Protocol name of course is MICP.
• Code - The code reports what happened when the user requested the file from the server. The code is a three digit number, the first digit indicates the general result type of the client's request. MICPLog uses:
  • 000 - MICP Request.
  • 100 - MICP Hit.
  • 400 - Bad MICP packet.
• Size of the file - Reports the size of MICP request or reply.

Example of a CLF line:

138.96.138.20 - - [01/Feb/1998 21:00:35 +1] "MICPGET http://www.essi.fr/~buffa/cours/internet98/ MICP" 000 55

Look at the snapshot:

How to download it?

You can download MICPLogger from http://www.mygale.org/~jeanfi/LA.zip.

• Yves Lafon (W3C) for the idea.
• Benoit Mahe (W3C) for beta-testing, and a lot of ideas.
• The Jigsaw Team for the fabulous Web Server Jigsaw(A.Baird-Smith, Y.Lafon, B.Mahe).
• James Gosling (Sun) for the Java Virtual Machine.
• Severine Vouret: I let you imagine why...
• and the JFouffa Consortium.