4254 |
25 Nov 16 |
nicklas |
1 |
<?xml version="1.0" encoding="UTF-8"?> |
4254 |
25 Nov 16 |
nicklas |
2 |
<opengrid> |
4254 |
25 Nov 16 |
nicklas |
3 |
|
4294 |
11 Jan 17 |
nicklas |
4 |
<!-- |
4294 |
11 Jan 17 |
nicklas |
One or more "cluster" tags, each one should define |
5981 |
07 Jul 20 |
nicklas |
a unique user + cluster combination. The |
4294 |
11 Jan 17 |
nicklas |
following attributes are used: |
4294 |
11 Jan 17 |
nicklas |
8 |
|
6688 |
21 Apr 22 |
nicklas |
type: The type of cluster. Valid values are "opengrid", "slurm" and "direct". |
5981 |
07 Jul 20 |
nicklas |
"opengrid" is assumed if no value is specified. |
4294 |
11 Jan 17 |
nicklas |
name: A readable name intended to be used when interfacing with users |
5981 |
07 Jul 20 |
nicklas |
address: Network address or number to the primary cluster host |
4294 |
11 Jan 17 |
nicklas |
port: Port number that accepts SSH connections (optional, default=22) |
4451 |
10 Apr 17 |
nicklas |
fingerprint: The SSH fingerprint. This can be either the MD5 hash formatted |
4451 |
10 Apr 17 |
nicklas |
as 16 two-digit hexadecimal numbers separated with ':' or the SHA-256 |
4451 |
10 Apr 17 |
nicklas |
hash in Base64 encoding. |
5981 |
07 Jul 20 |
nicklas |
user: Username to use when connecting to the cluster |
5981 |
07 Jul 20 |
nicklas |
password: Password to use when connecting to the cluster |
4750 |
16 Apr 18 |
nicklas |
Required unless private-key authentication is enabled (see below). |
4294 |
11 Jan 17 |
nicklas |
20 |
|
4294 |
11 Jan 17 |
nicklas |
Internally, an ID for each cluster is created using the username, |
4294 |
11 Jan 17 |
nicklas |
address and port number (example: smith@server.com:22). The ID can be |
5981 |
07 Jul 20 |
nicklas |
used by other extensions to reference and work with clusters. |
4294 |
11 Jan 17 |
nicklas |
The ID must be unique. |
4294 |
11 Jan 17 |
nicklas |
25 |
--> |
4254 |
25 Nov 16 |
nicklas |
26 |
<cluster |
6688 |
21 Apr 22 |
nicklas |
27 |
type="opengrid|slurm|direct" |
4254 |
25 Nov 16 |
nicklas |
28 |
name="Display name of the host" |
4254 |
25 Nov 16 |
nicklas |
29 |
address="ip-address.to.the.host" |
4254 |
25 Nov 16 |
nicklas |
30 |
port="22" |
4254 |
25 Nov 16 |
nicklas |
31 |
fingerprint="Fingerprint of the public key for this server" |
4254 |
25 Nov 16 |
nicklas |
32 |
user="" |
4294 |
11 Jan 17 |
nicklas |
33 |
password="" |
4254 |
25 Nov 16 |
nicklas |
34 |
> |
4294 |
11 Jan 17 |
nicklas |
35 |
|
4750 |
16 Apr 18 |
nicklas |
<!-- [Optional] |
4750 |
16 Apr 18 |
nicklas |
A path to a private key file to use when connecting to |
5981 |
07 Jul 20 |
nicklas |
the cluster. Takes priority over password-authentication |
4750 |
16 Apr 18 |
nicklas |
if specified. If the private key is password-protected the |
4750 |
16 Apr 18 |
nicklas |
password should be specified. Auto-detection of the key type |
4750 |
16 Apr 18 |
nicklas |
should work in most cases, but a type can be set explictely: |
4750 |
16 Apr 18 |
nicklas |
OpenSSH, OpenSSHv1, PuTTY, PKCS5 or PKCS8 |
4750 |
16 Apr 18 |
nicklas |
43 |
--> |
4750 |
16 Apr 18 |
nicklas |
<!-- <key-file password="" type="">/path/to/.ssh/private/key</key-file> --> |
4750 |
16 Apr 18 |
nicklas |
45 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Required] |
4294 |
11 Jan 17 |
nicklas |
Specify a path that BASE can use to send job scripts and data files |
5981 |
07 Jul 20 |
nicklas |
to/from the cluster. This folder must be accessible using the |
4294 |
11 Jan 17 |
nicklas |
same path from both the controller and all nodes in the cluster. Subfolders |
4294 |
11 Jan 17 |
nicklas |
will be created inside the specified folder and they are NOT automatically |
4294 |
11 Jan 17 |
nicklas |
deleted after jobs has finished. |
4294 |
11 Jan 17 |
nicklas |
52 |
--> |
4254 |
25 Nov 16 |
nicklas |
53 |
<job-folder>/path/to/folder-for-jobs</job-folder> |
4294 |
11 Jan 17 |
nicklas |
54 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
4294 |
11 Jan 17 |
nicklas |
Specify a folder to use for temporary working data. The default |
5981 |
07 Jul 20 |
nicklas |
is to use the folder assigned by the cluster ($TMPDIR). |
4294 |
11 Jan 17 |
nicklas |
This folder is typically deleted once the job has finished. |
4294 |
11 Jan 17 |
nicklas |
59 |
--> |
4352 |
13 Feb 17 |
nicklas |
<!-- <tmp-folder>${TMPDIR}</tmp-folder> --> |
4294 |
11 Jan 17 |
nicklas |
61 |
|
4294 |
11 Jan 17 |
nicklas |
62 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
4294 |
11 Jan 17 |
nicklas |
Specify a folder to use for temporary working data running a job in debug |
4294 |
11 Jan 17 |
nicklas |
mode. The default is to use the 'tmp-folder'. A different folder can |
4294 |
11 Jan 17 |
nicklas |
be specified to avoid the automatic cleanup. |
4294 |
11 Jan 17 |
nicklas |
67 |
--> |
4264 |
14 Dec 16 |
nicklas |
<!-- <tmp-folder-debug></tmp-folder-debug> --> |
4294 |
11 Jan 17 |
nicklas |
69 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
6688 |
21 Apr 22 |
nicklas |
Specify a command to run on the cluster to get the current |
4294 |
11 Jan 17 |
nicklas |
date+time in YYYY-MM-DD hh:mm:ss format. The default setting probably |
4294 |
11 Jan 17 |
nicklas |
works in most cases (date +'%Y-%m-%d %T') |
4294 |
11 Jan 17 |
nicklas |
74 |
--> |
4254 |
25 Nov 16 |
nicklas |
<!-- <date-command></date-command> --> |
4294 |
11 Jan 17 |
nicklas |
76 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
6688 |
21 Apr 22 |
nicklas |
Specify a command to run on the cluster to get information |
4294 |
11 Jan 17 |
nicklas |
about the operating system. This is for informational purposes only |
4294 |
11 Jan 17 |
nicklas |
and can be changed to something else in case this information is |
4294 |
11 Jan 17 |
nicklas |
considered sensitieve. The default value is (uname -srmo). |
4294 |
11 Jan 17 |
nicklas |
82 |
--> |
4257 |
30 Nov 16 |
nicklas |
<!-- <host-info-command></host-info-command> --> |
4294 |
11 Jan 17 |
nicklas |
84 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
6688 |
21 Apr 22 |
nicklas |
Specify a command to run on the cluster to get information |
6688 |
21 Apr 22 |
nicklas |
about the job scheduler software. This is currently for informational |
4294 |
11 Jan 17 |
nicklas |
purposes only, but may be needed for feature-detection in the future. |
6688 |
21 Apr 22 |
nicklas |
The default value is different depending on the cluster type. |
4294 |
11 Jan 17 |
nicklas |
90 |
--> |
4257 |
30 Nov 16 |
nicklas |
<!-- <opengrid-info-command></opengrid-info-command> --> |
4294 |
11 Jan 17 |
nicklas |
92 |
|
4294 |
11 Jan 17 |
nicklas |
<!-- [Optional] |
4294 |
11 Jan 17 |
nicklas |
Specify the external ID of a Job agent that has been defined in BASE. |
4294 |
11 Jan 17 |
nicklas |
The job agent is used as a permission proxy for the cluster definition. |
4294 |
11 Jan 17 |
nicklas |
Only users that have been given USE permission to the job agent are |
4294 |
11 Jan 17 |
nicklas |
allowed to use the cluster. Clusters without a job agent proxy can be |
4294 |
11 Jan 17 |
nicklas |
used by all users. |
4294 |
11 Jan 17 |
nicklas |
99 |
--> |
4255 |
28 Nov 16 |
nicklas |
<!-- <job-agent-id></job-agent-id> --> |
4275 |
19 Dec 16 |
nicklas |
101 |
|
6827 |
31 Aug 22 |
nicklas |
<!-- List of custom options for the cluster. Options are specified --> |
6827 |
31 Aug 22 |
nicklas |
<!-- as key=value where the tag name is used as key and tag contents --> |
6827 |
31 Aug 22 |
nicklas |
<!-- as the value --> |
6827 |
31 Aug 22 |
nicklas |
105 |
<options> |
6827 |
31 Aug 22 |
nicklas |
<!-- Enable this option to disable the use of 'sacct' command to get --> |
6827 |
31 Aug 22 |
nicklas |
<!-- information about finished jobs in Slurm clusters. Instead, a --> |
6827 |
31 Aug 22 |
nicklas |
<!-- custom 'status'-file is used but this may be less reliable. --> |
6827 |
31 Aug 22 |
nicklas |
<!-- <slurm-accounting-disabled>1</slurm-accounting-disabled> --> |
7380 |
18 Oct 23 |
nicklas |
110 |
|
7380 |
18 Oct 23 |
nicklas |
<!-- Enable this option to automatically remove job folders --> |
7380 |
18 Oct 23 |
nicklas |
<!-- that are older than the specified number of DAYS --> |
7380 |
18 Oct 23 |
nicklas |
<!-- auto-remove-job-folders>14</auto-remove-job-folders> --> |
6827 |
31 Aug 22 |
nicklas |
114 |
</options> |
6827 |
31 Aug 22 |
nicklas |
115 |
|
4294 |
11 Jan 17 |
nicklas |
116 |
<!-- |
4294 |
11 Jan 17 |
nicklas |
List of nodes that can be used for some quick actions that is not suitable |
4294 |
11 Jan 17 |
nicklas |
to be executed on the controller node, eg. picard CheckIlluminaDirectory |
4294 |
11 Jan 17 |
nicklas |
The nodes are typically not used by this extension but can be |
4294 |
11 Jan 17 |
nicklas |
programmatically accessed by other extensions. |
4294 |
11 Jan 17 |
nicklas |
121 |
--> |
4275 |
19 Dec 16 |
nicklas |
122 |
<nodes> |
4275 |
19 Dec 16 |
nicklas |
123 |
<node name="name-of-node" /> |
4275 |
19 Dec 16 |
nicklas |
124 |
</nodes> |
4275 |
19 Dec 16 |
nicklas |
125 |
|
4254 |
25 Nov 16 |
nicklas |
126 |
</cluster> |
4254 |
25 Nov 16 |
nicklas |
127 |
</opengrid> |