Release Notes PI OLEDB Version

Transcription

1 PI OLEDB Version OSIsoft, Inc. All rights reserved

2 Contents Overview... 1 Fixes and Enhancements... 1 Fixes... 1 Enhancements... 2 Known Issues... 3 Setup... 3 Operating Systems... 3 System Prerequisites... 4 Server Platforms... 4 Distribution Kit Files... 4 Installation and Upgrade... 5 Uninstalling Product... 5 List of Files Installed During Setup... 5 Documentation Overview... 6 Technical Support and Resources... 8

3 Overview The PI System itself is not a relational database. But it is possible to expose PI System data in a relational way. The PI OLEDB Provider implements SQL to allow relational queries to be run against the PI Server. This release of PI OLEDB Provider provides both 32-bit and 64-bit support, as well as other fixes and enhancements. Fixes and Enhancements Fixes This section lists items that were resolved or added in this release of PI OLEDB. For problems with previous versions see the release notes history presented on the web. Punch List Item 3823GMBH Description On Windows 2003 Server the setup version sometimes does not remove/uninstall the previous version. Instead it overwrites the old version. As side effect an old entry remains in "Add or Remove Programs". An attempt to manually uninstalling the old entry would also remove new components. This problem is related to the use of the /qb switch when calling MSI Installer. The setup has been changed to use the /qr switch and not run into this problem anymore. Before updating the provider with this setup, remove the old entry in "Add or Remove Programs" via "Remove" button and repair version via "Change" button and "Repair" Performance of DELETE piarchive..picomp2 WHERE tag was improved by leveraging PIData::RemoveValues instead of deleting events one-by-one. At the same time, execution of DELETE piarchive..picomp2 without WHERE condition was disallowed OSI OSI8 3833GMBH 17206OSI8 value column in pisystem..piconnection table was declared as non-nullable although it can contain NULLs. This bug has been fixed. One time use of PI OLEDB in an application might have caused hang. This bug has been fixed. Editing of an annotation for _index >1 deleted annotations of all other values at that timestamp. This bug has been fixed. Connection through PI OLEDB might have changed the global PI SDK Connection Timeout setting. This bug has been fixed. PI OLEDB 1

4 17048OSI OSI8 3816GMBH 3835GMBH 3837GMBH PI OLEDB didn't support SQL-specific ROUND function. Thus, ROUND function was evaluated as PE function. SQL-specific ROUND function implementation was added. Some time restrictions on pibatch catalog tables were not correctly delegated to PI SDK batch searches. Thus, the query execution might have been slow. Time restriction processing has been refactored. Caching algorithm was too memory-consuming especially for batch database queries. The algorithm has been revisited to take less memory. In addition, size of caches can be configured now (Max Cache Size). PI OLEDB connects but then shows error "[PI SDK] Operation not supported by the installed version of the PI server." on all queries. Recommendation to use PI OLEDB for older PI Servers has been added to the manual. Fixed queries in Compendium that use pointid. Enhancements 3791GMBH: Added new columns into summary tables to support filtered summaries and filtered expression summaries OSI8: PI OLEDB was compiled for 64-bit platform OSI8: "Switch Member" The user or application can explicitly switch to the next collective node by executing the new "Switch Member" command OSI8: The OLE DB consumer can now provide one or more identifiers (GUIDs) via the "Application Identity" property. One application should always use the same GUID to identify itself OSI8: An Option has been added to disallow log file creation for remote users and thus directly specify log file location on a remote computer (the PI OLEDB host). This option should be used if the end user has access to the connection string (parameter "Log File= "). An alternative parameter "Server Log" has been added that allows the end user or application to just specify the log file name but leverage a global configured log directory OSI8: PI OLEDB can be configured to route log messages to the local PI SDK log. In order to make this information visible a new table pilog..pisdklog has been added OSI8: Timestamp formatting has been added to the FORMAT function OSI8: pilog..pimessagelog table was extended with columns corresponding to new message log properties OSI8: Support for explicit conversions from string to numeric types was added. PI OLEDB 2

