DOKK / manpages / debian 12 / slurmrestd / slurmrestd.8.en
slurmrestd(8) Slurm REST Daemon slurmrestd(8)

slurmrestd - Interface to Slurm via REST API.

slurmrestd [OPTIONS...] <[host]:port|unix:/path/to/socket>...

slurmrestd is REST API interface for Slurm. It can be used in two modes:

Inetd Mode: slurmrestd will read and write to STDIO. If STDIN is a socket file descriptor, then slurmrestd will detect this and use relevant functionatlity. If a controlling TTY is detected, interactive mode will automatically activate to provide additional logging information. This mode is designed to work with piped input, inetd, xinetd or systemd socket activation.

Listen Mode: slurmrestd will open a listening socket on each requested host:port pair or UNIX socket.

[host]:port
Hostname and port to listen against. host may be an IPv4/IPv6 IP or a resolvable hostname. Hostnames are only looked up at startup and do not change for the life of the process. host is optional; if not provided, slurmrestd will listen on all network interfaces.

Listen on local UNIX socket. Must have permission to create socket in filesystem.

Comma-delimited list of authentication plugins to load. Default behavior is to load all REST authentication plugins found at load time.
Display a list of the possible plugins to load.

Allows authentication via UNIX sockets when auth/munge is active.
NOTE: slurmrestd and client processes must run under the same UID or the client requests will be rejected.

Allows authentication via TCP and UNIX sockets when AuthAltTypes=auth/jwt is active. User must specify the following HTTP cookies with each request:
NOTE: Tokens are usually generated via calling "scontrol token".

Read Slurm configuration from the specified file. See NOTES below.

Change group id (and drop supplemental groups) before processing client request. This should be a unique group with no write access or special permissions. Do not set this to the group belonging to to SlurmUser or root or the daemon won't start with the default settings.

Help; print a brief summary of command options.

Comma-delimited list of OpenAPI plugins. Set to "list" to dump a list of the possible plugins to load. Defaults: all builtin supported OpenAPI plugins.

Specify number of threads to use to process client connections. Ignored in inetd mode. Default: 20

Change user id before processing client request. This should be a unique group with no write access or special permissions. Do not set this user to SlurmUser or root or the daemon won't start with the default settings.

Verbose operation. Multiple -v's increase verbosity. Higher verbosity levels will have significant performance impact.

Print version information and exit.

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

The location of the Slurm configuration file.

Specify debug flags for slurmrestd 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.

This variable must be set to use JWT token authentication.

Set allowed authentication types. See -a

Set debug level explicitly. Valid values are 1-10. See -v

Comma-delimited list of host:port pairs or unix sockets to listen on.

Comma-delimited list of OpenAPI plugins to load. See -s

Control slurmrestd security functionality using the following comma-delimited values:
Disables unsharing file descriptors with parent process.

Disables unsharing the SYSV namespace.

Disables check that slurmrestd is not running as root or SlurmUser, or with the root or SlurmUser's primary group.

slurmrestd will shutdown cleanly.

This signal is explicitly ignored.

SPANK and clifilter plugins are not supported in slurmrestd due to their lack of thread safety. Active SPANK plugins and JobSubmitPlugins in slurmctld are independent of slurmrestd and can be used to enforce site policy on job submissions.

Copyright (C) 2019-2022 SchedMD LLC.

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.

slurm.conf(5), slurmctld(8), slurmdbd(8)

Slurm REST Daemon December 2022