[cpx] Preparing for CPX [repost]

[Scott Wiersdorf <scottw@xxxxxxxxxxxx>]

How can I prepare my existing VPS v2 to run CPX?

- Make sure you have domain catchalls in your virtusertable. Depending
  on your configuration, this may imply several other requirements:

  - if you were allowing email to "pass-through" (i.e., no catchall)
    onto the aliases and underlying system users, you'll need to make
    sure that corresponding virtusertable entries are created for
    those aliases and users.

    For example, assume you have domain foo.com and no catchall for
    foo.com in virtusertable. For mail sent to 'joe@xxxxxxx', sendmail
    will check the aliases for'joe'. If found, it will deliver to
    whatever the 'joe' alias points to. If no alias, sendmail will
    look for a user 'joe'. If that user exists, it will deliver to it.
    Otherwise, sendmail will reject the message with a "User unknown"
    error.

    For CPX to function properly, each domain will need a
    virtusertable catchall for each domain. For foo.com, you'd add a
    line like this:

        @foo.com        Error:nouser Unknown user

    and then for any mail that used to "fall through" and find an
    alias or a user, you'll need to add a new virtusertable entry:

	joe@xxxxxxx     joe

  - after adding catchalls to your domains, make sure mail still gets
    delivered as you currently expect it to.

  - old-style "virtmaps" catchalls should be converted (a leading '@'
    is required):

        domain.tld      some@xxxxxxxx

    becomes:

        @domain.tld     some@xxxxxxxx

  - any mailing lists you host will likely use aliases to do the
    actual sending. You can either qualify them with the primary
    hostname (which is frankly cumbersome), or after running the cpx
    installer, remove the primary hostname catchall again so that the
    aliases will resolve correctly (the unqualified virtusertable RHS
    entries will "fall-through" to the aliases table).

- Make sure your sendmail.cf and submit.cf files do not contain
  customizations, or that if you have customizations, that they were
  derived from corresponding .mc files (/etc/mail/yourdomain.tld.mc
  and /etc/mail/freebsd.submit.mc). If you have never edited
  sendmail.cf or submit.cf on your system, you don't need to do
  anything to be compatible.

- Backup your /etc/mail directory:

    # cd /etc
    # cp -rp mail mail.backup

ClamAV, SpamAssassin, Perl (including mod_perl), and savelogs will all
be updated if necessary. You may choose to update those before hand
to make sure you won't have other surprises:

  - vinstall perl5.8.4
  - vinstall savelogs
  ... etc.

Any other items I've missed? These things should help most accounts
to convert cleanly.

Scott
-- 
Scott Wiersdorf
scottw@xxxxxxxxxxxx
======================================================================
This is <cpx@xxxxxxxxxxxxx>      <http://www.groupmail.org/lists/cpx/>
Before posting a question, please search the archives (see above URL).