Page History

...

1. FEWS configuration file Explorer.xml  in the directory  SystemConfigFiles
   1. the  dateTime  section  
      1. In order to hide the year within FEWS, the dateTimeFormat must be configured accordingly.  
      2. The element adjustSystemTimeAutomatically should be set to 'true' (this is the defaultdefault for a Stand Alone is false), otherwise it will not be possible for the WaterCoach to alter the systemTime during the game. (Also make sure that you don't have a T0 configured in the global.properties file).

   2. To have a pop-up appear with new messages, vjdbcServicePortRange needs to be configured in Explorer.xml. This same service is also required for the participant mode, and should only be configured for a Stand Alone or a Master application. Note: by specifying this range the vjdbc service is started. This part of the configuration can be kept the same in the live system, but be aware that this means that this service will be started in the live system as well.

      Code Block
      xml xml
      <vjdbcServicePortRange start="40402" end="40402"/>

      
      

   3. Note: this change is no longer required with the embedded WaterCoach: The port number  fewsPiPortNumber for the FEWS PI service has to be in the range of port numbers that must be specified in Explorer.xml . Note: by specifying this range the PI service is started. This part of the configuration can be kept the same in the live system, but be aware that this means that the PI service will be started in the live system as well.

      Code Block
      xml xml
      <piServicePortRange start="50505" end="50505"/>

      
      

2. Note: with some configurations at the start-up of fews via the WaterCoach, the error message 'Fault occurred' may occur. This message can be ignored. 
3. Changes to the global.properties
   1. add key WATERCOACH_SCENARIO_DATABASE_PATH=%REGION_HOME%/WaterCoach
      Note, this is optional, you could also define this location directly in waterCoachDisplay.xml

   2. configure localDatastoreFormat=firebird, since the default 2016.01 database is Dirby

      Info
      Note: the shared database approach for the participant mode is only supported for Firebird at the moment

      
      

4. Create <My_WaterCoachDisplay>.xml in <root_folder>\Config\DisplayConfigFiles\, see configuration example
   If you have an existing application_config.xml, make the following changes:
   
   1. move file to <root_folder>\Config\DisplayConfigFiles\ and rename if you like
   2. replace root element config with root element waterCoachDisplay
   3. add element config
   4. remove elements
      
      1. locale,
      2. fewsExecutable,
      3. fewsRegionDir,
      4. fewsPiPortNumber
   5. move element hideYear under the element scenarioScriptDatabasePath
   6. use key from global.properties to configure scenarioScriptDatabasePath
   7. add element /waterCoachDisplay to the end of the file
5. FEWS configuration file Explorer.xml  in the directory  SystemConfigFiles

   1. Add WaterCoach plugin to Explorer.xml, see the configuration example (Only for the embedded WaterCoach, Delft-FEWS 2016.01 and up).

      Anchor
      watercoachplugin watercoachplugin

      Info
      title loadAtStartup with embedded WaterCoach (Delft-FEWS 2016.01 and up)
      Note: with the embedded WaterCoach (Delft-FEWS 2016.01 and up), it is recommended to use the option loadAtStartup in Explorer.xml set to true, when the script_config.xml makes use of the option dataStart . This is because to be able to change the time in the GUI Delft-FEWS needs to restart. After the restart, only those tasks in Explorer.xml with loadAtStartup=true are started. If this option is set to false for the WaterCoachDisplay, the user will have to manually restart the display, just after she started the WaterCoach mode the first time, which can be confusing.

      
      

6. Optional: Modifiy Delft-Fews layout to start with WaterCoach plugin in the front

   1. Make sure you have configured the WaterCoach plugin in Explorer.xml to loadAtStartup is true (see previous step)

   2. Start Delft-FEWS

   3. Bring WaterCoach plugin window to the front and

   4. select menu -> File -> Save Layout

7. Managing of the logging from WaterCoach

   1. User category name nl.wldelft.fews.gui.plugin.watercoach in Log4jConfig.xml to enter specific rules for logging from WaterCoach.
      See configuration example , in which all debug messages in WaterCoach are suppressed.

...