Man Linux: Main Page and Category List

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.

SEE ALSO

       slurm.conf(5)