.NET Based OPC UA Client/Server SDK  3.0.3.458
Troubleshooting

Using Wireshark to Analyze OPC UA Binary Protocol

This section describes how to use Wireshark for OPC UA protocol analyzing.

First you need to install Wireshark. The source code as well as binary installers for Windows and Mac OS X are available at http://www.wireshark.org/download.html.

How to Use Wireshark

To use Wireshark, follow these steps:

  • install Wireshark and follow the on-screen instructions
  • start Wireshark
  • configure the Protocol Preferences (add Ports you want to capture)
  • select your network card
  • configure the Capture Filter
  • start capturing

If you now start your OPC UA Server and connect with your Client, you will capture all service calls on the network. After performing the actions you want to capture, stop the Wireshark capturing. You can now set “Display Filters” to reduce the view and all the captured information.

Example

First set the OPC UA ports you want to capture by setting the Wireshark Preferences. Choose “Edit” → “Preferences” from the menu. Select “Protocols” from the tree and scroll down to OpcUa. Enter all the ports you need separated by a comma (see screenshot) and confirm with “Apply”.

wireshark1.png
Set Port Numbers

Click on “Capture Options” in the main window.

wireshark5.png
Capture Options

If necessary, select the network interface for capturing.

To reduce the amount of data collected, set a capture filter to “tcp” or a specific port, e.g. “tcp port 4841” (see screenshot), and start capturing by clicking on “Start”. Then perform the actions you want to capture.

wireshark2.png
Set Capture Filter

The result is displayed in the main window having three horizontal sections. The first upper section shows the individual telegram including timestamp and direction (source to destination). To show only OPC UA related packages, enter “opcua” at “Filter”. On selecting a certain message its content is expanded in the window below. In the example you can see a response sent from the server to the client that was returned on a call of the Browse Service. The content of all objects can be decoded. In addition, the lowest window pane shows the hexadecimal view for the selected item.

wireshark3.png
Decoded Browse Response

Wireshark Issue: Lots of Checksum Errors due to TCP Checksum Offloading

When using a newer network interface card, you may notice a lot of checksum errors while capturing (see the following screenshot) caused by TCP checksum offloading (see the Wireshark wiki for more information).

wireshark-tcpoffloading-error.png
TCP Offloading Error

To suppress these errors, you have to disable TCP checksum validation. Choose “Edit” → “Preferences” from the menu, select “Protocols” → “TCP” from the tree and uncheck the box at “Validate the TCP checksum if possible” (see screenshot).

wireshark-tcpoffloading-config.png
Disable TCP Checksum Validation

Using the Trace Functionality

The SDK comes with a built-in tracing mechanism. See Trace for more information and Trace Settings and Trace Levels in the section Configuration Schema for configuration options.

License Issues

If the .NET OPC UA application cannot be licensed as described in Licensing the SDK, check the following steps:

Do You Use the Correct Assemblies?

Check the Product Version of UnifiedAutomation.UaBase.dll in the “bin” folder of your application. If the Product Version contains the string “_EVAL”, then you are not using the correct assemblies. Use the Release Version of the assemblies instead.

Do You Use the Correct License File?

Check if the license file used in your application is binary equal to the license file you retrieved from your download share (WebDAV or ftp).

Do You Invoke the Commands in the Correct Order?

ApplicationLicenseManager.AddProcessLicenses must be called before ApplicationInstance.Start is called.

Do You Use the Correct License Type?

If the OPC UA application is a server application, you need a UaSdkNetBundle license.