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

image

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)

image

In the Development Tools section, select Advanced Tools, then select Go.

image

When the Kudu window opens, from the Debug console menu, select CMD.

image

Select site.

image

Then select wwwroot.

image

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.

image

The file will be uploaded and unzipped.

image

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.

image

Stop the website, wait a minute, and restart the site.

image

Navigate to the root of the site in your web browser.

image

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…

image

…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'

image

Drag and drop the install package again .

image

Navigate to the root of the site in your web browser again .

image

The Install Upgrade Wizard will show.

Fill in the information for the Administrator account and click the Log In button.

image

The site will detect that there are upgrade scripts to process and it will process them.

image

When the processing is complete, you will be presented with a button to Click Here To Continue.

image

You can confirm that the upgrade was successful by logging in as the Administrator, and checking the updated version number in the Settings.

An error has occurred. This application may no longer respond until reloaded. Reload 🗙