IMDTouchKnowledge BaseShop main store

How-to

Activating a WebIQ Designer trial license for project conversion

HMI and touchscreens Published 6 min read

Short answer

WebIQ Designer never runs without a license, and a successful connection to 127.0.0.1:17123 proves neither login rights nor license state. Request a trial license — a shorter one through the vendor's license store or a 30-day one through its trial sign-up — activate it for the environment you connect to, and convert the v2.16.3 project on a working copy in Designer v2.17.

On this page
  1. What the connection to 127.0.0.1:17123 proves
  2. Request the trial before the bench work starts
  3. Activate the entitlement for the target environment
  4. If login still fails with the license active
  5. Convert the v2.16.3 project on a working copy
  6. Timing a v2.16.3 to v2.17 conversion inside a 10-day trial
  7. Questions asked

You cannot convert a WebIQ project on an unlicensed Designer: the tool requires a license for every session, and no unlicensed editing mode exists. The documented path is a trial entitlement — a shorter one through the vendor's license store, or 30 days through the vendor's trial sign-up. Your connection to the ctrlX Virtual endpoint at 127.0.0.1:17123 has already cleared the first of three independent checks; the rejected login and the missing license are the other two. This article walks the reported case — a v2.16.3 HMI project inside Base_Template_Handling-v2.6.4, opened in portable Designer v2.17 on ctrlX Virtual v2.6 — from license request through activation, login and conversion, and shows how to time the work to the trial window.

What the connection to 127.0.0.1:17123 proves #

In the reported case the portable Designer v2.17 connects to the ctrlX Virtual endpoint at 127.0.0.1:17123, and login with the username set in Runtime Manager is rejected. Read that as three separate gates rather than one fault: the endpoint address decides where the Designer connects, authentication decides which account the application accepts, and licensing decides which functions are authorized at all. The gates fail independently, so a responding endpoint proves the transport and nothing more.

Observation in the reported case What it proves What it does not prove
Connection to 127.0.0.1:17123 succeeds The ctrlX Virtual endpoint answers and speaks the protocol the Designer expects Nothing about the account or the license
Login with the Runtime Manager username is rejected The session never reached an authenticated state Whether the cause is the credential pair, the account's rights or the absent license
No Designer entitlement is installed Project conversion is not authorized That licensing is the only gate still blocking

Record the complete login rejection message before changing any configuration. The checkpoint to pass here is a responding endpoint with the failure located at login: if the message points at licensing, go straight to the trial entitlement, and if it points at the account, work the credentials once the license is active.

Request the trial before the bench work starts #

Designer use always requires a license: running in a virtual environment does not remove the requirement, and a portable Designer install does not create an unlicensed path. Two documented request paths exist. The answer documented for this exact scenario points to the vendor's license store and its shorter trial. The vendor's trial page advertises a free 30-day Designer trial, and beginning with WebIQ 2.11 that trial replaced the discontinued free but limited edition, so older guides describing a free Designer no longer match what you can download.

A trial is a time-boxed entitlement, not a feature-limited product; what separates paid software from free builds once the window closes is compared in paid vs free SCADA software: what actually differs. Whichever path you take, request the entitlement on the day the bench work starts, because the window spends itself on calendar days from activation, weekends included.

Activate the entitlement for the target environment #

Installing the Designer and licensing it are different operations: an installed editor with no active entitlement still cannot open the project. The documented activation flow runs as follows.

  1. Start the Designer from its shortcut and sign in; the page for requesting license activation opens.
  2. Request the trial entitlement, the shorter trial through the vendor's license store or the 30-day trial through the vendor's trial sign-up.
  3. In the license portal, click Organization in the main menu and open the Licenses tab.
  4. Click Activate License, enter the license code and click Next.
  5. Associate the entitlement with the identification the workflow requests for the environment you will connect to; a license bound to a different environment does not authorize this setup.
  6. Restart WebIQ after the license change, then read the license status on the ctrlX CORE to confirm the entitlement is active and to note its expiry date.

The checkpoint to pass is an active Designer entitlement for the environment being accessed, inside its validity window. Having requested a trial is not the same as having completed activation.

If login still fails with the license active #

The license clears the authorization gate, not the account gate. Reconnect to 127.0.0.1:17123 and retry the login, then check in this order: that the endpoint belongs to the intended ctrlX Virtual instance, especially when several local test environments share one host; that the complete credential pair matches the account configured in Runtime Manager, not only the copied username; and that the account carries the access rights a Designer session needs. A matching username alone verifies neither the password nor the permissions. If the rejection persists with an active entitlement, read the application diagnostics and the exact rejection text before changing accounts or reinstalling anything; the message identifies which of the three gates is blocking.

