Important WP 3.0 Upgrade Instructions: PLEASE READ BEFORE UPDATING!
After more than 6 months of development, WP 3.0 is out! Many of you will be anxious to update right away, but there are some important things you should know first:
General Info
WordPress MU has been merged into regular WP, which means whether or not you need multiple blogs (sites now) you will download it from the same place (http://wordpress.org/download/). We will be updating our manuals over the coming weeks with the new installation process. For now, check out our simple upgrade guide here: How to Upgrade WPMU 2.9.2 to WordPress 3.0 in 5 Easy Steps
New Terminology
Also it is important to know that much of the terminology we were used to in WPMU has changed, so to avoid confusion here is a quick glossary:
- WordPress MU -> WordPress Multisite (or "MultiSite", "MS", etc. This is WP with MultiSite enabled)
- Blog -> Site (a blog that a user can signup for)
- Site -> Network (a group of blogs are tied together, usually with a main blog to head them up and accept registrations. Unless you are using a special plugin a MultiSite install only has one Network)
- Site Admin -> Super Admin (the super user that has access to everything in the Network)
- All the admin menu's under "Super Admin" have also changed to reflect this new terminology.
Updating Plugins & Themes
Due to the vast amount of changes made in 3.0, many plugins and themes will be broken unless they are updated to work with 3.0. This is especially true for WPMU plugins and BuddyPress themes. Almost every single one will be broken if you don't update them. Luckily as a member of WPMU DEV you have an upgrades guarantee, and we have every single one of our plugins & themes compatible now!
When you update to 3.0, you will need to also update to the latest versions of all our plugins and themes! If you do not, there is a very good chance your site will be broken or even inaccessible until you do. It is also important to know that many of our 3.0 compatible plugin and theme versions WILL NOT be backwards compatible to WPMU 2.9.2 due to the vast changes between versions. If you are running 2.9.2 and want to install a plugin or theme from here you will need to go into the past versions and download an older one.
If you are doing a fresh install of WP 3.0 MultiSite there is a very important step to consider. The /wp-content/mu-plugins/ folder will no longer be created by default. Many MultiSite plugins will still need to be installed in this folder though. Simply create the /wp-content/mu-plugins/ folder if it doesn't exist and follow the regular install instructions. We will be updating our documentation to reflect this fact soon.
Final Instructions
So in summary, when updating to WP 3.0, you will also have to update all your plugins/themes, especially WPMU ones at the same time. We HIGHLY recommend setting up a test install and upgrading that first to make sure everything works before upgrading a live site. It will save you and your user's a lot of pain!
I will leave this thread open as it's a good place to ask any general upgrade questions. If your question is about a specific plugin or theme please start a new thread in the correct place.
Happy Updating!
Everyday at WPMU DEV we help hundreds of WP Users. Become a member today to:
- Download 250+ Premium Plugins and Themes
- Get unlimited support from WordPress Experts
- Get help with your WordPress or BuddyPress projects
Help & Support from WPMU DEV members and staff
Keeper of the Dark Chocolate
Just to throw this in, I've been trying to tag all of the threads/ topics here discussing wp3.0 with the Wordpress 3.0 tag. Hopefully this way folks here can quickly find what they're looking for.
It would be a plus if folks would help out with that tagging. Not a biggie but I did want to point that out.
Thanks,
-drmike
edit: In case anyone is wondering, we're waiting for 3.0.1 :)
Same here on the 3.0.1. There will be a lot of dust to settle from this one...
Get personal, comprehensive and timely support and assistance
from WordPress Experts
Is there any point at all in trying to use the automatic upgrade option or am I better going manual. I see lots of failed installs on the WP forums! I'm a bit scared but eager to upgrade.
I noticed a few plugins show an update date of 6-17-2010, but they still say compatible up to 2.9.2. Are they good to go with 3.0 if it shows today's date?
We ALWAYS recommend against using autoupgrade with WPMU. Too error prone for a WPMU site when you have users depending on you. Backup your db and files, then upgrade manually using FTP. You'll have to use FTP anyway to update your .htaccess file.
@tesla - anything updated today will be 3.0 ready, we've just yet to update the plugin pages fully.
We've been sitting waiting for 3.0 to be released, so have all made a mad rush to get the plugin updates uploaded and available (I think it took us less than an hour to get them live :) ).
Get personal, comprehensive and timely support and assistance
from WordPress Experts
Yes, they should be. We'll be changing those numbers tonight when we've finished uploading them all. Also if you click the "Other Versions" link you can see release notes, like this:
http://premium.wpmudev.org/project/anti-splog/download
Great work guys. Thanks.
Keeper of the Dark Chocolate
heh Looks like they're still having problems on remembering to hide the plugins page:
http://core.trac.wordpress.org/changeset/15271
;)
Well done guys, this must have been a whole lot of work on top of everything else.
I will wait patiently for the core bugs to phase out before I do any upgrade.
THanks.
Get personal, comprehensive and timely support and assistance
from WordPress Experts
Erstwhile founder
I will wait patiently for the core bugs to phase out before I do any upgrade.
I have my fingers crossed that most people will be smart enough to wait a bit.
Thanks,
Andrew
@georgef @andrew
Sounds like sage advice. I'll wait for a bit as well.
Great work though.
Get personal, comprehensive and timely support and assistance
from WordPress Experts
I am torn about what to do.
Had a WP.MU Install last week which was 2.9.2 and have only just started putting the site together. There has been a few bugs. Tammie has suggested perhaps a WP3 upgrade might be better for me considering I am new to WPMU and rather than learn 2.9.2 it will be better to learn 3 as it is different.
But then here you admit it may be smart to wait. I need to get this site going and am now worried about how buggy WP3 may be.
Any other advice?
@AquaPebble: my points were mainly about terminology and also about the fact the themes you wanted to use have had large updates for wordpress 3.0 that was the big factor towards you going onto wordpress 3.0 as you haven't gone live yet against those on this thread who already have quite a bit of data set up so a bug in 3.0 would impact them perhaps more hence their caution upgrading. That being said yes you do run the risk as I have said of it being a new version.
Ultimately it's a decision you have to make my choice with what you have said and done so far would be 3.0 but it's your call. I was also responding to your query when you asked should you upgrade as you seemed interested in doing so - I never suggested first you upgrade to 3.0.
Thanks Tammie. I know your advice is good and with good intentions. I realise the choice is mine and am really torn, as I agree with your advice, but when I read here that it is smart to wait, I became concerned as I was ready to do the upgrade.
I feel I don't have enough information to make the choice, hence asking for additional advice.
@AquaPebble if I was in your situation I would upgrade to WP3, as you said, your site is new, and if you do experience any hassles it will be a good learning curve for you. :-)
Get personal, comprehensive and timely support and assistance
from WordPress Experts
Keeper of the Dark Chocolate
Just to clarify, has anyone looked at the theme pack? It still has the previous date on it:
http://premium.wpmudev.org/project/farms-133-theme-pack
edit: The Older Versions page also shows the older versions.
I will wait patiently for the core bugs to phase out before I do any upgrade.
Sounds like sage advice. I'll wait for a bit as well.
Same here.
How ling will this thread remain a sticky? I'm thinking of waiting awhile.
OK so I took the plunge and did the upgrade according to those 5 steps and it went really smoothly. Thanks for the advice (especially Tammie).
Keeper of the Dark Chocolate
How ling will this thread remain a sticky? I'm thinking of waiting awhile.
We'll probably go through this when the next version rolls around.
I did notice though that they're gone straight to 3.1. Hopeful thinking?
I did notice though that they're gone straight to 3.1. Hopeful thinking?
Got to be!
They are punting everything to 3.1. They are taking a release cycle off, so 3.1 will be at least 6 months away.
For sure there will be some 3.0.x releases, likely soon with bugs like http://core.trac.wordpress.org/changeset/15271
Get personal, comprehensive and timely support and assistance
from WordPress Experts
Hi Aaron, I upgraded to 3.0, and the problem I'm having is that the url's are not working, because they are adding in the word "blog" into the previous blog posts url. For example, the links are now directing to:
When it should be:
http://modernsingleparents.net/2010/03/13/creating-a-positive-co-parenting-partnership/#comment-159
In order to work correctly. This is happening for every post and category.
How can I fix this?
Thank you!
Check the show on home page option under settings->reading. Try changing it then back to see if it resets your permalinks.
I didn't see a show on home page option on settings - reading, but there was the option to set a static page, which I did and then set it back. That didn't work.
Then I went to the permalink structure and added a "category base" with the word "blog" and that worked...now the question is, will this mess with the other blogs that get set up?
Thanks Aaron.
No it shouldn't. If you don't want the /blog/ try removing it on the permalinks page again.
You mean after I just added it, try taking it back out?
Yes, I think it will reset your urls.
That worked, thanks!
in my installation the problem is character encoding.
Keeper of the Dark Chocolate
@camaran, you need to give a lot more details then that. Best bet actually would be to start with a new thread since I have a feeling that this is a general issue, not one specifically dealing with 3.0. Please be sure to give these a read:
So, is it safe to ass/u/me that all wpmudev plugins and themes are good to go as far as wp3 is concerned? Even the ones that haven't been updated a few months?
Yes, we didn't have to update all of them.
Cool. Thanx @Aaron.
I'm building a final, pre-live version of one of my projects now. I hope to be good to go as soon as a few wp3.0x fixes come down the pipe.
Followed the upgrade instruction to the Tee and following the upgrade ALL USER's photos, avatars, logos and everthing is gone.
content /files/2010/06/grtatlmedia_logo.png
Most likely you deleted the blogs.php file without updating the line in your htacess file.
Keeper of the Dark Chocolate
Most likely you deleted the blogs.php file without updating the line in your htacess file.
Or the edit didn;t take due to the ownership of the file not allowing edits by your user account. The .htaccess file is created by the webserver so chances are it;s completely owned by the webserver.
I read that the all the plugins @ WPMU Dev have been updated and are 3.0 compatible. Have the install instructions been updated as well? Are plugins still uploaded to the MU folders or has that changed?
The install instructions are the same. The one exception is what I pointed out in the first post here is you may need to create the wp-content/mu-plugins/ folder as it's not included in the default WP3.0 zip file.
I have 3.0 setup on a test server, however I am having the same problem I did on 2.9.2. In the "WPMU DEV" Area, I am not seeing any content. Here is my previous thread, and it looks exactly the same but with WP3.0
http://premium.wpmudev.org/forums/topic/nothing-displayed-in-wpmu-dev?replies=1#post-38622
Yes, there are bugs with this plugin we are working on.
What is the process to upgrade 3.0? should I use the automatic upgrade or using file zilla? if I use file zilla, should I just copy the 3.0 files and replace the old version files? Also, should I upgrade the plugins first or the main site? Thanks.
http://wpmu.org/how-to-upgrade-wpmu-2-9-2-to-wordpress-3-0-in-5-easy-steps/
I would just follow the directions, overwrite the files via FTP.
@GreatAtlantic or anyone else who has an image issues after the upgrade, check your .htaccess line. You can't just change the blogs.php to ms-files.php - make sure you're also changing the directory part of the line.
won't mention why that's on my mind... /*whistles and looks innocent*/
Got it.
Keeper of the Dark Chocolate
Also make sure the edit actually took hold. I know with some servers (ie CPanel) it assigns ownership to of the wp-config.php file to the webserver. While CPanel does everything as root, edits have been known to not take hold.
Keeper of the Dark Chocolate
The closing of the mu forums have been made official:
New multi site forum here.
Keeper of the Dark Chocolate
Lots of repeated questions that have been answered many time previously on the old forums that folks now won;t have in front of them.
Fixed. :)
edit: Sorry but the best thing they could have done if they closed the old forums was to actually merge the old ones into the new ones. Now there's no past experience or "institutional intelligence" (that's not the term I'm thinking of but I can;t think of it) to draw on.
Hi Aaron,
What a huge work you have with the new versión of WP :P
Well, My issue is regarding admin ads, admin messages, messages and TOS, I downloaded the new code and rewrite the plugins, but still not working just show me a 404 page and I can´t find how to fix it on the instructions.
how can I fixed?
Thanx.
You mean a 404 page when you try to save the settings? That's the main symptom of the plugins NOT being updated.
Thanks for the link. The five steps seem easy enough indeed, but they always make it look easy!
One thing I don't see addressed is the order of things. I asked on that post if we should upgrade WP first or all the plugins. Sarah suggested doing the WP upgrade first, then plugins one at a time. We've already got all current wp plugins. Should we update all our mu-plugins first or take care of the WP upgrade first?
There will be less potential errors if you update WP first. When you are managing a complex WPMU site you should really be keeping a local copy where you can update everything (and test), then upload it all at once. SVN is great for this.
Thanks! We hope to get everything working on our test install, so the upgrade of the live site will be quicker and smoother.
So... 3.0.1 was just released. I have a WPMU 2.9.2 install and thinking about taking the plunge. Probably will wait for the weekend. I'm actually more concerned for non WPMU DEV customized themes and such then plugin breakdowns. We'll see. Been prepping for this for awhile!
Im right in the middle of upgrade and cross my finger
i still get the yellow nag screen about the .htacces change that i have done!
any ideas?
Keeper of the Dark Chocolate
Can you confirm the changes have been made to the htaccess file? Please actually check. I ask as that file is usually owned by the webserver and folks won;t be able to make modifications while logged in as their user account on many hosting platforms like CPanel even though CPanel tells you the edit was made.
FYI unsticking this now :)
Hi guys, so i'm finally starting to use the new Dev plugins with 3.0 and i realized that the mu folder was missing so i wanted to make sure that i was indeed supposed to create it and i finally found the answer in this thread.
I'm going to suggest that you add notes to the install instructions of all the updated plugins that explain that users need to create the folder with a fresh install of 3.0 because it certainly caused me some confusion and took some time to find the answer. I'm sure that others will feel the same way as you continue to grow your membership.
I am going to follow all of the instructions in all of the plugin install directions exactly and put everything where they say to. In the past i was able to use plugins by putting them in regular plugins folder for some reason. I will report any issues that i have with using this plugin folder to this thread i guess.
It says above that not all of the Dev plugins go in the /wp-content/mu-plugins folder. I think it would be nice to see a definitive list of which ones go where if at all possible.
Thanks!
Justin
ok so i put all of the files in the mu-plugins folder that i created and everything seems to be working fine. for the first time i noticed that there are install instructions under where we download the plugins (duh) but i also noticed that the install .txt files were not found with every plugin and the folder structures weren't always consistent. not to be nit picking hehe i just think new users would appreciate more consistency in terms of the files and install instructions included in the downloads. regards!
Justin
Yes we are moving all docs to this site and Working on more consistency.
Allows you to scale your standard Multisite install to allow for millions of blogs... also will vastly improve the performance of your site!