11/27/2020 Administrator
Upgrading Blazor Blogs (Version 1.0 to Version 2.0)
If you want to upgrade Blazor-Blogs from any version that begins with 1.0 to a version of Blazor-Blogs that begins with 2.0, you must use the following directions rather than the usual upgrade instructions covered here: Upgrading Blazor Blogs.
Before beginning any upgrade, backup the website and the database that the site is running on.
Step One: Start with an Install of Blazor-Blogs
These directions assume you have a 1.0 version of Blazor-Blogs installed using the directions covered here:
Installing Blazor-Blogs on Microsoft Azure (Manual Method) or here: Installing Blazor-Blogs on Microsoft Azure (Deploy To Azure Button Method)
Step Two: Download The Upgrade Package
Download the Blazor-Blogs_01Versions_to_02.00.00_UpgradePackage.zip file from:
Release Version 02.00.00 · ADefWebserver/Blazor-Blogs (github.com)
Step Three: unzip the contents over the existing version 1.0 installation
(Note: The following upgrade instructions cover a Microsoft Azure deployment)
(Note: If not using Microsoft Azure, ensure that .NET 5 is installed on the server)
In the Development Tools section, select Advanced Tools, then select Go.
When the Kudu window opens, from the Debug console menu, select CMD.
Select site.
Then select wwwroot.
Drag the Blazor-Blogs_01Versions_to_02.00.00_UpgradePackage.zip file onto the web browser window until you see the box that says: Drag here to upload and unzip.
Release your finger on your mouse to drop the .zip file in that box.
The file will be uploaded and unzipped.
When the process is complete, Error boxes will display that there are more files than can be displayed.
This is normal.
Note: You can also deploy the files to the wwwroot directory using other methods such as FTP.
Stop the website, wait a minute, and restart the site.
Navigate to the root of the site in your web browser.
If you get an error, this is normal.
Click on the link presented, to log back into to Azure portal to see additional details, or…
…log into portal.azure.com directly, and navigate to the Diagnose and solve problems section to see the details of any error.
If any of the error messages are one of the following:
- Unable to locate application dependencies. Ensure that the versions of Microsoft.NetCore.App and Microsoft.AspNetCore.App targeted by the application are installed.
- Could not find 'aspnetcorev2_inprocess.dll'. Exception message: Error: An assembly specified in the application dependencies manifest (BlazorBlogs.deps.json) was not found: package: 'Humanizer.Core', version: '2.8.26' path: 'lib/netstandard2.0/Humanizer.dll'
Drag and drop the install package again .
Navigate to the root of the site in your web browser again .
The Install Upgrade Wizard will show.
Fill in the information for the Administrator account and click the Log In button.
The site will detect that there are upgrade scripts to process and it will process them.
When the processing is complete, you will be presented with a button to Click Here To Continue.
You can confirm that the upgrade was successful by logging in as the Administrator, and checking the updated version number in the Settings.