OPC UA Servers

  1. In
    FactoryTalk Administration Console
    Explorer
    , right-click an OPC UA Connector, and then select
    Properties
    .
  2. In
    FactoryTalk Linx
    OPC
    UA Connector
    , select
    OPC UA Servers
    .
Use
OPC UA Servers
to configure settings and view the diagnostic information for each
OPC
UA Server that communicates with a
FactoryTalk Linx
OPC
UA Connector.

OPC UA Servers

Lists the OPC UA Servers that the
FactoryTalk Linx
OPC
UA Connector is configured to communicate with. Status icons show the OPC UA Server status. Each connector supports up to 20 OPC UA Servers.
Normal Connection Status Icon
Icon
Text
Description
opc_ua_client_status_not_started
Communication is not started
The
OPC
UA Server configuration is not saved. The
FactoryTalk Linx
OPC
UA Connector service is not attempting to connect to the
OPC
UA Server.
To save the configuration and start the connection, select
Apply
or
OK
.
opc_ua_client_status_connecting
Connecting with Server
The
FactoryTalk Linx
OPC
UA Connector is attempting to connect to the
OPC
UA Server.
Tip
: If the FactoryTalk Linx OPC UA Connector stays in this state for an extended period of time, use the FactoryTalk Live Data Test Client to evaluate the "@OPC_Namespace…" predefined tags to monitor the namespace upload process.
opc_ua_client_status_disconnected
Disconnected with server
The
FactoryTalk Linx
OPC
UA Connector cannot connect or has lost connection to the
OPC
UA Server.
opc_ua_client_status_connected
Uploading Namespace
The
FactoryTalk Linx
OPC
UA Connector is uploading the
OPC
UA Server's namespace and presents the count of detected tags and the associated time cost for uploading.
Communicating with server
The
FactoryTalk Linx
OPC
UA Connector is connected to the
OPC
UA Server.
Reverse Connection Status Icon
Icon
Text
Description
opc_ua_client_status_not_started
Communication is not started
The
OPC
UA Server configuration is not saved. The
FactoryTalk Linx
OPC
UA Connector service is not attempting to connect to the
OPC
UA Server.
To save the configuration and start the connection, select
Apply
or
OK
.
opc_ua_client_status_connecting
Connecting with Server
The
FactoryTalk Linx
OPC
UA Connector is attempting to connect to the
OPC
UA Server.
Tip
: If the FactoryTalk Linx OPC UA Connector stays in this state for an extended period of time, use the FactoryTalk Live Data Test Client to evaluate the "@OPC_Namespace…" predefined tags to monitor the namespace upload process.
opc_ua_client_status_disconnected
Disconnected with server
The
FactoryTalk Linx
OPC
UA Connector cannot connect or has lost connection to the
OPC
UA Server.
opc_ua_client_status_connecting
Listening for connection request
The
FactoryTalk Linx
OPC
UA Connector is actively monitoring for incoming connection requests from the OPC UA Server. This status only applies to the case of a reverse connection.
opc_ua_client_status_retrieving
Server detected, retrieving endpoints
The
FactoryTalk Linx
OPC
UA Connector has detected the OPC UA Server configured for reverse connection and is retrieving its endpoint URL to establish communication.
opc_ua_client_status_disconnected
Failed Connections:
number
The
FactoryTalk Linx
OPC
UA Connector fails to establish communication with the OPC UA Server through reverse connection and presents unsuccessful connection attempts for a duration of 10 seconds before switching the status to
Listening for connection request
. The failed connection count resets upon service restart or successful connection. Possible causes are as follows:
  • The network path to the OPC UA Server entered in the
    Endpoint URL
    box does not match the actual one.
  • The security policy configured in the OPC UA Connector does not match that configured in the OPC UA Server.
  • The OPC UA Server does not trust the security certificate of the OPC UA Connector.
  • The user ID or password that the OPC UA Connector is using to connect to the OPC UA Server does not match that configured in the OPC UA Server.
