GFK-2993F 78
For public disclosure
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.
•
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.
•
Each
DataSubscriptionConfig
represents a group of OPC UA variables to be read and published to the Predix
Cloud at a given interval.
•
The
Name
element represents the name of the subscription, which is used in the section
Configure
Sending Data to the Predix Cloud
.
•
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:
o
Source
: Prefer the time stamp from the data source. If the time stamp from the data source is
not available, the OPC UA Server time stamp will be used instead.
o
Server
: Prefer the time stamp from the OPC UA Server. If the time stamp from the OPC UA
Server is not available, the data source time stamp will be used instead.
o
Adapter
: Prefer the time stamp from the Field Agent. Source and Server fall back to using
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.
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
.
Summary of Contents for Embedded Field Agent
Page 1: ...GFK 2993F Field Agents User Guide July 2017 For public disclosure ...
Page 31: ...GFK 2993F 31 For public disclosure Notes ...
Page 50: ...GFK 2993F 50 For public disclosure 2 Verify that the Field Agent Updater page displays ...
Page 60: ...GFK 2993F 60 For public disclosure 5 10 1 4 1 Using Certificate Enrollment ...
Page 62: ...GFK 2993F 62 For public disclosure 5 10 1 4 2 Using OAuth Authentication Code Enrollment ...
Page 65: ...GFK 2993F 65 For public disclosure Notes ...
Page 67: ...GFK 2993F 67 For public disclosure ...
Page 86: ...GFK 2993F 86 For public disclosure Notes ...
Page 87: ...For public disclosure ...
