&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;