NMS2DLF.IN(1)						  LogReport's Lire Documentation					     NMS2DLF.IN(1)

NAME

       nms2dlf - convert Netscape Messaging Server SMTP log files to the email DLF

SYNOPSIS

       nms2dlf STDIN STDOUT

DESCRIPTION

       This program converts Netscape Messaging Server log file generated by the SMTP service to the email DLF.

       To process correctly the log file, you need to turn on logging of the following modules:

	   - SMTP-Accept
	   - SMTP-Deliver
	   - Error-Handler
	   - Mailbox-Deliver (Need to be enabled)

LIMITATIONS

       This DLF converter was developed for the Netscape Messaging Server version 4.1. Other versions may or may not work. Contact the LogReport
       developers if you have problems with that converter.

       You can find information about the log format used by Netscape Messaging Server at the following URL:

	   http://developer.netscape.com/docs/manuals/messaging/41/ag/logging.htm

       Not all messages are documented. And we found errors in the documentation. The fields msgID and mailFrom are inversed in both SMTP-Accept
       and SMTP-Deliver from what described the documentation.

   CONFIGURING LOGGING OF MAILBOX-DELIVER MODULE
       We found that there are no logs from the Mailbox-Delivery module by default. In order to fix that problem please make sure you do the
       following:

       1.  Go on the Netscape Messaging Server 4 MTA or Message Store

       2.  Become the Mail Server user (usually this should not be root but typically a user like mailsrv or whatever was defined at installation
	   time, check for the ownership of the files in your message server instance for example)

       3.  Go to the right location, something like: server-root/msg-instance

	   For example it could be: /usr/netscape/server4/msg-mymailserver

       4.  Do:

	       $ ./configutil -o service.smtp.mailbox-deliver.log -v yes
	       OK SET

       5.  Then become root, go again to your instance directory like: /usr/netscape/server4/msg-mymailserver and do:

	       # ./stop-msg smtp
	       /usr/netscape/server4: Stopping SMTP daemon 16279 .... done: 16279

	       # ./start-msg smtp
	       /usr/netscape/server4: Starting SMTP daemon ..... done: 10820

       And then you will start seeing lines which will look like the following:

	   [19/Jul/2002:08:31:54 +0200] amail2 smtpd[10820]: 
	   General Notice: SMTP-Accept:GZHGT501.C01:<200207190632.g6J6W7Y01389@
	   esmtp.orangemail.ch>:[192.168.30.2]:192.168.30.2: 
	   <newsletter@gamezone.com>:19514:1:<hmarmy@orangemail.ch>
	   [19/Jul/2002:08:31:54 +0200] amail2 smtpd[10820]: General Notice: 
	   Mailbox-Deliver:GZHGT501.C01:<200207190632.g6J6W7Y01389@
	   esmtp.orangemail.ch>:19516:1:hmarmy;

       If this was not done the line with the pattern Mailbox-Deliver above will not be present and the program will give wrong results. A warning
       will be output in the error log.

EXAMPLES

       To process a log as produced by Netscape Messaging Server

	$ nms2dlf < mail.log

       nms2dlf will be rarely used on its own, but is more likely called by lr_log2report:

	$ lr_log2report nms < /var/log/mail.log

VERSION

       $Id: nms2dlf.in,v 1.10 2006/07/23 13:16:34 vanbaal Exp $

COPYRIGHT

       Copyright (C) 2002 Stichting LogReport Foundation <logreport@LogReport.org> Copyright (C) 2002 Arnaud Taddei Copyright (C) 2002 Arnaud
       Gaillard

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

       This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.

       You should have received a copy of the GNU General Public License along with this program (see COPYING); if not, check with
       http://www.gnu.org/copyleft/gpl.html.

AUTHORS

       Francis J. Lacoste <flacoste@logreport.org>, Arnaud Taddei <Arnaud.Taddei@sun.com> and Arnaud Gaillard <wireless@orange.ch>

Lire 2.1.1							    2006-07-23							     NMS2DLF.IN(1)