Skip to main content

On-premises upgrade

Planning​

Before you upgrade to a new version, please carefully read the Important notices and Known issues sections.

Before you upgrade the production environment, we recommend that you first test the upgrade itself and all production-critical features in a separate test environment.

If you have a perpetual license and are planning a manual upgrade, make sure that the version is covered by your license, i.e. that the version has been released within 1 year of the license being issued.

Upgrade preparation​

  1. Inform users before starting the upgrade.
  2. Switch the database on SQL Server to RESTRICTED_USER mode. When using SQL Server Management Studio, perform the following steps.
    • Right-click the Alvao database and select Properties.
    • Go to the Options page.
    • From the State section, set the Restrict Access option to RESTRICTED_USER.
warning

In the RESTRICTED_USER mode, only users with sysadmin, dbcreator or db_owner privileges will be allowed to access the datababase. However, only a user with sysadmin or db_owner privileges can run the upgrade.

Data backup​

  1. Backup the database or check that a current backup exists.
  2. Backup the folders on the server where Alvao is installed, i.e.:
    • C:\Program Files (x86)\ALVAO
    • C:\inetpub\wwwroot\web application folders

Alvao Server​

The Alvao Server Setup application supports the upgrade of a typical Alvao server application installation (i.e. all server applications installed on one server) from version 10.3 SP1 and later. If you are upgrading from an older version or using a non typical installation, follow the Alvao Server - manual upgrade instructions.

  1. Go to the ALVAO Downloads page and download the AlvaoServerSetup.exe application.
  2. On the server, run the AlvaoServerSetup.exe installation file and follow its instructions.
warning

Check carefully that the right Alvao database will be upgraded and no other, e.g., a production db instead of a test one. ServerSetup upgrades the database used by Alvao Service installed on the same machine. ServerSetup displays the database connection string so you can check it before upgrade.

note

When upgrading the database, the current activation key is verified over the internet.

Client applications​

The Asset Management Agent is updated automatically according to the installed version of the Alvao Server.

tip

You can also download the latest version of the installation package from User Menu - Settings - Install Applications.

Completing the upgrade​

  1. If you have upgraded the SQL Server prior to the Alvao upgrade, please also increase the compatibility level of the database to the highest value available.

  2. Switch the database back to MULTI_USER mode, see the Upgrade preparation section for the procedure.

  3. The Web.config files of server applications could be overwritten by default settings during upgrade. If you have some custom settings in those Web.config files, restore them from the backup files Web-backup-{datetime}.config after upgrade. This applies to following applications:

  4. Perform the post-upgrade manual steps.
    When upgrading from older than immediately preceding version, first perform the post-upgrade steps for all the versions that were skipped in their chronological order.

  5. Restart the IIS server.