Troubleshooting

This chapter provides solutions to common issues encountered during configuration, project deployment, UI connection, and runtime operation of WinCC OA on Edge Devices.

Project Upload Troubleshooting

Common issues and resolutions encountered during the project upload process to a WinCC OA Edge Device.

Manager Problems

If one or more WinCC OA managers are not running correctly after project upload:

  1. Open the WinCC OA Console.
  2. Click the Flag Button next to the manager entry.
  3. Restart the manager using the debug flag to inspect behavior.
Tip:
Using the debug flag can help you identify specific issues with the manager startup process.

Log Viewer

Use the Log Viewer to examine runtime logs and identify root causes:

  1. Logs Page in the navigation bar.
  2. The default Logviewer displays the PVSS_II.log file.
  3. Click WinCC OA logs to access the full log list under /project/logs/.
  4. Logs can be viewed in-browser or downloaded.
  5. Config files (except certs and keys) are accessible via the Configuration Page.
Important:
Sensitive files such as certificates and keys are not accessible for security reasons.
Important:
When using firmware versions older than simatic-ipc-ied-os-3.1.0-19-x86-64 the LogViewer is not updated properly, therefore a firmware upgrade is highly recommended!

Connection Problems

Check the following areas to resolve connectivity issues:

  • Verify network cable and connectivity.
  • Ensure all required ports are open and not blocked by firewalls.
  • Double-check port configuration in the project's config file.
Warning:
Blocked ports or incorrect network configuration are common causes of connection problems.

Upload Failures

Follow these checks to resolve upload-related issues:

  • Verify that the file does not exceed allowed upload size.
  • Ensure stable network connection during the upload process.
  • Check access permissions for upload operations.
Tip:
Large files or unstable connections can interrupt the upload process.

Remote UI Troubleshooting

Common issues encountered when connecting to a WinCC OA project via Remote UI from an Engineering Station.

Connection Problems

  • Ensure the Edge Device is reachable over the network (ping test).
  • Verify that the correct IP address and port are used in the UI Manager configuration.
  • Check that required firewall ports are open (e.g., 38443, 34999).

Authentication Failures

  • Ensure correct username and password are used.
  • Change default credentials immediately upon first login.

Configuration Mismatches

  • Validate project name and timeout settings in the UI Manager configuration.
  • Ensure the project is deployed and running on the Edge Device.

Desktop UI Troubleshooting

Resolution steps for typical problems encountered when using the WinCC OA Desktop UI to connect to an Edge Device.

Connection Problems

  • Verify Edge Device IP and configured port.
  • Confirm network connectivity between Desktop UI and Edge Device.
  • Check local firewall or security software blocking outbound connections.

Authentication Failures

  • Double-check login credentials provided during Desktop UI connection.
  • Reset credentials on the Edge Device if access was revoked or changed.

UI Responsiveness

  • Ensure the project is actively running and not in an idle state.
  • Check system resources (CPU, memory) on the Edge Device.
  • Restart the Desktop UI if the interface becomes unresponsive.