BlogEngine.NET 1.3 Upgrade Guide

As we all know, installing BlogEngine.NET from scratch is a piece of cake.  Upgrading, however, can cause people a bit of concern and it is easy to overlook something.  Here is a guide for your journey to BlogEngine.NET 1.3 from 1.2.

1. Back it up

This is the standard first step to doing most anything.  While I don't always do this step myself, I should and you'd be wise to as well.

At a minimum, backup your App_Data folder and any custom themes or extensions you might have done.  SQL users should add the sql.config file as well as the database to that.

2. Download BlogEngine.NET 1.3 (website)

This is an easy and painless step.  If you are reading this, you likely already have done this step.  If not, get it here.  Unzip this file to a place you can work with it.  Go into properties and remove the Read Only check.  (This step has helped some and has never hurt anyone.)

3. Update the Database

If you are an XML user, please take a moment of silence for your SQL lovin' brethren, as they actually have something to do in this step.  Then move on to step #4.

Ok, SQL provider people, there are two things you need to take care of to get ready for 1.3.

First, you need to download the upgrade script and run it.  This does a bunch of magic including adding a field to a table, adds some entries to your settings table, and some other stuff like indexes, relations, etc.

Second, you are going to need to update your web.config file.  Release 1.3 has moved away from using the sql.config as it was not supported in mono.  So you are going to need to move your connection string to the new web.config file.  (Yes, I'm really sorry about that.) Also, don't forget to make the MSSQLProvider the default provider (as XML is the default setting in the new web.config.)

4. Update your web site

Now, we are copy the new stuff to your website.  You'll want to copy everything up except the App_Data folder.

Once it is copied, you should be able to browse to your blog and see the 1.3 version number at the bottom of the page.

5. Update your Settings

Settings - Mozilla Firefox (2) Login and go to your settings page.  There are a few new things to look at.

Under the Basic Settings area, you'll see a Mobile Theme and Show post navigation links options.  Be sure to select Mobile for your Mobile theme (unless you've already made a new one.)

Under the Advanced Settings, Enable Trackbacks and Enable Pingbacks now appear with Send and Receive options.  Turn them on or off as you'd like.

Be sure to click Save Settings when you are done.

Troubleshooting

If you are having trouble getting your web site up after copying the files up, please remove any custom themes and extensions and try again.  (You may need to manually change the selected theme to Standard in your settings.xml file or be_settings table if you remove a theme that you were using.

If you still have trouble after that, please have a look on the BlogEngine.NET forums and wiki.  Someone else likely had a similar problem so searching is the best option.  If not however, ask a question.

Good luck and enjoy the latest version.

Comments

12/24/2007 6:01:08 PM #

pingback

Pingback from rtur.net

Quick update on 1.3 release

rtur.net |

12/24/2007 6:16:13 PM #

Phil Garcia

Thanks for the script!

Phil Garcia United States |

12/24/2007 9:36:30 PM #

Justin Wendlandt

Thank you for providing this update script. It worked perfectly!

Justin Wendlandt United States |

12/24/2007 9:43:24 PM #

Jack

Thanks...I really appreciate your efforts... Looks like my conversion went smoothly...now onto finishing my theme...

Jack Switzerland |

12/27/2007 8:47:18 PM #

pingback

Pingback from 13bit.com.ar

BlogEngine.NET 1.3 released

13bit.com.ar |

12/30/2007 1:58:44 AM #

Kurt LeBlanc

Nice Job! Appreciate the script. I'm also looking forward to customizing my theme.

Kurt LeBlanc United States |

12/31/2007 8:30:12 PM #

Stevo

Hi. I was trying to upgrade from 1.2 because after some testing of that version, I keep getting fatal bugs relating to adding/deleting/editing categories. Is this a known bug? Is there a workaround? My host is Godaddy and it doesn't look like I can easily upgrade to 1.3.

Is it known what the problem is with the categories bug?

Stevo United States |

1/8/2008 2:45:28 AM #

Linus

Hi.

Thanks for the great guide. But i have some problems. I have backcup my App_Data from dotnetblogengine 1.2.

The problem is. I cant se my old posts i the new version.
I have my old App_Data but i still not se my old posts and my settings.

Please help me.
My english is not the best, sorry.

Linus Sweden |

Comments are closed
Recent Comments