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)