slurmctld(8)

1slurmctld(8)                     Slurm Daemon                     slurmctld(8)
2
3
4

NAME

6       slurmctld - The central management daemon of Slurm.
7

SYNOPSIS

9       slurmctld [OPTIONS...]
10

DESCRIPTION

12       slurmctld  is  the  central management daemon of Slurm. It monitors all
13       other Slurm daemons and resources, accepts work (jobs),  and  allocates
14       resources to those jobs. Given the critical functionality of slurmctld,
15       there may be a backup server to assume these  functions  in  the  event
16       that the primary server fails.
17
18       OPTIONS
19
20
21       -c     Clear  all  previous  slurmctld  state from its last checkpoint.
22              With this option, all jobs, including both running  and  queued,
23              and all node states, will be deleted.  Without this option, pre‐
24              viously running jobs will be preserved along with node State  of
25              DOWN, DRAINED and DRAINING nodes and the associated Reason field
26              for those nodes.  NOTE: It is rare you would ever  want  to  use
27              this in production as all jobs will be killed.
28
29
30       -d     Run slurmctld in the background.
31
32       -D     Run slurmctld in the foreground with logging copied to stdout.
33
34       -f <file>
35              Read configuration from the specified file. See NOTES below.
36
37       -h     Help; print a brief summary of command options.
38
39       -i     Ignore  errors  found  while  reading in state files on startup.
40              Warning: Use of this option  will  mean  losing  the  data  that
41              wasn't recovered from the state files.
42
43       -L <file>
44              Write log messages to the specified file.
45
46
47       -n <value>
48              Set  the daemon's nice value to the specified value, typically a
49              negative number.
50
51
52       -r     Recover partial  state  from  last  checkpoint:  jobs  and  node
53              DOWN/DRAIN  state  and  reason  information state.  No partition
54              state is recovered.  This is the default action.
55
56
57       -R     Recover full state from last checkpoint: jobs, node, and  parti‐
58              tion  state.   Without this option, previously running jobs will
59              be preserved along with node State of DOWN, DRAINED and DRAINING
60              nodes  and the associated Reason field for those nodes. No other
61              node or partition state will be preserved.
62
63
64       -v     Verbose operation. Multiple -v's increase verbosity.
65
66       -V     Print version information and exit.
67
68

ENVIRONMENT VARIABLES

70       The following environment variables can be used  to  override  settings
71       compiled into slurmctld.
72
73       SLURM_CONF          The  location of the Slurm configuration file. This
74                           is overridden by explicitly naming a  configuration
75                           file on the command line.
76
77

CORE FILE LOCATION

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

SIGNALS

91       SIGTERM SIGINT
92              slurmctld will shutdown cleanly, saving its current state to the
93              state save directory.
94
95       SIGABRT
96              slurmctld will shutdown cleanly, saving its current  state,  and
97              perform a core dump.
98
99       SIGHUP Reloads  the  slurm  configuration  files,  similar to 'scontrol
100              reconfigure'.
101
102       SIGUSR2
103              Reread the log level from the configs, and then reopen  the  log
104              file.  This should be used when setting up logrotate(8).
105
106       SIGCHLD SIGUSR1 SIGTSTP SIGXCPU SIGQUIT SIGPIPE SIGALRM
107              These signals are explicitly ignored.
108
109

NOTES

111       It  may  be useful to experiment with different slurmctld specific con‐
112       figuration parameters using a distinct configuration file  (e.g.  time‐
113       outs).   However,  this  special configuration file will not be used by
114       the slurmd daemon or the Slurm programs, unless you  specifically  tell
115       each of them to use it. If you desire changing communication ports, the
116       location of the temporary file system,  or  other  parameters  used  by
117       other   Slurm   components,   change  the  common  configuration  file,
118       slurm.conf.
119
120

COPYING

122       Copyright (C) 2002-2007 The Regents of the  University  of  California.
123       Copyright (C) 2008-2010 Lawrence Livermore National Security.  Produced
124       at   Lawrence   Livermore   National   Laboratory   (cf,   DISCLAIMER).
125       CODE-OCEC-09-009. All rights reserved.
126
127       This  file  is  part  of  Slurm,  a  resource  management program.  For
128       details, see <https://slurm.schedmd.com/>.
129
130       Slurm is free software; you can redistribute it and/or modify it  under
131       the  terms  of  the GNU General Public License as published by the Free
132       Software Foundation; either version 2  of  the  License,  or  (at  your
133       option) any later version.
134
135       Slurm  is  distributed  in the hope that it will be useful, but WITHOUT
136       ANY WARRANTY; without even the implied warranty of  MERCHANTABILITY  or
137       FITNESS  FOR  A PARTICULAR PURPOSE.  See the GNU General Public License
138       for more details.
139
140