Installing OMTA
===============

    Before installing OMTA, you might want to consider what you want to do
    with it.

    If you have a rather large local network, you might want to take
    advantage of the fact that OMTA can also use SENDMAIL for local mail
    handling. In that case, you might want to back up your old SENDMAIL
    binary before beginning the installation.

    If, on the other hand, your machine is the only UNIX machine on your
    network, you might want to set up OMTA so it will relay email for all
    the other machines on your network.

    If you don't have an internal network, or you just don't trust the
    other people on your network (parents can sometimes be a true security
    threat :^)), then just follow the instalation instructions below.

    NOTE that it is assumed that you follow these instructions as root.

Configuring the source

    OMTA builds with the autoconf/automake build system. Firstly, you will
    need to configure the source code. This is done by typing the
    following command in the directory that contains the OMTA source code
    (eg. ~/omta-0.51):

    	./configure --prefix=/usr

    You might also want to add a few options to the configure command. The
    most common ones are:

    --prefix=<path>		set the prefix directory where OMTA is to
    				be installed

    --enable-setuid[=user]	install setuid (as user)

    --enable-setgid[=group]	install setgid (as group)

    --enable-debug		enable debugging (NOT RECOMMENDED)

    For more options, issue the following command:

    	./configure --help

    Default, when no parameters are given, is installation with the prefix
    set to /usr/local, and setgid as group mail. It is however recommended
    to set the prefix to /usr, as most email clients expect the mail
    system there.

Making the source

    After configuration is complete, issue the following command in the
    same directory as where you did the configuring:

    	make

    This will build the OMTA source. You should see no warnings and/or
    error messages.

Installing the binaries

    After make has completed, you are ready to install OMTA. Firstly,
    please consider if you want to install OMTA with or without debugging
    information. Use the former if you are an OMTA developer or would like
    to be able to debug OMTA. For the former, issue the following command:

    	make install

    for the latter, which is by the way the recommended installation
    procedure for novice users, issue the following command:

    	make install-strip

Creating the queue directory

    OMTA uses a directory for storing queued messages, called the queue
    directory. This directory is usually /var/spool/omtaqueue, unless your
    system doesn't have /var (you'd probably know that, as these systems
    are rather rare), in which case it is /usr/spool/omtaqueue.

    You can create this directory with the following commands:

    	mkdir -m 0770 /var/spool/omtaqueue
    	chown .mail /var/spool/omtaqueue

    These commands assume you didn't fiddle with the setuid/setgid
    configuration options. If you did, you're on your own concerning
    having to sort out the directory mode and/or ownership.

Editing the configuration file

    A generic configuration file is included with the OMTA distribution
    called omta.conf.dist. You can copy it to /etc/omta.conf and edit it
    to suit your needs.

    For more information about the configuration file, see the
    omta.conf(5) man page (type 'man 5 omta.conf' on the command prompt to
    view).
