Upgrade Previous Versions

When you install AVEVA Recipe Management 2023 R2 (v5.1) on a system that already has an earlier version of AVEVA Recipe Management installed, the installation procedure automatically detects the earlier version and upgrades it to AVEVA Recipe Management 2023 R2 (v5.1).

NOTE:
- Ensure that the user running the AVEVA Recipe Management setup.exe and/or the Configurator utility has 'sysadmin' privileges in SQL Server. The 'sysadmin' privilege defined in SQL Server is necessary for the successful upgrade of ASB components on a node where previous versions of AVEVA Recipe Management was installed or previous versions of AVEVA System Platform were installed.
- If you have localized the AIM Login page and are upgrading from versions earlier than AVEVA Recipe Management (v5.0), ensure that you back up the respective AIM localization language file from C:\Program Files (x86)\Schneider Electric\ArchestrA Identity Manager\Host\Resources location. After the upgrade is complete, copy the file to the new localization location C:\Program Files (x86)\AVEVA\Platform Common Services\Management Server\Resources\Languages.
For more information, see the Localizing the AVEVA Identity Manager topic in AVEVA Recipe Management User Guide.
- Ensure that AVEVA Recipe Management History database size is not more than 4 GB before upgrading the product. If the database size exceeds 4 GB, archive the data using AVEVA Recipe Management History Archive Utility.

The AVEVA Enterprise License Manager is not installed as a part of an upgrade, and you must run the AVEVA Recipe Management setup again and click Modify to install and configure the AVEVA Enterprise License Server after the upgrade before you can use the AVEVA Recipe Management 2023 R2 (v5.1) application.

To upgrade the earlier version of the product to AVEVA Recipe Management 2023 R2 (v5.1) in Standalone mode:

• Before upgrade, undeploy ArchestrA.ASBOPCUAClientService in Configure ArchestrA Services window.

• The ArchestrA.ASBOPCUAClientService option which was used earlier for OPCUA Server connection will be unavailable in Configure ArchestrA Services window after the upgrade.

• Use AVEVA OI Gateway to establish an OPCUA Client connection to communicate with the OPCUA Server. Refer Configure AVEVA Recipe Management in Standalone Mode using OI Gateway for more information.

• After configuring OPCUA Client connection in OI Gateway, remap all the existing IO references for equipment with the new IO reference syntax supported in OI Gateway.

To upgrade the earlier version of the product to AVEVA Recipe Management 2023 R2 (v5.1) in Integrated mode:

• Uninstall the PCS-Service Repository feature from all nodes except the GR node, which was configured in Integrated mode in earlier product version.

To upgrade an installation

1. Run setup.exe to install AVEVA Recipe Management 2023 R2. The AVEVA Recipe Management Installation Wizard starts.

2. The AVEVA Recipe Management Installation Wizard detects the earlier version of the product and starts the upgrade procedure.

3. If your computer does not meet the prerequisites for the features to be upgraded, the Prerequisites dialog box appears.

   

4. Click Yes to install the required prerequisites.

   

5. Click OK to restart the computer after all the prerequisites are installed.

6. After the restart, the License Agreement dialog box appears. Read the license agreement, if you agree with the terms provided and then click I accept the License Agreement.

7. Click Next. The AVEVA Recipe Management Installation dialog box appears. The features that are installed in the previous version of the product are automatically selected for upgrade.

   You can add new features during the upgrade, but features marked for an upgrade cannot be changed during the upgrade.

   NOTE: While configuring the product in Standalone mode, make sure to select the PCS - Service Repository feature.

   

8. Click Next. The Ready to Install dialog box appears.

   

9. Click Install. The files from the previous version of the product are uninstalled and the new files are copied.

   After the upgrade process is complete, the Complete Installation dialog box appears.

10. If the upgraded features require configuration, click Configure. For more information on configuring AVEVA Recipe Management, see AVEVA Recipe Management Configuration.

    NOTE: It is recommended to restart the computer after you upgrade AVEVA Recipe Management when AVEVA System Platform is already installed on the same computer.