Configure An Opc Ua Data Source - GE Mini Field Agent User Manual

6.2.3.1

Configure an OPC UA Data Source

The steps to configure the OPC UA Machine Adapter are:
1. Open the file com.ge.dspmicro.machineadapter.opcua-0.config for editing.
2. Edit line 52 to specify the path to the OPC UA configuration XML file, which by default will be:
•
com.ge.dspmicro.machineadapter.opcua.configFile="configuration/machine/com.ge.dspmicro.machine
adapter. opcua-0.xml"
3. If the OPC UA Server you are connecting to uses authentication or encryption, edit line 68 to specify the appropriate
Security Mode. If a username and password is used for authentication, edit lines 118 and 121 respectively. The
plaintext password will be encrypted, removed from line 121, and added to line 124 in its encrypted form. If certificates
are used for authentication, they must be installed into security/machinegateway_truststore.jks as part of the
configuration package's install/install.sh script.
4. Save and close com.ge.dspmicro.machineadapter.opcua-0.config.
5. Open the file com.ge.dspmicro.machineadapter.opcua-0.xml for editing.
6. Edit the ServerUri and AppUri XML elements to configure the IP address and port number of the OPC UA server:
•
For MFA, edit the ServerUri and AppUri XML elements to replace localhost with the IP address of the OPC
UA server, and replace port 4841 with the port of the OPC UA server.
•
For EFA on CPE400, the ServerUri and AppUri XML elements default to using localControllerHost and port
4840 for connecting to the OPC UA server through an internal interface. localControllerHost is a hostname
assigned to the internal virtual NIC to communicate with the controller.
•
For EFA on UCSC, edit the ServerUri and AppUri XML elements to replace replace localControllerHost with
the IP address of the OPC UA server, and replace port 4840 with the port of the OPC UA server.
7. Edit the data contained within the DataNodeConfigs and DataSubscriptionConfigs elements to specify the following:
•
Each DataNode element represents an OPC UA variable. Configure only the variables to be collected.
•
•
•
Each DataSubscriptionConfig represents a group of OPC UA variables to be read and published to the Predix
Cloud at a given interval.
•
•
•
•
•
8. Save and close com.ge.dspmicro.machineadapter.opcua-0.xml
Note Additional information on configuring the OPC UA Machine Adapter, including settings for each configuration item,
can be found by searching for "OPC-UA Machine Adapter" in https://docs.predix.io.
For public disclosure
The StringId element contains the variable name as exposed in the OPC UA server with the
namespace index number before the colon and the variable name after the colon.
The Name element contains the tag name as it will appear in the Predix Cloud. The name should
be unique amongst all of the variables from any Field Agent that will be going to this same Time
Series Database.
The Name element represents the name of the subscription, which is used in the section
Sending Data to the Predix
The PublishingInterval is the rate in milliseconds at which the subscription is set up for getting
data from the OPC UA Server. The OPC UA Server will send data at this rate, assuming that the
value of the variables has changed since the last publishing interval. Whenever changed data is
received in Predix Machine, it will immediately be forwarded on to the Predix Cloud, given that
the data is configured to go to the cloud and a DataChangeFilter does not restrict it.
The TimestampOrigin specifies which time stamp is preferred for the data. The possible values are:
Source: Prefer the time stamp from the data source. If the time stamp from the data source is
o
not available, the OPC UA Server time stamp will be used instead.
Server: Prefer the time stamp from the OPC UA Server. If the time stamp from the OPC UA
o
Server is not available, the data source time stamp will be used instead.
Adapter: Prefer the time stamp from the Field Agent. Source and Server fall back to using
o
the Field Agent time if both data source and OPC UA Server time stamps are unavailable.
All time stamps made by the OPC UA Machine Adapter will be in UTC (Coordinated
Universal Time).
Each DataNode element corresponds to a DataNode defined in the DataNodeConfigs element.
A DataChangeFilter can be optionally applied to each DataNode or to the DataSubscriptionConfig
as a whole to specify the conditions under which each OPC UA variable is recognized as changed
and sent on.
Cloud.
Configure
GFK-2993F 78