	INSTALL guide ( on Windows NT 4.0 )
	--- fml mailing list server package ---

				Ken'ichi Fukamachi

This file describes the difference between fml on UNIX and on NT4.
Please see INSTALL for the install flow.

------------------------------------------------------------
1	Required Softwares
1.1	Required Softwares
1.2	fml for NT ?
1.3	tips for each MTA
1.4	Case Study: test environment

2	how fml NT Version work 
2.1	Two Kinds of fml for NT4
2.2	Case Study: MetaInfo Sendmail (prog mailer type)
2.3	Case Study: fml POP version

3	Installation
3.1	Installer (ntinstall.cmd)
3.2	POP and SMTP Server configurations
3.3	Digest Delivery

4	The difference of make fml between on UNIX and on NT4
4.1	make fml newml (create a new mailing list)
4.2	make fml pop_passwd <ML> (change POP password)
4.3	Mget And Digest File Default Format

5	ML Operations
5.1	ML Operation and Maintenance
5.2	How to Debug
5.3	ntfml.pl options
5.4	Remove a ML

6	Trouble Shooting
6.1	Lack of directories?
6.2	config.ph becomes file size 0
Appendix A	useful links
------------------------------------------------------------


1	Required Softwares

1.1	Required Softwares

   perl 5
	You need perl 5. Please use build 522 if you fail to run fml 
	by buld 6XX (perl 5.6.0 base).

	http://www.activestate.com/download/ActivePerl/APi522e.exe
	http://www.activestate.com/Products/ActivePerl/Download.html

   MTA
	There is two kinds of MTA's.
	a. one type which runs programs
	b. another type which cannot run programs

1.2	fml for NT ?

There is no fml special for Windows 2000/NT. Please use the standard
distribution.

1.3	tips for each MTA

* Sendmail for NT

2.5 (MetaInfo Sendmail 2.5 (?))

3.0 (Sendmail - Products - NT Routing)
	http://www2.sendmail.com/products/routing/nt/

* IMail Server Gold
References: fml -support: 7947 7954 7967 

	OS          Windows NT4.0
	Mail Server IMail Server Gold 4.1J
	Perl        ActivePerl 522
	fml         fml 3.0.1

     C:\\ fml \ml\elena\include.cmd <

1.4	Case Study: test environment

NOTE:	Required and Test Environment 

You need MTA and ntperl. I tested fml master source using ntperl by
activestate.com. Other perl ports to NT4 exist but I've not tested
them. If you try and succeed it, please let me know.

My test environment is 

	i486 architecture
	NT 4.0 service pack 1
	Pw32i307.exe
	ataman rlogind
	MetaInfo Sendmail 2.x 

2	how fml NT Version work 

The almost same code as UNIX works on NT4. The difference is around
fork(), exec() and alarm(). We emulate timeout using Win32 perl module
but it is less degree of freedom than UNIX signal;_;.

The default in retrieving file is tar.gz on UNIX but MIME/Multipart on
NT4 since tar, gzip does not exist on standard NT4. The default for
some functions are changed for this type reasons.

 fml runs on a lot of operating systems, so fml on NT4 is just one of
them. But NT4 differs a lot from UNIX, so we cannot use usual
technique on UNIX. Some functions do not work but almost all
functions work well I believe.
# Attention: please do not consult me with NT4 and commercial products
# itself.

2.1	Two Kinds of fml for NT4

A lot of MTA's on NT4 runs with limited functions. MTA provides SMTP
and POP servers but not others. We need "prog mailer" function which
runs fml .pl and puts mail into fml .pl. I have experimented and found
a prog mailer in MetaInfo Sendmail (2.x) works well.

For this lack of functions, two variations of fml for NT4 exist.

	1.	the same as UNIX (prog mailer type)
		Configuration is the same as on UNIX.	
	2.	POP3 type
		fml gets mail from POP server and 
		injects it to fml .pl to run a mailing list.

2.2	Case Study: MetaInfo Sendmail (prog mailer type)

Configuration with MetaInfo Sendmail is the same as on UNIX
fundamentally. You need not to run ntfml.cmd but msend.cmd if you use
digest delivery periodically.

