Wednesday, July 18, 2007

cPanel 11 Upgrade checklist


When you are upgrading the cpanel from version 10.0 to 11.1.0

Here is a checklist of items when upgrading to cPanel 11:


1) Make sure you're running Perl 5.8.8:

a) check perl -v to make sure it says 5.8.8

b) if you see 5.8.7 or something else, follow these steps:

1) wget http://layer1.cpanel.net/perl588installer.tar.gz
2) tar xfvz perl588installer.tar.gz
3) cd perl588installer
4) ./install
5) /usr/local/cpanel/bin/checkperlmodules

2) Upgrade YAML::Syck and File::Copy::Recursive:
1) /scripts/realperlinstaller YAML::Syck
2) /scripts/realperlinstaller File::Copy::Recursive

3) Remove any SARE/openprotect spamassassin rules

These seem to be not compatible with SpamAssassin v3.2

4) Upgrade from mbox to maildir.

This can be done by running /scripts/convert2maildir.

WARNING: Make sure to run the option to back up your mail first. IMAP must be enabled in the Service Manager before running this script!!

When running the conversion, you should watch out for the following:

It will take a long time. Don't kill the process or you'll be left with a lot of half-converted mailboxes and angry clients who aren't getting mail.

Mail will not be delivered during the conversion, it will be instead queued until the conversion is complete and then delivered.

Make sure your mailbox permissions are ok before converting and make sure your clients aren't currently using mailboxes called /cur /new or /tmp

NOTE: For users using POP accounts, converted messages will appear as new and will download twice. Users should re-download their messages after the conversion completes.