Successful upgrade to WPMU 1.5.1 - with some lessons learned
June 11th, 2008 by Dan YorkTonight I successfully upgraded blogs.voxeo.com to WordPress MU 1.5.1, the latest version. I’ve been wanting to do this since the release a month ago but I’ve held off to monitor the WPMU Forums to see what upgrade issues there were. The other challenge is, of course, that doing a site-wide upgrade requires setting aside a block of time in case anything goes wrong (and it did… see below). However, in light of reports of mass hacking of WordPress sites (see also here), I decided to make the upgrade tonight.
Following some of the links off of this forum post, I did successfully complete the upgrade, but I thought I’d record several lessons I learned in case they help others:
1. BACKUPS ARE YOUR FRIEND - Before doing anything, I had done the good old
tar -cvzf wpmu-backup-20080612.tgz wpmu
command in the directory above my WPMU installation to have a nice little tar file sitting there. This turned out to be critical as I did in fact need to restore it all to how it originally was after messing it up with #2 below. I also performed a MySQL backup to be safe although that turned out not be needed.
2. DISABLE ALL PLUGINS - This was mentioned in a few posts but for whatever reason I didn’t do it. Bad move. There was something about the OpenID plugins I was using that did not like the upgrade. It was somewhat bizarre in that the plugin to accept OpenID logins actually seemed to start working, which it hadn’t done before! However, it was causing a host of errors - bizarrely even when I reverted to a backup… so I wound up going into mu-plugins and blowing away the OpenID plugins from the directory (thanks to having the backup in #1).
3. YOU DO HAVE TO ADD THE SECRET KEY AND SALT - Just as detailed on Donncha’s blog post, on my first login to the admin interface I was given the warning that I needed to add two lines to my wp-config.php file. This was a very simple copy/paste into a shell window I had open.
4. USE ‘UPGRADE’ FROM SITEADMIN - Once you’ve copied the WPMU 1.5.1 files into your WPMU directory, the upgrade process for the individual blogs is a simple matter of choosing ‘Upgrade’ from the Site Admin menu.
5. THE ‘DEFAULT’ THEME GETS OVERWRITTEN! - After the upgrade, our home page was perfectly fine, but each of the individual blogs looked horrible. After a forced browser refresh it became clear that they had reverted to the default Kubrick theme. The issue became clear - the ‘default’ WP theme gets overwritten by the upgrade. In retrospect, this makes sense, but here’s the problem - we replaced the ‘default’ theme with our own that is visible on any of our blogs. The reason is simple… on this site, the only blogs that will be created will be with this theme. It will be the default for all blogs. Rather than create a separate theme directory and require blogs to be changed to that separate theme, it seemed to make sense to just replace the ‘default’ theme.
Oops.
Thankfully because of the backup from #1, restoring our ‘default’ theme was a trivial matter.
In a nutshell, those were my lessons from tonight. We’ll see if there are any further issues as we use it, but so far everything seems fine (outside of the fact that I have to go back and add the OpenID plugins back in - which will be for another day).
Technorati Tags: wordpress, wordpressmu, wordpress mu, wpmu
Tags: WPMU
RSS Feed
June 12th, 2008 at 7:52 am
Nice post and some good lessons to be aware of with the next WPMU upgrade. I started developing with MU just before the 1.5.1 upgrade, so I was lucky that I didn’t have many user blogs before then;)
July 1st, 2008 at 5:39 am
Hi Dan
I’ve been interested by MU on a superficial level, and have been following your posts from time to time.
I’m wondering as to whether you have found Mu useful for a company blog system, as opposed to maintaining a number of separate wordpress installs.
I guess you might say it depends on the number of blogs that people set up, but my feeling is that less people would take up the medium than I might hope for in an organisation- and as my wife often says, ‘not everyone is like you Matt’
But repetitive as multiple blogs might be, I’m thinking ‘more plugins, less risk’…would you agree or is it worth the learning curve?