Resolving Siemens WinCC 7.4 WebNavigator Client Graphics Errors
After migrating a WinCC 7.4 SCADA server from Windows Server 2008 to Windows 10, an operations team observed that WebNavigator clients rendered faulty graphics. Out of ten client workstations, eight worked correctly, while two displayed corrupted or missing picture elements. The fault was eventually traced to inconsistent distribution of the Siemens HMI Symbol Library and stale WinCC Viewer RT plug-in components on the failing clients. This reference describes the full diagnostic, root-cause analysis, and resolution workflow that resolves this class of WinCC 7.4 WebNavigator client graphics error.
1. Problem Description and Symptoms
WebNavigator thin clients load published WinCC pictures over HTTP/HTTPS using the WebViewer control hosted in Internet Explorer (or the Edge IE Mode shim on Windows 10 22H2 and later). When the picture cache or plug-in catalog on a client is older than the server build, the WebViewer can fall back to placeholder rendering for any object that has been added, replaced, or updated on the server.
The reported failure pattern:
- Server: WinCC 7.4 running on Windows 10 (migrated from Windows Server 2008).
- Clients: 10 Windows 10 22H2 workstations with WebNavigator client + DataMonitor client V7.4 Update 19.
- 8 of 10 clients render the same picture correctly.
- 2 of 10 clients display missing symbols, blanked picture areas, or visually corrupt static graphics.
- A re-imaged client (clean Windows 10 Pro + Office + WebNavigator + DataMonitor V7.4 Upd 19) reproduces the fault on the same two screens.
- Fault appears in
WinCC Viewer RTonly; the WinCC single-user station on the same PC renders the picture correctly.
The defect is not random. The discrepancy is deterministic per client, which points at a local component mismatch rather than a network or server-side runtime issue.
2. Affected Versions and Components
The following matrix summarizes the components that participate in client-side picture rendering and which release streams are known to interact badly if they drift apart.
| Component | Tested Version | Role | Failure Mode If Mismatched |
|---|---|---|---|
| WinCC Server | V7.4 + Upd 19 | Hosts published PDL pictures and the WebNavigator publishing service | New symbols added to libraries are not exposed to clients |
| WebNavigator Server | V7.4 + Upd 19 | Publishes HTTP/HTTPS Web pages and picture packages | Stale .cprj project, broken WebConfigurator output |
| DataMonitor Server | V7.4 + Upd 19 | Provides WebTrend, WebAlarm, and report views | WebTrend controls render as red X placeholders |
| WebNavigator Client | V7.4 + Upd 19 | Renders pictures in IE/Edge IE Mode via WebViewer.dll
|
Missing controls, blanked backgrounds |
| DataMonitor Client | V7.4 + Upd 19 | Renders WebTrend, WebAlarm, and Excel Workbook add-in | Excel add-in tools disappear, WebTrend controls blank |
| Siemens HMI Symbol Library | V7.4 baseline (compiled into the Web package) | Provides the 2D/3D and piping/winch/icons palette used in PDL pictures | Symbol objects render as gray boxes or are missing |
| Internet Explorer / Edge IE Mode | IE 11 / Edge 100+ | Hosts the WebViewer ActiveX control | ActiveX blocked, cache returns old binaries |
Whenever the server-side build number advances (a WinCC Update, a WebNavigator hotfix, or a re-issued symbol library) and a client does not receive the matching plug-in set, the client silently reverts to whatever version of the symbol library and custom control plug-ins is already cached under %LOCALAPPDATA%\Siemens\WebNavigator.
3. Root Cause Analysis
There are four overlapping root causes that produce this exact symptom set. They are not mutually exclusive; in the field most cases combine at least two.
3.1 Stale WebConfigurator Output
The WebConfigurator is the WinCC tool that writes the Web.config file, the plug-in manifest, the published picture set, and the WebNavigator client installer into the WebNavigator publishing folder. When the WinCC installation is updated, the WebConfigurator must be re-run; otherwise, the web installer it produces continues to deploy the previous plug-in generation to any new client. The symptom is that the two problem clients in the field were originally installed while the WebConfigurator was still pointing at a pre-update manifest, and the cached client payload is now permanently behind the server.
3.2 Missing or Outdated WebNavigator Plug-in on the Client
WebNavigator plug-ins are ActiveX controls and WinCC custom controls that the WebViewer downloads on first contact. The browser also caches them in the Temporary Internet Files folder. If the local cache is not invalidated after a server update, the browser re-uses the old ax_*.cab file and silently skips the newer one.
3.3 Siemens HMI Symbol Library Not Distributed
The Siemens HMI Symbol Library is a separately installable WinCC component that supplies the standard palette of motors, valves, pipes, fans, and 2D/3D icons. When a PDL picture uses a symbol from this library, the WebNavigator client must have the same library registered locally. If the symbol library was installed on the server but not on the WebNavigator client installer image, the symbol instances render as empty rectangles or are absent entirely.
3.4 Custom ActiveX / OCX Requiring Plugin Builder
If the picture uses a custom ActiveX or OCX control that is not part of the standard WinCC picture elements, the WebNavigator client receives an empty placeholder. The control must be packaged using the WebNavigator Plugin Builder and added to the WebNavigator client installation. The Plugin Builder workflow is documented in the WinCC Information System under the entry ID cited in Section 9.
4. Diagnostic Workflow
Run these steps in order. Each step isolates one of the four root causes above.
- Confirm the symptom is local to the client. Open the same picture on a known-good client. If the picture is good, the server is exonerated. The fault is local to the failing client or to the WebConfigurator output that fed it.
-
Capture the WebViewer log. On the failing client, start
WinCC Viewer RTwith the-logswitch ("C:\Program Files (x86)\Siemens\Automation\WinCC Viewer RT\WinCCViewerRT.exe" -log) and reproduce the picture. Look for entries that reference missing OCX/ActiveX controls, missing DLLs, or symbol library load errors. -
Compare the published package. On the server, open
<WinCC Project>\WebNavigator\Web\and check the modification times ofWeb.config,SiemensHmiSymbolLibrary.dll, and thePluginssubfolder. If the last-modified timestamps predate the WinCC Update 19 install, the WebConfigurator has not been re-run. -
Compare the client cache. On a working client and on a failing client, open
%LOCALAPPDATA%\Temp\Siemens\WebNavigator\and list the*.cabfiles. The SHA-1 ofWebViewer.cabshould match; if it does not, the client is running an older viewer generation. -
Inspect browser cache. In Internet Explorer (or Edge IE Mode) choose Tools → Internet Options → General → Settings → View Files and look for
SiemensHmiSymbolLibrary.dllandWebViewer.dll. Note the file version. Repeat on a good client and confirm they are identical. -
Verify the Symbol Library registry entries. On a working client and the failing client, compare
HKLM\SOFTWARE\WOW6432Node\Siemens\WinCC\WebNavigator\InstalledPlugins. A missing key on the failing client means the plug-in was never registered locally. - Check for custom controls. Open the original PDL picture in Graphics Designer on the server and select Tools → Cross Reference for any control that is not a standard WinCC picture element. If a third-party or custom ActiveX is referenced, it must be packaged with the Plugin Builder (Section 6.2).
5. Solution: Re-Run the WebConfigurator
The single highest-leverage action is to re-run the WebConfigurator on the server so that the published web content and the client installer payload are regenerated against the current WinCC build.
- Open Start → Siemens Automation → WebNavigator → WebConfigurator on the WinCC server.
- Select the WinCC project that hosts the WebNavigator server.
- Walk through every page. The configurator regenerates
Web.config, refreshes the picture package, and rewrites the client installer with the current plug-in set. - When the configurator reports "Configuration successfully completed", close it.
- Re-publish the WinCC project: in WinCC Explorer right-click the project and choose Web Navigator → Publish. Accept the default picture set. Do not skip this step; the WebConfigurator writes the manifest, but Publish rebuilds the actual picture data.
- From any client, open
http://<server>/WebNavigator/and confirm the new self-signed certificate prompt and the updated plug-in version are reported.
6. Solution: Repair or Reinstall the Failing Clients
6.1 Standard WebNavigator Client Reinstall
- On the failing client, open Control Panel → Programs and Features.
- Uninstall SIMATIC WinCC WebNavigator Client and SIMATIC WinCC DataMonitor Client in that order.
- Delete the user-scoped cache:
rd /s /q "%LOCALAPPDATA%\Siemens\WebNavigator". - Delete the IE cache: Internet Options → General → Delete → Temporary Internet Files and website files. Tick the box.
- Reboot.
- Reinstall WebNavigator Client and DataMonitor Client from the updated server-published installer at
http://<server>/WebNavigator/setup.exe. Do not reuse an oldsetup.exefrom a USB stick or a network share that pre-dates the WebConfigurator rebuild. - Open the project in
WinCC Viewer RTand re-test the picture.
6.2 Custom ActiveX Controls — Plugin Builder
If diagnostic step 7 (Section 4) revealed a custom ActiveX, OCX, or custom WinCC Control in the picture, that control must be packaged for WebNavigator distribution. The Plugin Builder is documented in the WinCC Information System entry referenced in Section 9.
- On the server, start Start → Siemens Automation → WebNavigator → Plugin Builder.
- Add the custom
.ocxor.dllto a new plug-in project. - Mark the plug-in as required so that the client installer pulls it automatically.
- Build the plug-in package; the output is a
.crpfile that the WebConfigurator will copy into the publishedPluginsfolder. - Re-run the WebConfigurator (Section 5) so the plug-in is included in the regenerated client installer.
- Reinstall the WebNavigator Client on every workstation that uses the custom control, including the two problem clients.
7. Solution: Symbol Library Refresh on the Client
If diagnostic step 6 (Section 4) shows the SiemensHmiSymbolLibrary registry key is missing on the failing client, the symbol library was never registered. There are two valid paths.
Path A — Re-run the WebNavigator Client installer. When the WebConfigurator output is current (Section 5), the client installer includes the symbol library as a dependency. A clean reinstall of the WebNavigator Client registers it.
Path B — Manual registration from a known-good client. If the deployment is image-based and you cannot push a fresh installer, you can copy the symbol library files from a good client and register them manually.
- From a known-good client, copy
SiemensHmiSymbolLibrary.dllfromC:\Program Files (x86)\Siemens\Automation\WinCC\WebNavigator\bin\to the same path on the failing client. - Open an elevated
cmd.exeon the failing client and runregsvr32 /s "C:\Program Files (x86)\Siemens\Automation\WinCC\WebNavigator\bin\SiemensHmiSymbolLibrary.dll". - Restart
WinCC Viewer RTand re-test the picture.
regsvr32 registration is a stopgap. It is acceptable when the failing client is a single workstation and you need to restore service before the next maintenance window, but the long-term fix is to reissue the client installer through WebConfigurator so the registration is idempotent across the fleet.8. Solution: Browser Cache and Internet Explorer Settings
Even after the server is fixed, a stale browser cache on the client will keep the client pinned to the old control generation. Apply the following baseline to every WebNavigator client and lock it down with Group Policy.
- Open Internet Options → General → Settings → Caching → Automatically. Set the disk space to between 250 MB and 1 GB.
- Open Internet Options → General → Delete and clear Temporary Internet Files, Cookies, and History.
- Open Internet Options → Security → Local Intranet → Sites → Advanced and add the WinCC WebNavigator server FQDN to the zone. The WebViewer ActiveX only loads automatically from the Local Intranet or Trusted Sites zones.
- Open Internet Options → Security → Custom Level and confirm that Download signed ActiveX controls is set to Prompt and that Run ActiveX controls and plug-ins is set to Enable.
- Open Internet Options → Advanced → Security and confirm that Do not save encrypted pages to disk is unchecked; the WebViewer caches picture data as encrypted blobs and will be unable to reuse them across sessions otherwise.
For Edge IE Mode on Windows 10 22H2 and Windows 11, configure the same Local Intranet zone via edge://flags and the Enterprise Mode Site List. The same ActiveX rules apply.
9. Official Documentation References
- WinCC V7.4: Working with WinCC — WebNavigator (Information System)
- WinCC V7.4 SP1: WebNavigator documentation
- WinCC V7.4: WebNavigator — installation and configuration
- WinCC V7.4: Installation notes and Update 19 readme
- WinCC V7.4: DataMonitor — configuration and operation
- WinCC V7.4: HMI Symbol Library — usage and distribution
- WebNavigator Plugin Builder (WinCC Information System chapter)
- WinCC WebNavigator — operating manual (V7.x generic)
10. Verification Procedure
After the WebConfigurator has been re-run and the clients have been reinstalled, validate the fix end-to-end.
- On a representative client, open
WinCC Viewer RTand connect to the WebNavigator server. Verify that the client installer reports the same build number as the server (read the build from Help → About in both the server project and the client viewer). - Load every picture that was previously reported as faulty. Confirm that every Siemens HMI Symbol Library object renders.
- Open a picture that uses a custom ActiveX control (if applicable). Confirm that the control initialises without an "Object does not support this property or method" dialog.
- From a Windows command line on the client, run
tasklist /m SiemensHmiSymbolLibrary.dll. The output should showWinCCViewerRT.exeas a process that has the library loaded. - Restart the client and re-test. A correct fix survives a reboot without re-installation.
- Open the same picture from a thin-client session via the WebNavigator URL (not the Viewer RT). Confirm the picture is correct in this code path as well.
- From the Windows event viewer on the client, confirm there are no Application Error or SxS (side-by-side) warnings relating to
WebViewer.dll,SiemensHmiSymbolLibrary.dll, or any custom OCX.
11. Field Commissioning Checklist
Use this checklist whenever a WinCC V7.4 WebNavigator deployment is moved, upgraded, or extended.
- Server and client build numbers match (e.g. both at V7.4 + Upd 19).
- WebConfigurator re-run after the last server-side update.
- Project re-published with Web Navigator → Publish.
- WebNavigator Client uninstalled and reinstalled from the current server installer on every new or changed client.
- IE cache and
%LOCALAPPDATA%\Siemens\WebNavigatorcleared on every changed client. - Siemens HMI Symbol Library registered on every client (verified by registry key under
HKLM\SOFTWARE\WOW6432Node\Siemens\WinCC\WebNavigator). - Custom ActiveX controls packaged with the Plugin Builder and re-included in the client installer.
- Local Intranet zone configured on every client; the WebNavigator server FQDN added to Trusted Sites if it is across a DMZ.
- First picture load tested on every client from a cold boot; the ActiveX prompt is accepted.
- Event viewer clean of WebViewer, OCX, and SxS warnings.
12. Troubleshooting Matrix
| Symptom | Likely Cause | Action |
|---|---|---|
| All clients fail after server update | WebConfigurator not re-run | Re-run WebConfigurator and re-publish |
| Some clients fail, some work, same build | Client cache or Symbol Library not refreshed | Reinstall client, clear cache, verify registry |
| Symbol objects missing only | Siemens HMI Symbol Library not on client | Reinstall client, or regsvr32 the library manually |
| Custom ActiveX shows as a gray box | Plug-in not packaged for WebNavigator | Build with Plugin Builder, re-run WebConfigurator, reinstall client |
| Red X on WebTrend / WebAlarm | DataMonitor Client mismatch | Match DataMonitor Client to server update, clear browser cache |
| ActiveX blocked by IE | Server not in Local Intranet or Trusted Sites | Add server FQDN to zone, lower security for the zone to Medium |
| Picture correct in single-user WinCC, broken in WebNavigator | WebNavigator-only custom control missing on client | Package control with Plugin Builder, redeploy |
| Picture flickers / partial repaint | Symbol library version drift between client and server | Reinstall WebNavigator Client from current server installer |
13. Frequently Asked Questions
Why do my WinCC 7.4 WebNavigator clients render faulty graphics only after a WinCC Update?
The WinCC Update changes the server-side build of the HMI Symbol Library, the WebViewer ActiveX, and the published control manifest. If the WebConfigurator is not re-run and the clients are not reinstalled, the clients keep using the pre-update control generation. Re-run the WebConfigurator, re-publish the project, and reinstall the WebNavigator Client on every affected workstation.
How do I check which build of the WebNavigator Client is installed on a workstation?
Open Control Panel → Programs and Features and read the version column for "SIMATIC WinCC WebNavigator Client". Compare it with the server build by reading Help → About on the WinCC project. Both should report the same major.minor.update number (e.g. 7.4.0.19).
Where is the WebConfigurator and what does it actually do?
The WebConfigurator is at Start → Siemens Automation → WebNavigator → WebConfigurator on the WinCC server. It regenerates the Web.config, rebuilds the published picture package, refreshes the client installer with the current plug-in set, and writes the symbol library and ActiveX references into the client deployment manifest. It must be re-run after every WinCC Update or WebNavigator Update.
Do I need the Siemens HMI Symbol Library on every WebNavigator client?
Yes. Any picture that uses symbols from the Siemens HMI Symbol Library (motors, valves, pipes, 2D/3D icons, the winch palette) requires the library to be registered on the client. If the library is missing, the symbol instances render as gray rectangles. The library is installed automatically when you reinstall the WebNavigator Client from an up-to-date server-published installer.
Why does a re-imaged Windows 10 client still show the same fault?
Re-imaging fixes the OS and the Office stack, but it does not fix the published client installer if the WebConfigurator on the server has not been re-run. The new client is being fed the same old setup.exe payload. Re-run the WebConfigurator first, then re-image, then install WebNavigator Client from the new server installer.
What is the role of the WebNavigator Plugin Builder?
The Plugin Builder packages a third-party or custom ActiveX/OCX control into a WebNavigator plug-in (.crp) so that the WebViewer can download and host it on the client. Without the Plugin Builder, a custom control used in a PDL picture renders as an empty placeholder on every WebNavigator client. The Plugin Builder is documented in the WinCC Information System entry ID 109792585.
How do I clear the WebNavigator cache on a client without re-imaging?
Delete %LOCALAPPDATA%\Siemens\WebNavigator and the IE Temporary Internet Files folder, then reboot. The next connection to the WebNavigator server re-downloads the current plug-in generation and the current picture package. This is the fastest way to recover a single client without a full reinstall.