FAQs for ASP.NET

What is Microsoft ASP.NET Core?

Microsoft ASP.NET core is an implementation of the Microsoft .NET Framework, specifically targeted at providing basic services for internet-connected apps, such as web apps, IoT (Internet of Things) apps and mobile backends.

Apteco Orbit (or at least the Orbit API) is implemented using the Microsoft ASP.NET Core framework.

Why are we doing this?

We have used .NET Core 6 for a number of years in Orbit (as a previous “Long Term Service” - LTS - version of .NET), but it will soon stop being supported by Microsoft and will no longer receive security updates, representing a security risk.

The current LTS release of .NET (including the ASP.NET Core libraries) was released in March 2024 and we are now migrating Orbit to this version.

What do partners/customers have to do?

For existing Apteco Orbit installations

You do not yet need to uninstall the existing version of ASP.NET Core 6. You can uninstall this after we have fully migrated Apteco Orbit to ASP.NET Core Runtime 8.

  1. Install the ASP.Net 8 Hosting Bundle from dotnet.microsoft.com/en-us/download/dotnet/8.0

  2. Install the .NET Desktop Runtime from the same resource dotnet.microsoft.com/en-us/download/dotnet/8.0

For new Apteco Orbit installations

Both the ASP.NET Core Hosting bundle (8.0) and .NET Desktop Runtime items should be installed.

Will we have to do this again?

We anticipate eventually having to move to a newer version of .NET in the future, but Microsoft have committed to supporting .NET 8 until at least November 2026. See https://dotnet.microsoft.com/en-us/platform/support/policy/dotnet-core for further information.

When will we push out the first version of the Orbit API that requires .NET 8?

Orbit Version 2.1.3 released on June 10th 2024 requires .NET 8. If telemetry and other feedback indicates a slow take up (of ASP.NET Core 8) we may choose to delay this.

Using an unsupported version of the .NET library increases the potential of a security risk. Apteco needs to balance this risk with any delay.

What will happen if the required version of ASP.NET Core is not installed?

When the first version of the Orbit API that requires ASP.NET Core 8 is release, those systems that don’t have the pre-requisite will still be able to continue to use Orbit.

They won’t automatically update until the pre-requisite is installed and will not benefit from any new Orbit features or fixes.

Once ASP.NET Core 8 has been installed, are any other actions necessary?

No. The updater detects the presence of ASP.NET Core 8, the next time it attempts an update and then updates to the latest version.

Are there any pre-requisites for installing ASP.NET Core 8?

Yes. The operating systems that are supported can be found [here].

My web server's OS is not on that list. What does this mean?

If the web server is running on an operating system that is not in the list supported by Microsoft, then you will not be able to install Microsoft.NET Core. Please see above What will happen if the required version of ASP.NET core is not installed for how this will affect your system ongoing.

Will this affect any other applications that use .NET Core?

No. ASP.NET Core 8 can be installed side by side with other versions of the same component library.

Issues when uninstalling earlier versions of ASP.NET Core

Uninstalling earlier versions of the ASP.NET Core hosting bundle (e.g. 6) before installing the latest version can result in the ASP.NET Core 8 hosting bundle being de-registered within IIS, resulting in the OrbitAPI no longer running correctly.

To avoid this, repair the ASP.NET Core installation from within Apps & Features:

  1. Select the Windows Server Hosting entry, and then the Modify option.

  2. In the dialogue that opens, choose the Repair option.

  3. Restart IIS.