[opcuasrv]

Settings for the OPC UA server

[opcuasrv] certificateStore

Type
string
Path to the directory in which the Public Key Infrastructure directory is located. By default the location of the PKI directory is in <WinCC OA VersionDirectory>/data/opcua/server. This config entry allows the changing the path to the PKI directory.

[opcuasrv] checkApplicationUri

Type
bool
Default
1
Range
0|1
Specifies if the server verifies if the application URI, which is sent by the client during connection establishment, is matching with the application URI in the client certificate. If the verification fails no secured communication is possible.

[opcuasrv] cnsShowSystemNameForLocalViews

Type
bool
Default
0
Range
0|1
Determines if the local system name is used in the OPC address space. This entry is only valid for server configuration using CNS View.

[opcuasrv] cnsShowViewInPI

Type
bool
Default
1
Range
0|1
Determines if the CNS View name is used in the OPC address space. This entry is only valid for server configuration using CNS View. If this entry is set to 0 and the server uses more than one view of a system, item name conflicts might appear.

[opcuasrv] conditionSuffix

Type
string
Default
_@condition
Sets the condition suffix.

[opcuasrv] disableSecurity

Type
bool
Default
0
Range
0|1
Specifies whether the server accepts the security policy "None". 1 = yes; 0 = no.

[opcuasrv] discoveryServer

Type
string
URL of a Discovery Server the OPC UA server should register to. This entry can be set multiple times, if the server should register to more than one Discovery Server.

[opcuasrv] enableAnonymous

Type
bool
Default
0
Range
0|1
Specifies whether the user/password check is disabled. 1 = yes; 0 = no. For detailed information see chapter User Authentication.

[opcuasrv] externalAckPrefix

Type
string uint
Default
-
Range
<alertclass prefix> <driver number>
The config entry enables the OPC UA server to acknowledge external alerts. Therefore the config entry must be set using the alertclass prefix of the external alerts and the driver number which defines the driver that shall acknowledge the alerts. The config entry can be specified multiple times. Example: externalAckPrefix = "BAC" 1 All alerts with an alertclass that begin with "BAC" are acknowledged by the _Driver1 DP.

[opcuasrv] historyNumValuesPerNode

Type
uint
Default
10000
Range
>= 0
Maximum number of values in a readRaw result for a single node. A value of 0 indicates that no limitation is used.

[opcuasrv] maxSessionTimeout

Type
int
Default
60000
Range
>= 0
Sets the maximum session time-out (in milliseconds). A value of 0 sets that the limit will not be considered.

[opcuasrv] maxVcMessageSize

Type
unsigned integer
Default
200
Range
>= 0
Defines how many value changes a VC (value change) message, which is sent by the UA server to the Event, may maximal contain.

[opcuasrv] nodeIdType

Type
bool
Default
0
Range
0|1
Specifies whether the sever uses the datapoint name or the alias as NodeId:
  • 0 -> DP name
  • 1 -> DP alias

[opcuasrv] notifierSuffix

Type
string
Default
_@notifier
Sets the notifier suffix.

[opcuasrv] numberOfClients

Type
uint
Default
0
Range
>=0
Specifies the maximal number of clients which are allowed to connect the server. The value 0 means that theoretically endless many clients can connect the server.

[opcuasrv] opcuaAlarmGroup

Type
string
Default
OPCUAAlarm
Range
<Alarm DP Group Alias>
Defines the data point group that is used for the OPC UA servers alarm data. The group alias must be used. Every OPC UA server can use a separate data point group. Note: If a data point group is generated for the OPC UA server, it is necessary to specify an alias for the generated group!

[opcuasrv] opcuaHAReadGroup

Type
string
Default
OPCUAHARead
Range
<Historical Access DPGroup Alias>
Defines the data point group that is used for the OPC UA servers historical data. The group alias must be used. Every OPC UA server can use a separate data point group. Note If a data point group is generated for the OPC UA server, it is necessary to specify an alias for the generated group.

[opcuasrv] opcuaReadGroup

