Nibble

Moving from Umbraco V4 to v5 : Installation

First post in a hopefully large series on the differences and similarities between Umbraco v4 (webforms) and Umbraco v5 (MVC). So this assumes you’ve already used Umbraco v4 and are starting with Umbraco v5 (although it should also be valuable if you don’t have previous experience and just want to get started with Umbraco v5).

As an obvious first post we’ll take a look at the installation of Umbraco v5.

There are different ways to install Umbraco but here I’ll outline my preferred option, downloading the latest stable release from codeplex and using webmatrix to get up and running.

To get details on different installation methods( iis and web platform installer, nuget, visual studio template, manually, …) check out the getting started page on the v5 documentation.

Downloading

You can always find the latest stable release on http://umbraco.codeplex.com/releases, at the time of this blogpost that’s Umbraco 5.0.1. So simply download the recommended download (the web application).

image

There is also an option to get a nightly build (so a work in progress version) you can find those at http://nightly.umbraco.org/ (of course there is no guaranty that the version you’ll download will work 100% since it’s a current development version).

Once the download is successful you should end up with an archive if you unzip that you should have a file structure similar to the following screenshot.

image

Firing up

Now to get Umbraco running I’ll be using WebMatrix, if you don’t have it installed you can get it at the following site http://www.microsoft.com/web/webmatrix/ (basically WebMatrix will make it easy to get up and running without having to worry about all the dependencies, you might have to install Umbraco once trough the web gallery to make sure the dependencies get installed).

WIth webmatrix installed I can simply fire it up and have it ready to run my site if I open the context menu on the Umbraco web application archive folder.

image

After hitting the ‘”Open as a web site with Microsoft WebMatrix” option you should end up with an instance of WebMatrix that has the Umbraco site open (tree at the middle left should show you the files).

image

So all that’s left is to hit the run button in the webmatrix toolbar.

image

Webmatrix will open a new browser window or will add a new tab to an existing window and you should see the following

image

So now we’ll have to launch the Umbraco installation wizard by clicking 1 of the 2 links.

Installation wizard

The installation wizard looks pretty much the same as it did in Umbraco v4 with the big difference being that there are less steps in the installation process (no license and no skins step).

image

After hitting “Lets get started!” We need to specify the db that we want to use. Currently you can choose for SQL Server 2008 (and higher versions), SQL CE 4, or a custom connection string.

Still pretty similar to the v4 installer just that SQL Server 2005 isn’t supported and that there isn’t support for MySQL at this point. If you choose the SQL CE 4 option you won’t need to add additional files like you needed when installing v4 on SQL CE. So to get up an running without having to worry about the db simply choose SQL CE 4 and hit install.

image

After hitting install you should see the installation progress and once it’s finished you can continue to the next step.

image

In the create user step you’ll have to specify the admin user details (this is exactly the same as on v4).

image

After the user step you’ll be able to install a starter kit, this will install a sample starter site. Currently there is only 1 you can choose and there is no option to choose a skin for it (so different to v4 at the moment).

image

Once that step is completed the installation is done

image

Accessing Umbraco

After a successful installation it’s possible to go to the Umbraco backend and that’s still located at /Umbraco

image

So after providing the user credentials (that where setup in the create user section) you should have access to the Umbraco backend (again looking very familiar).

image

Conclusion

If you have experience with setting up an Umbraco v4 it al feels very familiar and you should be up and running in a couple of minutes.

1 Comment so far

  1. Iwin on December 10th, 2012

    Thanks for your post. it is very clear

Leave a Reply