Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
topology.conf(5)	   Slurm Configuration File	      topology.conf(5)

NAME
       topology.conf  -	 Slurm	configuration  file  for  defining the network
       topology

PREREQUISITES
       Topology.conf can only represent	a hierarchical network.	All  nodes  in
       the  network must be connected to at least one switch. The network must
       be fully	connected to use a RoutePlugin.	Jobs can only span nodes  con-
       nected  by  the	same  switch  fabric, even if there are	available idle
       nodes.

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.   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 line defining a switch name and
       its children, either node names or switch names.	 Slurm's hostlist  ex-
       pression	 parser	is used, so the	node and switch	names need not be con-
       secutive	(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  topology.conf  file	 for an	Infiniband switch can be automatically
       generated    using    the    slurmibtopology    tool    found	 here:
       <https://ftp.fysik.dtu.dk/Slurm/slurmibtopology.sh>.

       The overall configuration parameters available include:

       SwitchName
	      The  name	 of a switch. This name	is internal to Slurm and arbi-
	      trary.  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 communica-
	      tion 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).
       Copyright (C) 2010-2013 SchedMD LLC.

       This  file  is  part  of	Slurm, a resource management program.  For de-
       tails, see <https://slurm.schedmd.com/>.

       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  op-
       tion) 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)

April 2015		   Slurm Configuration File	      topology.conf(5)

NAME | PREREQUISITES | DESCRIPTION | EXAMPLE | COPYING | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=topology.conf&sektion=5&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help