T31-2021 BIOVIA Notebook 2021 to 2021 HF1 Upgrade

BIOVIA Notebook 2021 to 2021 HF1 Upgrade:

When Notebook 2021 HF1 is applied to a fresh installation of 2021, existing configuration in some web.config files are re-added and this leads to errors when trying to login to ElnAdminWeb or Notebook

Program

BIOVIA Notebook 2021 HF1

Operating System

Microsoft Windows Server (64 bit), 2016 and 2019

Background

Due to a settings version mismatch between Notebook version 2021 and 2021 HF1, when upgraded from 2021, some existing configurations are duplicated in RIA/web.config, ElnAdminWeb/web.config and NotebookLoginSerive/web.config files.

Workaround

If you have installed Notebook 2021 as a new installation, i.e. not upgraded from a release before 2021, then you must carry out an extra step before you can upgrade to 2021 HF1.

For SQL Server:

Use Microsoft SQL Server Management studio to connect to the "ELN" database.

Execute the following statement:

update eln.VERSION
set DATABASEVERSION='8.00130',
SETTINGSVERSION='8.00195'
where DATABASEVERSION ='8.00070'
and SETTINGSVERSION='8.00020'

After this, follow the upgrade instructions for 2021 HF1.

For Oracle:

Use SQL/Developer or a similar tool to connect to the database as user ELN.

Execute the following statements:

update VERSION
set DATABASEVERSION='8.00125',
SETTINGSVERSION='8.00195'
where DATABASEVERSION ='8.00070'
and SETTINGSVERSION='8.00020';
commit;

After this, follow the upgrade instructions for 2021 HF1.

In the case that an attempt was made to upgrade to 2021 HF1 without applying the changes above, then please note the following:

To fix the problem with the web.config files, first restore the Notebook application server files from the backup taken before upgrading.
Re-run the upgrade to 2021 HF1. There may be errors reported from two settings upgrade step that affect the applicationHost.config file, because that change is already applied. That error can be ignored.

To upgrade a 2020 SP2 installation that has never been upgraded to 2021 or 2020 HF1, please contact BIOIVA Support.

BIOVIA Support

If you have any questions, please contact BIOVIA Support.