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

FreeBSD Manual Pages

  
 
  

home | help
slurmctld(8)			 Slurm Daemon			  slurmctld(8)

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,  pre-
	      viously  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. This is the default behavior.

       -D     Run  slurmctld  in the foreground	with logging copied to stdout.
	      This limits the resilience of 'scontrol reconfigure' and	should
	      be avoided in production.

       -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,  partition
	      state, and power save settings.  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 Slurm's StateSaveLocation otherwise. If  both
	      of them fail it will fallback to /var/tmp.

       --systemd
	      Use  when	 starting  the	daemon	with  systemd. This will allow
	      slurmctld	to notify systemd of the new PID when using  'scontrol
	      reconfigure'.

       -v     Verbose  operation. Multiple v's can be specified, with each 'v'
	      beyond the first increasing  verbosity,  up  to  6  times	 (i.e.
	      -vvvvvv).

       -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.

       SLURM_DEBUG_FLAGS   Specify debug flags for the scheduler to  use.  See
			   DebugFlags in the slurm.conf(5) man page for	a full
			   list	 of  flags.  The  environment  variable	 takes
			   precedence over the setting in the slurm.conf.

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 SlurmctldLog-
       File 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.

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 re-
	      configure'.

       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 con-
       figuration parameters using a distinct configuration file  (e.g.	 time-
       outs). 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  lo-
       cation  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.	 Copy-
       right (C) 2010-2022 SchedMD LLC.	 Produced at  Lawrence	Livermore  Na-
       tional  Laboratory  (cf,	DISCLAIMER).  CODE-OCEC-09-009.	All rights re-
       served.

       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), slurmd(8)

February 2024			 Slurm Daemon			  slurmctld(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=slurmctld&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help