15.2. Global (Site, User) Config File Reference¶
This section defines all legal items and values for cylc site and
user config files. See Global (Site, User) Configuration Files for file locations,
intended usage, and how to generate the files using the
cylc get-site-config
command.
As for suite configurations, Jinja2 expressions can be embedded in site and user config files to generate the final result parsed by cylc. Use of Jinja2 in suite configurations is documented in Jinja2.
15.2.1. Top Level Items¶
15.2.1.1. temporary directory¶
A temporary directory is needed by a few cylc commands, and is cleaned
automatically on exit. Leave unset for the default (usually $TMPDIR
).
- type: string (directory path)
- default: (none)
- example:
temporary directory = /tmp/$USER/cylc
15.2.1.2. process pool size¶
Maximum number of concurrent processes used to execute external job submission, event handlers, and job poll and kill commands - see Managing External Command Execution.
- type: integer
- default: 4
15.2.1.3. process pool timeout¶
Interval after which long-running commands in the process pool will be killed - see Managing External Command Execution.
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default: PT10M - note this is set quite high to avoid killing important processes when the system is under load.
15.2.1.4. disable interactive command prompts¶
Commands that intervene in running suites can be made to ask for confirmation before acting. Some find this annoying and ineffective as a safety measure, however, so command prompts are disabled by default.
- type: boolean
- default: True
15.2.1.5. task host select command timeout¶
When a task host in a suite is a shell command string, cylc calls the shell to determine the task host. This call is invoked by the main process, and may cause the suite to hang while waiting for the command to finish. This setting sets a timeout for such a command to ensure that the suite can continue.
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default: PT10S
15.2.2. [task messaging]¶
This section contains configuration items that affect task-to-suite communications.
15.2.2.1. [retry interval][task messaging] ->
retry interval¶
If a send fails, the messaging code will retry after a configured delay interval.
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default: PT5S
15.2.2.2. [maximum number of tries][task messaging] ->
maximum number of tries¶
If successive sends fail, the messaging code will give up after a configured number of tries.
- type: integer
- minimum: 1
- default: 7
15.2.2.3. [connection timeout][task messaging] ->
connection timeout¶
This is the same as the --comms-timeout
option in cylc
commands. Without a timeout remote connections to unresponsive
suites can hang indefinitely (suites suspended with Ctrl-Z for instance).
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default: PT30S
15.2.3. [suite logging]¶
The suite event log, held under the suite run directory, is maintained as a rolling archive. Logs are rolled over (backed up and started anew) when they reach a configurable limit size.
15.2.3.1. [rolling archive length][suite logging] ->
rolling archive length¶
How many rolled logs to retain in the archive.
- type: integer
- minimum: 1
- default: 5
15.2.3.2. maximum size in bytes][suite logging] ->
maximum size in bytes¶
Suite event logs are rolled over when they reach this file size.
- type: integer
- default: 1000000
15.2.4. [documentation]¶
Documentation locations for the cylc doc
command and gcylc
Help menus.
15.2.4.1. [documentation] ->
[[files]]¶
File locations of documentation held locally on the cylc host server.
15.2.4.1.1. [documentation] ->
[[files]] ->
html index¶
File location of the main cylc documentation index.
- type: string
- default:
<cylc-dir>/doc/index.html
15.2.4.1.2. [documentation] ->
[[files]] ->
pdf user guide¶
File location of the cylc User Guide, PDF version.
- type: string
- default:
<cylc-dir>/doc/cug-pdf.pdf
15.2.4.1.3. [documentation] ->
[[files]] ->
multi-page html user guide¶
File location of the cylc User Guide, multi-page HTML version.
- type: string
- default:
<cylc-dir>/doc/html/multi/cug-html.html
15.2.4.1.4. [documentation] ->
[[files]] ->
single-page html user guide¶
File location of the cylc User Guide, single-page HTML version.
- type: string
- default:
<cylc-dir>/doc/html/single/cug-html.html
15.2.4.2. [documentation] ->
[[urls]]¶
Online documentation URLs.
15.2.4.2.1. [documentation] ->
[[urls]] ->
internet homepage¶
URL of the cylc internet homepage, with links to documentation for the latest official release.
- type: string
- default: http://cylc.github.com/cylc/
15.2.4.2.2. [documentation] ->
[[urls]] ->
local index¶
Local intranet URL of the main cylc documentation index.
- type: string
- default: (none)
15.2.5. [document viewers]¶
PDF and HTML viewers can be launched by cylc to view the documentation.
15.2.5.1. [document viewers] ->
pdf¶
Your preferred PDF viewer program.
- type: string
- default: evince
15.2.6. [editors]¶
Choose your favourite text editor for editing suite configurations.
15.2.6.1. [editors] ->
terminal¶
The editor to be invoked by the cylc command line interface.
- type: string
- default:
vim
- examples:
-
terminal = emacs -nw
(emacs non-GUI) -terminal = emacs
(emacs GUI) -terminal = gvim -f
(vim GUI)
15.2.6.2. [editors] ->
gui¶
The editor to be invoked by the cylc GUI.
- type: string
- default:
gvim -f
- examples:
-
gui = emacs
-gui = xterm -e vim
15.2.7. [communication]¶
This section covers options for network communication between cylc clients (suite-connecting commands and guis) servers (running suites). Each suite listens on a dedicated network port, binding on the first available starting at the configured base port.
By default, the communication method is HTTPS secured with HTTP Digest Authentication. If the system does not support SSL, you should configure this section to use HTTP. Cylc will not automatically fall back to HTTP if HTTPS is not available.
15.2.7.1. [communication] ->
method¶
The choice of client-server communication method - currently only HTTPS and HTTP are supported, although others could be developed and plugged in. Cylc defaults to HTTPS if this setting is not explicitly configured.
- type: string
- options: - https - http
- default: https
15.2.7.2. [communication] ->
base port¶
The first port that Cylc is allowed to use. This item (and
maximum number of ports
) is deprecated; please use
run ports
under [suite servers]
instead.
- type: integer
- default:
43001
15.2.7.3. [communication] ->
maximum number of ports¶
This setting (and base port
) is deprecated; please use
run ports
under [suite servers]
instead.
- type: integer
- default:
100
15.2.7.4. [communication] ->
proxies on¶
Enable or disable proxy servers for HTTPS - disabled by default.
- type: boolean
- localhost default: False
15.2.7.5. [communication] ->
options¶
Option flags for the communication method. Currently only ‘SHA1’ is supported for HTTPS, which alters HTTP Digest Auth to use the SHA1 hash algorithm rather than the standard MD5. This is more secure but is also less well supported by third party web clients including web browsers. You may need to add the ‘SHA1’ option if you are running on platforms where MD5 is discouraged (e.g. under FIPS).
- type: string_list
- default:
[]
- options: - SHA1
15.2.8. [monitor]¶
Configurable settings for the command line cylc monitor
tool.
15.2.8.1. [monitor] ->
sort order¶
The sort order for tasks in the monitor view.
- type: string
- options:
- alphanumeric
- definition - the order that tasks appear under
[runtime]
in the suite configuration.
- default: definition
15.2.9. [hosts]¶
The [hosts] section configures some important host-specific settings for the suite host (“localhost”) and remote task hosts.
Note
Remote task behaviour is determined by the site/user config on the suite host, not on the task host.
Suites can specify task hosts that
are not listed here, in which case local settings will be assumed,
with the local home directory path, if present, replaced by
$HOME
in items that configure directory locations.
15.2.9.1. [hosts] ->
[[HOST]]¶
The default task host is the suite host, localhost, with default
values as listed below. Use an explicit [hosts][[localhost]]
section if you need to override the defaults. Localhost settings are
then also used as defaults for other hosts, with the local home
directory path replaced as described above. This applies to items
omitted from an explicit host section, and to hosts that are not listed
at all in the site and user config files. Explicit host sections are only
needed if the automatically modified local defaults are not sufficient.
Host section headings can also be regular expressions to match multiple hostnames.
Note
The general regular expression wildcard
is '.*'
(zero or more of any character), not '*'
.
Hostname matching regular expressions are used as-is in the Python
re.match()
function.
As such they match from the beginning
of the hostname string (as specified in the suite configuration) and they
do not have to match through to the end of the string (use the
string-end matching character '$'
in the expression to force this).
A hierarchy of host match expressions from specific to general can be used because config items are processed in the order specified in the file.
- type: string (hostname or regular expression)
- examples:
-
server1.niwa.co.nz
- explicit host name -server\d.niwa.co.nz
- regular expression
15.2.9.1.1. [hosts] ->
[[HOST]] ->
run directory¶
The top level for suite logs and service files, etc. Can contain
$HOME
or $USER
but not other environment variables (the
item cannot actually be evaluated by the shell on HOST before use, but the
remote home directory is where rsync
and ssh
naturally
land, and the remote username is known by the suite server program).
- type: string (directory path)
- default:
$HOME/cylc-run
- example:
/nfs/data/$USER/cylc-run
15.2.9.1.2. [hosts] ->
[[HOST]] ->
work directory¶
The top level for suite work and share directories. Can contain
$HOME
or $USER
but not other environment variables
(the item cannot actually be evaluated by the shell on HOST before use, but the
remote home directory is where rsync
and ssh
naturally
land, and the remote username is known by the suite server program).
- type: string (directory path)
- localhost default:
$HOME/cylc-run
- example:
/nfs/data/$USER/cylc-run
15.2.9.1.3. [hosts] ->
[[HOST]] ->
task communication method¶
The means by which task progress messages are reported back to the running suite. See above for default polling intervals for the poll method.
- type: string (must be one of the following three options)
- options: - default - direct client-server communication via network ports - ssh - use ssh to re-invoke the messaging commands on the suite server - poll - the suite polls for the status of tasks (no task messaging)
- localhost default: default
15.2.9.1.4. [hosts] ->
[[HOST]] ->
execution polling intervals¶
Cylc can poll running jobs to catch problems that prevent task messages from being sent back to the suite, such as hard job kills, network outages, or unplanned task host shutdown. Routine polling is done only for the polling task communication method (below) unless suite-specific polling is configured in the suite configuration. A list of interval values can be specified, with the last value used repeatedly until the task is finished - this allows more frequent polling near the beginning and end of the anticipated task run time. Multipliers can be used as shorthand as in the example below.
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default:
- example:
execution polling intervals = 5*PT1M, 10*PT5M, 5*PT1M
15.2.9.1.5. [hosts] ->
[[HOST]] ->
submission polling intervals¶
Cylc can also poll submitted jobs to catch problems that prevent the submitted job from executing at all, such as deletion from an external batch scheduler queue. Routine polling is done only for the polling task communication method (above) unless suite-specific polling is configured in the suite configuration. A list of interval values can be specified as for execution polling (above) but a single value is probably sufficient for job submission polling.
- type: ISO 8601 duration/interval representation (e.g.
PT10S
, 10 seconds, orPT1M
, 1 minute). - default:
- example: (see the execution polling example above)
15.2.9.1.6. [hosts] ->
[[HOST]] ->
scp command¶
A string for the command used to copy files to a remote host. This is not used
on the suite host unless you run local tasks under another user account. The
value is assumed to be scp
with some initial options or a command
that implements a similar interface to scp
.
- type: string
- localhost default:
scp -oBatchMode=yes -oConnectTimeout=10
15.2.9.1.7. [hosts] ->
[[HOST]] ->
ssh command¶
A string for the command used to invoke commands on this host. This is not
used on the suite host unless you run local tasks under another user account.
The value is assumed to be ssh
with some initial options or a
command that implements a similar interface to ssh
.
- type: string
- localhost default:
ssh -oBatchMode=yes -oConnectTimeout=10
15.2.9.1.8. [hosts] ->
[[HOST]] ->
use login shell¶
Whether to use a login shell or not for remote command invocation. By default cylc runs remote ssh commands using a login shell:
ssh user@host 'bash --login cylc ...'
which will source /etc/profile
and
~/.profile
to set up the user environment. However, for
security reasons some institutions do not allow unattended commands to
start login shells, so you can turn off this behaviour to get:
ssh user@host 'cylc ...'
which will use the default shell on the remote machine,
sourcing ~/.bashrc
(or ~/.cshrc
) to set up the
environment.
- type: boolean
- localhost default: True
15.2.9.1.9. [hosts] ->
[[HOST]] ->
cylc executable¶
The cylc
executable on a remote host.
Note
This should normally point to the cylc multi-version wrapper
(see User Interfaces) on the host, not bin/cylc
for a specific
installed version.
Specify a full path if cylc
is not in \$PATH
when it is
invoked via ssh
on this host.
- type: string
- localhost default:
cylc
15.2.9.1.10. [hosts] ->
[[HOST]] ->
global init-script¶
If specified, the value of this setting will be inserted to just before the
init-script
section of all job scripts that are to be
submitted to the specified remote host.
- type: string
- localhost default:
""
15.2.9.1.11. [hosts] ->
[[HOST]] ->
copyable environment variables¶
A list containing the names of the environment variables that can and/or need to be copied from the suite server program to a job.
- type: string_list
- localhost default:
[]
15.2.9.1.12. [hosts] ->
[[HOST]] ->
retrieve job logs¶
Global default for the [runtime] -> [[__NAME__]] -> [[[remote]]] -> retrieve job logs setting for the specified host.
15.2.9.1.13. [hosts] ->
[[HOST]] ->
retrieve job logs command¶
If rsync -a
is unavailable or insufficient to retrieve job logs
from a remote host, you can use this setting to specify a suitable command.
- type: string
- default: rsync -a
15.2.9.1.14. [hosts] ->
[[HOST]] ->
retrieve job logs max size¶
Global default for the [runtime] -> [[__NAME__]] -> [[[remote]]] -> retrieve job logs max size setting for the specified host.
15.2.9.1.15. [hosts] ->
[[HOST]] ->
retrieve job logs retry delays¶
Global default for the [runtime] -> [[__NAME__]] -> [[[remote]]] -> retrieve job logs retry delays setting for the specified host.
15.2.9.1.16. [hosts] ->
[[HOST]] ->
task event handler retry delays¶
Host specific default for the [runtime] -> [[__NAME__]] -> [[[events]]] -> handler retry delays setting.
15.2.9.1.17. [hosts] ->
[[HOST]] ->
tail command template¶
A command template (with %(filename)s
substitution) to tail-follow
job logs on HOST, by the GUI log viewer and cylc cat-log
. You are
unlikely to need to override this.
- type: string
- default:
tail -n +1 -F %(filename)s
15.2.9.1.18. [hosts] ->
[[HOST]] ->
[[[batch systems]]]¶
Settings for particular batch systems on HOST. In the subsections below, SYSTEM should be replaced with the cylc batch system handler name that represents the batch system (see [runtime] -> [[__NAME__]] -> [[[job]]] -> batch system).
15.2.9.1.18.1. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
err tailer¶
A command template (with %(job_id)s
substitution) that can be used
to tail-follow the stderr stream of a running job if SYSTEM does
not use the normal log file location while the job is running. This setting
overrides [hosts] -> [[HOST]] -> tail command template above.
- type: string
- default: (none)
- example: For PBS:
[hosts]
[[ myhpc*]]
[[[batch systems]]]
[[[[pbs]]]]
err tailer = qcat -f -e %(job_id)s
out tailer = qcat -f -o %(job_id)s
err viewer = qcat -e %(job_id)s
out viewer = qcat -o %(job_id)s
15.2.9.1.18.2. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
out tailer¶
A command template (with %(job_id)s
substitution) that can be used
to tail-follow the stdout stream of a running job if SYSTEM does
not use the normal log file location while the job is running. This setting
overrides [hosts] -> [[HOST]] -> tail command template above.
- type: string
- default: (none)
- example: see [hosts] -> [[HOST]] -> [[[batch systems]]] -> [[[[SYSTEM]]]] -> err tailer
15.2.9.1.18.3. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
err viewer¶
A command template (with %(job_id)s
substitution) that can be used
to view the stderr stream of a running job if SYSTEM does
not use the normal log file location while the job is running.
- type: string
- default: (none)
- example: see [hosts] -> [[HOST]] -> [[[batch systems]]] -> [[[[SYSTEM]]]] -> err tailer
15.2.9.1.18.4. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
out viewer¶
A command template (with %(job_id)s
substitution) that can be used
to view the stdout stream of a running job if SYSTEM does
not use the normal log file location while the job is running.
- type: string
- default: (none)
- example: see [hosts] -> [[HOST]] -> [[[batch systems]]] -> [[[[SYSTEM]]]] -> err tailer
15.2.9.1.18.5. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
job name length maximum¶
The maximum length for job name acceptable by a batch system on a given host. Currently, this setting is only meaningful for PBS jobs. For example, PBS 12 or older will fail a job submit if the job name has more than 15 characters, which is the default setting. If you have PBS 13 or above, you may want to modify this setting to a larger value.
- type: integer
- default: (none)
- example: For PBS:
[hosts]
[[myhpc*]]
[[[batch systems]]]
[[[[pbs]]]]
# PBS 13
job name length maximum = 236
15.2.9.1.18.6. [hosts] ->
[[HOST]] ->
[[[batch systems]]] ->
[[[[SYSTEM]]]] ->
execution time limit polling intervals¶
The intervals between polling after a task job (submitted to the relevant batch system on the relevant host) exceeds its execution time limit. The default setting is PT1M, PT2M, PT7M. The accumulated times (in minutes) for these intervals will be roughly 1, 1 + 2 = 3 and 1 + 2 + 7 = 10 after a task job exceeds its execution time limit.
- type: Comma-separated list of ISO 8601 duration/interval representations, optionally preceded by multipliers.
- default: PT1M, PT2M, PT7M
- example:
[hosts]
[[myhpc*]]
[[[batch systems]]]
[[[[pbs]]]]
execution time limit polling intervals = 5*PT2M
15.2.10. [suite servers]¶
Configure allowed suite hosts and ports for starting up (running or
restarting) suites and enabling them to be detected whilst running via
utilities such as cylc gscan
. Additionally configure host
selection settings specifying how to determine the most suitable run host at
any given time from those configured.
15.2.10.1. [suite servers] ->
auto restart delay¶
Relates to Cylc’s auto stop-restart mechanism (see Auto Stop-Restart).
When a host is set to automatically shutdown/restart it will first wait a
random period of time between zero and auto restart delay
seconds before beginning the process. This is to prevent large numbers
of suites from restarting simultaneously.
- type: integer
- default:
0
15.2.10.2. [suite servers] ->
condemned hosts¶
Hosts specified in condemned hosts
will not be considered as suite
run hosts. If suites are already running on condemned hosts
they
will be automatically shutdown and restarted (see Auto Stop-Restart).
- type: comma-separated list of host names and/or IP addresses.
- default: (none)
15.2.10.3. [suite servers] ->
run hosts¶
A list of allowed suite run hosts. One of these hosts will be appointed for
a suite to start up on if an explicit host is not provided as an option to
a run
or restart
command.
- type: comma-separated list of host names and/or IP addresses.
- default:
localhost
15.2.10.4. [suite servers] ->
scan hosts¶
A list of hosts to scan for running suites.
- type: comma-separated list of host names and/or IP addresses.
- default:
localhost
15.2.10.5. [suite servers] ->
run ports¶
A list of allowed ports for Cylc to use to run suites.
Note
Only one suite can run per port for a given host, so the length of this list determines the maximum number of suites that can run at once per suite host.
This config item supersedes the deprecated settings base port
and maximum number of ports
, where the base port is equivalent to
the first port, and the maximum number of ports to the length, of this list.
- type: string in the format
X .. Y
forX <= Y
whereX
andY
are integers. - default:
43001 .. 43100
(equivalent to the list43001, 43002, ... , 43099, 43100
)
15.2.10.6. [suite servers] ->
scan ports¶
A list of ports to scan for running suites on each host set in scan hosts.
- type: string in the format
X .. Y
forX <= Y
whereX
andY
are integers. - default:
43001 .. 43100
(equivalent to the list43001, 43002, ... , 43099, 43100
)
15.2.10.7. [suite servers] ->
[[run host select]]¶
Configure thresholds for excluding insufficient hosts and a method for
ranking the remaining hosts to be applied in selection of the most suitable
run host
, from those configured, at start-up whenever a set host
is not specified on the command line via the --host=
option.
15.2.10.7.1. [suite servers] ->
[[run host select]] ->
rank¶
The method to use to rank the run host
list in order of
suitability.
- type: string (which must be one of the options outlined below)
- default:
random
- options:
- random - shuffle the hosts to select a host at random
- load:1 - rank and select for the lowest load average over
1 minute (as given by the
uptime
command) - load:5 - as for
load:1
above, but over 5 minutes - load:15 - as for
load:1
above, but over 15 minutes - memory - rank and select for the highest usable memory i.e.
- free memory plus memory in the buffer cache (‘buffers’) and in the
page cache (‘cache’), as specified under
/proc/meminfo
- disk-space:PATH - rank and select for the highest free disk
- space for a given mount directory path
PATH
as given by thedf
command, where multiple paths may be specified individually i.e. viadisk-space:PATH_1
anddisk-space:PATH_2
, etc.
- default: (none)
15.2.10.7.2. [suite servers] ->
[[run host select]] ->
thresholds¶
A list of thresholds i.e. cutoff values which run hosts must meet in order
to be considered as a possible run host. Each threshold is a minimum or a
maximum requirement depending on the context of the measure; usable
memory (memory
) and free disk space
(disk-space:PATH
) threshold values set a minimum value,
which must be exceeded, whereas load average (load:1
,
load:5
and load:15
) threshold values set a
maximum, which must not be. Failure to meet a threshold results in
exclusion from the list of hosts that undergo ranking to
determine the best host which becomes the run host.
- type: string in format
MEASURE_1 CUTOFF_1; ... ;MEASURE_n CUTOFF_n
(etc), where eachMEASURE_N
is one of the options below (note these correspond to all the rank methods accepted under the rank setting except forrandom
which does not make sense as a threshold measure). Spaces delimit corresponding measures and their values, while semi-colons (optionally with subsequent spaces) delimit each measure-value pair. - options:
- load:1 - load average over 1 minute (as given by
the
uptime
command) - load:5 - as for
load:1
above, but over 5 minutes - load:15 - as for
load:1
above, but over 15 minutes - memory - usable memory i.e. free memory plus memory in the
buffer cache (‘buffers’) and in the page cache (‘cache’), in KB, as
specified under
/proc/meminfo
- disk-space:PATH - free disk space for a given mount
directory path
PATH
, in KB, as given by thedf
command, where multiple paths may be specified individually i.e. viadisk-space:PATH_1
anddisk-space:PATH_2
, etc.
- load:1 - load average over 1 minute (as given by
the
- default: (none)
- examples:
thresholds = memory 2000
(set a minimum of 2000 KB in usable memory for possible run hosts)thresholds = load:5 0.5; load:15 1.0; disk-space:/ 5000
(set a maximum of 0.5 and 1.0 for load averages over 5 and 15 minutes respectively and a minimum of 5000 KB of free disk-space on the/
mount directory. If any of these thresholds are not met by a host, it will be excluded for running a suite on.)
15.2.11. [suite host self-identification]¶
The suite host’s identity must be determined locally by cylc and passed
to running tasks (via $CYLC_SUITE_HOST
) so that task messages
can target the right suite on the right host.
15.2.11.1. [suite host self-identification] ->
method¶
This item determines how cylc finds the identity of the suite host. For
the default name method cylc asks the suite host for its host
name. This should resolve on remote task hosts to the IP address of the
suite host; if it doesn’t, adjust network settings or use one of the
other methods. For the address method, cylc attempts to use a
special external “target address” to determine the IP address of the
suite host as seen by remote task hosts (in-source documentation in
<cylc-dir>/lib/cylc/hostuserutil.py
explains how this works).
And finally, as a last resort, you can choose the hardwired method
and manually specify the host name or IP address of the suite host.
- type: string
- options:
- name - self-identified host name
- address - automatically determined IP address (requires target, below)
- hardwired - manually specified host name or IP address (requires host, below)
- default: name
15.2.11.2. [suite host self-identification] ->
target¶
This item is required for the address self-identification method.
If your suite host sees the internet, a common address such as
google.com
will do; otherwise choose a host visible on your
intranet.
- type: string (an inter- or intranet URL visible from the suite host)
- default:
google.com
15.2.11.3. [suite host self-identification] ->
host¶
Use this item to explicitly set the name or IP address of the suite host if you have to use the hardwired self-identification method.
- type: string (host name or IP address)
- default: (none)
15.2.12. [task events]¶
Global site/user defaults for [runtime] -> [[__NAME__]] -> [[[events]]].
15.2.13. [test battery]¶
Settings for the automated development tests.
Note
The test battery reads
<cylc-dir>/etc/global-tests.rc
instead of the normal site/user
global config files.
15.2.13.2. [test battery] ->
remote host¶
Host name of a remote account that does not see the same home directory as the account running the test battery - see also “remote owner” below).
15.2.13.3. [test battery] ->
remote owner¶
User name of a remote account that does not see the same home directory as the account running the test battery - see also “remote host” above).
15.2.13.4. [test battery] ->
[[batch systems]]¶
Settings for testing supported batch systems (job submission methods). The tests for a batch system are only performed if the batch system is available on the test host or a remote host accessible via SSH from the test host.
15.2.13.4.1. [test battery] ->
[[batch systems]] ->
[[[SYSTEM]]]¶
SYSTEM is the name of a supported batch system with automated tests. This can currently be “loadleveler”, “lsf”, “pbs”, “sge” and/or “slurm”.
15.2.13.4.1.1. [test battery] ->
[[batch systems]] ->
[[[SYSTEM]]] ->
host¶
The name of a host where commands for this batch system is available. Use “localhost” if the batch system is available on the host running the test battery. Any specified remote host should be accessible via SSH from the host running the test battery.
15.2.13.4.1.2. [test battery] ->
[[batch systems]] ->
[[[SYSTEM]]] ->
err viewer¶
The command template (with \%(job_id)s
substitution) for testing
the run time stderr viewer functionality for this batch system.
15.2.13.4.1.3. [test battery] ->
[[batch systems]] ->
[[[SYSTEM]]] ->
out viewer¶
The command template (with \%(job_id)s
substitution) for testing
the run time stdout viewer functionality for this batch system.
15.2.13.4.1.4. [test battery] ->
[[batch systems]] ->
[[[SYSTEM]]] ->
[[[[directives]]]]¶
The minimum set of directives that must be supplied to the batch system on the site to initiate jobs for the tests.
15.2.14. [cylc]¶
Default values for entries in the suite.rc [cylc]
section.
15.2.14.1. [cylc] ->
UTC mode¶
Allows you to set a default value for UTC mode in a suite at the site level. See [cylc] -> UTC mode for details.
15.2.14.2. [cylc] ->
health check interval¶
Site default suite health check interval. See [cylc] -> health check interval for details.
15.2.14.3. [cylc] ->
task event mail interval¶
Site default task event mail interval. See [cylc] -> task event mail interval for details.
15.2.14.4. [cylc] ->
[[events]]¶
You can define site defaults for each of the following options, details of which can be found under [cylc] -> [[events]]:
15.2.14.4.1. [cylc] ->
[[events]] ->
handlers¶
15.2.14.4.2. [cylc] ->
[[events]] ->
handler events¶
15.2.14.4.3. [cylc] ->
[[events]] ->
startup handler¶
15.2.14.4.4. [cylc] ->
[[events]] ->
shutdown handler¶
15.2.14.4.5. [cylc] ->
[[events]] ->
aborted handler¶
15.2.14.4.6. [cylc] ->
[[events]] ->
mail events¶
15.2.14.4.8. [cylc] ->
[[events]] ->
mail from¶
15.2.14.4.9. [cylc] ->
[[events]] ->
mail smtp¶
15.2.14.4.10. [cylc] ->
[[events]] ->
mail to¶
15.2.14.4.11. [cylc] ->
[[events]] ->
timeout handler¶
15.2.14.4.12. [cylc] ->
[[events]] ->
timeout¶
15.2.14.4.13. [cylc] ->
[[events]] ->
abort on timeout¶
15.2.14.4.14. [cylc] ->
[[events]] ->
stalled handler¶
15.2.14.4.15. [cylc] ->
[[events]] ->
abort on stalled¶
15.2.14.4.16. [cylc] ->
[[events]] ->
inactivity handler¶
15.2.14.4.17. [cylc] ->
[[events]] ->
inactivity¶
15.2.14.4.18. [cylc] ->
[[events]] ->
abort on inactivity¶
15.2.15. [authentication]¶
Authentication of client programs with suite server programs can be configured here, and overridden in suites if necessary (see [cylc] -> [[authentication]]).
The suite-specific passphrase must be installed on a user’s account to authorize full control privileges (see Suite Passphrases and Client-Server Interaction). In the future we plan to move to a more traditional user account model so that each authorized user can have their own password.
15.2.15.1. [authentication] ->
public¶
This sets the client privilege level for public access - i.e. no suite passphrase required.
- type: string (must be one of the following options)
- options:
- identity - only suite and owner names revealed
- description - identity plus suite title and description
- state-totals - identity, description, and task state totals
- full-read - full read-only access for monitor and GUI
- shutdown - full read access plus shutdown, but no other control.
- default: state-totals