How to install .NET Core updates on a GDOT server?

Download as pdf : 
Products: Aspen GDOT 
Last Updated: 03-Nov-2020
Versions: 
Article ID: 000097464
Primary Subject: 
Attachments (1)
Problem Statement

This KB describes the best practice to install .NET Core updates without affecting GDOT components.

Solution

Updating .NET Core is not required by GDOT. The GDOT V11 media automatically sets up .NET Core 2.1.5 as part of the installation process. The GDOT Web Viewer can run without issues using this version.

However, if there is an IT or Cybersecurity policy which requires an update to .NET Core 2.1 on the GDOT Web Viewer server, the update must be applied using the ASP.NET Core Hosting Bundle installer. The Hosting Bundle installer includes the .NET Core runtime, ASP.NET Core runtime and the ASP.NET Core IIS Module, all of which are required by the GDOT Web Viewer.

User-added image
This is the recommended option by Microsoft for Windows Servers that deploy .NET Core applications. The GDOT Web viewer server deploys a .NET Core application – the GDOT Web Viewer web page – and it requires the runtime portion and IIS support. 

It is important to remark that .NET Core updates are not typically distributed via Windows Update, as opposed to .NET Framework. .NET Core updates are only available from https://dotnet.microsoft.com/download/dotnet-core/ and manually installed, or deployed using silent packages (customized by local IT resources).

Possible scenario

It has been reported that the GDOT Web viewer may fail to start after installing the .NET Core 2.1.19 update with HTTP 502.5 error.

This issue will occur after installing the .NET Core Runtime installer, instead of the Hosting Bundle installer. To fix this issue, it will be necessary to install the ASP.NET Core Hosting Bundle.

User-added image


Tech Tip

To confirm the .NET Core version installed in the server, open a PowerShell instance and issue the following command:
dotnet --info

User-added image
.NET Core version installed on a GDOT V11 Web Viewer server (2.1.5)

User-added image
.NET Core version after installing the ASP.NET Core 2.1.19 Hosting Bundle on a GDOT Web Viewer server

Keywords
.NET Core, GDOT Web Viewer, HTTP Error 502.5, GDOT, .NET Core Runtime, .NET Core Hosting Bundle
 
Attachments
Filename Date Added
HTTP Error 502.5 on GDOT Web Viewer after NET Core Installation.pdf 17-Sep-2020