How to upgrade from uSkinned Site Builder for Umbraco 8 to Umbraco 11
Latest compatible version: Umbraco 11.0.0 uSkinned Site Builder 4.0.0
Make sure you are running uSkinned Site Builder 1.1.6 for Umbraco 8 before completing these steps.
This guide also assumes that you have not made any changes to uSkinned code, Document Types, Data Types etc.
If you have made your own changes then you will need to migrate these changes yourself.
Step 1
Create a new Umbraco 11 project and install uSkinned Site Builder for Umbraco 11.
Follow our guide here if you are unsure how to do this.
Step 2
Install uSync against your new Umbraco 11 website.
dotnet add package uSync
Step 3
Go to your Umbraco 11 website directory and delete the contents of:
~/wwwroot/media/
Go to your Umbraco 8 website and copy the contents of:
~/media/
Paste your copied media into your Umbraco 11 website directory at location:
~/wwwroot/media/
Step 4
It is very important that you take a backup of your Umbraco 8 database before proceeding with the next steps.
Locate the following file within your Umbraco 11 website directory:
~/appsettings.Development.json
Update the connection string to point to your Umbraco 8 database.
Set UpgradeUnatended to true.
Set RunSchemaAndContentMigrations to false.
{ "$schema": "https://json.schemastore.org/appsettings.json", "ConnectionStrings": { "umbracoDbDSN": "YOUR UMBRACO 8 DATABASE" }, "Umbraco": { "CMS": { "Unattended": { "UpgradeUnattended": true },
"PackageMigration": {
"RunSchemaAndContentMigrations": false
} } } }
Step 5
Go to your Umbraco 11 website directory and copy the contents of:
~/usn/updates/4.x/
Paste the contents of the uSync folder above into your uSync folder at the route level of your website. Your uSync version folder may be v9. This can have any name. It is controlled by a uSync config setting.
Any other files in your updates folder should be pasted into the corresponding path at the route level of your website.
Run your website and login to the Umbraco CMS. Dont worry if you see an error when browsing the frontend of your website at his stage.
Go to the Settings (Section) > uSync (node) > Import Settings
This will update Document Type and Data Type changes
Go to the Settings (Section) > uSync (node) > Import Content
This will update Dictionary item changes
When the settings import is complete your website will be upgraded to Umbraco 11.
Step 6
If you have made any changes to your website design make sure you re-save your Design node to generate the stylesheet for your website.
If you have completed the above steps to upgrade and experience any issues, please refer to the following troubleshooting solutions.
Troubleshooting
The following issues are a result of not following Step 1 in this guide and instead attempting to complete the upgrade process via NuGet.
Error in backoffice when viewing content nodes
'Sequence contains more than one matching element'
Caused by duplicate property editors which happen due to the presence of property editors found in the folder:
~/App_Plugins/
The property editors from this folder are now included with the Razor Class Libraries for Umbraco 10.
If you are using Umbraco Forms, delete the folder:
~/App_Plugins/UmbracoForms
If you have upgraded via NuGet, delete the folder:
~/App_Plugins/uSkinned
Now, rebuild your project and run.
Form Submission goes to a blank page with Javascript output
Javascript is broken due to a change in the file
~/Views/USNMaster.cshtml
Contact support for guidance on fixing this issue.
#h5yr
Related guides