Please ensure Javascript is enabled for purposes of website accessibility
Powered by Zoomin Software. For more details please contactZoomin

PI Connector for HART-IP

Connector failover

  • Last UpdatedJan 06, 2023
  • 4 minute read

Caution: Manufacturers such as Pepperl+Fuchs, Endress+Hauser, and Honeywell may only allow a single connection to a configured endpoint on the HART gateway. Therefore, check with the HART gateway manufacturer to verify support for simultaneous connections to the HART gateway. In some cases, the HART gateway may require multiple endpoints in order to support multiple connections. In this case, the connector failover pairs will require the data source to be configured with different endpoints so that each member of the failover pair can communicate with the same HART gateway.

With warm failover, each connector instance connects with the HART gateway defined in the configured datasource(s). Each connector instance actively retrieves HART gateway information so that the connector is able to assume the role of Active. However, only the connector instance in the Active role will actively retrieve real-time data to send to the PI System. The connector instance in the Backup role will actively check the HART gateway configuration to keep its objects up to date, but will not retrieve real-time data to send to the PI System. Having both connector instances simultaneously retrieve gateway configuration will put a slight load on the HART gateway. The HART gateway configuration calls are inexpensive in comparison to real-time data collections calls to the HART gateway. Therefore, warm failover should provide adequate performance during a failover scenario while minimizing the load on the HART gateway.

For failover to function properly, the connector must be able to notify the failover mechanism as to the connection status of the connector relative to the configured data source(s). PI Connector for HART-IP supports multiple data source configurations. A data source is considered connected if the connector can communicate with the HART gateway defined for the data source. Communication with the gateway means that the connector can discover the HART gateway contents. The connector does not need to be actively collecting real-time measurements from the datasource to be considered connected. The connector is considered connected if the percentage of connected data sources is greater than or equal to the value of the PercentUp field defined in the global configuration file (ConnectorGlobal.config.json). The connector is considered Disconnected if the percentage of connected data sources is less than the value of the PercentUp field defined in the global configuration file (ConnectorGlobal.config.json). The default PercentUp value is set to 100 percent.

The connector creates a PI AF element representing the connector instance failover configuration and status under the PI AF path of connector_root\Connector Installations\Failover. By default, the connector instance failover configuration and status PI AF element is not created. However, element creation can be enabled by setting the CreateFailoverStatusElements field in the global configuration file (ConnectorGlobal.config.json) to true.

Note: If this option is enabled, the PI AF element representing the connector instance failover configuration and status element, and any associated PI points, will not be created or updated while the connector instance is in the Backup role. Therefore, the failover element of the connector instance in the Backup role is not reliable and cannot be used to determine failover status. The failover element of the connector instance in the Active role is reliable and should be used monitor failover configuration and status.

The connector PI AF element representing the connector instance failover configuration and status contains the following attributes:

Attribute

Description

Value Type

PI Point

UoM

Value Range

Connector Type

Name of connector type.

String

No

HARTIP

Datasource Percent Up Actual

Percentage of data sources defined in the connector that are connected to their corresponding HART gateway. Updated once a minute or on-change.

Int32

Yes

%

0-100

System Digital: Not Connect

Datasource Percent Up Minimum

Minimum percentage of data sources defined in the connector that must be connected to their corresponding HART gateway in order for connector to report a failover status of Connected. This value is taken from the PercentUp field defined in the global configuration file. Updated on-change.

Int32

No

%

0-100

Designated Active

Set to true if this instance is the designated active when both instances report equal failover status. Updated on-change.

Boolean

No

True, False

System Digital: Not Connect

Failover Enabled

Report if failover is enabled or disabled for this connector instance. Updated once a minute or on-change.

HARTIP Connector.FailoverEnabledStatus

Yes

Disabled, Enabled

System Digital: Not Connect

Peer Failover State

Current failover state of Peer connector instance. Updated once a minute or on-change.

HARTIP Connector.EnumFailoverState

Yes

Unknown, Backup, Active, BackupDataSourceError, ActiveDataSourceError, BackupSyncError, ActiveSyncError, Transition, Stopped, Shutdown

System Digital: Not Connect

Peer Host

Hostname for the failover peer connector. Updated on-change.

String

No

Hostname

Peer Port

Port for the failover peer connector. Updated on-change.

Int32

No

Port

This Failover Connector Role

Current failover role of this connector instance. Updated once a minute or on-change.

HARTIP Connector.ConnectorRole

Yes

Backup, Active

System Digital: Not Connect

This Failover Datasource Status

Status of the datasource connection based on PercentUp. Updated once a minute or on-change.

HARTIP Connector.FailoverDataSourceStatus

Yes

Unknown, Connected, Disconnected

System Digital: Not Connect

This Failover State

Current failover state of this connector instance. Updated once a minute or on-change.

HARTIP Connector.EnumFailoverState

Yes

Unknown, Backup, Active, BackupDataSourceError, ActiveDataSourceError, BackupSyncError, ActiveSyncError, Transition, Stopped, Shutdown

System Digital: Not Connect

This Host

Hostname for this instance of the connector. Updated on-change.

String

No

Hostname

This Port

Port for this instance of the connector. Updated on-change.

Int32

No

Port

Time Tolerance

Number of milliseconds between peer-to-peer failover checks. Updated on-change.

Int32

No

0-MaxInt

The PI AF object representing the connector instance failover configuration and status for the TestHost:9876 connector instance is shown below.

Note: Users should refer to the Failover configuration page in the connector UI to determine connector instance failover status.

TitleResults for “How to create a CRG?”Also Available in