IBH OPC UA:Installation on Windows

From IBHsoftec Wiki English
Revision as of 12:09, 14 August 2026 by Axel (talk | contribs) (Created dedicated Windows installation guide)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

The IBH OPC UA Server/Client is installed as a 64-bit Windows application. The setup configures the automatically started ibhopcua Windows service, the tray application and the Web Configurator.

Workflow at a glance

  1. Download the current 64-bit setup.
  2. Run the setup with administrative privileges.
  3. Verify the Windows service and tray application.
  4. Open the Web Configurator and change the default password.
  5. Activate the license online or offline.
  6. Configure and test the OPC UA endpoint and controller connections.

Requirements

  • Approved 64-bit Windows system; Windows 10 or Windows 11 is recommended for new installations
  • Local administrative privileges for installation
  • Static IP address or resolvable hostname recommended
  • Network access to the configured controllers
  • DNS resolution and HTTPS access to the license server for online activation
  • Required TCP ports available or configured

Before updating an existing installation, create a configuration backup and close the tray application.

Download

Download the current 64-bit setup from the official site:

Use only an installer from a trusted source and verify the IBHsoftec digital signature if required.

Installation

  1. Sign in with an account permitted to install software.
  2. Right-click the setup file and select Run as administrator.
  3. Verify the publisher and confirm the Windows security prompt.
  4. Follow the installation wizard.
  5. Keep the proposed installation folder unless your system policy requires another location.
  6. Complete the installation and restart Windows if requested.

The default folder is: 

C:\Program Files\IBH OPC UA Server-Client

The setup installs the ibhopcua service, IBHOpcUATray.exe, the server/client runtime, the Web Configurator and Start menu entries.

Check the service and tray

Open services.msc. The IBH OPC UA Server-Client service, internally named ibhopcua, should be present and start automatically.

Administrative PowerShell commands: 

Get-Service ibhopcua
Start-Service ibhopcua
Restart-Service ibhopcua
Starting the IBH OPC UA Server/Client. The appearance may vary.

The tray application provides access to start, stop, the Web Configurator and diagnostics. If the icon is missing, start IBH OPC UA Server-Client from the Windows Start menu.

Starting the tray application from the Start menu.

Open the Web Configurator

Open it from the tray menu or use: 

http://localhost:48080

From another computer: 

http://IP-ADDRESS-OR-HOSTNAME:48080

For an unchanged initial installation:

User name Password
admin admin

Change the default password immediately after the first login.

Network and firewall

Function Default TCP port Notes
Windows Web Configurator 48080 Allow only from required administration networks
OPC UA Server 48010 Endpoint for OPC UA clients
HTTPS web access according to configuration Allow only when HTTPS is configured

MQTT, the integrated OPC UA Client and online activation may require additional outgoing connections.

License activation

The former hardware-ID, email, serial-number and PIN workflow is no longer current.

Online activation

  1. Open System / Licensing.
  2. Enter the license serial number.
  3. Enter the associated eight-digit secret.
  4. Start activation and verify the license status.

Offline activation

  1. Generate and download ibhlinkua-license-request.json.
  2. Process the request using the designated licensing workflow on a computer with Internet access.
  3. Upload the signed JSON license file.
  4. Verify the license status.

The license is bound to the Windows computer. See Licensing.

OPC UA connection test

opc.tcp://IP-ADDRESS-OR-HOSTNAME:48010

Add the endpoint to an OPC UA client, verify the server certificate, select the matching security policy and authentication, browse the address space and read a test variable. Write only to variables explicitly intended for testing.

Update

  1. Back up the configuration.
  2. Download the current 64-bit setup.
  3. Run it as administrator over the existing installation.
  4. Restart Windows if requested.
  5. Verify the service, license, certificates, projects and controller connections.

Perform a downgrade only after consulting IBHsoftec Support.

Uninstallation

Open Settings / Apps / Installed apps, select IBH OPC UA Server-Client and start uninstallation. Back up configuration, certificates and licensing information before removing remaining data.

Troubleshooting

Setup does not start
Check administrative privileges, digital signature, Windows version, antivirus software and system policies.
Service does not start
Check services.msc, Windows Event Viewer and port conflicts.
Tray icon is missing
Start the tray application from the Start menu and check hidden taskbar icons.
Web Configurator cannot be reached
Check the service, TCP port 48080, local URL and Windows Firewall.
OPC UA client cannot connect
Check endpoint, port 48010, system time, certificates, security policy and user authentication.
Online activation fails
Check Internet access, DNS, proxy, firewall, system time, serial number and the eight-digit secret.

Next steps

Retrieved from "https://wiki.ibhsoftec.com/en/index.php?title=IBH_OPC_UA:Installation_on_Windows&oldid=2367"