NAME

       slurmctld - The central management daemon of Slurm.

SYNOPSIS

       slurmctld [OPTIONS...]

DESCRIPTION

       slurmctld  is  the central management daemon of Slurm. It monitors all other Slurm daemons and resources,
       accepts work (jobs), and  allocates  resources  to  those  jobs.  Given  the  critical  functionality  of
       slurmctld,  there  may  be a backup server to assume these functions in the event that the primary server
       fails.

OPTIONS

       -c     Clear all previous slurmctld state  from  its  last  checkpoint.   With  this  option,  all  jobs,
              including  both  running  and  queued, and all node states, will be deleted.  Without this option,
              previously running jobs will be preserved along with node State  of  DOWN,  DRAINED  and  DRAINING
              nodes  and  the  associated Reason field for those nodes.  NOTE: It is rare you would ever want to
              use this in production as all jobs will be killed.

       -d     Run slurmctld in the background.

       -D     Run slurmctld in the foreground with logging copied to stdout.

       -f <file>
              Read configuration from the specified file. See NOTES below.

       -h     Help; print a brief summary of command options.

       -i     Ignore errors found while reading in state files on startup.  Warning: Use  of  this  option  will
              mean losing the data that wasn't recovered from the state files.

       -L <file>
              Write log messages to the specified file.

       -n <value>
              Set the daemon's nice value to the specified value, typically a negative number.

       -r     Recover  partial state from last checkpoint: jobs and node DOWN/DRAIN state and reason information
              state.  No partition state is recovered.  This is the default action.

       -R     Recover full state from last checkpoint: jobs, node, and partition state.   Without  this  option,
              previously  running  jobs  will  be  preserved along with node State of DOWN, DRAINED and DRAINING
              nodes and the associated Reason field for those nodes. No other node or partition  state  will  be
              preserved.

       -s     Change   working   directory   of   slurmctld   to   SlurmctldLogFile  path  if  possible,  or  to
              SlurmStateSaveLocation otherwise. If both of them fail it will fallback to /var/tmp.

       -v     Verbose operation. Multiple -v's increase verbosity.

       -V     Print version information and exit.

ENVIRONMENT VARIABLES

       The following environment variables can be used to override settings compiled into slurmctld.

       SLURM_CONF          The location of the Slurm configuration file. This is overridden by explicitly naming
                           a configuration file on the command line.

CORE FILE LOCATION

       If  slurmctld  is  started  with  the -D option then the core file will be written to the current working
       directory.  Otherwise if SlurmctldLogFile is a fully qualified path name (starting  with  a  slash),  the
       core  file will be written to the same directory as the log file, provided SlurmUser has write permission
       on the directory.  Otherwise the core file will be written to the StateSaveLocation, or "/var/tmp/" as  a
       last  resort.  If none of the above directories have write permission for SlurmUser, no core file will be
       produced.  The command "scontrol abort" can be used to abort the slurmctld daemon  and  generate  a  core
       file.

SIGNALS

       SIGTERM SIGINT
              slurmctld will shutdown cleanly, saving its current state to the state save directory.

       SIGABRT
              slurmctld will shutdown cleanly, saving its current state, and perform a core dump.

       SIGHUP Reloads the slurm configuration files, similar to 'scontrol reconfigure'.

       SIGUSR2
              Reread  the  log  level  from the configs, and then reopen the log file.  This should be used when
              setting up logrotate(8).

       SIGCHLD SIGUSR1 SIGTSTP SIGXCPU SIGQUIT SIGPIPE SIGALRM
              These signals are explicitly ignored.

NOTES

       It may be useful to experiment  with  different  slurmctld  specific  configuration  parameters  using  a
       distinct  configuration  file (e.g. timeouts).  However, this special configuration file will not be used
       by the slurmd daemon or the Slurm programs, unless you specifically tell each of them to use it.  If  you
       desire  changing communication ports, the location of the temporary file system, or other parameters used
       by other Slurm components, change the common configuration file, slurm.conf.

COPYING

       Copyright (C) 2002-2007 The Regents of the University of California.  Copyright  (C)  2008-2010  Lawrence
       Livermore  National  Security.   Copyright  (C)  2010-2021  SchedMD  LLC.  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://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
       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), slurmd(8)