OSIsoft Release Notes PI OPC DA Server 2017 Version 2.2.1 2017 OSIsoft, LLC. All rights reserved
Table of Contents Overview... 1 Fixes and Enhancements... 1 Fixes... 1 Enhancements... 2 Known Issues... 2 Setup... 2 Operating Systems... 2 Server Platforms... 3 Distribution Kit Files... 3 Installation and Upgrade... 3 Uninstalling PI OPC DA Server 2017... 4 Documentation Overview... 4 Technical Support and Resources... 5
Overview PI OPC DA Server is an OPC server for the PI Data Archive. It implements the OPC Data Access (DA) standard v2.05. It supports browsing, synchronous reads, asynchronous reads, read on change (also known as "advise" data), and both writes and deletes. This release of the PI OPC DA Server greatly decreases the lengthy time it takes to start the server. It achieves this through optimizations of the first-time startup procedures and by caching relevant data for use in subsequent startups. These changes reduce first-time startup by over 90%, and subsequent startups by over 95%. The PI OPC DA/HDA Server 2010 release implemented the DA and HDA standards in the same server executable. DA and HDA standards are now met by different OPC servers. This release, PI OPC DA Server 2017 implements the Data Access standard. PI OPC HDA Server 2016 is available separately and meets the Historical Data Access standard. Together, these replace PI OPC DA/HDA Server 2010. Fixes and Enhancements Fixes This section lists items that were resolved or added in this release of PI OPC DA Server 2017. Work Item Description 72531 - Require AF 2.7 or later Installer checks for AFSDK 2.7 or later in order to support CurrentValue 72535 Service Name Consistency When installed as a service, the service name has been changed to PI OPC DA Server 72556 Uninstall fails to properly removed the component / MSI Previous versions of PI OPC DA Server may fail to uninstall properly and prevent re-installation. This is corrected in this version. 81173 Reduce calls to PI on startup Vastly improved startup time. First starts are 90% faster. Subsequent startups are 95% faster OSIsoft Release Notes Template Version 2.5 Page 1
Seconds Enhancements Drastically lower startup times. No-cache, initial startups faster by over 90%. Data cached on server shutdown improves subsequent startups by over 95% 800 700 600 Startup Times 500 400 300 200 100 0 1,000,000 tags 500,000 tags 100,000 tags 2015 R2 SP1 695 345 68 2017, no cache 61 28 5 2017, cached 21 10 2 2015 R2 SP1 2017, no cache 2017, cached Known Issues Work Item 137864 - Saved namespace can be inaccurate if large numbers of edits are being made during shutdown. Description: If large numbers of tag edits are being made while the OPC server is shut down, it is possible for some of those edits to be lost, as the updates are in the consumer's queue on PI Data Archive and will be lost when the process exits. It is not yet determined how many tag edits will trigger the problem, but mass deleting 500K tags will show the issue. Workaround: Shutdown PI OPC DA Server. Delete the saved namespace, found in the PIPC\PI_OPCDA2\Data subdirectory. Restart PI OPC DA Server. Setup Operating Systems This release supports Microsoft Windows 2008 Server R2, Windows 7, or later. Separate installation kits are provided for 32-bit (x86) and 64-bit (x64) systems. OSIsoft Release Notes Page 2
Server Platforms This release requires: PI Server 3.4.390 minimum PI AF SDK 2.7 or higher Distribution Kit Files For 64-bit systems: PI OPC DA Server 2017 (x64).exe For 32-bit systems: PI OPC DA Server 2017 (x86).exe Installation and Upgrade Prerequisites: PI AF SDK version 2.7 or later (Available via https://techsupport.osisoft.com/products/developer-technologies/pi-af-sdk/) PI OPC DA Server 2017 comes as part of a Windows Installer package which will perform the necessary installation functions, including installing Visual Studio 2013 redistributable libraries, if necessary..net Framework 4.6.2 will be downloaded and installed automatically if not already installed. PI AF SDK version 2.7 or later is required, and installation will not be possible if not found. Silent Installation PI OPC DA Server 2017 can be installed without user interaction. From an elevated command prompt (i.e., running as administrator), run the installer executable with a /quiet switch. The installer will install the application as a Windows service. DCOM Configuration DCOM configuration can be performed with the DCOM Configuration utility (dcomcnfg.exe) that comes with the Windows OS. In order to be able to use this utility, the user must be logged in with administrator s privileges. This utility allows for the configuration of special security rules for all DCOM objects on the local node. The DCOM Configuration utility may look slightly different and setting options may differ, depending on the version of the Windows OS. For detailed information on how to configure DCOM, please refer to the DCOM Configuration Guide on the OSIsoft Tech Support Download Center. OSIsoft Release Notes Page 3
Installation Run the distribution kit with administrator privileges. During installation, you will be prompted to install as a service (recommended) or as a COM server/process. PI OPC DA Server 2017 can be run as a windows service or process. Successful connection of the server and client depends on both DCOM configuration and whether the server is run as a service. When the server is run as a service, the services window will show that the service is started. Upgrade from PI OPC DA / HDA Server 2010 or earlier There is no direct upgrade from PI OPC DA/HDA Server 2010. You must uninstall PI OPC DA/HDA Server 2010 before installing PI OPC DA Server 2017 or PI OPC HDA Server 2016. Upgrade from PI OPC DA Server 2015 (v2.0.x or v2.1.x) Stop all instances of PI OPC DA Server 2015 (OPCDA2_Console86.exe and OPCDA2_Service86.exe). Follow the installation instructions above. Uninstalling PI OPC DA Server 2017 Stop all instances of PI OPC DA Server 2017 (OPCDA2_Console86/64.exe and OPCDA2_Service86/64.exe). Uninstall normally via Windows Control Panel. Documentation Overview PI OPC DA Server 2017 User Manual: A user manual describing principles of operation, installation and configuration of PI OPC DA Server 2017 OSIsoft Release Notes Page 4
Technical Support and Resources For technical assistance, contact OSIsoft Technical Support at +1 510-297-5828 or techsupport@osisoft.com. The OSIsoft Technical Support website offers additional contact options for customers outside of the United States. When you contact OSIsoft Technical Support, be prepared to provide this information: Product name, version, and build numbers Computer platform (CPU type, operating system, and version number) Time that the difficulty started Log files at that time Details of any environment changes prior to the start of the issue Summary of the issue, including any relevant log files during the time the issue occurred The PI Square community has resources to help you with your technical questions. PI Developers Club program offers specific services to developers and system integrators. OSIsoft Release Notes Page 5
OSIsoft, LLC 1600 Alvarado Street San Leandro, CA 94577 USA Tel: (01) 510-297-5800 Fax: (01) 510-357-8136 Web: http://www.osisoft.com PI OPC DA Server 2017 1992-2017 by OSIsoft, LLC. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, photocopying, recording, or otherwise, without the prior written permission of OSIsoft, LLC. OSIsoft, the OSIsoft logo and logotype, Managed PI, OSIsoft Advanced Services, OSIsoft Cloud Services, OSIsoft Connected Services, PI ACE, PI Advanced Computing Engine, PI AF SDK, PI API, PI Asset Framework, PI Audit Viewer, PI Builder, PI Cloud Connect, PI Connectors, PI Coresight, PI Data Archive, PI DataLink, PI DataLink Server, PI Developer's Club, PI Integrator for Business Analytics, PI Interfaces, PI JDBC driver, PI Manual Logger, PI Notifications, PI ODBC, PI OLEDB Enterprise, PI OLEDB Provider, PI OPC HDA Server, PI ProcessBook, PI SDK, PI Server, PI Square, PI System, PI System Access, PI Visualization Suite, PI Web API, PI WebParts, PI Web Services, RLINK and RtReports are all trademarks of OSIsoft, LLC. All other trademarks or trade names used herein are the property of their respective owners. U.S. GOVERNMENT RIGHTS Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the OSIsoft, LLC license agreement and as provided in DFARS 227.7202, DFARS 252.227-7013, FAR 12.212, FAR 52.227, as applicable. OSIsoft, LLC. Version: 1.0.0.0 Published: March 17, 2017 OSIsoft Release Notes Page 6