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 validorError 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 Propertiesor fromcmd > hostname.
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):
- A valid WinCC RT Professional license must be installed on the server PC.
- Each WinCC client requires a WinCC RT Professional client license.
- The Computer name of every HMI device in the project must match the Windows hostname of the PC that will run that role.
- The server and clients must be reachable on the same subnet; multicast / UDP discovery must be permitted on the network.
- 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 |
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
- Open an elevated Command Prompt.
- Run
hostnameandecho %COMPUTERNAME%. Both must return the same string. - Run
ipconfig /alland note the Primary DNS Suffix — this is the value Windows appends when it shows the hostname with a trailing dot. - 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
- Open Start > Control Panel > System and Security > System > Rename this PC.
- Enter a name that satisfies the WinCC subset: 1–15 characters, alphanumeric plus hyphen, alphanumeric first and last, no trailing punctuation.
- Click Next and restart the PC. A reboot is mandatory — WinCC services cannot reload the hostname at runtime.
- After reboot, run
hostnameagain to confirm the new value. There should be no trailing period.
Step 3 — Update the TIA Portal project
- Open the project in TIA Portal V11 / V11 SP1.
- Select the WinCC server device in the project tree.
- Open Properties > General > Computer name and replace the value with the new Windows hostname, in the same letter case (uppercase is recommended for consistency).
- Repeat for every WinCC client device that participates in the project.
- Right-click the project and choose Compile > Software (rebuild all).
Step 4 — Verify the project compiles
- The compile log under Info > Compile should now end with
Compile finished without errors. - Open the Project tree > WinCC RT Professional > Server data and confirm the entry under Computer list matches the Windows hostname character-for-character.
- 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.
- Open SQL Server Configuration Manager on the WinCC server.
- Under SQL Server Services, confirm the
WINCCinstance is running. The instance name is normallyWINCCand binds to the local machine identity. - Under SQL Server Network Configuration > Protocols for WINCC, enable TCP/IP and disable Named Pipes if the clients will reach the server over IPv4.
- Restart the
SQL Server (WINCC)service so the new hostname is registered in the SQL metadata. - Open Start > Programs > Microsoft SQL Server > SQL Server Management Studio, connect to
localhost\WINCCwith Windows authentication, and verify themasterdatabase lists the new hostname insys.servers(columnname).
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 |
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:
- 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.
-
DCOM and RPC — WinCC uses DCOM for tag and alarm exchange. The COM Security settings under
dcomcnfgmust allow Everyone access if the PC is in a workgroup; in a domain, the WinCC service account must have launch and activation rights. - 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:
- Close TIA Portal and stop the
Siemens TIA Portal V11service. - Navigate to the project folder and delete the
System\<CPU name>\IM\<device>subfolder, then delete the.srfand_logsfolders. - Reopen the project, perform a full Compile > Software (rebuild all), and verify the log.
- 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 > hostnameand 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.