opc_ua_client_status_connected
Uploading Namespace
The
FactoryTalk Linx
OPC
UA Connector is uploading the
OPC
UA Server's namespace and presents the count of detected tags and the associated time cost for uploading.
Communicating with server
The
FactoryTalk Linx
OPC
UA Connector is connected to the
OPC
UA Server.
Buttons
Button
Description
Add
Adds an
OPC
UA Server to the
FactoryTalk Linx
OPC
UA Connector.
Delete
Removes the selected
OPC
UA Server from the
FactoryTalk Linx
OPC
UA Connector.

UA Server Properties

Select a server from the
OPC UA Servers
list to view or edit its properties. Some properties have predefined diagnostic item counters that can be used for monitoring. If needed, use
Reset Counters
command to reset diagnostic counter values to 0 for the server. Not all counters are resettable.
General
Property
Predefined Diagnostic Item
Description
Name
N/A
Sets the name for the
OPC
UA Server. The name must be unique. The server name displays in the
FactoryTalk
application tree and is included in the full tag path for all tags provided by the server.
Description (optional)
N/A
Sets the description for the
OPC
UA Server as needed.
Endpoint URL
N/A
Sets the network path to the
OPC
UA Server. The path must be in the format of
opc.tcp://
hostname_or_ip:port
/
EndpointName
where
hostname_or_ip
,
port
, and
EndpointName
are replaced with the host name or IP address, port number, and endpoint name of an
OPC
UA Server and its local discovery service.
If no port is specified, the
FactoryTalk Linx
OPC
UA Connector will attempt to connect to port 4880.
The security system on the
OPC
UA Server must allow incoming connections to the selected port for the connection to succeed.
If the
OPC
UA server is on the same computer as the connector, enter
opc.tcp://
localhost:port
.
Typically, an
OPC
UA Server identifies its Endpoint URL within the server management interface. If the server or endpoint cannot be browsed, copy this URL from the server and enter it manually.
If the UA Connector is configured to operate in a redundant configuration, one additional selection is available:
  • Select
    Utilize the same URL as primary endpoint
    to use the same OPC UA Server for the redundant connector.
All the settings and configuration of OPC UA Servers are the same as the primary and secondary URLs.
Reverse Connect
@OPC_ReverseConnectEnabled
Enables or disables the Reverse Connection function by selecting or clearing this checkbox. After this property is initially configured, any change to it requires restarting the
FactoryTalk Linx
OPC
UA Connector service.
The @OPC_ReverseConnectEnabled diagnostic item is read-only.
Client Address
N/A
Specifies the host name or the IP address of
FactoryTalk Linx
OPC
UA Connector.
When the OPC UA Connector is configured locally, select the host name or IP address from the list or enter the value in the box.
When the OPC UA Connector is configured remotely, the default is the host name. You can also choose to enter the IP address in the box.
Client Port
N/A
Specifies the port of the OPC UA Client to be used for Reverse Connection. The port must not be used by another endpoint or application.
Tip
:
FactoryTalk Linx
OPC
UA Connector will verify the usage availability of the specified port. When the OPC UA Connector is configured locally, the port that passes the verification is available to use. When the OPC UA Connector is configured remotely, you must go to the local workstation to verify if the port is used by another application.
Client Endpoint URL
@OPC_ReverseConnectClientURL
Generates the network path to the
FactoryTalk Linx
OPC
UA Connector in the format of
opc.tcp://
ClientAddress:ClientPort
based on the values specified in
Client Address
and
Client Port
. This value will be used by the OPC UA Server to initiate a reverse connection to the
FactoryTalk Linx
OPC
UA Connector.
This property is read-only. Select
Copy
next to this property to copy the value if needed.
Server URI
@OPC_ReverseConnectServerUri
Displays the retrieved Server URI provided by the OPC UA Server. This property is read-only.
Log Reverse Connect Server Uri
@OPC_ReverseConnectLogDiscoveredUrls
Determines whether to log the URL and URI for the reverse connected OPC UA Server to
FactoryTalk Diagnostic Log
.
Security
Property
Predefined Diagnostic Item
Description
Security Policy
N/A
Determines what type of encryption algorithm is used for protecting data passed between the
FactoryTalk Linx
OPC
UA Connector and the
OPC
UA Server.
Use either:
  • None
    - No security is used between the connector and the server.
  • Basic128Rsa15
    - This algorithm has been deprecated by the OPC Foundation and is no longer considered secure. It is provided for use with older systems that require encryption but cannot update to the newer policy.
  • Basic256
    - This algorithm has been deprecated by the OPC Foundation and is no longer considered secure. It is provided for use with older systems that require encryption but cannot update to the newer policy.
  • Basic256Sha256
    - Recommended. Appropriate for environments with high security needs.
  • Aes128_Sha256_RsaOaep
    - Defines a security policy for configurations with average security needs.
  • Aes256_Sha256_RsaPss
    - Defines a security policy for configurations with a need for high security.
