Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Edit through the REST API

The Run Manager is accessed via a web browser interface regardless of whether it is installed as a local application or accessed on the cloud. It is optimised for use with Google Chrome.

Cloud Application

For authorised users, the Run Manager Cloud application can be accessed by visiting https://runmanager.ewater.org.au/ via your web browser.

To use the Run Manager Cloud, you must log in. This will occur automatically if you are logged in to eWater's Toolkit in your web browser. If not, you must log in manually using your Toolkit credentials (see Profile).

Info

The Run Manager Cloud Application is currently configured to use multiple verisons of Source and has two plugins available:

  • UrbanDeveloper
  • SubSource

Before running a project on Run Manager it is always recommended to save the projects using a supported version to avoid needing to upgrade the project during the run. This is particularly important for any of the multi-run jobs.

Contents

Table of Contents
maxLevel3
excludeContents

Local Application

Installation

Local installation of eWater Run Manager requires the following additional software to be installed:

  • eWater Source version 4.
5
Core 2

eWater Run Manager is distributed as a ZIP file that should be extracted to your local drive.

Contents

Table of Contents
maxLevel3
excludeContents

It's now available as a toolkit product: https://toolkit.ewater.org.au/Tools/Run Manager 

Configuration

The eWater Run Manager application contains a number of sub-directories. Two of these, the Agent and Run Manager sub-directories, contain configuration files called appSettings.json. These files can be opened in a text editor and allow you to configure the Source Cloud Run Manager settings. Generally, the only setting that
The default settings are already configured for local use, however the user will need to modify is specify or review the eWater Source installation directory , which is located setting. This setting is the SourceDirectory setting in the Agent's appSettings.json configuration file. Generally, all other settings should be left at their default values. The Run Manager will need to be restarted for configuration changes to take effect.

Warning

When entering file paths, back slashes, "\", must be escaped with an additional back slash, i.e.

eWater Run Manager settings file

"\\".

Agent Settings file (inside Agent folder):

Code Block
languagejava
titleeWater Run Manager Agent appsettings.json
{
  "BaseUrlPollingPeriodMs": "http://localhost:505110000",
   "MaxLocalAgentsSourceDirectory": "C:\\eWater\\Source\\4.9.0.9947\\",
  "TimeseriesCycleCreatorExeAdditionalPlugins": "..[
    "Plugins\\CommunityPlugins\\SourcePlugin.SubSource.dll",
    "Plugins\\TimeseriesCycleCreatorUrbanDeveloper\\TimeseriesCycleCreatorUrbanDeveloper.exedll"
 }
  • BaseUrl - The browseable URL for the local version of Source Cloud
  • MaxLocalAgents - The maximum number of Source instances to be running for a given job
  • TimeseriesCycleCreatorExe - The location of the executable for the TSCC
Agent Settings file
 ]
}
  • PollingPeriodMs - How often an agent will poll the server requesting a job/task
  • SourceDirectory - The directory containing the version of Source to run
  • AdditionalPlugins - List of plugins to be loaded by the Source when running jobs; paths should be relative to the SourceDirectory path

eWater Run Manager settings file (inside Run Manager folder):

Code Block
languagejava
titleAgent eWater Run Manager appsettings.json
{
  "PollingPeriodMsBaseUrl": "10000http://localhost:5051",
  "ServerBaseUrlLaunchBrowserOnStart": "http://localhost:5051"true,
  "SourceDirectoryAgentEndpoints": "C:\\Source\\Source_4.5.0.7410\\"
}
  • PollingPeriodMs - How often agent will poll the server requesting for a job/task
  • ServerBaseUrl - The URL to contact the server on
  • SourceDirectory - The directory containing the version of Source to run Back slashes must be escaped with a double slash (\\)
Launch eWater
["Local"]
}
  • BaseUrl - The browsable URL for the local version of Source Cloud
  • LaunchBrowserOnStart - Whether to open the Run Manager web application in your default web browser when "Source.Web.exe" starts
  • AgentEndpoints - Use Local agents

Launching eWater Run Manager

Launch the eWater Run Manager application by executing Source.Web.exe, which is located in the /Run Manager directory. This folder. If the LaunchBrowserOnStart setting is true this will launch the local eWater Run Manager application in your default web browser. Otherwise open a web browser and open the URL specified in the BaseUrl setting, default is "http://localhost:5051".

Warning

Your If you have used a previous version of eWater Run Manager your web browser may cache the old versions version of the eWater Run Manager the website and fail to update when you run a new version. To ensure that this does not happen, always refresh the version displayed you will need to do a 'hard refresh' on the eWater Run Manager webpage after installing starting a new version. In Firefox and Chrome, the default shortcut for a hard refresh is Ctrl -F5+ F5.

Shutting down eWater Run Manager

When Run Manager is started by executing Source.Web.exe a commandline window will be opened which displays various logging information. If you need to close Run Manager you should not simply close the commandline window as this will not close all processes. Instead, use the Shut Down eWater Run Manager button on the options page.