Release Notes MatrikonOPC UA Wrapper for COM OPC Servers

For additional information on this product, these release notes, or Matrikon, please contact: Matrikon Inc. 1800, 10405 Jasper Avenue Edmonton, Alberta, Canada T5J 3N4 +1-780-448-1010 +1-780-448-9191 http://www.matrikonopc.com drivers@matrikonopc.com support@matrikonopc.com

Address:

Phone: Fax: Web: Sales: Support:

CONFIDENTIAL
The information contained herein is confidential and proprietary to Matrikon Inc. It may not be disclosed or transferred, directly or indirectly, to any third party without the explicit written permission of Matrikon Inc. All rights reserved. No part of this document may be reproduced, stored in a retrieval system, translated, or transmitted in any form or by any means, electronic, mechanical, photocopying, recording, or otherwise, without prior written permission of Matrikon Inc. Copyright 1997 - 2013 Matrikon Inc. These are notes that are added to, and sent with, each release of MatrikonOPC UA Wrapper for COM OPC Servers.

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.2.3 (February 8, 2013)
New Features and Enhancements: 18866: HostName and ProgID fields added to server status, showing the host name and program ID of the OPC server that is being connected to. During the development of the MatrikonOPC UA Wrapper, the OPC Foundation was in the process of finalizing the UA specifications. The MatrikonOPC UA Wrapper may change without notice to match the UA specification. Un-installing the MatrikonOPC UA Wrapper will remove your existing configuration files. To backup the existing wrapped servers configuration, make a copy of the file. By default, in Windows XP and Windows 2003, the file is found in C:\Documents and Settings\All Users\Application Data\Matrikon\UA\MatrikonOpcUaWrapper.Config.xml.

Known Outstanding Issues:

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

Note: Version 1.2.0 of the MatrikonOPC UA Wrapper is not backwards-compatible with configuration files older than version 1.1.0. On a fresh installation of the MatrikonOPC UA Wrapper it cannot register at the UA Local Discovery Server due to a certificate trust issue. As a workaround to resolve the issue, the UA Local Discovery Servers certificate should be copied to the UA Applications certificates store. To copy the certificate: 1. From the Start menu, click Run. 2. Type mmc. 3. Click OK to open the Microsoft Management Console. 4. In the File menu, click Add/Remove Snap-in. 5. Click Add to add a snap-in. 6. Select Certificates from the list of snap-ins and click Add to open the Certificates snap-in window. 7. Click Computer account -> Next -> Finish. 8. Close the Add Standalone Snap-in window and click OK on the Add/Remove Snap-in window. 9. Expand Certificates (Local Computer) and Personal. Click Certificates. 10. Right-click the UA Local Discovery Server certificate and select Copy. 11. Expand UA Applications. 12. Right-click Certificates and select Paste. After a few moments, the UA Wrapper will register with the UA Local Discovery server.

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.2.2.0 (May 18, 2012)
New Features and Enhancements: Removed some unnecessary log messages (with HDA only the OPC server is wrapped, there were messages that the DA connection could not be created or DA properties could not be read). 0018316: Cannot access an OPC HDA item if the wrapped OPC HDA server returns a server handle equal to 0 for it.

Resolved Issues:

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.2.1.0 (December 15, 2011)
New Features and Enhancements: Improved responsiveness when Read, Write or Browse operations that are running take a long time. For example, if one session is performing a Read request for large number of items, it does not block another sessions operations. Removed some unnecessary log messages, and added or modified others for easier troubleshooting.

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

Removed potential deadlock source for case when multiple sessions are intensively accessing the same wrapped OPC server. Added new options to the wrapped OPC server configuration for Anonymous type User Token Policy of UA Session. Now on the classic OPC connection end it can be impersonated as either the ANONYMOUS LOGON Windows account (default value) or UA Wrapper Process account.

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

