NAME¶
topology.conf - Slurm configuration file for defining the network topology
DESCRIPTION¶
topology.conf is an ASCII file which describes the cluster's network
topology for optimized job resource allocation. The file location can be
modified at system build time using the DEFAULT_SLURM_CONF parameter or at
execution time by setting the SLURM_CONF environment variable. The file will
always be located in the same directory as the
slurm.conf file.
Parameter names are case insensitive. Any text following a "#" in the
configuration file is treated as a comment through the end of that line. The
size of each line in the file is limited to 1024 characters. Changes to the
configuration file take effect upon restart of SLURM daemons, daemon receipt
of the SIGHUP signal, or execution of the command "scontrol
reconfigure" unless otherwise noted.
The network topology configuration one one line defining a switch name and its
children, either node names or switch names. SLURM's hostlist expression
parser is used, so the node and switch names need not be consecutive (e.g.
"Nodes=tux[0-3,12,18-20]" and "Switches=s[0-2,4-8,12]"
will parse fine). An optional link speed may also be specified.
The overall configuration parameters available include:
- SwitchName
- The name of a switch. This name is internal to SLURM and
arbitrary. Each switch should have a unique name. This field must be
specified.
- Switches
- Child switches of the named switch. Either this option or
the Nodes option must be specified.
- Nodes
- Child Nodes of the named leaf switch. Either this option or
the Switches option must be specified.
- LinkSpeed
- An optional value specifying the performance of this
communication link. The units used are arbitrary and this information is
currently not used. It may be used in the future to optimize resource
allocations.
EXAMPLE¶
##################################################################
# SLURM's network topology configuration file for use with the
# topology/tree plugin
##################################################################
SwitchName=s0 Nodes=dev[0-5]
SwitchName=s1 Nodes=dev[6-11]
SwitchName=s2 Nodes=dev[12-17]
SwitchName=s3 Switches=s[0-2]
COPYING¶
Copyright (C) 2009 Lawrence Livermore National Security. Produced at Lawrence
Livermore National Laboratory (cf, DISCLAIMER). CODE-OCEC-09-009. All rights
reserved.
This file is part of SLURM, a resource management program. For details, see
<
http://www.schedmd.com/slurmdocs/>.
SLURM is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.
SLURM is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.
SEE ALSO¶
slurm.conf(5)