Upgrade a PI Vision installation

Review the installation recommendations and requirements for AVEVA PI Vision on the Pre-install checklist.

If you are running PI Coresight 2015 (2.1.0.2) or later, you can upgrade directly to the latest version of AVEVA PI Vision. If you are running a version earlier than PI Coresight 2015, you must first perform an intermediary upgrade to PI Vision 2020 Patch 1, and then upgrade to that latest version of AVEVA PI Vision.

To upgrade AVEVA PI Vision, run the AVEVA PI Vision setup program, which updates AVEVA PI Vision. Then, configure the application pool accounts and upgrade the AVEVA PI Vision database, if necessary.

Note: If you no longer use PI Web API, you should uninstall it.

1. Log on to the application server as a system administrator, using a domain user account that belongs to the local Administrators group.

2. Verify that all required roles and features are installed.

   For a list of required roles and features, see Prepare the PI Vision application server computer.

3. Download the new AVEVA PI Vision installation kit from the AVEVA Customer Portal Products page.

4. Right-click the AVEVA PI Vision setup executable and then select Run as Administrator to launch the installation wizard.

5. If necessary, upgrade the AVEVA PI Vision database:

   • If the installation program automatically upgraded AVEVA PI Vision database, no additional work is necessary.

   • If the installation did not successfully upgrade the database, you must manually upgrade it after the installation kit finishes. For details, see Create or upgrade the PI Vision database.

   Note: If you are unable to manage displays with the AVEVA PI Vision Display Utility, the AVEVA PI Vision Utility application pool may not be configured to run under the same service account as the Admin and Service application pools. For additional information, see Configure PI Vision application pools to use the PI Vision service account.

   Note: You have the option to run PIVisionPatchDisplayAFids when you upgrade AVEVA PI Vision or at a later date. PIVisionPatchDisplayAFids patches existing AVEVA PI Vision displays so that elements and attributes renamed or moved on a PI AF server automatically update if the display is newly opened or actively running. For more information, see Patch displays with PIVisionPatchDisplayAFids. Running PIVisionPatchDisplayAFids during upgrade may fail if upgrading from PI Coresight 2016 R2 or earlier. In this case, reboot the server after upgrade and run PIVisionPatchDisplayAFids again manually.

6. If your PI Vision installation is configured for OpenID Connect authentication, you may receive a message that your client registration needs to be updated. If this is the case, visit the Security page of the PI Vision Administration website to update the client registration.