Type
string
Default
OPCUARead
Range
<Read DP Group Alias>
Defines the data point group that is used for the OPC UA servers read data. The group alias must be used. Every OPC UA server can use a separate data point group. Note: If a data point group is generated for the OPC UA server, it is necessary to specify an alias for the generated group!

[opcuasrv] opcuaWriteGroup

Type
string
Default
OPCUAWrite
Range
<Write DP Group Alias>
Defines the data point group that is used for the OPC UA servers write data. The group alias must be used. Every OPC UA server can use a separate data point group. Note: If a data point group is generated for the OPC UA server, it is necessary to specify an alias for the generated group!

[opcuasrv] pollCount

Type
unsigned integer
Default
32
Range
>0

Defines the number of data points that can be polled at once. If several polling requests are queued they will be processed in the next driver cycle.

[opcuasrv] pvRangeCheck

Type
bool
Default
0
Range
0|1
By default (0) the OPC UA server will not check values of write requests for range violation. If this is required set the entry to 1, then the OPC UA Server will load all _pv_range configs of the linked DPEs and use the configured values for range checking of client write requests. If the values of the _pv_range configs are changed, the OPC UA Server must be restarted!

[opcuasrv] reduServerDiscoveryUrl

Type
string
This entry is needed if the redundant server shall be added to the list of servers, which can be discovered via the server discovery URL. This allows a client to determine the URL of the redundant server automatically. If this entry is empty the redundant server is not added to this list.

[opcuasrv] reduServerInstanceName

Type
string
Allows to configure the server name of the redundant UA server if the server is operating in Hot redundancy mode. In the default case the redundant server name is automatically determined using project settings if possible.

[opcuasrv] reduServerInstanceUri

Type
string
Allows to configure the server URI, which is inserted in the ServerUriArray of the ServerRedundancy object in the case the UA server is operating in Hot redundancy mode. In the default case the redundant server URI is automatically determined using project settings if possible.

[opcuasrv] rootNode

Type
string
Allows to specify the root node of the OPCUA server. Per default no root node is defined and therefore not displayed in the address space.

[opcuasrv] sendCertificateChain

Type
bool
Default
1
Range
0|1
Specifies if the server shall send the whole certificate chain to the client. This option allows to deactiate the sending of the chain if a client cannot handle certificate chain properly.

[opcuasrv] server

Type
string
Default
OPCUAPvssServer
Specifies the server name for the internal datapoint (without leading "_").

[opcuasrv] serverBuildDate

Type
string
Default
<AutoGeneratedBuildDate>
Defines the build date in ISO 8601 format, e.g. "2020-03-16T09:41:27.179Z". This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] serverBuildNumber

Type
string
Default
<AutoGeneratedBuildNumber>
Defines the build version. This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] serverCertificate

Type
string
Default
PVSS_UA_server.der bzw. ab Version 3.11: WinCC_OA_UA_Server.der
Certificate which the server should use for its identification.

[opcuasrv] serverInstanceName

Type
string
With the aid of this entry you can set an arbitrary Server name if you do not like the automatically generated name.

[opcuasrv] serverInstancePrefix

Type
string
Default
WinCC_OA
Defines the prefix for the Server URI and for the name.

[opcuasrv] serverInstanceURI

Type
string
With the aid of this entry you can set an arbitrary Server URI if you do not like the automatically generated URI.

[opcuasrv] serverManufacturerName

Type
string
Default
ETM professional control GmbH - a Siemens company
Defines the product name. This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] serverProductName

Type
string
Default
WinCC OA OPC UA Server
Defines the product name. This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] serverProductUri

Type
string
Default
http://www.etm.at/WinCC_OA
Defines the product URI. This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] serverSoftwareVersion

Type
string
Default
<WinCC OA version>
Defines the software version. This information can be found within the OPC UA node "Server.ServerStatus.BuildInfo".

[opcuasrv] showDescriptions

