Update Amplia from 3.x to 4.0

Note

If your Amplia instance is on a 2.x version, update first to 3.0

Warning

This update creates two missing indexes, on the Orders and Certificates tables. If your database has a high number of orders and/or certificates (several thousands or more), the database update may fail. In this case, update the database manually with the command update-db passing a high --timeout <seconds> value.

Now that ASP.NET Core 3.1 is deprecated, version 4.0 of Amplia has been migrated to use ASP.NET Core 6.0, which is the newest LTS release of ASP.NET Core, to be supported by Microsoft until November 2024.

Because of that, to update your on-premises instance, you must install the ASP.NET Core Runtime 6.0.

Please refer to the Install the ASP.NET Core Runtime 6.0 section of the installation procedure corresponding to your platform:

• Windows Server
• Linux
  • Ubuntu Server
  • Red Hat Enterprise Linux
  • Oracle Linux

Note

On Docker, there's nothing to do, the new 4.0 image already ships based on the ASP.NET Core 6.0 image

Azure App Services

If your Amplia instance is hosted on Azure App Services:

1. On the Azure Portal, enter your App Service configuration
2. Click on Configuration, then select the General settings tab
3. On the Stack settings section:
   1. The Stack setting should be set to .NET
   2. The .NET version setting, should be set to .NET 6 (LTS)

Tip

The Stack settings section mentioned above is only shown if the App Service Plan is Windows-based. Otherwise, for Linux-based plans, no changes are needed.