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:
In Server Admin, select a computer in the Servers list, then select Mail.
Click Settings.
Click the Quotas tab.
Select "Enable Quota Warnings".
Edit the Quota Warning Message, then customize the message.
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.