Resolve an Invalid Startup Configuration File

If a Startup Configuration File is detected when you launch a ViewX client, the file is parsed and interpreted before the client opens. If it is determined that the XML code in the configuration file is invalid, the system will display a notification as follows:

The notification provides details that will help you to fix the invalid code (you might want to make a note of the details at this point). The problem displayed in the notification is the first problem encountered.

When you select OK, the ViewX client ignores the Startup Configuration File and opens normally.

To determine why the Startup Configuration File is invalid, you need to refer to the ViewX log file (see ViewX and Virtual ViewX Logging). By default, this file is in the following folder:

C:\ProgramData\Schneider Electric\ClearSCADA\Logs\ViewX

Within the ViewX log file, information about the Startup Configuration File is timestamped and labeled with "[Startup]".

Example:

The text below is an extract from the ViewX log file following an unsuccessful attempt to launch the ViewX client:

2016-04-06 10:06:30.405 [01] [Startup] Error reading startup configuration file C:\ProgramData\Schneider Electric\ClearSCADA\StartupConfiguration.xml: Multiple window containers named 'Left' defined

Multiple window containers specified for monitor 1, but one or more are specified as Maximized or FullScreen

The "[Startup]" label indicates that this information relates to the Startup Configuration File. The time stamp indicates when the last unsuccessful launch took place.

The log entry explains the reason for the startup problem.

To repair an invalid Startup Configuration File:

  1. Review the ViewX log file to determine why the file is invalid.
  2. Locate the Startup Configuration File (StartupConfiguration.xml). By default, it is in the following directory:

    C:\ProgramData\Schneider Electric\ClearSCADA

  3. Open the file in a standard XML editing tool.
  4. Make the required changes to the file.
  5. Close the ViewX client (if it is currently open).
  6. Start the ViewX client again.

If further configuration anomalies are detected in the Startup Configuration File, repeat these steps until the XML code is valid.

A Startup Configuration file is an XML file. XML is case-sensitive. To be valid in XML files, Boolean 'true' and 'false' values must be fully lower case.

NOTICE

unexpected behavior OF APPLICATION

Startup Configuration files are intended only for use on ViewX clients that are required to launch Geo SCADA Expert on a Multi-Monitor setup, and/or have customized Window Container behavior.
Do not use Startup Configuration files on Virtual ViewX clients, as these clients only support a single monitor setup, and do not support the same customized behavior. Using a Startup Configuration file on such a client could result in unexpected behavior. (Startup Configuration files are not supported, and are ignored, on Original WebX clients.)
Failure to follow these instructions can result in inoperable equipment.

Further Information

For information about the requirements and restrictions that apply to the various elements and attributes in a Startup Configuration File, see XML Elements.


Disclaimer

Geo SCADA Expert 2022