Sepasoft - MES Modules
Cirrus Link - MQTT Modules
Inductive University
Ignition Demo Project
Knowledge Base Articles
Forum
IA Support
SDK Documentation
SDK Examples
An OPC UA connection is used to communicate with an OPC UA compliant server, such as the one the OPC UA Module provides.
The following steps walk through connecting Ignition (as an OPC UA client) to a OPC UA server.
Select OPC UA Connection from the list and click Next. The Endpoint Discovery page appears.
Enter an OPC UA endpoint URL for the OPC UA server Ignition should connect to. The format should be as follows:
opc.tcp://IpAddress:Port
Ignition can connect to its own OPC UA server's endpoint by using localhost and the port. You can set the Bind Port to whatever you want, but the default is 62541. You can also use a hostname or IP Address instead of localhost:
opc.tcp://localhost:62541 opc.tcp://myhostname:62541
Once an endpoint has been entered, choose a server. Click Next: Select Endpoint. A list of available Security Policies and Message Security options will appear.
Select a Security Policy and Message Security configuration to use when connecting to the endpoint. Basic128 SecurityPolicies and SignAndEncrypt MessageSecurity are more secure than None. If available, Basic256 should be selected.
Once an endpoint configuration has been selected, click Finish.
On the New OPC UA Connection Settings page, give the connection a name. Some OPC UA servers may require a username and password, but this is not always the case. Check with the OPC UA server's documentation for more details. Credentials for Ignition's OPC UA server can be found on the OPC UA Server Settings page.
Ignition is now connected to the OPC UA server.
The following table describes all the available properties.
Main | |
|---|---|
| Name | A name used to identify this connection. |
| Description | Short description of this connection. |
| Enabled | Disable the connection to the OPC server. |
| Read-only | Puts the connection into read-only mode. All writes sent to this server will fail. |
Authentication | |
| Username | A username the connection will use when authenticating with the UA server. |
| Password Fields | The password to use when authenticating with the UA server. |
Advanced | |
| Host Override | When specified, if the endpoint address returned by the OPC server has a different IP address or hostname than the discovered endpoint, the overridden value will be used. Expects just an IP address or hostname, for example: 192.168.1.10 |
| Connect Timeout |
This feature is new in Ignition version 8.0.3
Click here to check out the other new features The timeout, in milliseconds, when opening a socket connection to a remote host. Default is 5,000. |
| Acknowledge Timeout |
This feature is new in Ignition version 8.0.3
Click here to check out the other new features The timeout, in milliseconds, to wait for an Acknowledge message in response to the client's Hello message. Default is 5,000. |
| Request Timeout | Maximum amount of time, in milliseconds, to wait for the response to a request. Default is 120,000. |
| Session Timeout | Requested session timeout value, in milliseconds. Default is 120,000. |
| Max Per Operation | Specify the maximum number of nodes to read, write, subscribe, or unsubscribe to in any given UA server request. Default is 8,192. |
| Max References Per Node | Configures the number of references per node. A "node" in this case is any item inside of a UA server, so items like tags and folders would qualify as a node, while a References is simply a reference to another node. This setting is useful in situations where the address space is completely flat, so a large number of adjacent nodes could potentially run into a maximum message size. In these cases increasing the value of this property can be useful. However, most systems will not need to change this setting. Defaults to 8,192 references. |
| Max Pending Publish Requests | The number of concurrent Publish Requests allowed to be pending at any given time. Default is 2. |
| Max Notifications Per Publish | The maximum number of notifications per publish. Default is 65,535. |
| Max Message Size | The maximum allowable size of an OPC UA application layer message. Default is 33,554,432. |
| Max Array Length | The maximum allowable size for arrays. Default is 2,147,483,647. |
| Max String Length | The maximum allowable size for strings. Default is 2,147,483,647. |
| Type Dictionary Fragment Size | The fragment size to request when reading the server's type dictionary. Default is 8,192. |
| Keep-Alive Failures Allowed | Number of consecutive failures allowed before disconnecting. Setting this to <= 0 means consecutive failures will not cause a disconnect. Default is 1. |
| Keep-Alive Interval | Interval, in milliseconds, between keep-alive requests. |
| Keep-Alive Timeout | Max duration, in milliseconds, to wait for a response to a keep-alive request. Default is 10,000. |
| Browser Origin |
This feature is new in Ignition version 8.0.5
Click here to check out the other new features The Node that browsing should originate from. Options are OBJECTS_FOLDER or ROOT_FOLDER. Most OPC UA Servers use OBJECTS_FOLDER, but some non-standard servers may require ROOT_FOLDER to browse correctly. Ignition's OPC UA Servers uses OBJECTS_FOLDER. |
Failover | |
| Failover Enabled | Enable failover on the connection, allowing the UA client to switch to a backup server in the event the primary server is unavailable. |
| Failover Threshold | The number of retry attempts before the failover connection is used. The default is 3. |
Failover Discovery URL | The discovery URL for the backup server's OPC UA server. Expects the following format: opc.tcp://hostname:port |
| Failover Endpoint URL | The endpoint of the failover server. Example: opc.tcp://192.168.1.0:62541 |
| Failover Host Override | When specified, if the endpoint address returned by the failover OPC server has a different IP address or hostname than the discovered endpoint, the overridden value will be used. Expects just an IP address or hostname. Example: 192.168.1.10 |
Key Store | |
| Keystore Alias | The alias of the certificate and private key stored in the client key store. |
| Password Fields | The password to use when authenticating with the UA server. |
The Failover properties should be used when a single Ignition Gateway needs to connect to a pair of redundant OPC UA servers. The failover OPC UA server will be used in the event the primary OPC server goes down. To enable failover, set the Failover Enabled property to true, and specify the Failover Endpoint. The Failover Threshold can be adjusted if desired. Note: Failover events are "sticky." That means once control has moved to a backup OPC UA server, it stays there until that server fails.
Related Topics ...