Security Mode
N/A
Determines how the connection between the
FactoryTalk Linx
OPC
UA Connector and the
OPC
UA Server is authenticated and whether the data is protected by encryption.
Use either:
  • None
    - No security is used between the connector and the server. This option is appropriate when the
    OPC
    UA Server is protected using a firewall and other security measures. This mode has the highest performance.
  • Sign
    - Requires the communication between the connector and the server to be signed so that the sender of the data is authenticated. With this setting selected, if the signature is invalid or not present the incoming data is rejected. Used to protect against spoofing.
  • SignAndEncrypt
    - Requires the communication between the connector and the server to be both signed, so that the sender of the data is authenticated and encrypted so that it cannot be read by a client without the corresponding key. With this option selected, if the signature is invalid or not present or if the encryption key does not match the incoming data is rejected. Used to protect against snooping and spoofing.
Certificate path
@OPC_CertificateOutgoingPath
Displays the path to the certificate provided by the
FactoryTalk Linx
OPC
UA Connector. If the
FactoryTalk Linx
OPC
UA Connector is hosted on a remote computer, the path represents the file location on the remote computer.
The default path is C:\ProgramData\Rockwell\OpcUaConnector\RnaUaClientDataProvider\PKI\.
Accept Incoming Certificate automatically
N/A
Allows the FactoryTalk Linx OPC UA Connector to accept the certificate of OPC UA Server automatically. This checkbox is selected by default and cannot be cleared.
If the OPC UA Server requires authentication for the client connection, supply a username and password.
IMPORTANT: Modifying the user name and password requires using
FactoryTalk Administration Console
on the same workstation as the
OPC
UA Connector (as configured on
Connector Settings
).
Authentication Settings
Property
Predefined Diagnostic Item
Description
Anonymous
N/A
Uses an anonymous connection to the OPC UA Server
User name & Password
N/A
Specify the user name and password to use to log on to the OPC UA Server.
Data Access
Property
Predefined Diagnostic Item
Description
Tag update rate override
@DAQ_ScanRateOverrideActive
Determines the update rate for each UA server that the
FactoryTalk Linx
OPC
UA Connector uses to request a tag.
  • Use client-configured tag update rate
    By default, the
    FactoryTalk Linx
    OPC
    UA Connector will use the update rate configured in a client application to request a tag from a UA server.
  • Requested tag update rate
    Use this option to configure an update rate that the
    FactoryTalk Linx
    OPC
    UA Connector will use to request data from the UA server.
    By default, the update rate is
    0.5
    seconds. Select the appropriate update rate from the list.
Array access method
N/A
Determines how the
FactoryTalk Linx
OPC
UA Connector accesses data on the UA Server.
  • Operate on entire array at once (all elements)
    .
    By default, the
    FactoryTalk Linx
    OPC
    UA Connector will use the entire array when accessing data on the UA server. The entire array will be used each time the connector accesses data from the array.
  • Access subset of array (indexed elements)
    .
    Use this option to access data from specific array elements. UA Servers are not required to support indexing of array elements. Before using this access method, test your UA server to confirm access to the correct array elements.
    This option improves performance and is recommended for use if supported by the
    OPC
    UA Server.
