How To Manually Upgrade The Umbraco Database

A website can be a company’s gateway to making sales, generating leads or getting customer engagement. In some companies, zero-time is vital. If the website is down for maintenance while it’s being upgraded, it can cost a company hundreds, or even thousands of pounds in lost revenue. One way to create zero time deployments is to do the upgrades offline.

In most organisations of a certain size, you will have multiple environments, UAT, Staging, Live. Having these different environments is vital for business continuity but poses a problem when we upgrade. How do you update the database for each environment?

When you do an upgrade, Nuget will update your files and then when you load your site, the Umbraco database upgrade wizard will display.

Umbraco_Upgrade_rerun

After logging in, you see the upgrade wizard:

Umbraco_Upgrade_rerun_1

After you upgrade, the upgrade wizard will not be triggered again. When you deploy your files to a new environment your site will break. Instead, you can force Umbraco to re-load the upgrade wizard.

How To Force The Upgrade Wizard To Display

Open up your web.config file and in your section you should find a key called ‘umbracoConfigurationStatus’:

<add key="umbracoConfigurationStatus" value="7.5.0" />

To force the upgrade wizard to display again, you need to change the value to the version you upgraded to.

<add key="umbracoConfigurationStatus" value="6.1.6" />

After that, when you try and view your website on test, or staging, you should see the upgrade wizard again.

Jon D Jones

Software Architect, Programmer and Technologist Jon Jones is founder and CEO of London-based tech firm Digital Prompt. He has been working in the field for nearly a decade, specializing in new technologies and technical solution research in the web business. A passionate blogger by heart , speaker & consultant from England.. always on the hunt for the next challenge

More Posts

0 replies

Leave a Reply

Want to join the discussion?
Feel free to contribute!

Leave a Reply

Your email address will not be published. Required fields are marked *