|Grid Protection Alliance||openPDC Project||openPDC Wiki||Documentation||Latest Release|
openPDC OSI-PI Adapters
- For openPDC v2.1 or newer, the PI AF-SDK is required to be installed on the openPDC server. For openPDC v2.0 or older, the PI SDK v1.4.0 or greater (use 32-bit or 64-bit to match openPDC) must be installed on the openPDC server. For 64-bit installations you must install both the 64-bit SDK and the 32-bit SDK. The GSF OSI-PI adapter library depends on the 64-bit OSI-PI SDK libraries as well as the OSI-PI Buffering Subsystem which is only installed with the 32-bit SDK.
- Desired PI server connection must be added to the SDK
- Access to PI system using PI trust (preferred) or explicit login
- Connection must have access to read/write any points mapped to openPDC.
- If the metadata synchronization is enabled, connection must also have read/write access to the pipoint database.
Output Configuration on an Existing openPDC Installation
- Open the openPDC manager and navigate to Outputs > Historians.
- Click the Clear button to create a new historian.
- Type name is PIAdapters.PIOutputAdapter. Assembly name is PIAdapters.dll.
- Connection string should be the following: server=;
- For explicit logins, add the following: username=;password=;
- To have openPDC create new PI tags for all archived measurements if they don't already exist, add the following: runMetadataSync=True;
- Save the adapter configuration.
- Navigate to Manage > Measurements.
- Choose each measurement that should be archived to PI, and change its historian to the PI historian that was set up on the Historians page.
Output Configuration on a new openPDC Installation
- In the configuration setup utility, make sure to check the "Setup / change the primary historian" checkbox on the "Apply configuration changes" screen.
- On the next screen, which is the "Set up primary historian" screen, select "PI: Archives measurements to a PI server using AF-SDK"
- On the "Set up historian connection string" screen, set the servername property to the name of your PI server from the AF-SDK.
- For explicit logins, set the values of the username and password properties.
- To have openPDC create new PI tags for all archived measurements if they don't already exist, set the RunMetadataSync Property to True. Otherwise, set it to false.
- Continue with the setup utility. This will make all your measurements archive to PI by default.
Real-time Input Adapter Configuration
The real-time PI input adapter connects to PI using event pipes, which is the same mechanism process book uses to retrieve real-time data. The adapter also uses the connect on demand feature in openPDC, which allows it to only query PI for data being used by an action adapter or output adapter.
- In the openPDC manager, go to Adapters > Input Adapters.
- Enter a name for the PI input adapter.
- For the type of adapter, choose "PI: Reads real-time measurements from a PI server using AF-SDK."
- Set the ServerName property to the name of the PI server from the AF-SDK
- If you wish to connect to the PI server using explicit logins, set the UserName and Password properties too.
- Add an additional property to the connection string: "ConnectOnDemand=True;"
- Next, go to the Manage > Measurements screen.
- You will need to manually add measurements that you wish to make available in openPDC. Either the point tag or the alternate tag must match the point's tag in PI. It is recommended to create a separate historian (probably a virtual output historian) to archive all measurements and set the PI adapter's output measurement key to everything on the historian with a FILTER expression.
Copyright 2016 Grid Protection Alliance