Permit value writes to array elements
N/A
Selects this option to enable writing to arrays. This option works with the array access method to control writing data to the array.
When using the default array access method -
Operate on entire array at once (all elements)
- selecting this option results in writing the entire array if an element within the array changes. The array is read into memory, the elements that were modified are changed, and then the array is written back to the OPC UA server. There is a potential that the data on the OPC UA Server changed after it was read. These changes will be overwritten by the previously read data, which could lead to some data inconsistencies.
If the UA Server supports indexed arrays, selecting the
Access subset of array (indexed elements)
access method and then enabling this option results in writing only changed elements within an array. Before using this mode in a production system, test the results to confirm that the values are updating as expected.
Unsupported types
N/A
Selects
Provide string tags for unsupported types
to convert the OPC UA Connector data types that are not supported in Live Data to strings.
Monitor Item Mode
@OPC_MonitorItemTriggerMode
Selects FactoryTalk Linx OPC UA Connector the source timestamp to be delivered with each tag value it receives and passes to a FactoryTalk Live Data client when the source timestamp changes.
  • Value or Quality Only
    Send updates when the source quality or value changes but not if the timestamp is the only thing that changes.
  • Value, Quality, or Timestamp
    Send updates when the source value, quality, or timestamp change.
Alarms Settings
Property
Predefined Diagnostic Item
Description
Enable alarm and event support
N/A
Enables alarm and event support and activate the options on the properties dialog box by selecting the checkbox. By default, this setting is disabled.
Status icon
@OPC_AlarmEventProviderStatus
Shows the alarm server status.
  • Communicating
  • Stopped
  • New created
  • Disconnected
Priorities
N/A
Used to enable group alarm severities. Grouping severities by priority level helps operators filter and sort alarms more quickly and distinguish among degrees of urgency.
Select the
Enable server-assigned priorities
checkbox to override default system-wide priority settings with
FactoryTalk Linx
OPC
UA server-specific priorities.
The following are the default server-assigned priorities and their associated default severity range:
  • 751 (low) to 1000 (high): Urgent
  • 501 (low) to 750 (high): High
  • 251 (low) to 500 (high): Medium
  • 1 (low) to 250 (high): Low