5 13560OSI8: PI OLEDB doesn't support log file "recycling". Thus, long running processes may create extremely large log files. To solve this problem, support for logging into local PI SDK message log has been added OSI8: PI OLEDB, configured as Linked Server has been successfully tested with BizTalk 2009 and its SQL adapter. Known Issues This section lists problems and enhancements that have been deferred until a future release or need to be solved by the user. Punch List Item 3826GMBH 3825GMBH Description No Data displayed in Snap-In Data Grid: We found 3 different reasons that the Data Grid stays empty: # MMC version less than 1.2 # MDAC version less than 2.6 # General ADO problem, e.g. msado15.dll not registered. Please, use MDAC Component Checker for troubleshooting. Running the Setup (as Update) on Windows 2003 Server may hang: An update of PI OLEDB to version on a Windows 2003 Server might have left 2 entries in "Add or Remove Programs" (problem 3823GMBH). If you run the next update, the setup may hang. In this case manually terminate the setup (e.g. end related "msiexec" processes in Task Manager) and rerun the setup. 3842GMBH The Setup Kit does not install on Windows 2008 Server x64 when Webserver role is enabled. Workaround: toggle WebServer role before and after running the Setup. Setup Operating Systems This release supports Windows 2000, Windows XP, Windows Vista, Windows 2003 and Windows PI OLEDB 3

6 System Prerequisites Installation of OSIsoft products rely on the presence of operating system components such as the Microsoft.NET Framework 3.0 and Microsoft Runtimes. OSIsoft product setup kits check for needed prerequisite software during installation. If not found, the installation will stop and the user will be prompted to install prerequisites. See the Prerequisites Product Pages on the OSIsoft Tech Support Web site and download either the Full - Online or Full - Offline prerequisite kit you need: Server Platforms PI Server and later (Windows and UNIX) Annotations are supported with PI Server and later. PI Module Database and PI Batch Database support is provided in PI Servers and later. Distribution Kit Files The PI OLEDB distribution kit is intended to install additional prerequisites onto any target platform. The following table has a short description of each component included in the setup kit. The PI OLEDB setup distribution consists of the following files: File setup.exe setup.ini SetupUtils.dll pisdk.msi or pisdk_x64.msi silent.ini prerequisite.ini WindowsInstallerSetup.dll (32bit only) DotNet20Setup.dll Description Setup wrapper installation program. This program manages delivery of all components. Setup wrapper configuration. Setup wrapper utility module. Windows installer file for the PI-SDK Setup wrapper silent installation configuration. Setup wrapper configuration file prerequisite files that may cause a reboot. Setup module for Windows Installer 3.1. Setup module for DotNet 2.0 Framework. MSRuntimes.msi Visual Studio redistributables or MSRuntimes_x64.msi msxmlsetup.dll Setup module for XML parser version 6. PIOLEDBProvider.msi Windows Installer file for PI OLEDB MDACSetup.dll Setup module for mdac_typ.exe 2.7. This is only needed (32bit only) for some Windows 2000 installations. ScriptingRuntimeSetup.dll Setup module for Windows Script Runtime. This is only (32bit only) needed for some Windows 2000 installations. readme.pdf Release notes for PI OLEDB PI OLEDB 4

7 Installation and Upgrade PI OLEDB is installed via setup kit. Previous versions are updated automatically. For Windows 2003 Server please see Fix #3823GMBH and Known Issue #3825GMBH above. Uninstalling PI OLEDB Provider PI OLEDB can be uninstalled via "Add or Remove Programs" in the Control Panel for Windows 2000, XP, and 2003, or via Programs and Features in the Control Panel for Windows Vista and List of Files Installed During Setup The following tables list the files contained in the PI OLEDB MSI file. If not already present or available in an older version only, these files are installed on your system. Directory File Version Comment $PIPC\OLEDB PIOLEDB.dll $PIPC\OLEDB PIOLEDBSnapIn.ocx (32bit only) $PIPC\OLEDB PIOLEDBCtlsL.ocx (32bit only) $PIPC\OLEDB PIOLEDBCtls.dll (32bit only) $PIPC\OLEDB MyMDBCopy.exe (32bit only) $PIPC\OLEDB\Doc PIOLEDB.pdf $PIPC\OLEDB\Doc PIOLEDBProvider_ pdf $PIPC\OLEDB\Samples $PIPC\OLEDB\Tools64 $PIPC\OLEDB\Tools ADO, ADO.NET and SQL Server examples demonstration, testing and configuration tools, e.g. PI OLEDB Tester demonstration, testing and configuration tools, e.g. PI OLEDB Tester, MMC Snap-In (32bit only) (64bit only) (32bit only) Tutorials (32bit only) $Windows\Symbols\dll PIOLEDB.pdb (32bit only) $Windows\Symbols\dll PIOLEDB64.pdb (64bit only) $Windows\System32 MSVCRT71.DLL (32bit only) $Windows\System32 MSVCP71.DLL (32bit only) $Windows\System32 OLEAUT32.DLL (32bit only) $Windows\System32 COMCAT.DLL (32bit only) $Windows\System32 MSSNAPR.DLL (32bit only) $Windows\System32 TDBG7.OCX (32bit only) PI OLEDB 5

