
	fml CGI interface 

------------------------------------------------------------
1	Overview
1.1	fml CGI interface
1.2	installation of CGI
1.3	apache only for fml CGI ?
1.4	Please verify log of apache 

2	Q and A
2.1	What to do next after fml installation ?
2.2	What can I do on fml CGI interface?
2.3	CGI interface is for fml administrators ?
2.4	What user owns /var/spool/ml ?
2.5	httpd.conf is configured for fml/www/share/ directry?
2.6	What is the difference between fml/www/ and fml/www/share/ ?
2.7	fml CGI interface conflicts fml before 4.0 ?
2.8	add/delete a user which can use fml CGI interface
2.9	change the password for a user which can use fml CGI interface
2.10	select mail servers
2.11	Can I change CGI PATH ?
2.12	Case Study: postfix specific problmes
2.13	Case Study: sendmail specific problmes
2.14	qmail
2.15	Errors from apache
2.16	registration processes (e.g. CGI, makefml, ..) are independent ?

3	tips
3.1	releation between web and fml

Appendix A	miscellaneous memo
Appendix A.1	Directory Structure
Appendix A.2	password file
------------------------------------------------------------


1	Overview

1.1	fml CGI interface

1.2	installation of CGI

	doc/INSTALL_CGI.jp 

	http://www.fml.org/fml/INSTALL_CGI/

1.3	apache only for fml CGI ?

No. You can use for example "suexec".

	/usr/local/apache/conf/httpd.conf 

1.4	Please verify log of apache 

If apache succeed to start, you can see the following message:

[Wed Nov 10 23:27:07 1999] [notice] Apache/1.3.9 (Unix) mod_ssl/2.4.8 OpenSSL/0.9.4 configured -- resuming normal operations

2	Q and A

2.1	What to do next after fml installation ?

	../../INSTALL_CGI/

2.2	What can I do on fml CGI interface?

See your browser :-)

2.3	CGI interface is for fml administrators ?

Almost yes. You can also set up each CGI for each ML.

2.4	What user owns /var/spool/ml ?

It depends your apache configuration. If your apache is only for fml
CGI interface, "User" line in httpd.conf should be the same as the
user "fml" which is the owner of /var/spool/ml directory.

   apache/httpd.conf

	User fml

2.5	httpd.conf is configured for fml/www/share/ directry?

2.6	What is the difference between fml/www/ and fml/www/share/ ?

fml/www/ is allocated for fml CGI interface, fml/www/share/ is where
apache sees.

2.7	fml CGI interface conflicts fml before 4.0 ?

Yes.

2.8	add/delete a user which can use fml CGI interface

1.	do on CGI

2.	makefml admin.cgi conf

	MENU -> CHANGE PASSWORD

2.9	change the password for a user which can use fml CGI interface

You can do it on CGI menu.

2.10	select mail servers

makefml admin.cgi conf

   MENU -> 	
	6     MTA                
	7     HOW TO UPDATE ALIAS

2.11	Can I change CGI PATH ?

2.12	Case Study: postfix specific problmes

   % postalias /var/spool/ml/etc/aliases

2.13	Case Study: sendmail specific problmes

   # touch /var/spool/ml/etc/aliases.db 

2.14	qmail

under condideration ...

2.15	Errors from apache

You don't have permission to access /cgi-bin/fml/admin/menu.cgi on this server.

0. check the User of httpd.conf and fml user.

1. check the executable permission for menu.cgi in /usr/local/fml/www/share/

2. check the directory permission

	/usr/local/fml/www/share/
	/usr/local/fml/www/

3. check httpd.conf 

	.htaccess ?

2.16	registration processes (e.g. CGI, makefml, ..) are independent ?

Yes. Plural methods work well each other when the owner of these
processes is the same as "fml".

3	tips

3.1	releation between web and fml

You can input commands into makefml via pipe. For example, 
% echo help |/usr/local/fmlmakefml

Appendix A	miscellaneous memo

   $EXEC_DIR = '/usr/local/fml' 

Appendix A.1	Directory Structure

   $EXEC_DIR/www/	 templates and libraries
   $EXEC_DIR/www/share/	 export	under httpd (apache)
   $EXEC_DIR/www/authdb/ htpasswd location

Appendix A.2	password file

	$EXEC_DIR/www/cgi-bin/admin/.htaccess 

see

	$EXEC_DIR/www/db/admin/htpasswd

	makefml admin.cgi conf

$Id: misc.wix,v 1.3 2000/12/07 16:48:19 fukachan Exp $


		INDEX

