This article has been archived and is no longer updated by Apple.

Mac OS X Server v10.6: Mail Server upgrade and migration

Learn about Mail Server upgrade and migration in Mac OS X Server v10.6.

Some mail server settings and data may not be automatically preserved when migrating or upgrading Mac OS X Server v10.4 and v10.5 to Mac OS X Server v10.6. In order to preserve or re-create these settings, read the instructions in this article prior to upgrading or migrating your Mail server.

Important: Follow the instructions in the Upgrade and Migration administration guide. The below article supplements, but does not replace, those instructions.

Mail quotas

Important: If you upgrade using a Mac OS X Server installation DVD that contains version Mac OS X Server v10.6.3 or later, you do not need to follow the steps in this section. Go to the next sections if needed ("Real-time Blacklist" and "Webmail").

The Mac OS X Server v10.6 upgrade process does not preserve custom quota messages. To preserve custom quota messages, back up the following files:

  • /etc/mail/quota_exceeded.txt

  • /etc/mail/quota_warning.txt

Once the installation process is complete, copy the files back to /etc/mail to restore custom quota messages.

Alternatively, you can re-create the messages via Server Admin:

  1. In Server Admin, select a computer in the Servers list, then select Mail.

  2. Click Settings.

  3. Click the Quotas tab.

  4. Select "Enable Quota Warnings".

  5. Edit the Quota Warning Message, then customize the message.

  6. Click Save.

Real-time Blacklist

If you had enabled support for real-time blacklists (RBL) in Mac OS X Server v10.5 and then disabled it prior to upgrading to Mac OS X Server v10.6, it is possible that the smtpd_client_restrictions value could be incorrectly configured. To check the the value of smtpd_client_restrictions, use the postconf tool in Terminal:

sudo postconf smtpd_client_restrictions

If it returns a value similar to this:

smtpd_client_restrictions = permit_mynetworks my.rbl.host.com permit

... use the postconf tool to correct the value by adding reject_rbl_client before the RBL host name:

sudo postconf -e smtpd_client_restrictions='permit_mynetworks reject_rbl_client my.rbl.host.com permit'

If the mail server is running while you made these changes you will need to reload postfix so that it picks up the new settings; use this command:

sudo postfix reload

Webmail

The upgrade process preserves three directories related to the Webmail service:

  • /usr/share/squirrelmail/plugins/

  • /usr/share/squirrelmail/themes/

  • /etc/squirrelmail/config/

All other directories located in /usr/share/squirrelmail/, such as images, should be backed up before upgrading to Mac OS X Server v10.6.

Published Date: