Scope
- Last UpdatedAug 28, 2023
- 4 minute read
- PI System
- PI System Connector 2.5.4
- Connectors
This section describes the functions of AF Server and Data Archive, and how they are supported by PI System Connector.
Replication options
PI System Connector offers three source PI System replication options per data source instance. The connector supports different replication option choices for each data source instance, and multiple data source instances for the same source PI System. These may have different replication options.
It does not matter which replication option you select, a PI Point is only replicated once, regardless of how many times it is referenced in the AF or PI Data Archive.
Note: The Global Query only applies to Replicate Data Archive only option, and not to any other replication setting type.
-
Replicate AF and Data Archive
This option replicates the selected AF database or root element, along with PI points referenced by the AF data reference attributes.
If you define a global query, it does not apply to Replicate AF and Data Archive. It exclusively works with Replicate Data Archive only.
-
Replicate AF only
This option replicates the selected AF database or root element without PI points referenced by AF data reference attributes.
-
Replicate Data Archive only
This option replicates PI points from a selected source Data Archive that matches the PI point query defined in the data source configuration.
AF Server
AF stores asset framework objects, such as elements and templates, in AF databases.
PI System Connector facilitates copying the entire AF database, or copying a single element branch of an AF database.
Data Archive
Data Archive is the cornerstone of the PI System and your data infrastructure, enabling high-performance data storage and retrieval by client software.
PI System Connector facilitates:
-
Copying PI points referenced in the data reference configuration strings of AF objects associated with Replicate AF and Data Archive data source configurations. The data reference configuration string of AF objects may reference one or more Data Archives.
-
Copying PI points associated with Replicate Data Archive only data source configurations that match the defined Include PI Points that match this query option.
The following diagram provides an example PI System Connector configuration.
PI System Connector Architectural Diagram

The PI System Connector maintains a connection to the source AF and Data Archives to ensure changes occurring on the source AF and Data Archives are reflected to the respective destinations. This includes AF object additions, changes and removals. For PI points, point additions and data changes are reflected to the destination Data Archive. This functionality relies on a discovery algorithm that periodically (every two minutes) examines the source servers and checks for changes. PI point archive data is copied using a backfill algorithm on start and then begins monitoring current archive data events. PI point snapshot data is monitored for data events for source PI points that have compression disabled/off as indicated by the PI point attribute compressing=0, or if the PI point is selected by the Send snapshot data for PI Points that match this query option in the Global Settings of the data source configuration.
PI System Connector general description
When replication options Replicate AF and Data Archive or Replicate AF only are configured, PI System Connector initially exports an AF database (or source element) with all referenced objects (with some restrictions detailed later on). This includes the elements, element templates, categories, enumeration sets, internal tables, UOM objects and reference types. For a single source element, only the referenced objects of the source element and its children are exported. In the latter case, children that are not parented by elements in the source element branch are re-parented to an element in the destination element branch. Although the original parenting is lost, the newly parented element is still updated with the source element's changes.
Note: UOM objects are always copied even if a Collect Data from a Specific Branch is checked.
During AF processing using the Replicate AF and Data Archive data source configuration, any referenced PI point found in an attribute or attribute template’s data reference is included in the list of replicated PI points. This includes all PI points regardless of the source data archive. PI points that do not match any query defined in Replicate Data Archive only data source configurations will not be included in the list of replicated PI points.
The following figure shows the data flow from a source to PI System to a destination PI System. Observe that streams from the PI Connector are strictly one-way to the PI Connector Relay, which means that a connector cannot obtain any information from either destination AF or Data Archive.
PI System Connector Diagram

PI Connectors communicate with PI Connector Relays over encrypted TCP/IP connections, which allows them to be on different computers.
Note: The PI System Connector requires the PI Connector Relay be configured with the destination AF server and Data Archive prior to the initial start.