8 Directory File Version Comment $Windows\System32 TDBGPP7.DLL (32bit only) $Windows\System32 TODG7.OCX (32bit only) $Windows\System32 TODGUB7.DLL (32bit only) $Windows\System32 XADB7.OCX (32bit only) $Windows\System32 MSDATGRD.OCX (32bit only) $Windows\System32 MSADODC.OCX (32bit only) $Windows\System32 MSBIND.DLL (32bit only) $Windows\System32 MSSTDFMT.DLL (32bit only) $Windows\WinSxS MSVCM90.DLL $Windows\WinSxS MSVSP90.DLL $Windows\WinSxS MSVCR90.DLL Documentation Overview PI OLEDB Manual: Product description and many use cases. White Papers: Location Title Remark Download Center (Documentation/White Papers) PI OLEDB SQL Optimization White Paper Download Center (Documentation/White Papers) White Paper on Connecting OLAP with PI via the PI OLEDB Provider Targets Integration with MS SQL Server 2000 Analysis Services Tutorials: Location Title Remark OSIsoft vcampus, PI OLEDB Basics Getting Started OSIsoft vcampus, OSIsoft vcampus, OSIsoft vcampus, Creating SSRS Reports with PI OLEDB Building a PI OLEDB/SQL Web Service ADO.NET Programming via PI OLEDB Integration with MS SQL Server 2005 Reporting Services (SSRS) Create a Web Service for executing PI OLEDB queries utilizing Visual Studio.NET 2003; Also includes Client Create an ADO.NET client for PI OLEDB, utilizing Visual Studio.NET 2003 PI OLEDB 6

9 Location Title Remark OSIsoft vcampus, \Anno tation Replication PIPC\OLEDB\Doc PIOLEDB Manual, Appendix B Complementing RtWebParts with PI OLEDB Remote Execution of PI SQL Queries from a SQL Server 2005 Stored Procedure (CLR), (Query PI OLEDB Web Service) PI OLEDB based SSIS Package for PI Annotated Data Replication MDB BDB Tutorial PI Webparts accessing PI Batches and Calculations via PI OLEDB DataSets CLR Stored Procedure developed in Visual Studio 2005 Integration with MS SQL Server 2005 Integration Services (SSIS) Relational Model for PI Batches and PI Module Database; How to Query PI Batches PI OLEDB 7

10 Technical Support and Resources OSIsoft provides dedicated technical support internationally, 24 hours a day, 7 days a week to customers with a current SRP contract. To locate local access numbers and current contact options, please visit our Contact Methods page on the Technical Support web site at The main contact information is also listed below: Telephone: Web Portal: techsupport@osisoft.com My Calls When you open a case using any of the above methods, you will receive a response from a Technical Support Engineer within four hours. Be sure to provide: Product name, version, and/or build numbers Computer platform (CPU type, operating system, and version number) The time that the difficulty started The message log(s) at that time You can also take advantage of the Self-service Search page on our Technical Support Web Site to look for answers to your technical questions and issues. The search tool searches our online library of documentation, knowledge base articles, technical announcements and bulletins, known product issues, and documented product enhancement requests, as well as a collection of resources for system managers. PI OLEDB 8

11 OSIsoft, Inc. 777 Davis St., Suite 250 San Leandro, CA USA (01) (main phone) (01) (fax) (01) (support phone) Houston, TX Johnson City, TN Longview, TX Mayfield Heights, OH Philadelphia, PA Phoenix, AZ Savannah, GA Yardley, PA OSIsoft Australia Perth, Australia OSI Software GmbH Altenstadt, Germany OSI Software Asia Pte Ltd. Singapore OSIsoft Canada ULC Montreal, Canada OSIsoft, Inc. Representative Office Shanghai, People s Republic of China OSIsoft Japan KK Tokyo, Japan OSIsoft Mexico S. De R.L. De C.V. Mexico City, Mexico OSIsoft do Brasil Sistemas Ltda. Sao Paulo, Brazil Sales Outlets/Distributors Middle East/North Africa Republic of South Africa Russia/Central Asia South America/Caribbean Southeast Asia South Korea Taiwan OSIsoft, Inc. is the owner of the following trademarks and registered trademarks: PI System, PI ProcessBook, Sequencia, Sigmafine, grecipe, srecipe, and RLINK. All terms mentioned in this book that are known to be trademarks or service marks have been appropriately capitalized. Any trademark that appears in this book that is not owned by OSIsoft, Inc. is the property of its owner and use herein in no way indicates an endorsement, recommendation, or warranty of such party's products or any affiliation with such party of any kind. RESTRICTED RIGHTS LEGEND Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS PI OLEDB 9