Upgrade to AVEVA Work Tasks 2023 R2 U1

Upgrade scenarios

You can upgrade directly to AVEVA Work Tasks 2023 R2 U1 from any of the following versions:

• AVEVA Work Tasks 2023

• AVEVA Work Tasks 2023 SP1

• AVEVA Work Tasks 2023 R2

If you are using a version earlier than AVEVA Work Tasks 2023, first upgrade to AVEVA Work Tasks 2023, and then upgrade to AVEVA Work Tasks 2023 R2 U1.

Use the same upgrade procedure described in this topic for all supported upgrade paths.

The upgrade overwrites all files. Back up the files before upgrading the product.

Ensure that the user performing the upgrade has the appropriate rights to install and upgrade software on the machine.

Note: After the upgrade, reapply customizations made to files in the Locales, Web, and WorkflowElements folders to the newly created files.

Before upgrade

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

• Archive data before starting the upgrade.

• Back up the applicable databases and customized product files.

• Migration duration varies depending on the number of records.

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 U1.exe located in the product folder.

2. The installer splash screen appears, followed by the Prerequisites installation screen.

3. Install the prerequisites.

4. Select Next after installing the prerequisites.

5. Select Finish on the InstallShield Wizard Completed dialog.

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

   Note: Restarting after prerequisite installation is mandatory.

7. After restart, Upgrade Manager starts automatically. Select Next to begin the upgrade.

8. When the confirmation message appears, select Yes to continue.

9. Upgrade Manager:

   • Stops the services and application pools

   • Deletes the WorkTasksTemp and Work Tasks Cache files

10. After the upgrade is complete, 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 U1, existing workflows that use the Invoke Web API activity may fail with a Bad Request error if an input parameter contains special characters.

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.