The distributed compute relies on Apache Ignite and a few jars developed by RMA to manage the interaction of HEC-WAT with the ignite capabilities. Similar to the Controller node, all of the distributed compute dependencies need to live in "C:\Programs\DC"

The following files and jars as part of the download package are described below.

default-config.xml

This xml file contains the details of how the ignite grid will function. There are many variations that can be placed in this xml file. This file is located in "C:\Programs\HEC-WAT\HEC-WAT\ignite". A few important settings that are important for the user to note:

  • The port the compute nodes listen on and the controller broadcasts on.  The port number must be the same as the Controller node.  (Line 60)
  • The working directory for the models.  Similar to the controller node, your HEC-WAT project needs to be staged here.  ("\DCWorkingDir" on Line 71)

Default-config.xml Important Settings

computenode.bat

The computenode.bat is stored in "C:\Programs\HEC-WAT\HEC-WAT\ignite" and launches the ignite compute node that communicates back with the distributed compute controller.  Take note where the Ignite home, WAT home, and Java home path names are located and make sure the DC package and HEC-WAT installation properly matches.  If you are following the installation location, these lines should not need to be edited.

WAT home

By default the WAT home variable is set to C:\Programs\HEC-WAT\HEC-WAT, therefore HEC-WAT must be in that location with no version number in the folder. We recommend not changing this variable. If you do, ensure your folder structure matches the variable path.

dcmerge.jar

The dcmerge.jar merges simulated results from the compute nodes after simulation completes.  It is placed in "C:\Programs\DC\Plugin".  No edits need to be performed.

gridgaincompute.jar

The gridgaincompute.jar manages the integration of ignite and HEC-WAT dependencies. It is developed as a plugin in HEC-WAT that adds the necessary UI components to start a distributed compute and to manage the compute. It needs to be placed in "C:\Programs\DC\Plugin".  No edits to the file are needed.

rmiServer.jar

The rmiServer.jar manages the communication across processes using Remote invocation (RMI).  It is placed in "C:\Programs\DC\RMI".  No edits need to be performed.

Ignite Compute Node Resource files

The ignite package for the compute node needs to be placed in "C:\Programs\HEC-WAT\HEC-WAT" it will contain all of the ignite jars necessary to find the compute nodes. It also stores the JDK appropriate for the version of the ignite resources. This will be done automatically once the Overlay-WAT1.1.7z is placed.