How-To Guides
Integration Guides
OSI PI Historian Integration Guide
9min
Review the following guide for setting up an integration to allow the Litmus Edge Systems to connect with the PI Historian Web API for data exchange and interaction.
You will need the following:
- Make sure to update your Litmus Edge version to 3.16.0 or later to access the OSI PI Historian connector in the Integrations.
Follow the steps to Add a Connector and select the OSI PI Historian provider.
Configure the following parameters:
- Name: Enter a name for the connector.
- Description (Optional): Enter a description for the connection.
- Endpoint: Enter the address of the OSI PI Historian Web API (configured with OMF plugin).
- Username: Enter the username for access.
- Password: Enter the user password.
- CA Certificate (Optional): Upload or paste the SSL CA certificate.
- Gzip Compression: Enable gzip compression for OMF requests.
- Request Timeout: Set the HTTP request timeout in milliseconds.
- Data Timezone (Optional): UTC zone information to append to outbound data timestamps.
- Data Source Type (Optional): Text to be used as the root name for the data source. If empty, PI points will show "PIWebAPI_OMF".
- Data Source Version (Optional): Text to be used as the data source suffix. Requires a non-empty Data Source Type.
- Point Name Format: Text with format directives to generate PI point names.
- Point DataType Format: Text with format directives to generate AF type names.
- Point Description Format (Optional): Text with format directives to generate PI point descriptions.
- Check Tags (Optional): Select to check if the point name exists before attempting to create a new one.
- Publish Count Threshold: Set the publish count threshold (1 disables batching).
- Publish Delay Threshold: Set the publish delay threshold in milliseconds (0 disables batching).
- PI Data Server Name (Optional): Enter the name of the PI Data Archive server. Defaults to the first found.
- Subscribe Interval: Enter the polling interval in seconds.
- Max Subscription Events: Enter the maximum number of events processed per subscription poll (prioritized by the most recent).
- Insecure Skip Verify (Optional): Select to disable verification if you do not want the client to verify the server's certificate chain and host name.
- Parallel Publish Count: Set the number of simultaneously publishing messages.
- Persistent Storage (Optional): When enabled, messages in the outbound queue are stored on disk. If there are interruptions in connection or power loss, messages will be retained and eventually sent when the connection is restored.
- Queue Mode (Optional): Select the sequence of data transfer: FIFO or LIFO. Selecting FIFO (First In First Out) will send the earliest message first. Selecting LIFO (Last In First Out) will send the latest message first.
Edit a connector dialog box
Make sure to handle format directives with care when making changes. Refer to the points below for more details:
- Any change to metadata format settings is only applicable to proceeding data. Once ingested to PI, metadata of existing PI points will not be modified.
- Point names will change if inner variable value changes (e.g. Tag Description). This may result in new PI points being created.
- The following characters will be removed from any format string: *?;{}[]\'"|
- To use a special character in its literal form, enter the symbol twice: $$ -> $, %% -> % Example: $$$D.%%$N" -> "$deviceABC.%tagXYZ
- A special character must be followed by either itself or one of the supported characters. Refer to OSI PI Historian to get the list of symbols with their definition. Any other condition will result in an error: Example 1: $D.$N$% -> error Example 2: $D.$N$ -> error Example 3: $D.$N$# -> error
- Functions only act on the next variable found in the string.
After adding the connector, click the toggle in the connector tile to enable it.
OSI PI Historian Connector
You will now need to import the tags you added in Step 2 to the OSI PI Historian connector as topics.
Access the PI System Management Tools and verify that Litmus Edge is successfully sending data.
PI System Management Tools