1slurmctld(8) Slurm Daemon slurmctld(8)
2
6 slurmctld - The central management daemon of Slurm.
7
9 slurmctld [OPTIONS...]
10
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
20 -c Clear all previous slurmctld state from its last checkpoint.
21 With this option, all jobs, including both running and queued,
22 and all node states, will be deleted. Without this option, pre‐
23 viously running jobs will be preserved along with node State of
24 DOWN, DRAINED and DRAINING nodes and the associated Reason field
25 for those nodes. NOTE: It is rare you would ever want to use
26 this in production as all jobs will be killed.
27 -d Run slurmctld in the background.
29 -D Run slurmctld in the foreground with logging copied to stdout.
31 -f <file>
33 Read configuration from the specified file. See NOTES below.
34 -h Help; print a brief summary of command options.
36 -i Ignore errors found while reading in state files on startup.
38 Warning: Use of this option will mean losing the data that
39 wasn't recovered from the state files.
40 -L <file>
42 Write log messages to the specified file.
43 -n <value>
45 Set the daemon's nice value to the specified value, typically a
46 negative number.
47 -r Recover partial state from last checkpoint: jobs and node
49 DOWN/DRAIN state and reason information state. No partition
50 state is recovered. This is the default action.
51 -R Recover full state from last checkpoint: jobs, node, and parti‐
53 tion state. Without this option, previously running jobs will
54 be preserved along with node State of DOWN, DRAINED and DRAINING
55 nodes and the associated Reason field for those nodes. No other
56 node or partition state will be preserved.
57 -s Change working directory of slurmctld to SlurmctldLogFile path
59 if possible, or to SlurmStateSaveLocation otherwise. If both of
60 them fail it will fallback to /var/tmp.
61 -v Verbose operation. Multiple -v's increase verbosity.
63 -V Print version information and exit.
65
67 The following environment variables can be used to override settings
68 compiled into slurmctld.
69 SLURM_CONF The location of the Slurm configuration file. This
72 is overridden by explicitly naming a configuration
73 file on the command line.
74 SLURM_DEBUG_FLAGS Specify debug flags for the scheduler to use. See
76 DebugFlags in the slurm.conf(5) man page for a full
77 list of flags. The environment variable takes
78 precedence over the setting in the slurm.conf.
79
81 If slurmctld is started with the -D option then the core file will be
82 written to the current working directory. Otherwise if SlurmctldLog‐
83 File is a fully qualified path name (starting with a slash), the core
84 file will be written to the same directory as the log file, provided
85 SlurmUser has write permission on the directory. Otherwise the core
86 file will be written to the StateSaveLocation, or "/var/tmp/" as a last
87 resort. If none of the above directories have write permission for
88 SlurmUser, no core file will be produced. The command "scontrol abort"
89 can be used to abort the slurmctld daemon and generate a core file.
90
93 SIGTERM SIGINT
94 slurmctld will shutdown cleanly, saving its current state to the
95 state save directory.
96 SIGABRT
98 slurmctld will shutdown cleanly, saving its current state, and
99 perform a core dump.
100 SIGHUP Reloads the slurm configuration files, similar to 'scontrol re‐
102 configure'.
103 SIGUSR2
105 Reread the log level from the configs, and then reopen the log
106 file. This should be used when setting up logrotate(8).
107 SIGCHLD SIGUSR1 SIGTSTP SIGXCPU SIGQUIT SIGPIPE SIGALRM
109 These signals are explicitly ignored.
110
112 It may be useful to experiment with different slurmctld specific con‐
113 figuration parameters using a distinct configuration file (e.g. time‐
114 outs). However, this special configuration file will not be used by
115 the slurmd daemon or the Slurm programs, unless you specifically tell
116 each of them to use it. If you desire changing communication ports, the
117 location of the temporary file system, or other parameters used by
118 other Slurm components, change the common configuration file,
119 slurm.conf.
120
123 Copyright (C) 2002-2007 The Regents of the University of California.
124 Copyright (C) 2008-2010 Lawrence Livermore National Security. Copy‐
125 right (C) 2010-2022 SchedMD LLC. Produced at Lawrence Livermore Na‐
126 tional Laboratory (cf, DISCLAIMER). CODE-OCEC-09-009. All rights re‐
127 served.
128 This file is part of Slurm, a resource management program. For de‐
130 tails, see <https://slurm.schedmd.com/>.
131 Slurm is free software; you can redistribute it and/or modify it under
133 the terms of the GNU General Public License as published by the Free
134 Software Foundation; either version 2 of the License, or (at your op‐
135 tion) any later version.
136 Slurm is distributed in the hope that it will be useful, but WITHOUT
138 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
139 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
140 for more details.
141
144 slurm.conf(5), slurmd(8)
145August 2022 Slurm Daemon slurmctld(8)