cPanel 11 Upgrade checklist

[DaveUsedToWorkHere]

Here's a checklist of items that can help things go smoothly 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 see This Thread for more info.


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.



These steps should make things a lot smoother if you are running an older version of cPanel.

 

[wsenter]

Does cPanel/WHM 11 work with Unix Fedora Core 6? I checked on your site...

cPanel and WHM - System Requirements and it only said Core 5. I just was not sure if that page hadn't been updated or something.

 

[cPanelDavidG]

Does cPanel/WHM 11 work with Unix Fedora Core 6? I checked on your site...

cPanel and WHM - System Requirements and it only said Core 5. I just was not sure if that page hadn't been updated or something.

According to http://bugzilla.cpanel.net/show_bug.cgi?id=4746 - Fedora Core 6 is now supported in cPanel 11, but not cPanel 10.

 

[wsenter]

Thanks for the quick reply. We are awating on a shipment of 3 Dell Servers and wanted to put Fedora Core 6/cPanel 11 on there. We are looking for a good tutorial on how to install Core 6. I found this pretty good one here..

http://www.howtoforge.com/installing_a_lamp_system_with_fedora_core_6

However that tutorial seems to pass over the very important step of creating partitions for /usr, /var, /home etc... which is crucial to the proper operation of cPanel. I was able to find further documentaion from the Fedora Project here..

http://docs.fedoraproject.org/fedora-install-guide-en/fc5/sn-disk-druid.html

According to the WHM Installation Guide special attention should be paid to that of the /tmp directory to create a "seperate partition in order to take advantage of the "no exec" option of Linux." Does cPanel have any good tutorials on this subject or can anyone send me a link of a suggested place to look?

 

[unomateo]

I was also told that fedora core 4 is not supported. I'm currently running core 4 with WHM11.

We had a permission problem on install with DNS. We could not get it to start, but the co-location was able to give named the proper permissions, but other then that it is running fine.

We will upgrade to core 5 shortly

 

[cPanelDavidG]

I was also told that fedora core 4 is not supported. I'm currently running core 4 with WHM11.

While Fedora Core 4 may work with cPanel/WHM 11, we are no longer supporting new installations on Fedora Core 4.

We also recommend you do upgrade to a version of Fedora Core still supported by the Fedora Project such as Fedora Core 5, or if you're on version 11 of cPanel/WHM - you may want to consider Fedora Core 6.

 

[WebXSolution]

forgive the newbe'ish question, but upon upgrading from FC5 to FC6 will cPanel need to be reinstalled?

 

[cPanelNick]

forgive the newbe'ish question, but upon upgrading from FC5 to FC6 will cPanel need to be reinstalled?

/scripts/upcp --force

is highly recommended to make sure the post install scripts get re-run.

 

[BamaStangGuy]

3) Upgrade from mbox to maildir.

Is this done with the upgrade or is this something you still should do even if you have already upgraded?

 

[Silver_2000]

Assuming that Cpanel will update it self to 11 at some point will these steps still need to be done ? The perl upgrade for example ?

I just checked and am running 5.8.7

Doug

 

[Silver_2000]

Is this done with the upgrade or is this something you still should do even if you have already upgraded?

another question is .... How do I check which Im running ?

 

[Fernis]

Assuming that Cpanel will update it self to 11 at some point will these steps still need to be done ? The perl upgrade for example ?

I just checked and am running 5.8.7

Doug

You should upgrade to Perl 5.8.8

A good install script can be found HERE

 

[cPanelDavidG]

Is this done with the upgrade or is this something you still should do even if you have already upgraded?

This (mbox -> maildir conversion) is not done automatically with the upgrade. I would personally like to see people stop using mbox, but I realize some sysadmins have their reasons for holding out.

The maildir conversion (using /scripts/convert2maildir) for most people works just fine however once in a while you will get a server where 5 or 6 accounts may not work correctly and our techs need to go in and tweak a few things to get those accounts functional again. I would recommend if you are still on mbox and aren't exactly attached to it in any way (e.g. not using something that requires mbox like NeoMail or OpenWebmail) that you consider proceeding with the conversion and if anything goes wrong for any reason, get in touch with us so we can work with you on whatever issues crop up.

FWIW- I know many admins have reported a performance improvement regarding email after converting to maildir.

 

[chirpy]

Beware of FC5, though, support for it ends in about a month. You'd be better advised to move to an Enterprise OS that doesn't need upgrading every 4 to 6 months

Converting to maildir should show a huge improvement for those have have clients that store emails on the server. Courier-imap is also much more robust than the older cppop/uw-imap combination and offers new features, such as simultaneous IMAP access to a single account.

 

[DaveUsedToWorkHere]

another question is .... How do I check which Im running ?

Go to a home directory/mail and see if there is a file called "inbox" (mbox) or directories called "cur/" "new/" "tmp/" (maildir)

 

[chirpy]

...or:

grep maildir /var/cpanel/cpanel.config

If it's set to 1 it should be maildir. If it's 0 or not set, then mbox.

 

[Fernis]

another question is .... How do I check which Im running ?

You can log into WHM or cPanel and click on the "Service Status" and look for exim. It should tell you which you are using.


exim (exim-4.66-0_cpanel_maildir) up

 

[bjarte]

Are there any major problems running cpanel 11 on perl 5.8.5?

I installed 5.8.8, but I got a lot of problems with perlmodules.
Since I had changed the kernel after the modules was compiled in 5.8.5 many of them, like Mail:SpamAssassin would not compile

So no I have downgraded to 5.8.5 again.

 

[DaveUsedToWorkHere]

Are there any major problems running cpanel 11 on perl 5.8.5?

I installed 5.8.8, but I got a lot of problems with perlmodules.
Since I had changed the kernel after the modules was compiled in 5.8.5 many of them, like Mail:SpamAssassin would not compile

So no I have downgraded to 5.8.5 again.

5.8.5 is pretty old. Did you install 5.8.8 with perl588installer.tar.gz form layer1.cpanel.net?

Have you tried perl587installer.tar.gz from layer1?


Running /usr/local/cpanel/bin/checkperlmodules should install any missing modules that cPanel needs.

 

[bjarte]

I used the perl587installer.tar.gz first time. It did not work well. ( I use RH ES 4.0, x86_64)
I also tried to use some src rpm from fedora 5, it worked better. but could still not compile spamassassin. Now when I'm back to 5.8.5 it looks like things works well.

Though I still got the problem with spamassassin that made me do the cpup at the first place. But thats another story.

Think my problem with updating perl whas that the kernal had changed since I installed it in the first place. I got some architecture problems.

dont the updater run the /usr/local/cpanel/bin/checkperlmodules ?

-Bjarte