Upgrade the adapter

When a new version of the adapter is released, you can upgrade to the latest version by running the new installation package.

Note: Prior to the 1.5 release, if the component ID for OPC UA is OpcUa (case-insensitive), the certificate directory is located in the %ProgramDataOrUsrShare%/OSIsoft/Adapters/Certificates/Certificates.

To upgrade this instance, the certificates folder must be manually moved into the %ProgramDataOrUsrShare%/OSIsoft/Adapters/OpcUa folder before the upgrade.

Windows upgrade

To upgrade the OPC UA adapter on a Windows computer:

1. Download AVEVA-Adapter-for-OpcUa-1.6.0.296_.msi from the Customer Portal.

   Note: Customer login credentials are required to access the portal.

2. Run the installer and complete the setup wizard.

3. Optional: To verify the upgrade, send the following request by Postman using the port number specified when completing the wizard:

   GET "http://localhost:5590/api/v1/Diagnostics/ProductInformation"

   Upon successful upgrade, the JSON response lists the updated application version. For example:

   [

   {

   "Product Name": "AVEVA Adapter for OpcUa",

   "Product Version": "1.6.0.296",

   "Adapter Framework Version": "1.8.3.128",

   "Runtime Version": ".NET 8.0.15",

   "Operating System": "Microsoft Windows 10.0.26100"

   }

   ]

Linux upgrade

To upgrade the OPC UA adapter on a Linux computer:

4. Download the appropriate Linux distribution file from the Customer Portal.

   Note: Customer login credentials are required to access the portal.

5. Open a terminal session.

6. Move the Linux distribution file to the target host and run the sudo apt upgrade command.

   Platform	Command
   Linux x64	sudo apt upgrade ./AVEVA-Adapter-for-OpcUa-1.6.0.296-x64_.deb
   Linux ARM32 Debian	sudo apt upgrade ./AVEVA-Adapter-for-OpcUa-1.6.0.296-arm_.deb
   Linux ARM64 Debian	sudo apt upgrade ./AVEVA-Adapter-for-OpcUa-1.6.0.296-arm64_.deb

7. Optional: To verify the upgrade, send the following request by Postman using the port number specified when completing the wizard:

   GET "http://localhost:5590/api/v1/Diagnostics/ProductInformation"

   Upon successful upgrade, the JSON response lists the updated application version. For example:

   [

   {

   "Application Version": "1.6.0.296", // upgraded version

   ".Net Core Version": ".NET Core 3.1.15",

   "Operating System": "Linux 4.15.0-106-generic #107-Ubuntu SMP Thu Jun 4 11:27:52 UTC 2020"

   }

   ]