OPC UA Server Advanced Settings

In most circumstances, you will not need to modify any of the advanced UA server settings. Anyhow, if you do need to change or tweak some of these, they can be modified directly in the UAServer sub-key of the Windows registry key of the Hive instance.

The set of advanced UA server settings are described in the following table:

NameDescriptionDefault valueRequire restart to apply
EnabledNot in use, will be removed in a future Apis version0 (false)Yes
Enable_DownSamplingIf enabled, VQTs with timestamp delta less than the sampling interval is dropped0 (false)Yes
EngineeringUnits_UnitAttributeFallbackIf enabled, use proprietary EUInformation when proper EUInfo is unavailable0 (false)Yes
FixupLeaf2SourceIf enabled, use legacy mapping from eventsource to OPCUA NodeId 10 (false)Yes
ForceAllowHistoryWriteIf enabled, allow HistoryWrite on any node 20 (false)No
Limits_JobWorkersNot in use, will be removed in a future Apis version0 (false)Yes
Limits_MaxArrayLenSpecifies max items per Publish response0x1000000Yes
Limits_MaxEventQueueSpecifies max queuesize on event subscriptions0x100000Yes
Limits_MaxHistoryRead_EventsSpecifies max number of events per HistoryRead0x2000Yes
Limits_MaxHistoryRead_VQTSSpecifies max number of VQTs per HistoryRead0x10000Yes
Limits_MaxJobsNot in use, will be removed in a future Apis version0x100Yes
Limits_MaxSamplingFuzzFuzzy deltatime limit when downsampling is enabled, in milliseconds0x10Yes
Limits_MaxSubscriptionLifetimeMax lifetime of inactive subscriptions, in seconds60No
Limits_MaxSubscriptionsPerSessionMax number of subscriptions per session 30Yes
Limits_MinSamplingIntervalMin samplinginterval accepted by the server, in milliseconds10Yes
MaxThreadsPerCoreMax number of threads per core for parallelized HistoryRead processing8Yes
NS2Static URI to use for namespace 2 (Apis Hive canonical namespace)Yes
NsTableStatic initial set of semicolon-separated URIs in the servers namespace tableYes
Parallel_ClientSamplers_ThresholdControl if/when to parallelize Event broker commands 41000No
Persist_NsTableIf enabled, the active namespace table is saved into NsTable at shutdown0Yes
PKI_*Settings related to security/use of certificate 5
RedundancySupportThe type of redundancy reported by the OPCUA server 60Yes
RootNot in use, will be removed in a future Apis versionYes
Stack_RPC_TimeoutThe number of milliseconds the OPCUA server will wait for complete RPC messages60000No
UseExternalEventIdIf enabled, use the ExtEventId field as the real eventid 7Yes
1

Prior to ApisHive v10.0.2, the ApisHive OPCUA server would report the sourcenode of an event as a parent of the actual eventsource. This was done when the actual eventsource was an item in an ApisSemantics module monitored by an ApisAlarmArea module. This was done to "help" OPCUA clients to understand that the event logically belonged to the information-model exposed by the Semantics module. This behavior is usually not really wanted, so the new default since Apis v10.0.2 is to use the actual eventsource when events are reported over OPCUA.

2

When set to 1, the HistoryWrite AccessLevelType on the target node is ignored

3

When set to 0, use the default limit in the Apis OPCUA Server SDK, which is 1024 as of Apis 9.16

4

The Event Broker commands UaServerSampleMonitoredItems and UaServerUpdateMonitoredItems_DataPush will be executed in parallel when the number of active OPCUA subscriptions passes this limit

5

Use Certificate Management in Apis Management Studio to configure these settings

6

Use the Property Editor in Apis Management Studio on your Apis Hive instance to configure these settings

7

When this is enabled and ApisHive receives events from external OPCUA servers, these events will be reported to OPCUA clients using the eventid from the source system. Before Apis v10, this was always the case, but since Apis v10 this behaviour must be explicitly activated. Therefore, if upgrading from Apis v9 to Apis v10, this setting must be enabled after installation and before starting ApisHive instances, if the lecacy behaviour is required.