You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+33-19Lines changed: 33 additions & 19 deletions
Original file line number
Diff line number
Diff line change
@@ -50,30 +50,44 @@ each list element:
50
50
51
51
### slurm.conf
52
52
53
-
`openhpc_slurm_partitions`: Optional. List of one or more slurm partitions, default `[]`. Each partition may contain the following values:
54
-
*`groups`: If there are multiple node groups that make up the partition, a list of group objects can be defined here.
55
-
Otherwise, `groups` can be omitted and the following attributes can be defined in the partition object:
56
-
*`name`: The name of the nodes within this group.
57
-
*`cluster_name`: Optional. An override for the top-level definition `openhpc_cluster_name`.
58
-
*`extra_nodes`: Optional. A list of additional node definitions, e.g. for nodes in this group/partition not controlled by this role. Each item should be a dict, with keys/values as per the ["NODE CONFIGURATION"](https://slurm.schedmd.com/slurm.conf.html#lbAE) docs for slurm.conf. Note the key `NodeName` must be first.
59
-
*`ram_mb`: Optional. The physical RAM available in each node of this group ([slurm.conf](https://slurm.schedmd.com/slurm.conf.html) parameter `RealMemory`) in MiB. This is set using ansible facts if not defined, equivalent to `free --mebi` total * `openhpc_ram_multiplier`.
60
-
*`ram_multiplier`: Optional. An override for the top-level definition `openhpc_ram_multiplier`. Has no effect if `ram_mb` is set.
53
+
`openhpc_nodegroups`: Optional, default `[]`. List of mappings, each defining a
54
+
unique set of homogenous nodes:
55
+
*`name`: Required. Name of node group.
56
+
*`ram_mb`: Optional. The physical RAM available in each node of this group
in MiB. This is set using ansible facts if not defined, equivalent to
59
+
`free --mebi` total * `openhpc_ram_multiplier`.
60
+
*`ram_multiplier`: Optional. An override for the top-level definition
61
+
`openhpc_ram_multiplier`. Has no effect if `ram_mb` is set.
61
62
*`gres`: Optional. List of dicts defining [generic resources](https://slurm.schedmd.com/gres.html). Each dict must define:
62
63
-`conf`: A string with the [resource specification](https://slurm.schedmd.com/slurm.conf.html#OPT_Gres_1) but requiring the format `<name>:<type>:<number>`, e.g. `gpu:A100:2`. Note the `type` is an arbitrary string.
63
64
-`file`: A string with the [File](https://slurm.schedmd.com/gres.conf.html#OPT_File) (path to device(s)) for this resource, e.g. `/dev/nvidia[0-1]` for the above example.
64
-
65
65
Note [GresTypes](https://slurm.schedmd.com/slurm.conf.html#OPT_GresTypes) must be set in `openhpc_config` if this is used.
66
-
67
-
*`default`: Optional. A boolean flag for whether this partion is the default. Valid settings are `YES` and `NO`.
68
-
*`maxtime`: Optional. A partition-specific time limit following the format of [slurm.conf](https://slurm.schedmd.com/slurm.conf.html) parameter `MaxTime`. The default value is
66
+
*`params`: Optional. Mapping of additional parameters and values for
- Hosts in a nodegroup are assumed to be homogenous in terms of processor and memory.
73
+
- Hosts may have arbitrary hostnames, but these should be lowercase to avoid a
74
+
mismatch between inventory and actual hostname.
75
+
- An inventory group may be missing or empty, in which case the node group
76
+
contains no hosts.
77
+
- If the inventory group is not empty the play must contain at least one host.
78
+
This is used to set `Sockets`, `CoresPerSocket`, `ThreadsPerCore` and
79
+
optionally `RealMemory` for the nodegroup.
80
+
81
+
`openhpc_partitions`: Optional, default `[]`. List of mappings, each defining a
82
+
partition. Each partition mapping may contain:
83
+
*`name`: Required. Name of partition.
84
+
*`groups`: Optional. List of nodegroup names. If omitted, the partition name
85
+
is assumed to match a nodegroup name.
86
+
*`default`: Optional. A boolean flag for whether this partion is the default. Valid settings are `YES` and `NO`.
87
+
*`maxtime`: Optional. A partition-specific time limit following the format of [slurm.conf](https://slurm.schedmd.com/slurm.conf.html) parameter `MaxTime`. The default value is
69
88
given by `openhpc_job_maxtime`. The value should be quoted to avoid Ansible conversions.
70
-
*`partition_params`: Optional. Mapping of additional parameters and values for [partition configuration](https://slurm.schedmd.com/slurm.conf.html#SECTION_PARTITION-CONFIGURATION).
71
-
72
-
For each group (if used) or partition any nodes in an ansible inventory group `<cluster_name>_<group_name>` will be added to the group/partition. Note that:
73
-
- Nodes may have arbitrary hostnames but these should be lowercase to avoid a mismatch between inventory and actual hostname.
74
-
- Nodes in a group are assumed to be homogenous in terms of processor and memory.
75
-
- An inventory group may be empty or missing, but if it is not then the play must contain at least one node from it (used to set processor information).
76
-
89
+
*`params`: Optional. Mapping of additional parameters and values for
`openhpc_job_maxtime`: Maximum job time limit, default `'60-0'` (60 days). See [slurm.conf](https://slurm.schedmd.com/slurm.conf.html) parameter `MaxTime` for format. The default is 60 days. The value should be quoted to avoid Ansible conversions.
{%setfirst_host = play_group_hosts | first | mandatory('Inventory group "' ~ inventory_group_name ~ '" contains no hosts in this play - was --limit used?') %}
0 commit comments