The current installer (after 2.1A#6) asks you whether your MTA is
MetaInfo or not. If it is MetaInfo Sendmail, you follows INSTALL, cut
and paste examples e.g. aliases and runs "newaliases". Please see
the file INSTALL.

make fml creates examples for each type (prog mailer or POP). If you
change MTA after running a ML, you may not use examples in $DIR
directly.

In aliases MTA runs include.cmd and injects an input mail to
include.cmd. include.cmd runs fml .pl wrapped by wrapper.pl. When you
set up aliases, fml delivery and command functions work.

For digest delivery, you need to run msend.cmd periodically. You will
need to use OS functions (I don't know the detail).

2.3	Case Study: fml POP version

A lot of MTA on NT4 has only SMTP and POP servers and cannot run the
program. In POP version you need to set up ML name account in POP
server. fml extracts mail for ML by POP3 and injects it to fml .pl
(mailing list emulation). # This function is implemented on UNIX in
1995, and the same technique # is used on NT4.

    * prog mailer version
    
    	mail -> sendmail -> fml .pl
    
    * POP version
    
    	mail	-> sendmail -> mail spool
    				|
    				V POP3
    				pop fml .pl	->	fml .pl
    		   sendmail <-	<-	<-	<-	
    
    * ntfml.pl 
    
        infinite loop {
    
    	pop fml .pl runs one three minutes.
    
    		----> POP SERVER account = elena
    		<----
    
    	If mail for elena ML exist
    		runs fml .pl
    
    	elsif not, sleep again
        }

3	Installation

3.1	Installer (ntinstall.cmd)

Extract the fml package archive and run ntinstall.cmd. It adjusts
sources a little to fit NT4 and runs "make fml install". The
installation proceeds automatically with asking you a few
items. Please see INSTALL for what is asked to you. 

3.2	POP and SMTP Server configurations

In POP3 type, make fml asks you which is POP and SMTP server. Please
input them. This query does not exist on UNIX version.

3.3	Digest Delivery

* POP version

ntfml.pl runs always and runs digest program. So you need not to set
up it.

* prog mailer type

You need to set up msend.cmd runs periodically.

4	The difference of make fml between on UNIX and on NT4

4.1	make fml newml (create a new mailing list)

In creating a new ML, make fml asks you the POP password. Consider the
case that you create elena ML. The default configuration needs
accounts on POP server

	elena
	elena-ctl

	elena-admin	(MAINTAINER)

Please create these account on POP server and input the same password
in "make fml newml elena".

elena-ctl is 9 characters, so it cannot be created for the account
string limit. In that case you may need to consider the different
control address name.

4.2	make fml pop_passwd <ML> (change POP password)

	make fml pop_passwd ML

e.g.
	make fml pop_passwd elena

enables you to change POP password for elena account.

4.3	Mget And Digest File Default Format

The default in retrieving file is tar.gz on UNIX but MIME/Multipart on
NT4 since tar, gzip does not exist on standard NT4. The default for
some functions are changed for this type reasons.

5	ML Operations

5.1	ML Operation and Maintenance

* prog mailer type

 fml runs when mail comes. Please let it be.

* POP type

ntfml.cmd need to run always. If the machine is down, you need to kick
off it again.

Please see this url on how to regist fml to NT service and control via
control panel.

	Author: ssk@dmail.plala.or.jp
	http://www6.plala.or.jp/k-ssk/download.html

	http://www.activeplus.com/

maybe used but not tested well.

5.2	How to Debug

runs "ntfml.cmd -d" to show a lot of debug information.

5.3	ntfml.pl options

	-d		debug
	-o debug_option	debug option
	-u time		loop unit time (unit is second)

5.4	Remove a ML

* POP version

remove ML's HOME e.g. C:\ fml \ml\elena. ntfml.pl scans C:\ fml \ml always
in the loop. Hence the directory disappears, ntfml.pl ignores the ML
automatically.

* MetaInfo version

Remove aliases entries. You do not need to remove ML's HOME directory.
Remove digest delivery setting.

6	Trouble Shooting

6.1	Lack of directories?

Create directories before installation. 

6.2	config.ph becomes file size 0

fixed (98/07/15)

Appendix A	useful links

	http://www.csdinc.co.jp/archiver/

	ftp://ring.etl.go.jp/pub/pack/00tools/

$Id: INSTALL_on_NT4.wix,v 1.33.2.1 2001/07/01 03:37:34 fukachan Exp $