Enable history
N/A
By default, this setting is disabled. When the setting is disabled, you can view the alarms, but the alarms will not be recorded.
Database definition
N/A
Used to select a database definition that receives data from the alarm server.
Tip: If you have not created a database definition, refer to
FactoryTalk Alarms and Events
Help
to create one.
Computer Name
N/A
Displays the name of the computer that contains the database.
Database name
N/A
Displays the name of the database to which the data is logged.
Cache file path
N/A
Displays the location of alarm and event data cache files. If the connection to a database is lost, alarm and event history is cached to files in this path. Once the connection to the database is restored, the information in the cache files is written to the database. Only change the default value if the location does not have enough free disk space.
The cache file location must be local to the computer hosting the alarm server so that events can be cached if the computer is temporarily disconnected from the network.
Diagnostic Logging
Property
Predefined Diagnostic Item
Description
Log diagnostic message on tag write
N/A
Enable this item to include events related to writing data to tag values in the diagnostic log.
Tag Information
Property
Predefined Diagnostic Item
Description
Last Refreshed
@OPC_NamespaceCacheLastRefreshedDateMsg
Displays the most recent date and time that the
FactoryTalk Linx
OPC
UA Connector refreshed the namespace cache of the specified
OPC
UA Server.
Refresh Tag Names
@OPC_NamespaceCacheUploadCmd
Updates all tag information sent from the
OPC
UA Server.
Analyze Tag Names
@OPC_NamespaceAnalysisCmd
Analyzes the namespace of the
OPC
UA server and saves a report of all namespace items that have unsupported data types.
The
FactoryTalk Linx
OPC
UA Connector saves the namespace on its host computer to the file
C:\ProgramData\Rockwell\OpcUaConnector\RnaUaClientDataProvider\AddressSpace\ConnectorName_ServerName_ServerEndpointURL.txt
. In the output filename, ConnectorName, ServerName, and ServerEndpointURL are replaced with the names and Endpoint URL of a
FactoryTalk Linx
OPC
UA Connector and
OPC
UA Server configured in
FactoryTalk Linx
OPC
UA Servers >
OPC
UA Servers
.
OPC Subscriptions
Property
Predefined Diagnostic Item
Description
Monitored Tags
@OPC_ItemsMonitoredQty
The number of tags in all subscriptions that
FactoryTalk Services Platform
monitors for data from the
OPC
UA Server.
Bad Quality Tags
@OPC_ItemsBadQualityQty
The number of tags with Bad quality provided by an
OPC
UA Server.
Tag Updates / Second
@OPC_ItemsUpdatedRate
The rate in tag values per second at which the
OPC
UA Server sends tag values to the
FactoryTalk Linx
OPC
UA Connector.
Requested Groups
@OPC_SubscriptionQty
The number of subscriptions to the
OPC
UA Server.
Failed Item Requests
@OPC_CommSubscriptionsFailedQty
The number of subscriptions that entered an error state for an
OPC
UA Server.
OPC Write Operations
Property
Predefined Diagnostic Item
Description
Attempted Tag Writes
@OPC_ItemsWrittenQty
The number of attempted writes to tags in an
OPC
UA Server.
Failed Tag Writes
@OPC_ItemsWrittenErrorsQty
The number of tags write errors logged by an
OPC
UA Server.
OPC Server
Property
Predefined Diagnostic Item
Description
Write with Timestamp Supported
@OPC_SessionSupportsTimestampsOnWritesStatus
Whether the
OPC
UA Server supports writing values with time stamps. Defaults to True until the server rejects writing a value with a time stamp.
Tags Detected
@OPC_NamespaceTotalTagsInServerQty
The number of
OPC
UA items in the
OPC
UA Server that have supported data types and are converted to
FactoryTalk
tags.
Node IDs Detected
@OPC_NamespaceTotalNodesInServerQty
The number of
OPC
UA items in the
OPC
UA Server.
Performance Reads/Second
@OPC_ServerPerformanceReadRate
A performance rating of an
OPC
UA Server, based on the amount of time required to read a node.
Performance Writes/Second
@OPC_ServerPerformanceWriteRate
A performance rating of an
OPC
UA Server, based on the amount of time required to write a node.
Sessions
@OPC_CommConnectionQty
The number of active sessions for an
OPC
UA Server. Increments by one when a session connection succeeds. Decrements by one when a session connection fails.
Communications Errors
@OPC_CommConnectionFailedQty
The number of communication errors reported from the
OPC
UA Server.
Longest Processing Time (msec.)
@OPCtoDAQ_LongestTimeProcessingData_mSec
The longest amount of time in milliseconds that an
OPC
UA Server spent processing data.
Alarms Detected
@OPC_AlarmTotalAlarmConditionsQty
The number of alarms detected.
Alarms Bad Quality
@OPC_AlarmFaultedAlarmConditionsQty
The number of alarms with bad quality condition.
Alarms Active
@OPC_AlarmActiveAlarmConditionsQty
The number of active alarms.
Alarms Disabled
@OPC_AlarmDisabledAlarmConditionsQty
The number of alarms disabled. Disabling an alarm prevents the operator from being notified when the alarm condition occurs.
Alarms Acknowledged
@OPC_AlarmAckedAlarmConditionsQty
The number of alarms acknowledged. Acknowledging (Ack) an alarm does not correct the condition causing the alarm-it indicates that an operator is aware of the alarm.
Alarms Suppressed
@OPC_AlarmSuppressedAlarmConditionsQty
The number of alarms suppressed. Suppress an alarm that is not needed temporarily.
Alarms Shelved
@OPC_AlarmShelvedAlarmConditionsQty
The number of alarms shelved. Shelving an alarm temporarily suppresses it.
FactoryTalk Live Data
Property
Predefined Diagnostic Item
Description
Tag Requests
@DAQ_ItemsAddedQty
The number of tags that
FactoryTalk
clients request from the
OPC
UA Server.
Failed Tag Requests
@DAQ_ItemsAddFailureQty
The number of tags that
FactoryTalk
clients request, but do not exist in the
OPC
UA Server.
Active Tags
@DAQ_ItemsActiveQty
The number of tags in the active state that
FactoryTalk
clients request from the
OPC
UA Server.
Inactive Tags
@DAQ_ItemsInactiveQty
The number of tags in the inactive state that
FactoryTalk
clients request from the
OPC
UA Server.
Tag Updates / Second
@DAQ_TagsUpdatedRate
The rate in seconds at which the OPC UA server sends updated values to Live Data tags
Server Counters
Property
Predefined Diagnostic Item
Description
Reset Counters
@DP_CounterResetCmd
Resets all resettable diagnostic counters for this
OPC
UA Server. Does not affect any other
OPC
UA Server.
Provide Feedback
Have questions or feedback about this documentation? Please submit your feedback here.
Normal