Resolved Issues: 0017947: Connection to the wrapped OPC server is closed if there are no data changes for long time. Now connections are kept open while there is at least one client session which had access to it. When UA Wrapper detects that there are no more sessions using a connection, it will wait for a time defined by the ServerIdleTimeInSeconds option before closing of the connection. 0017987: Browsing of invalid node ID fails only on the first call and succeeds on following calls. 0017998: Read values for nodes from different wrapped servers in a single request returns either incorrect results or nodes in the wrong order.

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.2.0.0 (September 9, 2011)
New Features and Enhancements: Added support to pass user identity from a UA client to the end OPC server. Added shutdown callback handler for wrapped A&E OPC servers. Certification validation algorithm is changed. If the UA Clients certificate is not trusted and is not located in the trusted certificates folder configured in the configuration file, then requesting to create a secured communication channel will be refused (in the previous version an unsecured channel was created). 0017416: Engineering properties of a tag are not available unless the tag is browsed first. Note: When the FastBrowsing option is set to true, for tags which are not browsed yet, reading of BrowseName and DisplayName attributes may return incorrect values because these values are obtained by parsing of OPC Item ID. Parsing is performed based on assumption that Item ID has the following format: [ParentFolderId | Delimiter | ItemName]. For example, if item ID is Random.Int1, then ParentFolderId=Random, Delimiter=. and ItemName=Int1. Delimiter is configurable (the option SeperatorChars in the configuration file).

Resolved Issues:

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.1.2.0 (April 11, 2011)
New Features and Enhancements: OPC Foundations UA Local Discovery Server version 1.0.250.8 is now included in the install. The HTTP / SOAP XML connection endpoints were removed from the default configuration. The number of notification messages per publish was increased in the default configuration to allow the retrieval of all data change notifications when there are a large number of monitored items. The maximum monitored item queue size was reduced in the default configuration to reduce memory consumption. If required, this can be changed in the configuration file by editing the value for MaxMessageQueueSize. Improved performance when reading or writing to items that were not previously browsed or accessed.
4

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

Improved the monitoring of the status of end OPC servers to eliminate unnecessary reconnections and possible deadlock situations. Log file size limit is modified from hard coded 10000000 bytes (about 10 Mb) to 10% of the free disk space. Licensing has changed. After upgrading the MatrikonOPC UA Wrapper, existing licenses will not be valid and new licenses will have to be applied. 0017293: OPCHDA_INTERPOLATIVE is being returned as custom aggregate. 0017294: Data writes get mixed up and values are put in the wrong tags. 0017295: Writing data through the OPC UA Wrapper to ODH intermittently fails. 0017314: The server configuration option MaxNotificationsPerPublish is not used correctly.

Resolved Issues:

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.1.0.0 (June 10, 2010)
New Features and Enhancements: Rebuilt using a newer stable version (1.0.307) of the UA SDK from the OPC Foundation. To improve the efficiency of browsing large numbers of tags, a filtering feature has been added. The filter can be set from a UA client by calling the Set Browse Filter method, or by appending a filter expression to the Node ID argument of a Browse request. See the Users Manual for further details. Licensing has been modified to limit the maximum number of wrapped OPC servers. During the 30-day demo period, the number of wrapped OPC servers is unlimited. Note: If the UA Wrapper is upgraded from a previous version that had a permanent license, a new license must be requested from MatrikonOPC. The user impersonation feature is turned off in this version (1.1.0.0). Therefore, the MatrikonOPC UA Wrapper for COM OPC Servers (as part of MatrikonOPC Security Gateway) section of the Users Manual has been removed in this version. 0012177: DA, HDA, AE functionality is currently provided via nodes in separate address spaces. This is partially resolved: DA and HDA COM OPC servers are now presented in a combined address space. In the configuration file, options have been added to define different Prog IDs for DA and HDA, and the interface used for browsing. The UA Wrapper assumes that the OPC server has identical DA and HDA address spaces, such that items have the same IDs when connecting with DA and HDA. If the OPC server is HDA only, then the AccessLevel for items is HistoryReadable/HistoryWritable (no Read or Write access). However, Read requests are not rejected, but instead the latest raw history data is returned. Subscriptions to item values can be created only if the OPC server supports the DA interface and is configured to use the DA interface.
5

Resolved Issues:

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

0014798: Engineering units between HDA and DA are different. Now Engineering units are represented as UA properties of the EUInformation data type, corresponding to DA properties and/or HDA attributes.

