Resolving WinCC Professional V11 Computer Name Compile Error

David Krause11 min read
SiemensTroubleshootingWinCC
Licensed PE Working through this on a live machine? A Maine-licensed engineer can take it from here — included with IMD hardware, by the hour for everything else. Book an engineer

Problem Description

A compile error is reported in WinCC Professional V11 (TIA Portal) when configuring a client/server project under WinCC > Server for Runtime Professional. The compiler flags the Computer name field of the WinCC server or client device as invalid, aborting the build and preventing the runtime project from being generated. The error is reproducible across all TIA Portal V11 and V11 SP1 service packs and is independent of project size, HMI tag count, or screen complexity.

Typical symptoms observed in the field:

  • Compile log shows Error: The computer name is not valid or Error in parameter "ComputerName" of device <HMI_RT>.
  • The error appears immediately after pressing Compile > Software (rebuild all) with the server or client HMI device selected.
  • The Windows hostname of the engineering PC and the value entered in the WinCC device configuration Computer name field do not match exactly.
  • A trailing dot, hyphen, or special character appears at the end of the hostname when viewed from System Properties or from cmd > hostname.
Note: TIA Portal V11 / V11 SP1 enforces strict naming rules for any device that participates in a WinCC Runtime Professional client/server topology. The compile-time check is performed against the WinCC device list and not against the live Windows host, so a hostname that compiles locally may still fail on download if the target runtime station is renamed.

WinCC Professional V11 Client/Server Architecture Overview

WinCC Runtime Professional is a PC-based SCADA runtime that communicates with the TIA Portal engineering station over the same project used to program SIMATIC S7-1500/300/400 controllers. In a multi-station installation, one PC acts as the WinCC server and one or more PCs act as WinCC clients. The server holds the active process image, archives, alarms, and reports; the clients render the screens served by the server.

For the client/server split to compile correctly, the following prerequisites must be satisfied (per the official Siemens TIA Portal V20 documentation for Clients and servers (RT Professional) — the architectural rules apply back to V11):

  1. A valid WinCC RT Professional license must be installed on the server PC.
  2. Each WinCC client requires a WinCC RT Professional client license.
  3. The Computer name of every HMI device in the project must match the Windows hostname of the PC that will run that role.
  4. The server and clients must be reachable on the same subnet; multicast / UDP discovery must be permitted on the network.
  5. The SQL Server instance backing WinCC must be configured to allow the WinCC service accounts to start, stop, and create databases.

Failure of any of the above produces a compile-time error before the runtime is even generated. Of these, the hostname mismatch is by far the most common in fresh installations.

Root Cause: Computer Name Restrictions

WinCC Professional V11 performs a compile-time check on every HMI device's Computer name property. The check enforces the same character and length rules as a NetBIOS / DNS hostname, but with the additional Siemens restriction that no trailing dot or hyphen is allowed. This is the root cause behind the original report, where the Windows hostname was displayed as winimage. (with a trailing period) — the period is the FQDN delimiter that DNS resolvers append automatically, but the WinCC parser interprets it as an invalid character and aborts the build.

There are four classes of hostname that will trigger the compile error:

Class Example Why it fails
Trailing dot / FQDN paste winimage. or winimage.local. FQDN appended by DNS; WinCC strips the dot but fails the strict check on the raw string
Trailing hyphen server- RFC 952/1123 forbids trailing hyphens in hostnames
Special characters win_2, or server#1 Underscore and # are not permitted in NetBIOS names
Excessive length engineering-station-01-a-very-long-hostname NetBIOS limit is 15 characters; full DNS label limit is 63

The error is deterministic: the same invalid name will always fail to compile, regardless of user permissions, project size, or TIA Portal hotfix level.

Windows Hostname Rules and the WinCC Subset

Windows allows hostnames that violate the strict DNS letter rules if the NetBIOS compatibility layer is enabled. WinCC Professional V11 does not honor that compatibility — it applies the stricter Siemens subset. Use the following table as the authoritative reference when choosing a name:

Property Windows allows WinCC RT Professional requires
Allowed characters A–Z, a–z, 0–9, hyphen A–Z, a–z, 0–9, hyphen (no underscore, no space, no period)
Length (NetBIOS) 1–15 1–15
Length (DNS label) 1–63 1–63
First character Alphanumeric Alphanumeric (no leading hyphen)
Last character Alphanumeric or hyphen Alphanumeric (no trailing hyphen, no trailing dot)
Case Case-insensitive Case-insensitive, but the spelling must be identical in the project and on the OS
Reserved names CON, PRN, AUX, NUL reserved Same as Windows; additionally localhost is not permitted for a real device
Critical: When the hostname is entered in the WinCC device property, do not append the Active Directory domain. Use winserver01, not winserver01.contoso.local. The DNS suffix is resolved by the operating system at runtime.

Step-by-Step Resolution

Follow this sequence to clear the compile error and deploy the WinCC server/client pair successfully.

Step 1 — Capture the current Windows hostname

  1. Open an elevated Command Prompt.
  2. Run hostname and echo %COMPUTERNAME%. Both must return the same string.
  3. Run ipconfig /all and note the Primary DNS Suffix — this is the value Windows appends when it shows the hostname with a trailing dot.
  4. Open System > About > Rename this PC (advanced) and compare the value to what is stored in the registry under HKLM\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Hostname.

Step 2 — Rename the Windows computer

  1. Open Start > Control Panel > System and Security > System > Rename this PC.
  2. Enter a name that satisfies the WinCC subset: 1–15 characters, alphanumeric plus hyphen, alphanumeric first and last, no trailing punctuation.
  3. Click Next and restart the PC. A reboot is mandatory — WinCC services cannot reload the hostname at runtime.
  4. After reboot, run hostname again to confirm the new value. There should be no trailing period.
Warning: Renaming a PC that is joined to an Active Directory domain will break the domain trust. The PC must be removed from the domain, renamed, and re-joined. Plan a maintenance window.

Step 3 — Update the TIA Portal project

  1. Open the project in TIA Portal V11 / V11 SP1.
  2. Select the WinCC server device in the project tree.
  3. Open Properties > General > Computer name and replace the value with the new Windows hostname, in the same letter case (uppercase is recommended for consistency).
  4. Repeat for every WinCC client device that participates in the project.
  5. Right-click the project and choose Compile > Software (rebuild all).

Step 4 — Verify the project compiles

  1. The compile log under Info > Compile should now end with Compile finished without errors.
  2. Open the Project tree > WinCC RT Professional > Server data and confirm the entry under Computer list matches the Windows hostname character-for-character.
  3. Proceed to Download to target device.

TIA Portal V11 SP1 Specific Configuration

The V11 SP1 readme (Siemens Support entry 51784423 — WinCC Professional V11 SP1 readme) lists several post-installation steps that interact with the hostname. The SQL Server instance used by WinCC must be reachable under the new computer name, otherwise the runtime will start in a degraded state even though the compile succeeded.

  1. Open SQL Server Configuration Manager on the WinCC server.
  2. Under SQL Server Services, confirm the WINCC instance is running. The instance name is normally WINCC and binds to the local machine identity.
  3. Under SQL Server Network Configuration > Protocols for WINCC, enable TCP/IP and disable Named Pipes if the clients will reach the server over IPv4.
  4. Restart the SQL Server (WINCC) service so the new hostname is registered in the SQL metadata.
  5. Open Start > Programs > Microsoft SQL Server > SQL Server Management Studio, connect to localhost\WINCC with Windows authentication, and verify the master database lists the new hostname in sys.servers (column name).

License Requirements

Even when the compile error is fixed, the project will not start at runtime without the correct licensing. The license model is identical from V11 through V20:

Role License article number (V11 era) License article number (V20 era) Notes
WinCC RT Professional Server (16k tags) 6AV2105-1BA06-0AA0 6AV2105-1BA10-0AA0 One per server
WinCC RT Professional Client 6AV2107-1DB06-0AA0 6AV2107-1DB10-0AA0 One per client
WinCC Recipes + Logging 6AV2105-0DA06-0AA0 6AV2105-0DA10-0AA0 Optional add-on
Field tip: License article numbers changed between major TIA Portal versions. Always check the Automation License Manager (ALM) on the target PC — the license is bound to the computer's SID, which changes when the host is renamed. A re-host of the license to the new hostname is required after the Step 2 reboot.

Verification Checklist

Before declaring the fix complete, walk through this matrix and tick every row:

