Skip to main content

IMPORTANT: Pre-upgrade manual steps

warning

Please read this information carefully before upgrading.

This page provides warnings about changes in the new version of Alvao that may cause problems when upgrading from the previous versions.

We also recommend to read the list of subsequently identified issues in the released versions and their solutions on the Known issues page.

Before upgrade to ALVAO 25.1​

warning

When upgrading from older than immediately preceding version of Alvao, read also the pre-upgrade steps for all the versions that were skipped in their chronological order.

Core features​

  • WebApp, REST API, Custom Apps WebService and Alvao Service have been migrated to .NET 8, enhancing performance, security, and maintainability. (T155067ALVAO)

    • ASP.NET Core 8.0 Hosting Bundle and SDK 8.0.3xx have to be installed on the application server. If the server is connected to the internet, both packages are automatically installed by the Alvao Server Setup.
    • Each web application is running on its own IIS application pool.
    • Most of the application settings have been moved to the appsettings.json file from the Web.config. Therefore some settings can no longer be changed via the IIS console.
    • Make sure that identity for AlvaoWebApp AppPool has write permission in C:\Windows\System32\config\systemprofile and C:\inetpub\wwwroot\Alvao folders on the application server.

  • Alvao REST API, Alvao Service – if you use Azure Storage to store application logs, in the appsettings.json file, move the Azure Blob Storage connection string from the AzureBlob property at the root to the “AzureBlobLogs” property in section ConnectionStrings.

  • Alvao REST API - appsettings.json - move two following settings from the AppSettings section to the root (T158940ALVAO):

    • AAD_ClientSecret
    • AAD_TenantId

  • Don't forget to perform the post-upgrade manual steps after upgrade.

ALVAO Asset Management​

  • The AM Agent application is now part of the new ALVAO Discovery Agent module and is no longer available in the core ALVAO Asset Management product. To continue using this application after upgrade you will need to renew your activation key. (T156248ALVAO)

  • The features related to Software Asset Management processes are now part of the new ALVAO Software Asset Management module and are no longer available in the core ALVAO Asset Management product. To continue using these features after upgrade you will need to renew your activation key. (T156248ALVAO)

  • We recommend upgrading from version 11.2 SP1 or newer, to have AM Agents upgraded seamlessly to version 25.1. When upgrading from older versions, AM Agent will not upgrade automatically and you will have to either install the now-retired AM WS on Alvao Server to upgrade Agents, or deploy the new Agent some other way.

    AM Agent must be upgraded to version 25.1. Previous Agent versions don't work with current Alvao Server as the server communicates with Agent only via REST API. Before upgrade, make sure the the Alvao REST API url is set on the Administration – Settings – Web Services page. (T155160ALVAO)

  • AM Agent no longer supports the Agent over TCP/IP and Agent over shared folder scan methods. (T163665ALVAO)

  • If you have been using Alvao since before 4/2021 (i.e., since version 10.3 or older) chances are that some objects are not strictly unified with their object template. For objects whose name settings differ from their object template name settings, their name settings will be overwritten by the object template name settings during the upgrade to the new version. If an object name changes due to this, you will find a record of it in the object log. For more details, see object name template. (T161496ALVAO)

  • If some objects are not unified with their object templates, and contain some extra properties beyond their templates, those properties will be automatically added to the object templates to preserve object data. Such properties will be added to all objects of that object type.
    Run the script AMObjectPropertiesRefactoring.sql to identify such properties before upgrading, and adjust the object properties as needed. (T171485ALVAO)