EXIM_CONVERT4R4(8)                                            System Manager's Manual                                           EXIM_CONVERT4R4(8)

NAME

       exim_convert4r4 - Convert Exim configuration from v3 to v4 format

SYNOPSIS

       exim_convert4r4

DESCRIPTION

       This  script  is provided to assist in updating Exim configuration files.  It reads an Exim 3 configuration file on the standard input, and
       writes a modified file on the standard output.  It also writes comments about what it has done to the standard error file.  It assumes that
       the input is a valid Exim 3 configuration file.  A typical call to the conversion script might be

       exim_convert4r4 < /etc/exim/exim.conf > /etc/exim4/exim4.conf.new

       The output file MUST be checked and tested before trying to use it on a live system.  The conversion script is just an aid which does a lot
       of the "grunt work".  It does not guarantee to produce an Exim 4 configuration that behaves exactly the same as the Exim 3 configuration it
       reads.

       Each  option  change  in  the new file is preceded by an identifying comment.  In fact, the conversion script tends to make quite a mess of
       your configuration, and you should expect to go through it afterwards and tidy it up by hand.

       Unless you are running a very straightforward configuration, the automatic conversion is likely to generate  a  non-optimal  configuration.
       You should not only check it thoroughly, but also run as many tests as you can, to ensure that it is working as you expect.  In particular,
       you should test address routing, using -bt and -bv, and the policy controls, using -bh.  If possible, you should also do  some  live  tests
       (i.e. send and receive some messages) before putting Exim 4 into service.

       If  you  have a very complicated configuration, it is possible that exim_convert4r4 will break it in some situations, which is why thorough
       testing is strongly recommended.

BUGS

       This manual page needs a major re-work. If somebody knows better groff than us and has more experience in writing manual pages, any patches
       would be greatly appreciated.

SEE ALSO

       exim(8), the files in /usr/share/doc/exim4-base/, especially Exim4.upgrade.gz

AUTHOR

       This  manual  page  was  stitched together from Exim4.upgrade by Andreas Metzler <ametzler at downhill.at.eu.org>, for the Debian GNU/Linux
       system (but may be used by others).

                                                                  March 26, 2003                                                EXIM_CONVERT4R4(8)