Upgrade from AVEVA AIM Workhub and Dashboard 5​.x​.x

You have two options for upgrading an existing installation of AIM to the latest version:

• Using Deployment Manager - Use this if you have a deployment configuration file that you used to deploy your previous 5.x version of AIM, and this configuration still matches your current configuration or is edited to match. You can also create a new configuration file to match your current configuration using Deployment Manager.

• Using individual tools - Use this to perform the upgrade using individual tools, such as the Installer (AVEVA.AIM.Workhub.and.Dashboard.6.0.msi), Database Manager and Web Deploy.

  Important:

  • While upgrading from a version 5 installation, any new files you have added are deleted, and all files delivered with the application are overwritten. These files include:

    • The web.config settings, such as additional Portal IDs

    • The AVEVA.NET.Import.Server.exe.Config settings, such as database related details

      Note: From 5.1.5 onwards, all the Import Controller related configurations are available in the file AVEVA.NET.Import.Server.exe.Config under the <aveva.net.import.server /> section. The default location for this file is C:\Program Files\AVEVA\AVEVA NET\Import\Server.

  • When upgrading to 5.1 or later using an earlier Deployment Configuration file, if Windows authentication was used, then you must select the Use windows authentication option.

  • Any custom extensions that have been deployed to the AIM Dashboard website as a web deployment package must be redeployed after upgrade. If Web Deploy was not used, then all custom files must be backed up and reapplied after the upgrade.

  • DO NOT copy previous versions of configuration files back into place, as these files contain both user configuration and system configuration entries which may have changed between versions.

To upgrade using Deployment Manager:

1. If you have made any customizations to Windows Service configuration files (that are not configurable within Deployment Manager) or made any changes to the AIM configuration files (for example, web.config), create backups so that you can re-apply these customizations after the upgrade.

2. Load your deployment configuration file into Deployment Manager:

   1. From your installation media, double-click the AVEVA.AIM.Deployment.Manager file.

   2. Select Next.

   3. On the Load Configuration page, select Load from file … and browse to your deployment configuration file.

   4. Select Open.
      Deployment Manager upgrades the configuration to the 6.0 format.

   5. Check each page of the configuration to make sure it is correct, and then select Next > to move to the next page. If necessary, add, remove or configure new features introduced in the latest AIM version.

   6. On the Save Configuration page, save your new configuration – do not overwrite the old file as you might need it again. Select Next >.

   7. Run the upgrade: On the Deploy page, select Deploy.

3. Re-apply the specific changes you made to the Windows Service configuration files.

4. Re-apply any customizations, such as web.config settings. This includes any additional Portal IDs, which have been overwritten as part of the upgrade.

To upgrade using individual tools:

5. If you have made any customizations to Windows Service configuration files (that are not configurable within Deployment Manager) or made any changes to the AIM configuration files (for example, web.config), create backups so that you can re-apply these customizations after the upgrade.

6. Run the installer:

   8. From your installation media, double-click AVEVA.AIM.Workhub.and.Dashboard.6.0.msi.

   9. On the Welcome, screen, select Next.

      Your previous Destination Folder and set of features are maintained.

   10. Check each page of the wizard to make sure it is correct, and then select Next > to move to the next page. If necessary, add and configure new features introduced in AIM 6.0.

   11. Run the upgrade: On the Ready to install ... page, select Install.

7. Re-apply the specific changes you made to the Windows Service configuration files.

8. Run Database Manager and connect to your AIM Workhub database or databases. Accept the prompt to upgrade the database to 6.0.

9. Using the Dashboard.zip Web Deploy package (in the installation directory), re-deploy the AIM Dashboard web application.

10. Re-apply any customizations, such as web.config settings. This includes any additional Portal IDs, which have been overwritten as part of the upgrade.

11. If you are using the Accusoft PrizmDoc Viewer, re-deploy the viewer package.

    Note: Ensure that you have upgraded to the correct version of the Accusoft PrizmDoc; if not, you must re-deploy the site. For information about how to upgrade Accusoft PrizmDoc, see Upgrade Accusoft PrizmDoc.

12. Configure any new features introduced in AIM 6.0.