Browse FAQs

ClearSCADA: Multiple Containers in ClearSCADA 2017 R2

Published date: 14 December 2018

The StartupConfiguration.xml file used to configure multiple ViewX containers has changed in ClearSCADA 2017 R2.  The StartupConfiguration file format that was used for ClearSCADA 2015 R1, ClearSCADA 2015 R2 and ClearSCADA 2017 must be changed in order to run multiple containers in ClearSCADA 2017 R2.  Below are the details:

Information Regarding Multi-Monitor Setup in the ViewX Help:  May be found in:

System Administration | Client Administration | Launch a ViewX Client on a Multi-Monitor Setup | Configure a Multi-Monitor Setup | Startup Configuration File


Note shown on the ViewX Help opening page in ClearSCADA 2017 R2:



StartupConfiguration.xml example 1:

The following StartupConfiguration.xml file is an example of a 2 monitor configuration with the homepage and alarm banner shown on both monitors.


<Startup>
 
<WindowContainers>
 
<PrimaryWindowContainer Monitor="1"  DisplayMode="FullScreen"
AlarmBannerPersistSettings="true" AlarmBannerDisplayState="DockedBottom" />
 
<SecondaryWindowContainer Name="Right" Monitor="2"  DisplayMode="Restored"
AlarmBannerDisplayState="DockedBottom" />
 
</WindowContainers>
 
<InitialDocuments>
 
<Document Window="Primary" Type="Object" System="MAIN">Monitor1_homepage</Document>
 
<Document Window="Right" Type="Object" System="MAIN">Monitor2_homepage</Document>
 
</InitialDocuments>
 
</Startup>


StartupConfiguration.xml example 2:

The following StartupConfiguration.xml file is an example of a 2 monitor configuration with the homepage shown on both monitors only (i.e. no alarm banner).


<Startup>
 
<WindowContainers>
 
<PrimaryWindowContainer Monitor="1"  DisplayMode="FullScreen"/>
 
<SecondaryWindowContainer Name="Right" Monitor="2"  DisplayMode="Restored" />
 
</WindowContainers>
 
<InitialDocuments>
 
<Document Window="Primary" Type="Object" System="MAIN">Monitor1_homepage</Document>
 
<Document Window="Right" Type="Object" System="MAIN">Monitor2_homepage</Document>
 
</InitialDocuments>
 
</Startup>



(Older StartupConfiguration.xml example)

The following StartupConfiguration.xml file is an example of the file used in ClearSCADA 2015 R1, ClearSCADA 2015 R2 and ClearSCADA 2017 (Initial Release).  Notice the differences between this file and the files above which include:
  • removal of the 'InterfaceMode' clause
  • a change to the 'AlarmBanner' syntax
(The affected lines of code have been highlighted below.  This is the equivalent file to Example 1 above.)


<Startup>
 
<WindowContainers AlarmBannerWindow="Right">
 
<PrimaryWindowContainer Monitor="1" InterfaceMode="SingleDocument" DisplayMode="FullScreen"/>
 
<SecondaryWindowContainer Name="Right" Monitor="2" InterfaceMode="SingleDocument" DisplayMode="Restored" />
 
</WindowContainers>
 
<InitialDocuments>
 
<Document Window="Primary" Type="Object" System="MAIN">Monitor1_homepage</Document>
 
<Document Window="Right" Type="Object" System="MAIN">Monitor2_homepage</Document>
 
</InitialDocuments>
 
</Startup>
 

Was this helpful?

What can we do to improve the information ?

Can't find what you are looking for?

Reach out to our customer care team to receive information on technical support, assistance for complaints and more.