Professional Documents
Culture Documents
Table of Contents
Overview ................................................................................................................... 1
Fixes and Enhancements ........................................................................................ 1
Fixes .................................................................................................................... 1
Enhancements..................................................................................................... 3
Known Issues ........................................................................................................... 3
Setup ......................................................................................................................... 7
Operating Systems .............................................................................................. 7
System Prerequisites .......................................................................................... 7
Server Platforms .................................................................................................. 8
Distribution Kit Files ............................................................................................. 8
Installation and Upgrade ..................................................................................... 9
Uninstalling PI OLEDB Enterprise ....................................................................... 9
List of Files Installed During Setup........................................................................ 9
Documentation Overview ......................................................................................11
Technical Support and Resources ......................................................................12
Overview
PI OLEDB Enterprise is an OLE DB data provider which provides access to the PI System in
a relational view, accessible through SQL queries. The provider supports read-only access to
asset and event data stored in the PI Asset Framework (AF), such as AF Elements, AF
Attributes, and PI Event Frames. PI OLEDB Enterprise also provides read-only access to
timeseries data from the PI Data Archive, since Attributes can be configured to reference PI
points.
PI OLEDB Enterprise belongs to OSIsofts PI Data Access suite of products, which are
designed to support implementation of custom applications on top of the PI System, as well
as integration of PI System data with other applications and business systems. For more
information on other PI Data Access products and details on the licensing specific to these
products (e.g. development vs. runtime), please consult the PI OLEDB Enterprise User Guide
or contact your account manager.
This release brings performance enhancements and the following new features, in addition to
bugs being fixed:
Description
WI53694
Non-ASCII characters in a query stopped logging. This bug has been fixed.
WI58929
WI59215
Search by value query may return Unknown error. Details: error code
0xc0000005 error. This bug has been fixed.
WI59243
WI59247
Page 1
WI60680
WI61417
WI62408
When the PI SQL Commander is launched the first time for a certain user,
an unhandled Microsoft .NET Framework exception is shown at startup.
This bug has been fixed.
WI62409
When the PI SQL Commander is closing and there is an open .sql file which
is not included in any project, an unhandled Microsoft .NET Framework
exception is shown. This bug has been fixed.
WI62963
Global PI System settings (AF Server ports, PI Server lists) were not
refreshed. This bug has been fixed.
WI63000
WI63003
WI63118
A timeseries data query may fail when connected with explicit credentials.
This bug has been fixed.
WI66174
An ElementAttribute table query against asset hierarchy containing multiversion elements could fail. This bug has been fixed.
WI63876
WI65217
PI OLEDB Enterprise Agent may crash while stopping. This bug has been
fixed.
WI66183
Transpose functions could return empty cells when values were expected.
This bug has been fixed.
WI66529
Data retrieval from attributes with empty Guid or DateTime arrays fails.
This bug has been fixed.
WI71657
WI71675
WI73074
The command timeout could expire earlier than it was specified. This bug
has been fixed.
WI73387
Execution of parameterized queries could fail. This bug has been fixed.
WI73390
WI73558
WI73639
ORDER BY <integer_literal> could make the query execution fail. This bug
has been fixed.
WI75002
Page 2
WI75231
Under high load and due to a bug in the OLE DB layer, the query execution
may have ended with an unhandled exception. This bug has been fixed.
WI75237
Search by value may not return any results when parameters of type VT_I8
(OleDbType.BigInt in ADO.NET) are used. This bug has been fixed.
WI75509
WI76028
Hierarchy tables truncated paths longer than 4000. This bug has been fixed.
WI76040
RIGHT function with N argument bigger than the string length made the
whole query execution fail. This bug has been fixed.
WI76047
Queries containing more than 64 "UNION" subqueries might have failed with
the "The parameter is incorrect." error message. This bug has been fixed.
WI77118
Enhancements
Read-only Event Frame tables have been added to the provider.
The Asset.ElementReference table has been added. It complements the
Asset.vElementReference table and simplifies queries in certain cases. (WI58870)
Added GetPIPoint Table-Valued Function. (WI32497)
Export/Import capability for custom database objects (e.g. Views, Transpose Functions)
has been added to PI SQL Commander. (WI61286)
Known Issues
This section lists problems and enhancements that have been deferred until a future release or
need to be solved by the user.
Description
22592OSI8
Page 3
n/a
Page 4
N/A
25437OSI8
Page 5
WI74499
WI75531
WI77542
Page 6
Setup
Operating Systems
This release supports:
Windows 7
Windows 8
System Prerequisites
PI OLEDB Enterprise requires PI SQL for AF Server that is part of the PI AF Server
installation.
If you use PI AF Server 2.3, then PI SQL for AF Server can optionally be updated to version
PI SQL for AF Server 2.3.1.0. This version provides higher performance for Attribute
searches, compared to the version included in PI AF Server 2.3.
If you use PI AF Server 2.4 (2010 R3) it is recommended to install PI AF Server 2010 R3
Patch.
Installation of an OSIsoft product on Windows relies on the presence of Microsoft operating
system components such as the Microsoft .NET Framework and Microsoft run time libraries.
OSIsoft Prerequisite Kits are available in three packages that verify and install the needed
operating system prerequisites:
Online (Recommended): For installation on a computer connected to the internet. This kit
connects to Microsoft sites in order to download .NET Framework 3.5 for the operating
system on which it is run. This is a bootstrapper kit that is much smaller than the Standalone
kit.
Standalone (Recommended): For installation on a computer that cannot connect to Microsoft
sites, or for installations where such connection is not desirable. This is a full redistributable
kit that is much larger than the Online kit.
OSIsoft Release Notes
Page 7
Legacy: This kit should only be used for installation on older operating systems where the
OSIsoft products do not require .NET Framework 3.5.
All three Prerequisite Kits contain both 32-bit and 64-bit installation redistributables.
See the Prerequisites Product Pages on the OSIsoft Tech Support Web site to determine
which MS Operating System prerequisites you need:
http://techsupport.osisoft.com/Products/Prerequisite+Kits/Prerequisite+Kits+Overview.htm
Server Platforms
AF High Availability (HA) is supported with PI AF Server 2010 (2.2) and later.
Description
setup.exe
setup.ini
SetupUtils.dll
silent.ini
VSIsoShellSetup.dll
VSIsoShell.exe
dotnet35Setup.dll
dotnet40Setup.dll
dotNetFx40_Full_x86_x64.
exe
MSRuntimes.msi
MSRuntimes_x64.msi
en_visual_c++_2010_sp1_r
edistributable_package_x8
6_651767.exe
en_visual_c++_2010_sp1_r
edistributable_package_x6
4_651767.exe
MSRuntimesSetupVS2010
SP1_x86.dll
MSRuntimesSetupVS2010
SP1_x64.dll
pisdk.msi
pisdk_X64.msi
pibufss.msi
AFClient_x86_2012*.msi
AFClient_x86_2012*.msi
Page 8
File
Description
VSTOWrapper_x86.dll
VSTOWrapper_x64.dll
vstor40_x86.exe
vstor40_x64.exe
PIOLEDBEnterprise.msi
PIOLEDBEnterprise64.msi
PIOLEDB.msi
PIOLEDB64.msi
pisqldas_1.2.2.0243x86.msi
pisqldas_1.2.2.0243x64.msi
PISQLDASUpgrade.dll
*.htm
*.pdf
Page 9
Directory
File
Version
Comment
$PIPC\OLEDB
PIOLEDBENT.dll
1.3.1.5
PI OLEDB
Enterprise, 32-bit
$PIPC\OLEDB
PIOLEDBENT64.dll
1.3.1.5
PI OLEDB
Enterprise, 64-bit
$PIPC\OLEDB
PIOLEDBENTAgent.exe
1.3.1.5
PI OLEDB
Enterprise Agent,
32-bit
$PIPC\OLEDB
PIOLEDBENTAgent.exe.config
n/a
$PIPC\OLEDB
PIOLEDBENTAgent.exe.config.1.
3.1.5
n/a
Backup of
previous Agent
config file, 32-bit
$PIPC\OLEDB
PIOLEDBENTAgent64.exe
1.3.1.5
PI OLEDB
Enterprise Agent,
64-bit
$PIPC\OLEDB
PIOLEDBENTAgent64.exe.config
n/a
$PIPC\OLEDB
PIOLEDBENTAgent64.exe.config.
1.3.1.5
n/a
Backup of
previous Agent
config file, 64-bit
$PIPC\OLEDB
ManageAgentConfig.log
n/a
Configuration log
file
$Windows\Symbols\exe
PIOLEDBENTAgent.pdb
n/a
debug symbols,
32-bit
$Windows\Symbols\exe
PIOLEDBENTAgent64.pdb
n/a
debug symbols,
64-bit
$Windows\Symbols\dll
PIOLEDBENT.pdb
n/a
debug symbols,
32-bit
$Windows\Symbols\dll
PIOLEDBENT64.pdb
n/a
debug symbols,
64-bit
$PIPC\OLEDB\Tools
n/a
$PIPC\OLEDB\Doc
n/a
$PIPC\HELP
PISQLCommander.chm
n/a
Help file
32-bit Folder only
$WinSXS
Microsoft_VC100_CRT_x86.msm
10.0
$WinSXS
Microsoft_VC100_CRT_x86_x64.
msm
10.0
For other MSI files (PI SDK, AF Client and the classic PI OLEDB Provider), please consult
the release notes of these products to get a complete list of installed components.
Page 10
Details on the Microsoft Visual Studio Shell 2010 (Isolated) redistributables can be found
here:
http://www.microsoft.com/download/en/details.aspx?id=1366
Details on the .NET Framework 4.0 redistributables can be found here:
http://www.microsoft.com/downloads/en/details.aspx?FamilyID=0a391abd-25c1-4fc0-919fb21f31ab88b7&displaylang=en
Documentation Overview
PI OLEDB Enterprise User Guide:
Product description and use cases.
PI SQL Commander Help:
Working with PI SQL Commander and Generate Custom TVFs and Function Tables
Samples, tutorials and additional development support are provided through the OSIsoft
Virtual Campus (vCampus) program see http://vCampus.osisoft.com.
Page 11
Summary of the issue, including any relevant log files during the time the issue occurred
The OSIsoft Virtual Campus (vCampus) website has subscription-based resources to help you
with the programming and integration of OSIsoft products.
Page 12
OSIsoft, LLC
777 Davis St., Suite 250
San Leandro, CA 94577 USA
Tel: (01) 510-297-5800
Fax: (01) 510-357-8136
Web: http://www.osisoft.com
OSIsoft Australia Perth, Australia
OSIsoft Europe GmbH Frankfurt, Germany
OSIsoft Asia Pte Ltd. Singapore
OSIsoft Canada ULC Montreal & Calgary, Canada
OSIsoft, LLC Representative Office Shanghai, Peoples 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
Page 13