To use Process Data Integration, you must configure the Process Data Integration Service by modifying the file Meridium.PDI.Service.exe.config on the GE Digital APM Process Data Integration Server. If you installed the Process Data Integration Service in the default location, you can locate this file in the folder C:\Program Files\Meridium\Services.
Some modifications can be made using the APM System Administration tool and other modifications must be made by opening the file in an application that you can use to modify XML script (e.g., Notepad). The following instructions provide details on making all required modifications at one time, using both the APM System Administration tool and a text editor.
Note: This configuration file defines several endpoints on the Process Data Integration Server with URLs and ports that must be accessible from the GE Digital APM Server. You should ensure that your firewalls are configured to allow this access.
Steps
In the APM System Administration window, in the Configuration section, select the PDI Service link.
Some contents of the Meridium.PDI.Service.exe.config file appear to the right of the Configuration section.
In the OPCDA and OPCHDA boxes, enter the values that identify your OPC Server.
The following table contains the default values that identify the OPC Servers for the process historians that have been tested by GE Digital. We recommend, however, that you contact the third-party distributor of your process historian software to confirm the values that you should use for your system configuration.
| Process Historian | OPCDA | OPCHDA |
|---|---|---|
| OSIsoft® PI Server | OSI.DA.1 | OSI.HDA.1 |
| Matrikon Simulation tool | Matrikon.OPC.Simulation.1 | Matrikon.OPC.Simulation.1 |
| IP21 | Aspen.Infoplus21_DA.1 | N/A |
| MatrikonOPC HDA Server for IP21* | Matrikon.OPC.IP21.1 | Matrikon.OPC.IP21.1 |
| Honeywell Uniformance® Process History Database (PHD) | OPC.PHDServerDA.1 | OPC.PHDServerHDA.1 |
*In the GE Digital APM testing environment, IP21 and MatrikonOPC for IP21 are installed on separate machines.
In the OPCDAHOST and OPCHDAHOST boxes:
If the Process Data Integration Service and OPC software are installed on the same machine, leave these text boxes empty.
-or-
In the Tag Sync Interval box, replace the example value with the frequency (in hours) at which you want the tag synchronization to occur.
In the Initial Tag Sync Time box, replace the example value with the date and time (in UTC) that you want the first scheduled tag synchronization to occur.
Note: This value must be specified using the ISO 8601 standard for UTC date formats (i.e., the letters T and Z must be included), for example, 2014-01-01T04:00:00Z.
In the Max Sync Time box, replace the example value with the maximum length of time (in hours) that you want to allow the tag synchronization to run.
Note: The purpose of this setting is to stop a synchronization that is running significantly longer than expected (e.g., because it encountered an error) so that the synchronization will start over at the next scheduled time. Therefore, the maximum synchronization time that you allow should be longer than the length of time that it takes for tags to synchronize under normal circumstances and should account for known factors that may extend the synchronization time (e.g., network connection speed).
At the bottom of the APM System Administration window, select the Save button.
Your changes are saved to the file Meridium.PDI.Service.exe.config. You must now open the actual file to complete the service configuration.
Within the <meridiumConnections> tags, modify the attributes as described in the following table.
| Within this attribute... | Make this change | Notes |
|---|---|---|
| connection name |
Replace CONNECTION 1 with a name to identify the connection to the database. |
This value is used only by the configuration file. If you are configuring connections to multiple data sources, each connection name must be unique. |
| applicationServer |
Replace APPSERVER_NAME with the name or IP Address of the GE Digital APM Server on which the data source specified in the datasource attribute is configured. |
None |
| datasource | Replace DATASOURCE_NAME with the name of the GE Digital APM database to which you want to connect. |
The data source value is case sensitive and should be typed exactly as it is defined for the GE Digital APM Server in the Data Sources section of Operations Manager. |
| userId |
Replace SERVICE_USER_NAME with the User ID of the Security User whose credentials should be used to log in to the specified GE Digital APM database. |
The user you specify should be a member of the MI Process Data Integration Service Security Group. |
| password |
Replace PaSsWoRd with the password for the specified user. |
Do not delete the ! in front of the password. This symbol is not part of the password itself. Instead, this symbol will cause the password to be encrypted automatically when the service is restarted. IMPORTANT: If you need to change the password for the specified user, you should first stop the Process Data Integration service. Then, after changing the user’s password, update the password in this configuration file and restart the service. If you change the user’s password without restarting the service, the account will become locked. |
| xiServers | Replace OPC System1 with the value that exists in the OPC System ID field in an OPC System record in the GE Digital APM database. | If multiple OPC System records exist to identify multiple OPC Servers, you can specify multiple values and separate them with a semicolon (e.g., "OPC System1;OPC System2"). |
Save and close the file.
When the Process Data Integration Service is started or restarted, your settings will be applied and the initial tag synchronization will occur.
Copyright © 2018 General Electric Company. All rights reserved.