UniInt failover-specific messages
- Last UpdatedMay 22, 2025
- 5 minute read
Informational
|
Message |
Meaning |
|---|---|
|
|
Upon interface startup, the initial transition is made to the backup state. In this state the interface monitors the status of the other interface participating in failover. When configured for hot failover, data received from the data source is queued and not sent to Data Archive while in this state. The amount of data queued while in this state is determined by the failover update interval. In any case, there will be typically no more than two update intervals of data in the queue at any given time. Some transition chains can cause the queue to hold up to five failover update intervals worth of data. |
|
|
In primary state, the interface sends data to Data Archive as it is received. This message also indicates that there is not a backup interface participating in failover. |
|
|
While in this state, the interface sends data to Data Archive as it is received. This message also states that the other copy of the interface appears to be ready to take over the role of primary. |
Error messages (Phase 1 & 2)
|
Message |
Cause |
Resolution |
|---|---|---|
|
|
The Active ID tag is not configured properly. |
Check validity of point attributes. Make sure the location1 attribute is set to the id parameter of the interface. All failover tags must have the same pointsource and location1 attributes. Modify point attributes as necessary and restart the interface. |
|
|
The heartbeat tag is not configured properly. |
Check validity of point attributes. Make sure the location1 attribute is set to the id parameter of the interface. All failover tags must have the same pointsource and location1 attributes. Modify point attributes as necessary and restart the interface. |
|
|
The ufo_id parameter has not been assigned a positive integer value. |
Change and verify the parameter to a positive integer and restart the interface. |
|
|
The ufo_otherid parameter is not defined or has not been assigned a positive integer value. |
Change and verify the ufo_otherid parameter to a positive integer and restart the interface. |
Errors (Phase 1)
|
Message |
Cause |
Resolution |
|---|---|---|
|
|
The failover control points on the data source are returning an erroneous value to the interface. This error can be caused by creating a non-initialized control point on the data source. This message will only be received if the interface is configured to be synchronized through the data source (Phase 1). |
Check validity of the value of the control points on the data source. |
|
|
The Active ID or heartbeat tag is not configured properly. This message is received only if the interface is configured to be synchronized through the data source (Phase 1). |
Check validity of point attributes. Make sure the location1 attribute is set to the id parameter of the interface. All failover tags must have the same pointsource and location1 attributes. Modify point attributes as necessary and restart the interface. |
|
|
The Active ID point value on the data source caused an error when read by the interface. The value read from the data source must be valid. Upon receiving this error, the interface enters the “Backup in Error state.” |
Check validity of the value of the Active ID point on the data source. |
|
|
The heartbeat point value on the data source caused an error when read by the interface. The value read from the data source must be valid. Upon receiving this error, the interface enters the “Backup in Error state.” |
Check validity of the value of the heartbeat point on the data source |
Error Messages (Phase 2)
|
Message |
Cause |
Resolution |
|---|---|---|
|
|
The interface is unable to create a new failover synchronization file at startup. The creation of the file takes place the first time either copy of the interface is started and the file does not exist. The error number most commonly seen is error number 5. Error number 5 is an "access denied" error and is probably the result of a permissions problem. |
Ensure the account that the interface is running under has read and write permissions for the directory. Set the access control list on the directory to read/write/create access to the account that runs the interface. |
|
|
The interface is unable to open the failover synchronization file. The interface failover continues to operate correctly if communication to Data Archive is not interrupted. If communication to Data Archive is interrupted while one or both interfaces cannot access the synchronization file, the interfaces remain in the state they were in at the time of the second failure: the primary interface remains primary and the backup interface remains backup. |
Ensure the account that the interface is running under has read and write permissions for the directory. Set the access control list on the directory to read/write/create access to the account that runs the interface. |