0012005: EURange nodes are not queryable (bad node ID). Now EURange is represented as a UA property corresponding to DA properties HighEU and LowEU, and/or HDA attributes NormalMin and NormalMax. The AccessLevel for the property is Readable when an item has HighEU/LowEU DA properties, and HistoryReadable when an item has NormalMin/NormalMax HDA attributes. If the wrapped OPC server supports the HDA interface and is configured to use it, then the root folder for the server and its items will have an AggregateFunctions folder with the list of aggregates supported by the server. The HistoricalConfiguration node containing the AggregateConfiguration property (and other properties) will also be under the root folder.

0015065: Inconsistency in the way writes are currently being treated for DA and HDA requests. The issue is not resolved, but some improvement has been made to perform additional checking when converting from the UA type to Variant. Write requests are propagated to the wrapped OPC server, and write results completely depend on its behaviour.

0015064: OPC UA Wrapper does not connect to remote OPC servers. Now UA Wrapper can connect to remote OPC servers too. Note: DCOM permissions must be set up properly on both Server side and Client side to establish successful communication.

0015526: Reading the "tag" nodes of a wrapped MatrikonOPC Server for GDA returns BadNodeIdUnknown 0015553: Monitoring a "tag" node of a wrapped GDA server returns BadAttributeIdInvalid. The issue was caused by Item IDs on the GDA server with the : (colon) symbol, which is used as a delimiter symbol by the UA Wrapper. To resolve the issue the symbols : (colon), ? (question mark) and & (and) are prefixed by the & symbol when a UA Node ID is constructed from an Item ID. 0015501: When there are a significant number of tags, browsing times out. The reason for the time out is that the UA Wrapper retrieves detailed information for each browsed item, such as Item ID, Engineering Units, EURange, etc., which takes considerable time, especially with connections via MatrikonOPC Tunneller. As a workaround to resolve this issue, the following two configuration options are added for wrapped OPC servers: FastBrowsing When this option is set to true, item browsing does not retrieve item properties and HDA attributes. Therefore, all items will have the DataItemType type definition. DA properties and HDA attributes are read from a particular item when it is accessed. To define the true data type of the item, it must be browsed directly. The default value of the option is true. This option also plays a role when an item is accessed without prior browsing (for example, when a pre-configured item is being added for monitoring). If the option is true, then UA Wrapper does not try to define the items browse name and its parent in the OPC Server Address Space. ItemIdEqualToName The option should be set to true only if item IDs match their browse names, which is not true for most OPC servers. The option is applicable
6

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes

only if the FastBrowsing option is set to true. Setting this option to true optimizes the browsing speed when accessing MatrikonOPC Desktop Historian via MatrikonOPC Tunneller. The default value for this option is false. When both these options are set to true, browsing speed is close to the speed of browsing from MatrikonOPC Explorer. These options are not available on the configuration window. You must manually edit the MatrikonOpcUaWrapper.Config.xml file to change their value. The default configuration file does not have these tags, but they appear if the configuration is modified and saved from the configuration window. 0015794: IOPCBrowse interface is not utilized at browsing. Now UA Wrapper utilizes the OPC browsing interface specified by the PreferredBrowseInterface option. Two more options are created to fine tune the browsing by the IOPCBrowse interface: o QueryPropertiesOnBrowse: If this option is true, then the result of a Browse call includes item properties. As returning the item properties in the Browse call can increase load on the OPC server, the default value is false. MaxElementsReturnedOnOPCBrowseInterface: This option is only applicable when the FastBrowsing option is set to false. The option puts a limit on the number of returned results when browing to determine the browse name or parent branch of an OPC item. A value of 0 indicates no limit. The default value is 0.

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.0.1.0 (July 3, 2009)
Enhancements and Resolved Issues: Rebuilt using the latest stable version 1.0.240.1 of UA SDK from OPC Foundation. Stopping and restarting of a wrapped HDA OPC server is now handled properly. Only a single instance of the application can run at the same time. During an attempt to start a second instance a warning message is displayed and the application exits.

Release Notes for MatrikonOPC UA Wrapper for COM OPC Servers v1.0.0.0 (January 29, 2009)
This is the first release version of MatrikonOPC UA Wrapper for COM OPC Servers. Its code is based on version 1.0.222.0 of the OPC Foundations OPC UA SDK source code.

MatrikonOPC UA Wrapper for COM OPC Servers Release Notes