topology.conf(5)					     Slurm configuration file						  topology.conf(5)

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  vari-
       able. 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  cur-
	      rently 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)

topology.conf 2.0						    March 2009							  topology.conf(5)