Upgrading

Major upgrades : Upgrading from 3.x to 3.y

!Upgrading may require to re-activate your license in some cases. Read below for details.
If this is your case, please check beforehand that you will have a the ability to activate, otherwise your Alpana Server installation will stop working while you are reaching Support to solve it.
In case this happens, you may downgrade again to a version that supports your license, until a new activation is made available to you.
Check with your Support for more information.

A license activation is only valid while the first two numbers in the version don’t change.
Example : from v3.0.1.1 to v3.0.2.2, the license is still valid because you’re still in v3.0. You don’t need to activate your license again. It works normally following the upgrade.
Example : from v3.1.2.1 to v3.2.0.1, the license is not valid anymore because you upgrade from v3.1 to v3.2. You will need to activate your license again.

When the upgrade involves a change in major version (from v3.*.*.* to v4.*.*.*) or minor version (from v3.1.*.* to v3.2.*.*), and the license needs to be fully activated again.
You will need to submit again a license file and do a full activation.

!Until then, the Alpana Server installation is unlicensed and will not work.

General procedure

To upgrade Alpana Server from v3 to a newer v3, please follow the below procedure :

1. Backup

You must make sure you have all information to install again :

Folder path to the website

Note the current folder path of the installation.

!It must be the same during the upgrade, otherwise you will not be able to keep your configuration and dashboards on upgrade !

Network configuration

Note the DNS or IP addresses and ports of Frontend and Backend
If you used HTTPS, gather all required SSL information.

*If you change those settings during the upgrade, your users won’t be able to reach the website on the same address again.

SQL database connection

The upgrade will ask again for credentials to let Alpana access its SQL database.
Check that you have all the required information.

!It must be pointing to the same database during the upgrade, otherwise you will not be able to keep your configuration and dashboards on upgrade !

Other IIS configuration

If you tinkered with the IIS configuration manually, you must also back it up, as you will have to re-create it.

(optional) Application backup

As with any maintenance operation, you may wish to do a backup before the upgrade.

2. Read about the upgrade

Read the corresponding Release Notes

3. Un-install

Use Windows Control Panel to un-install previous versions of Alpana Server and Designer.

*Note : If you don’t stop the application, Windows will probably require you to reboot.
If you don’t want to reboot, you must stop the application before uninstalling.
To completely stop the application, you may need to stop the IIS server itself.
⇒ If you do this, don’t forget to start IIS again after uninstallation.

4. Pre-Requisites

Make sure you still meet the Pre-Requisites

5. Install

Run the new installers and perform the installation procedures again for Alpana Server and Alpana Designer.

*When upgrading Alpana Server, please instruct all your users to clear their browser cache or do a hard refresh.

Code192 2020 All rights reserved