Upgrade to AVEVA Work Tasks 2023 R2

Upgrade scenarios

You can upgrade to AVEVA Work Tasks 2023 R2 from AVEVA Work Tasks 2023 or AVEVA Work Tasks 2023 SP1.

However, if you want to upgrade from versions earlier than AVEVA Work Tasks 2023, you must first upgrade to AVEVA Work Tasks 2023, and then to AVEVA Work Tasks 2023 R2.

The upgrade will overwrite all files. Therefore, we recommend that you back up the files before upgrading the product.

Ensure that the user has appropriate rights for installing and upgrading software on the machine.

Note: Customizations to files in Locales, Web, and WorkflowElements folders need to be applied again to the newly created files after an upgrade.

Before upgrade

Before upgrading to AVEVA Work Tasks 2023 R2, consider the following points:

• Archiving data before starting the upgrade is strongly recommended.

• Migration duration varies based on the number of records and may take anywhere from a few minutes to days.

The table below provides the estimated data migration times observed in a test environment:

Notes:
- Taking a data backup is strongly recommended, as certain changes will modify data in specific tables to enhance security.

- Special characters such as &, ", ', <, > and other similar symbols are considered sensitive in web application security. These characters may break the intended context and can enable attacks such as Cross-Site Scripting (XSS), HTML injection, or SQL injection if not handled correctly. As a workaround, encode or escape special characters before passing them as parameters to the Invoke Web API call.

Steps to upgrade

1. Run AVEVA Work Tasks 2023 R2.exe located in the product folder.

2. The installer splash screen, and then the Prerequisites installation screen appears.

3. Install the prerequisites.

4. Click Next after installing the prerequisites.

5. Click Finish on the InstallShield Wizard Completed dialog.

6. When prompted, click OK to restart the machine.

   Note: Restarting after prerequisite installation is mandatory.

7. After restart, the Upgrade Manager launches automatically. Click Next to begin the upgrade process.

8. A message window appears. Click Yes to continue.

9. The Upgrade Manager will:

   • Stop services and Application Pools

   • Delete the WorkTasksTemp and Work Tasks Cache files

10. Once the upgrade completes, restart the machine.

    For more information on how to run the Upgrade Manager, see Run Upgrade Manager in the WorkTasksAdministrativeGuide.

After upgrade

After upgrading to AVEVA Work Tasks 2023 R2, existing workflows using the Invoke Web API activity may fail with a Bad Request error if any input parameter contains special characters. This occurs due to enhanced security validations introduced in this release.

Encode or escape all special characters in Invoke Web API parameters. For detailed rules and examples, see Guidelines for encoding API call values.

Notes:
- If Platform Common Service prompts for a restart during the upgrade, you may ignore the prompt and restart only after installation completes. Restarting early will interrupt installation, requiring you to re-run the installer.
- If a package from an earlier version is imported after the upgrade, it is mandatory to re-run the Upgrade Manager and click Update Package to apply necessary updates (especially for BAM Dashboard artifacts).

- After the upgrade completes, the Work Tasks services and Application Pools start automatically.

- Clear the browser cache on machines where Enterprise Console is accessed to ensure updated JS, CSS, and image files are loaded. For details, see Cache Refresh Settings in the WorkTasks Administrative Guide.