topology.conf(5)
NAME
topology.conf - Slurm configuration file for defining the network
topology
DESCRIPTION
/etc/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. 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 "Swithces=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 <https://computing.llnl.gov/linux/slurm/>.
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.