Convert the v2.16.3 project on a working copy #

Keep three version numbers straight before opening anything: Base_Template_Handling-v2.6.4 is the template revision, ctrlX Virtual v2.6 is the controller environment, and WebIQ v2.16.3 is the version the HMI project inside the template was authored with. The template and controller numbers are not WebIQ versions, and Designer v2.17 being newer than the project is exactly why the editor converts on open.

Work on a copy. Preserve the unchanged original so a failed conversion can be retried against the earlier environment, record the runtime version of the target, and open the copied project in Designer v2.17. Let the editor run its conversion prompts, resolve what the messages report, and save the converted result under a new name; then close and reopen the saved copy to prove it loads. Run the converted project against the target runtime and compare a displayed value with the controller value before trusting any write command, because an unproven HMI screen that writes to live outputs can move a real machine.

Timing a v2.16.3 to v2.17 conversion inside a 10-day trial #

Inputs, each with its source: 10 days of trial on the license store path, the length documented for this exact scenario; 30 days on the vendor's trial sign-up, the length that replaced the free edition beginning with WebIQ 2.11; one conversion pass, because the v2.16.3 project loads once into Designer v2.17 and converts on open; and a window that starts on activation day, because the entitlement counts calendar days from that moment.

The rule in words: a trial authorizes every Designer session inside its window and none after it, so the plan holds only if the days from activation to finished proving fit inside the window with margin.

Arithmetic: the store path expires on activation day plus its documented length, giving 10 usable calendar days in total; the sign-up path expires on activation day plus 30 days, and 30 - 10 = 20 more days than the store path.

Result: on the store trial you have the full 10-day window from activation to connect, convert the v2.16.3 project and prove it on the ctrlX Virtual runtime; on the 30-day sign-up trial you have 30 days.

Decision: for a single conversion pass with runtime proving, the shorter store path is enough when the whole job fits the window from activation. Take the 30-day sign-up trial when you need the 20 extra days, and buy the Designer license before activating anything when even 30 is not enough — an expired trial authorizes no session at all, and an entitlement that runs out mid-commissioning stops the editor with the project half-proven.

Questions asked

What happened to the free version of WebIQ Designer?

Beginning with WebIQ 2.11, the free but limited edition was discontinued and replaced with a 30-day trial license. Guides that describe installing a free Designer no longer match current downloads: expect to request a time-limited trial entitlement instead, and expect the countdown to start on the day you activate it, not the day you install the editor.

Can a WebIQ trial license be activated on an SD card?

No. The store listing for the ARM variant states that trial licenses are intended for online devices only and cannot be activated on an SD card. An offline bench built on removable storage will not take the trial, so run the trial conversion on a network-connected target such as the virtual controller.

Does the trial license also cover the WebIQ runtime on a panel?

The Designer entitlement covers the editing tool. The runtime on the target device is activated separately: on a WebIQ panel you open the License Activation tab, enter the license key and tap Confirm before the project serves pages. If the trial conversion is meant to end on a running panel, budget for that second entitlement.

Why does a freshly activated trial report as expired?

Treat the device clock as the first suspect. The trial counts calendar days from activation, so a wrong date on the target can consume the window before any work starts. Correct the date and time, restart WebIQ so the license check runs again, then read the license status before drawing any conclusion about the entitlement itself.

Keep reading

  • Selection guide

    Choosing Web-Based HMI and SCADA Architecture for Production Lines

    Run one web HMI/SCADA server per production line, so a server outage costs one line its screens instead of the whole plant. Add a central server only after writing down the outage cost per hour and the redundancy that cost justifies, and keep office viewers on status-only roles enforced at the tag write.

    HMI and touchscreens

  • Troubleshooting

    Fixing WinCC C Script Memory Growth From String Buffers

    Yes - writing a database field through a pointer aimed at a string literal is undefined behavior and a buffer overrun into 10 bytes of read-only storage, and it is not the leak. Days of script.exe growth come from database objects acquired per call and never released. Fix both: pass a caller-owned buffer with its capacity, copy at most bufferSize - 1 bytes, terminate explicitly, and release every acquired object on every exit path.

    HMI and touchscreens

  • Troubleshooting

    Fix the libQt5WebEngine.so.5 error when an HMI editor will not start

    The message means the dynamic loader cannot resolve one shared library the editor binary needs, so startup fails before any editor code runs. Run a dependency report on the exact failing binary, install your distribution's Qt 5 WebEngine runtime package that provides libQt5WebEngine.so.5, and relaunch only when the report shows no unresolved libraries. Do not symlink or rename another library to match the name.

    HMI and touchscreens