&fml8; Installation On Unix
Preparation Of Installation
Create the user "fml" and the group "fml" before running configure.
% su root
# groupadd fml
# useradd -g fml -m fml
Run Configure
Run configure (GNU autoconf) and make.
% su root
# groupadd fml
# useradd -g fml -m fml
# ./configure
# make install
where configure replaces variables in scripts and .cf files.
After runnig configure, run "make install". The fml installer (perl
scripts) reads ./etc/fml/install.cf configure created and install
&fml8; to e.g. /usr/local/.
You can specify the user name and fundamental directory names by
configure arguments. Customizable variables are follows:
configure --help shows them.
variables default value example
--------------------------------------------------------
prefix /usr/local /usr/local
exec_prefix /usr/local
bindir ${exec_prefix}/bin /usr/local/bin
sbindir ${exec_prefix}/sbin /usr/local/sbin
libexecdir ${exec_prefix}/libexec /usr/local/libexec/fml
datadir ${prefix}/share /usr/local/share/fml
sysconfdir ${prefix}/etc /usr/local/etc/fml
sharedstatedir ${prefix}/com
localstatedir ${prefix}/var
libdir ${exec_prefix}/lib /usr/local/lib/fml
includedir ${prefix}/include
oldincludedir /usr/include
infodir ${prefix}/info
mandir ${prefix}/man
You can overwrite the following variables by configure arguments.
fmlconfdir $sysconfidr/fml /usr/local/etc/fml
mlspooldir /var/spool/ml /var/spool/ml
fml_owner fml fml
fml_group fml fml
default_domain (spaculated by configure) (spaculated by configure)
These options are shown by runnig
configure --help
.
--without-warning run perl as perl without -w
--with-fmlconfdir=DIR use DIR instead of SYSCONFDIR/fml
--with-mlspooldir=DIR use DIR instead of /var/spool/ml
--with-fml-owner=USER use USER instead of fml
--with-fml-group=GROUP use GROUP instead of fml
--with-default-domain=DOMAIN use DOMAIN as the ML domain
Example: Running Configure
Example: On NetBSD, you should install 3rd party programs into /usr/pkg.
% ./configure --prefix=/usr/pkg
Example: On FreeBSD, use /usr/local.
% ./configure
If you use /etc/fml as configuration directory on e.g. Debian,
# ./configure --with-fmlconfdir=/etc/fml
loading cache ./config.cache
checking for perl... (cached) perl
checking for perl... (cached) /usr/local/bin/perl
checking whether optional useful commands are available or not
checking for cksum... (cached) /usr/bin/cksum
checking for md5... (cached) /usr/bin/md5
checking for ls... (cached) /bin/ls
checking for tar... (cached) /usr/bin/tar
checking for gzip... (cached) /usr/bin/gzip
checking for zcat... (cached) /usr/bin/zcat
checking for gunzip... (cached) /usr/bin/gunzip
checking for lha... (cached) /usr/pkg/bin/lha
checking for ish... no
checking for bzip2... (cached) /usr/bin/bzip2
checking for bunzip2... (cached) /usr/bin/bunzip2
checking for uuencode... (cached) /usr/bin/uuencode
checking for compress... (cached) /usr/bin/compress
checking for sendmail... (cached) /usr/sbin/sendmail
checking for newaliases... (cached) /usr/bin/newaliases
checking for postfix... (cached) /usr/sbin/postfix
checking for postalias... (cached) /usr/sbin/postalias
checking for postconf... (cached) /usr/sbin/postconf
checking for postmap... (cached) /usr/sbin/postmap
checking for nkf... (cached) /usr/pkg/bin/nkf
checking for kakasi... no
checking for namazu... no
checking for pgp... (cached) /usr/pkg/bin/pgp
checking for pgp5... no
checking for pgpe... no
checking for pgpk... no
checking for pgps... no
checking for pgpv... no
checking for gpg... no
checking for less... (cached) /usr/bin/less
checking for more... (cached) /usr/bin/more
checking for w3m... (cached) /usr/pkg/bin/w3m
updating cache ./config.cache
creating ./config.status
creating config.sh
creating fml/etc/main.cf
creating fml/etc/default_config.cf.ja
creating fml/etc/site_default_config.cf
creating fml/libexec/loader
creating fml/bin/fmlalias
creating fml/bin/fmlconf
creating fml/bin/fmldoc
creating fml/bin/fmlhtmlify
creating fml/bin/fmlsch
creating fml/bin/fmlthread
creating fml/bin/fmlspool
creating fml/bin/makefml
enabled perl -w
fml has been configure with the following options:
prefix: /usr/local
exec_prefix: ${prefix}
bindir: ${exec_prefix}/bin
sbindir: ${exec_prefix}/sbin
lib_dir: ${exec_prefix}/lib
libexec_dir: ${exec_prefix}/libexec
mandir: ${prefix}/man
datadir: ${prefix}/share
fml process owner: fml
fml process group: fml
fmlconfdir: /etc/fml
mlspooldir: /var/spool/ml
default domain: home.fml.org
Now you must run "make install".
Appendix: Directory Roles
&fml8; installs files under /usr/local by default.
directory structure
directory description /usr/local/etc/fml
Configuration files.
It corresponds with
&fml4;'s /usr/local/fml/.fml and default_config.ph.
/usr/local/etc/fml/main.cf
has fml version and library paths et.al.
/usr/local/libexec/fml
Executables (corresponding with &fml4;'s /usr/local/fml )
/usr/local/lib/fml
Perl module location ( &fml4;'s /usr/local/fml )
/usr/local/share/fml
Message templates ( &fml4;'s /usr/local/fml/messages/).
Template files are language dependendent.
/var/spool/ml
The top directory for mailing lists of the default domain.
same as &fml4;.
caution: the owner of /var/spool/ml
can be specified by configure arguments.
Prepare different directory for each domain.
For example, /var/spool/ml for fml.org (default domain),
whereas /var/spool/nuinui.net for nuinui.net domain
(virtual domain).
See
ml_home_prefix_maps
for the relation between domain and directory.
Also see
for the virtual domain detail.
Fml Installation: make install
change user to "root" and run "make install" after configure runs.
% su root
# make install
You need not to run configure by the user root.
But, you need to run "make install" by root.
So, it may be better to run both by root.
% su root
# ./configure
# make install
Edit main.cf
Please edit /usr/local/etc/fml/main.cf if needed,
though already configure rewrites main.cf to fit your environment.
The file main.cf contains the most fundamental configuration variables
to control &fml8; basic features: fml version control, library path,
virtual domain et.al.
Instead, the detail of each ML configuration depends on config.cf file
of each ML such as /var/spool/ml/elena/config.cf for elena ML.
"config.cf" can override all configuration variables: header
customizations, filter rules, member file locations et.al.
§.main.cf;
Edit site_default_config.cf (optional)
/usr/local/etc/fml/site_default_config.cf is the configuration file
common over all mailing list on this host (site).
This file corresponds to &fml4;'s site_force.ph.
site_default_config.cf overrides default_config.cf file.
Each ML configuration file (/var/spool/ml/elena/config.cf for elena
ML) overrides site_default_config.cf.
By default, some example configurations are added to this file.
#
# site default_config.cf EXAMPLE
#
# fml-devel loads .cf files in this order for elena ML.
# 1. ${prefix}/etc/fml/defaults/$VERSION/default_config.cf
# 2. ${prefix}/etc/fml/site_default_config.cf
# 3. ${prefix}/etc/fml/domains/$DOMAIN/default_config.cf
# 4. /tmp/dir/elena/config.cf
#
# This file overrides the default "default_config.cf" configurations
# in the following way.
#
# We want to disable the subject tag in articles by default.
article_header_rewrite_rules -= rewrite_article_subject_tag
# mime based comonent filter
use_mime_component_filter = yes
# [site specific options]
# Example:
# key = value
# key += value
# key -= value
=cut
#
# you can write hooks here after.
# Example:
# $distribute_run_start_hook = q{ ... };
Filter
All filter are enabled by default.
"mime component filter" is important.
By default mime component filter is enabled,
Only text/plain article can be passed through &fml8;.
To disable mime component filter on all ML's,
set
use_mime_component_filter = no
at site_default_config.cf.
To customize mime component filter, set
use_mime_component_filter = yes
at site_default_config.cf, and edit rules in
/usr/local/etc/fml/mime_component_filter file.
Virtual Domain
You do not need edit /usr/local/etc/fml/main.cf but you need to edit
$ml_home_prefix_maps (/usr/local/etc/fml/ml_home_prefix file by
default). You can use "makefml newdomain" command to control
$ml_home_prefix_maps. See
"ML creation"
for newdomain command.
Suppose that fml.org is the default domain. In this case,
/var/spool/ml/$ml is used for $ml ML of fml.org. /var/spool/ml is used
only for the domain fml.org. If you want to set up elena@nuinui.net,
you need to specify other directory.
Specify the relation between domain and directory,
edit /usr/local/etc/fml/ml_home_prefix and set the following:
nuinui.net /var/spool/nuinui.net
Please use "makefml newdomain" command to change
/usr/local/etc/fml/ml_home_prefix file.
It is recommended that you do not edit this file directly.
site_default_config.cf is applied to all domains.
§.install.postfix;
§.install.qmail;
recipes
§.install.recipes;