01 Root Configuration Files for Operator Client

Root configuration files

Root configuration files define the behaviour of DELFT-FEWS on the local machine. These files are synchronised in the live system environment, nor are they available in the database. The files must be installed locally with the DELFT-FEWS system.

clientConfig

The clientConfig File determines if the instance of DELFT-FEWS is to run as a stand alone system, or if it is to connect to the master controllers defined below.
Since 2011.01 the clientConfig file is no longer required for stand alone. Stand alone is the default when the client config is missing

Figure 158 Elements of the clientConfig configuration

clientType

Definition of the client type. Enumeration of options includes;

• Operator Client
• Stand Alone

LogConfig

To be completed

synchConfig

Looks something like this for an OC:

<?xml version="1.0" encoding="UTF-8"?>
<fews-master-config xmlns="http://www.wldelft.nl/fews" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.wldelft.nl/fews http://fews.wldelft.nl/schemas/version1.0/synchronisationConfiguration.xsd">
	<queueconnection>
		<factory jndi="ConnectionFactory"/>
	</queueconnection>
	<defaultMcId>MC00</defaultMcId>
  <mc id="MC00">
		<jndicontext factory="org.jnp.interfaces.NamingContextFactory" provider="jnp://localhost:1099" prefixes="org.jboss.naming:org.jboss.interfaces"/>
		<queue>
			<root jndi="TEST/MC00/"/>
			<synch jndi="External/JMSQueue/OCIncoming" timeout="10"/>
		</queue>
   </mc>
	<synchronisation>
		<messaging maxrecords="1000" maxlobdata="30000000"/>
		<processor maxlistsize="500000"/>
		<schema location="nl/wldelft/fews/master/data/synchdata/synchronisation_schema.xsd"/>
	</synchronisation>
      <login timeout="10" />
</fews-master-config>

The synchConfig does not normally require editting.

The only setting that may demand editting is the <login timeout="10" />, which controls the timeout for a login attempt of the OC on the MC (in seconds). (This element may be absent, in which case the timeout is 10secs)
It may be needed to extend this timeout if the JMS server is very busy (very many clients starting up and synchronising at the same time, e.g. when all the PCs for a workshop are all starting up at the same time).
Note: the xml config can only extend the time out from the default 10 secs. Settings less than 10 secs are ignored)

synchProfiles

The file synchProfiles.xml contains several different profiles for fine-grained control over the synchronisation with the database.

The following profiles

From version 2010.01 onwards, it is possible to get an overview of the active users. This overview is available in both the Operator Client and the Admin Interface. In order to make this functionality work, the file synchProfiles.xml has to be configured properly in each of the Operator Clients. Before version 2010.01, the file synchProfiles.xml would typically contain several profiles containing the following snippet:

			<activity id="Activity.In.FewsSessions">
				<channelId>Channel.In.FewsSessions</channelId>
					<schedule>
						<single/>
					</schedule>
				<timeOut>10000</timeOut>
			</activity>

From version 2010.01 onwards, it is recommended to replace this snippet for the profiles 'Full', 'Minimal' and 'Custom' (not for ConfigManager) by the following:

			<activity id="Activity.In.FewsSessions">
				<channelId>Channel.In.FewsSessions</channelId>
				<schedule>
					<continuous>
						<period unit="minute" multiplier="3" divider="1"/>
						<priority>low</priority>
					</continuous>
				</schedule>
				<timeOut>10000</timeOut>
			 </activity>

This defines that the information needed for these overviews is synchronized every three minutes.

See also User Administration - Active Users

synchChannels

To be completed

Working with pool of localDataStores (under Citrix)

A standard installation will have to be adjusted to work well in a Citrix environment. It is possible to keep your own localDatastore folder, which is then stored on your personal home directory on the Citrix server or the localDatastore can be stored centrally on the hard drive of the citrix server, in what we call a pool directory. This pool can currently exist of a maximum of 11 users at the same time (hard coded). In this case 11 localdatastore folders are created in de pooldirectory.

The following adjustments will have to be made:

   1. in the jpif file, used together with the executable to start up the application, the last line will have to be replaced with

      $USER_HOME$\Local Settings\Application Data\<name of application root directory>_OC
      This is needed to make sure FEWS is working in multi-user mode, with caching in the profile directory, where $USER_HOME$ is a reference to the profile of the user. At the same time you can also make use of the localDataStorePoolDir and therefore two more adjustments will have to be made. 

   2. The file \<name of application root directory>\global.properties will have to be renamed to citrix_global.properties, to make sure you have a separate file for Citrix users.

   3. in the file \<name of application root directory>\citrix_global.properties the following line will have to be added: localDataStorePoolDir=[C:\FewsLocalDataStores]
     with an extra line after this line. Please also be aware that the localDataStorePoolDir is case sensitive. Obviously you can determine yourselves where this pooldir is located.

Global.properties file