01 Root Configuration Files

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.

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' 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

Global.properties file