Type
int
Default
1
Range
0..2
Defines for which instances in the address space the descriptions are to be set.
  • 0 - the server does not set any descriptions
  • 1 - the server sets the descriptions for DPE leaf elements (Variables) (default)
  • 2 - the server sets the descriptions for DPE leaf elements (Variables) as well as for DPE structure nodes (Folders)

[opcuasrv] showDPTs

Type
bool
Default
1
Range
0|1
Allows to define if data point types are mapped to the address space (value 1) or not (value 0).

[opcuasrv] sourceSuffix

Type
string
Default
_@source
Sets the source suffix.

[opcuasrv] tcpServerPort

Type
uint
Default
4840
Range
>=0
Port number of the TCP server. This config entry defines the server port, which can be opened by the OPC UA server.

[opcuasrv] timestampWriteMode

Type
int
Default
0
Range
0..2
Defines which timestamp the OPC UA server should use for received write requests.
  • 0 - the server uses its local time for writing values received from the client (default)
  • 1 - the server uses the "source timestamp" received from the client
  • 2 - the server uses the "server timestamp" received from the client
Please note that:
  • If mode 1 or 2 is selected, the server will accept write requests with set source timestamp and/or server timestamp.
  • If mode 1 or 2 is selected and the wanted timestamp is not received, the local time is used (behavior like option 0).

[opcuasrv] uaBadAttributes

Type
string
Default
_out_prange,_out_range,_exp_inv,_aut_inv,_stime_inv
Range
<attribute1>,<attribute2>,...,<attributeX>
Allows to define which attributes can raise a BAD status on the OPC UA server.

[opcuasrv] uaFloatingPointType

Type
bool
Default
0
Range
0|1
The config entry defines the format of ALL "float" DPEs in the address space with the OPC UA data type "Float". Possible values are::
  • 0 - Double (64bit Double Precision) - Default
  • 1 - Float (32bit Single Precision)
Please note that:
  • The OPC UA data type for "float" DPEs can only be defined globally and NOT individually for each single "float" DPE.
  • When converting comma spearated values stored on DPEs as 64bit (double precisoon) format to the OPC UA data type "Float" a loss of precsison might occur.
  • If the stored value of a 64bit floating point number on the "float" DPE exceeds the maximum or minimum value range of the OPC UA data type "Float" (+/- 3.4*1038), the value within the address space is set to "+/- Infinite".

[opcuasrv] uaMaxDataQueueSize

Type
int
Default
100
Range
>= 1
Sets the maximum queue size, which is accepted by the server for monitored items.

[opcuasrv] uaMaxRetransmissionQueueSize

Type
int
Default
20
Range
>= 1
Sets the maximum number of messages in the republish queue the server allows per subscription.

[opcuasrv] uaSecurityMode

Type
int
Range
1|2
Defines the security mode. 1 - the lowest security mode accepted is "Sign" 2 - the lowest security mode accepted is "Sign and Encrypt" Note: If the config entry uaSecurityPolice is set to 0 (= none) this config entry is ignored.

[opcuasrv] uaSecurityPolicy

Type
int
Default
3
Range
0..5
Defines the security policy. 0 - the lowest security policy accepted is "None" 1 - the lowest security policy accepted is "BasicRsa15" 2 - the lowest security policy accepted is "Basic256" 3 - the lowest security policy accepted is "Basic256Sha256" 4 - the lowest security policy accepted is "Aes128Sha256RsaOaep" 5 - the lowest security policy accepted is "Aes256Sha256RsaPss"

[opcuasrv] uaUncertainAttributes

Type
string
Range
<attribute1>,<attribute2>,...,<attributeX>
Allows to define which attributes can raise an UNCERTAIN status on the OPC UA server.

[opcuasrv] useClientUser

Type
bool
Default
0
Range
0|1
Allows to define if value changes and alarm acknowledgements are done unter the user the clients uses for connecting or under the user the server is running.

[opcuasrv] useOnlineValueForConnect

Type
bool
Default
1
Range
0|1
By default (1) the OPC UA server transfers "online" values to the connected client. If it is required to transfer "original" values to the client, set this entry to 0. However in this case default values are not taken into account.