# Check Command / Location Expected
1 Windows hostname hostname Plain string, no trailing dot
2 WinCC device property TIA Portal > Device > Properties > Computer name Identical to hostname
3 Compile Compile > Software (rebuild all) Compile finished without errors
4 SQL Server SQL Server Configuration Manager > Services WINCC instance Running, LocalSystem logon
5 Network ping <clientname> from server Resolves to IPv4 address, no <name>.<domain> suffix
6 License Automation License Manager > View > Trust computer RT Professional license listed, host = new hostname
7 Runtime start WinCC RT Professional start on server Green status, project loaded from Siemens\Automation\WinCC\RT Pro\<project>
8 Client connection Start WinCC RT on client Project list shows server, connection established

Troubleshooting Matrix

Observed error Likely cause Corrective action
Computer name is not valid Hostname contains underscore, space, or trailing dot Rename PC to alphanumeric + hyphen only, reboot
Device with computer name X could not be found at runtime Project computer name and OS hostname diverge after rename Update TIA project, recompile, re-download
SQL Server connection failed on startup WINCC instance still bound to old hostname Restart SQL Server (WINCC) service after rename
License not found on this computer ALM trust anchor still points to old SID Re-host license, or transfer via ALM > Move license
Client cannot see server in project list Multicast blocked or wrong subnet Enable UDP 5001/5002, allow WinCCDiscovery on Windows Firewall
Compile warning: computer name contains uppercase/lowercase mismatch OS hostname differs in case from project entry Align both to upper or lower case, recompile
Compile error persists after rename Cached project data from a previous compile Close project, delete .tmp and _logs folders, reopen and rebuild

Related Configuration Items Worth Checking

Even after the computer-name issue is resolved, three supporting settings are responsible for the majority of follow-on errors reported on the Siemens support portal:

  1. Windows Firewall — open UDP 5001, UDP 5002, and TCP 5000 inbound on the server. These ports are used for client/server discovery and the WinCC channel RPC traffic.
  2. DCOM and RPC — WinCC uses DCOM for tag and alarm exchange. The COM Security settings under dcomcnfg must allow Everyone access if the PC is in a workgroup; in a domain, the WinCC service account must have launch and activation rights.
  3. Time synchronization — alarms and archive entries are timestamped. A clock skew larger than five seconds between server and client causes Invalid time stamp warnings and is a common source of confusion on commissioning day. Configure an NTP source on both PCs.

What to Do If the Error Persists

If the compile log continues to report Computer name is not valid after Steps 1–4 above, the issue is almost always in the project cache rather than the OS hostname:

  1. Close TIA Portal and stop the Siemens TIA Portal V11 service.
  2. Navigate to the project folder and delete the System\<CPU name>\IM\<device> subfolder, then delete the .srf and _logs folders.
  3. Reopen the project, perform a full Compile > Software (rebuild all), and verify the log.
  4. If the error still appears, open a support request on the Siemens Industry Online Support portal and attach the full compile log plus a screenshot of cmd > hostname and the device property sheet.

Why does WinCC Professional V11 reject my computer name when Windows accepts it?

WinCC applies a strict alphanumeric-plus-hyphen subset of the Windows hostname rules, and it disallows trailing dots and hyphens. Windows accepts names that violate this subset when NetBIOS compatibility is enabled, but the WinCC compile-time check is performed on the raw string and will fail. Rename the PC and recompile.

Do I need to enter the FQDN (for example, server01.contoso.local) in the Computer name field?

No. Enter the short hostname only, e.g. SERVER01. The Active Directory DNS suffix is resolved at runtime by the Windows networking stack. Entering the FQDN is one of the most common causes of the trailing-dot compile error.

After renaming the PC, my WinCC license is reported as not found. How do I fix it?

Open Automation License Manager on the renamed PC and use License Management > Move license (or Rehost) to transfer the WinCC RT Professional license to the new computer identity. The license is bound to the SID, which changes on rename.

Is this error still present in newer TIA Portal versions such as V20?

Yes. The same hostname subset is enforced in WinCC Runtime Professional through V20. Renaming conventions and the compile-time check have remained backward compatible. Reference the current TIA Portal documentation for Clients and servers (RT Professional) for the latest matrix.

Do I need to restart the SQL Server service after renaming the WinCC server PC?

Yes. Stop and start the SQL Server (WINCC) instance in SQL Server Configuration Manager so the new hostname is registered in sys.servers and the WinCC databases accept connections from the renamed host. The V11 SP1 readme (Siemens Support entry 51784423) lists this as a required post-installation step.

Back to blog