AVEVA™ Communication Drivers Pack – Standards - Gateway Driver Readme

Last revision: 11/20/2020

In This Document

Important Upgrade Information

HMI SCADA YouTube Channel

eLearning Training Courses

About This Release

System Requirements

Trusting the Gateway Communication Driver OPC UA Certificates with the OPC UA Server

Resolved Issues

Known Issues

Gateway Communication Driver Documentation

Important Upgrade Information

IMPORTANT: If you are upgrading from a previous version, and are using secured OPC UA connections, you must update the trust relationship with the OPC UA server. For more information, see Trusting the Gateway Communication Driver OPC UA Certificates with the OPC UA Server.

Note: The MQTT plug-in within the Gateway has been superseded with a standalone MQTT Communication Driver. The MQTT Gateway plug-in will be phased out in the next major release of the Communication Drivers. We recommend you to modify your configuration to start using the standalone MQTT Communication Driver instead.

HMI SCADA YouTube Channel

Our YouTube channel contains instructional and promotional videos on our various product lines. Please follow the links below:

Platform Connectivity and Device Integration Playlist

https://www.youtube.com/playlist?list=PLJq4rR8tWINwTpCnlHqjUUlysBClU-YqU

HMI SCADA Channel Main Page

https://www.youtube.com/user/wonderwarehmi

eLearning Training Courses

You can now access hundreds of training courses that cover simple and complex topics with all the products that you use in our Monitoring and Control portfolio. Access to the eLearning modules is free!

https://sw.aveva.com/training/wonderware

About This Release

This document contains important information about AVEVA Gateway Communication Driver. Review this document for known issues and changes to Gateway Communication Driver.

New Features and Enhancements

Enhanced OPC UA Client

The OPC UA Namespace section of the OPC UA editor now has a new column - Tag Prefix. It helps to specify a common prefix for an item so that it can reduce the item name length when subscribed by the client.

OpenSSL 1.1.1g support for OPCUA

Now OPCUA supports OpenSSL 1.1.1g framework for secure communication.

System Requirements

Platform Compatibility

The Gateway Communication Driver can be installed with AVEVA Communication Drivers Pack 2020 R2, as well as bundled in the installation of the System Platform (SP). You can select the appropriate options install Gateway Communication Driver during SP installation.

Prior to installing a newer version of Gateway Communication Driver on any previous versions of SP, it is recommended to refer to the Technology Matrix section of the Global Customer Support (GCS).

Trusting the Gateway Communication Driver OPC UA Certificates with the OPC UA Server

When using a secured connection to the OPC UA Server, the OI Gateway node must be trusted by the OPC UA Server. Follow the steps below to trust the OI Gateway node.

Open the OPC UA configuration.
Ensure that the configuration on the OPC UA faceplate matches the configuration settings in the OPC UA Server that you are trying to connect. Click Test.
A new OI Gateway OPC UA certificate is automatically copied to the OPC UA Server.
Follow the OPC UA Server workflow to trust the new certificate that was published to it.
Return to the OPC UA Configuration screen and click Test to ensure that the operation is successful.
Note:
- If you are upgrading from a version older than 5.2, you must trust the certificate again as explained above.
- Connection to OPCUA server with unencrypted passwords is no longer supported by UA SDK v1.7.0. If User Name and password is configured for connection with OPCUA Server, then the security policy cannot be NONE. You have to configure the appropriate security policy (Basic128Rsa15, Basic256, Basic256Sha256).

Resolved Issues

The following issues are resolved in this release of Gateway Communication Driver.

Defect ID	SR/Case Number	Description
CR-L00157917	SR-63511882	MQTT data precision - data changed from 2.4563E + 15 to 2.4563
CR-L00157082 CR-L00156996 CR-L00156997	SR-63913263	Wonderware Sending Buffer data instead of string ( JSON FORMAT)
CR-L00158502	SR-51316575	OI-Gateway did not update active (9) Item after 20-50 min from a local running OPC UA Server.
CR-L00158899 CR-L00158218	-	OI Gateway 3.0 stopped updating some tag values
CR-L00158215 CR-L00157191	SR-81810551	DEMAND READ and DEMAND WRITE Timing out when one of the connected Topics(PLC) is shutdown.
CR-L00159843	IMS-0001867110	Items were not updated correctly.

Known Issues

The following table lists known issues at the time of release.

Defect ID

Description

TFS-1355437

If a standalone Gateway Communication Driver (v4.0-v6.0) is installed on a machine and if you try to upgrade the system using System Platform 2020 R2, then the Gateway Communication Driver gets uninstalled.

Workaround:

Use Modify install option in the System Platform 2020 R2 and select Standards - Gateway to install on the machine.

Note:

If you use Communication Drivers Pack 2020 R2, then there is no issue in upgrading the Gateway Communication Driver on the machine.
If you install the Gateway Communication Driver using System Platform 2020 or Wonderware System Platform 2017 (along with InTouch/Application Server), then there is no issue in upgrading the Gateway Communication Driver using System Platform 2020 R2.

TFS-1360928

Gateway Communication Driver OPC Client cannot connect to OPC Server on the remote node when Gateway Communication Driver is running under the SYSTEM account.

Workaround:

Change Gateway Communication Driver DCOM Identity settings to use a domain administrator account or login machine with a domain administrator account and run Gateway Communication Driver in desktop mode.

To change the DCOM settings, follow the below steps:

Press and hold the Windows key and then press R to open the Run command window.
In the Open field, type dcomcnfg and press Enter. The Component Services window opens.
Go to Component Services > Computers > My Computer > DCOM Config.
To change Identity settings of Gateway to Domain Administrator account:
1. Under the DCOM Config folder, right-click Gateway and select Properties.
2. Under the Identity tab, select This User and enter the credentials of the user account that has administrator privileges and click OK.
Deactivate and activate the Gateway Communication Driver to work with OPC connection to the remote OPC server.

Gateway Communication Driver Documentation

The AVEVA Gateway Communication Driver documentation set includes the following guides. These documents can be accessed from the Help menu in the SMC.

Standards - AVEVA™ GATEWAY Communication Driver Help. This guide describes the user interface and functions of the Gateway Communication Driver.
AVEVA™ Communication Drivers Pack Help. This documentation describes the runtime Configuration, Diagnostics, and Activation/Deactivation aspects of a Communication Driver.
Log Viewer Help. This guide provides information about the Logger™ and the Log Viewer snap-in to the System Management Console.
LogFlag Editor User's Guide. This documentation describes the user interface and functions of the LogFlag Editor utility. This utility can be opened only from the Log Viewer, a part of the System Management Console suite of utilities.
AVEVA Enterprise License Manager Help This guide describes how to use the License Manager to activate and acquire licenses.
Note: The AVEVA Enterprise License Manager Help can be accessed through the License Manager application (available only for the new license framework). For earlier versions of the license framework, see License Utility Guide.