Configuration
The Source Cloud . 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 Source.Web 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
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 |
.Source Cloud settings filepaths, back slashes, "\", must be escaped with an additional back slash, i.e. "\\". |
Agent Settings file (inside Agent folder):
| Code Block |
|---|
| language | java |
|---|
| title | Source Cloud Agent appsettings.json |
|---|
|
{
"BaseUrlPollingPeriodMs": "http://localhost:505110000",
"MaxLocalAgentsSourceDirectory": "C:\\eWater\\Source\\4.9.0.9947\\",
"LocalAgentExeAdditionalPlugins": [
"..Plugins\\AgentCommunityPlugins\\SourceCloudAgentSourcePlugin.SubSource.exedll",
"TimeseriesCycleCreatorExe": "..Plugins\\..UrbanDeveloper\\TimeseriesCycleCreator\\TimeseriesCycleCreator.exe"
}
|
- 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 |
|---|
| language | java |
|---|
| title | Agent 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
Launch Local Cloud
Launch the Local Cloud application by SourceCloud.exe, which is located in the /SourceCloud directory. This will launch the Local Cloud application in your default web browser.
| Warning |
|---|
Your web browser may cache old versions of the Source Cloud ["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, located in the Run Manager 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 |
|---|
If you have used a previous version of eWater Run Manager your web browser may cache the old version of 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 Source Cloud 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.