Agent Configuration Settings
Slurm-web agent can be configured in INI file
/etc/slurm-web/agent.ini
.
This page contains the reference documentation of all configuration parameters that can be defined in this file, grouped by sections, and a full example to illustrate its syntax and possible values.
Sections
service
Parameter | Type | Description | Required |
---|---|---|---|
cluster |
str |
Name of cluster served by agent Example: No default value |
✅ |
interface |
str |
Interface address to bind for incoming connections Default: |
- |
port |
int |
TCP port to listen for incoming connections Default: |
- |
cors |
bool |
When true, Cross-Origin Resource Sharing (CORS) headers are enabled. Default: |
- |
debug |
bool |
Enable debug mode Default: |
- |
log_flags |
list[str] |
List of log flags to enable. Special value Choices:
Default:
|
- |
debug_flags |
list[str] |
List of debug flags to enable. Special value Choices:
Default:
|
- |
slurmrestd
Parameter | Type | Description | Required | ||
---|---|---|---|---|---|
socket |
path |
Path to slurmrestd UNIX socket Default: |
- |
||
version |
str |
Slurm REST API version.
Default: |
- |
filters
Parameter | Type | Description | Required |
---|---|---|---|
jobs |
list[str] |
List of jobs fields selected in slurmrestd API when retrieving a list of jobs, all other fields arefiltered out. Default:
|
- |
acctjob |
list[str] |
List of slurmdbd job fields selected in slurmrestd API when retrieving a unique job, all other fields are filtered out. Default:
|
- |
ctldjob |
list[str] |
List of slurmctld job fields selected in slurmrestd API when retrieving a unique job, all other fields are filtered out. Default:
|
- |
nodes |
list[str] |
List of nodes fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
node |
list[str] |
List of invidual node fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
partitions |
list[str] |
List of partitions fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
qos |
list[str] |
List of qos fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
reservations |
list[str] |
List of reservations fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
accounts |
list[str] |
List of accounts fields selected in slurmrestd API, all other fields are filtered out. Default:
|
- |
policy
Parameter | Type | Description | Required |
---|---|---|---|
definition |
path |
Path to RBAC policy definition file with available actions Default: |
- |
vendor_roles |
path |
Path to default vendor RBAC policy definition file with roles and permitted actions Default: |
- |
roles |
path |
Path to site RBAC policy definition file with roles and permitted actions Default: |
- |
jwt
Parameter | Type | Description | Required |
---|---|---|---|
key |
path |
Path to private key for JWT signature Default: |
- |
algorithm |
str |
Cryptographic algorithm used to sign JWT Choices:
Default: |
- |
audience |
str |
Audience defined in generated JWT and expected in JWT provided by clients Default: |
- |
racksdb
Parameter | Type | Description | Required |
---|---|---|---|
db |
path |
Path to RacksDB database Default: |
- |
schema |
path |
Path to RacksDB database schema Default: |
- |
extensions |
path |
Path to site-specific RacksDB schema extensions Default: |
- |
drawings_schema |
path |
Path to RacksDB database schema Default: |
- |
infrastructure |
str |
Name of the infrastructure for the cluster in RacksDB. By default, the cluster name is used. Example: No default value |
- |
tags |
list[str] |
List of tags applied to compute nodes in RacksDB database Default:
|
- |
cache
Parameter | Type | Description | Required |
---|---|---|---|
enabled |
bool |
Determine if caching is enabled Default: |
- |
host |
str |
Hostname of Redis cache server Default: |
- |
port |
int |
TCP port of Redis cache server Default: |
- |
password |
str |
Password to connect to protected Redis server. When this parameter is not defined, Redis server is accessed without password. Example: No default value |
- |
version |
int |
Expiration delay in seconds for Slurm version in cache Default: |
- |
jobs |
int |
Expiration delay in seconds for jobs in cache Default: |
- |
job |
int |
Expiration delay in seconds for invidual jobs in cache Default: |
- |
nodes |
int |
Expiration delay in seconds for nodes in cache Default: |
- |
node |
int |
Expiration delay in seconds for node in cache Default: |
- |
partitions |
int |
Expiration delay in seconds for partitions in cache Default: |
- |
qos |
int |
Expiration delay in seconds for QOS in cache Default: |
- |
reservations |
int |
Expiration delay in seconds for reservations in cache Default: |
- |
accounts |
int |
Expiration delay in seconds for accounts in cache Default: |
- |
Example
This section contains a full example of Slurm-web agent configuration file.
Do NOT use this full example file as a basis for your custom site configuration. This example is provided only to illustrate the syntax of the file, its parameters and possible values. Most parameters are actually optional. You should define only the sections and parameters that are either really required or those for which you want to override default value. Please refer to the quickstart guide to understand the parameters you are supposed to define in most cases. |
This example file is also installed in Slurm-web agent distribution
packages at /usr/share/doc/slurm-web-agent/examples/agent.ini .
|
# This file is an example configuration file for Slurm-web agent
#
# Please DO NOT USE THIS FILE as a basis for your custom
# /etc/slurm-web/agent.ini.
[service]
# Name of cluster served by agent
#
# This parameter is required.
cluster=atlas
# Interface address to bind for incoming connections
#
# Default value: localhost
interface=localhost
# TCP port to listen for incoming connections
#
# Default value: 5012
port=5012
# When true, Cross-Origin Resource Sharing (CORS) headers are enabled.
cors=no
# Enable debug mode
debug=no
# List of log flags to enable. Special value `ALL` enables all log flags.
#
# Possible values:
# - slurmweb
# - rfl
# - werkzeug
# - urllib3
# - racksdb
# - ALL
#
# Default value:
# - ALL
log_flags=
ALL
# List of debug flags to enable. Special value `ALL` enables all debug
# flags.
#
# Possible values:
# - slurmweb
# - rfl
# - werkzeug
# - urllib3
# - racksdb
# - ALL
#
# Default value:
# - slurmweb
debug_flags=
slurmweb
[slurmrestd]
# Path to slurmrestd UNIX socket
#
# Default value: /run/slurmrestd/slurmrestd.socket
socket=/run/slurmrestd/slurmrestd.socket
# Slurm REST API version.
#
# CAUTION: You SHOULD NOT change this parameter unless you really know what
# you are doing. This parameter is more intented for Slurm-web developers
# rather than end users. Slurm-web is officially tested and validated with
# the default value only.
#
# Default value: 0.0.39
version=0.0.39
[filters]
# List of jobs fields selected in slurmrestd API when retrieving a list of
# jobs, all other fields arefiltered out.
#
# Default value:
# - job_id
# - user_name
# - account
# - job_state
# - state_reason
# - partition
# - priority
# - qos
# - cpus
# - node_count
jobs=
job_id
user_name
account
job_state
state_reason
partition
priority
qos
cpus
node_count
# List of slurmdbd job fields selected in slurmrestd API when retrieving a
# unique job, all other fields are filtered out.
#
# Default value:
# - association
# - comment
# - derived_exit_code
# - exit_code
# - group
# - name
# - nodes
# - partition
# - priority
# - qos
# - required
# - script
# - state
# - steps
# - submit_line
# - time
# - tres
# - used_gres
# - user
# - wckey
# - working_directory
acctjob=
association
comment
derived_exit_code
exit_code
group
name
nodes
partition
priority
qos
required
script
state
steps
submit_line
time
tres
used_gres
user
wckey
working_directory
# List of slurmctld job fields selected in slurmrestd API when retrieving a
# unique job, all other fields are filtered out.
#
# Default value:
# - accrue_time
# - batch_flag
# - command
# - cpus
# - current_working_directory
# - exclusive
# - last_sched_evaluation
# - node_count
# - partition
# - standard_error
# - standard_input
# - standard_output
# - state_reason
# - tasks
# - tres_req_str
ctldjob=
accrue_time
batch_flag
command
cpus
current_working_directory
exclusive
last_sched_evaluation
node_count
partition
standard_error
standard_input
standard_output
state_reason
tasks
tres_req_str
# List of nodes fields selected in slurmrestd API, all other fields are
# filtered out.
#
# Default value:
# - name
# - cpus
# - sockets
# - cores
# - real_memory
# - state
# - reason
# - partitions
nodes=
name
cpus
sockets
cores
real_memory
state
reason
partitions
# List of invidual node fields selected in slurmrestd API, all other fields
# are filtered out.
#
# Default value:
# - name
# - architecture
# - operating_system
# - boot_time
# - last_busy
# - cpus
# - sockets
# - cores
# - threads
# - real_memory
# - state
# - reason
# - partitions
# - alloc_cpus
# - alloc_memory
node=
name
architecture
operating_system
boot_time
last_busy
cpus
sockets
cores
threads
real_memory
state
reason
partitions
alloc_cpus
alloc_memory
# List of partitions fields selected in slurmrestd API, all other fields are
# filtered out.
#
# Default value:
# - name
# - node_sets
partitions=
name
node_sets
# List of qos fields selected in slurmrestd API, all other fields are
# filtered out.
#
# Default value:
# - name
# - description
# - priority
# - flags
# - limits
qos=
name
description
priority
flags
limits
# List of reservations fields selected in slurmrestd API, all other fields
# are filtered out.
#
# Default value:
# - name
# - users
# - accounts
# - node_list
# - node_count
# - start_time
# - end_time
# - flags
reservations=
name
users
accounts
node_list
node_count
start_time
end_time
flags
# List of accounts fields selected in slurmrestd API, all other fields are
# filtered out.
#
# Default value:
# - name
accounts=
name
[policy]
# Path to RBAC policy definition file with available actions
#
# Default value: /usr/share/slurm-web/conf/policy.yml
definition=/usr/share/slurm-web/conf/policy.yml
# Path to default vendor RBAC policy definition file with roles and
# permitted actions
#
# Default value: /usr/share/slurm-web/conf/policy.ini
vendor_roles=/usr/share/slurm-web/conf/policy.ini
# Path to site RBAC policy definition file with roles and permitted actions
#
# Default value: /etc/slurm-web/policy.ini
roles=/etc/slurm-web/policy.ini
[jwt]
# Path to private key for JWT signature
#
# Default value: /var/lib/slurm-web/jwt.key
key=/var/lib/slurm-web/jwt.key
# Cryptographic algorithm used to sign JWT
#
# Possible values:
# - HS256
# - HS384
# - HS512
# - ES256
# - ES256K
# - ES384
# - ES512
# - RS256
# - RS384
# - RS512
# - PS256
# - PS384
# - PS512
# - EdDSA
#
# Default value: HS256
algorithm=HS256
# Audience defined in generated JWT and expected in JWT provided by clients
#
# Default value: slurm-web
audience=slurm-web
[racksdb]
# Path to RacksDB database
#
# Default value: /var/lib/racksdb
db=/var/lib/racksdb
# Path to RacksDB database schema
#
# Default value: /usr/share/racksdb/schemas/racksdb.yml
schema=/usr/share/racksdb/schemas/racksdb.yml
# Path to site-specific RacksDB schema extensions
#
# Default value: /etc/racksdb/extensions.yml
extensions=/etc/racksdb/extensions.yml
# Path to RacksDB database schema
#
# Default value: /usr/share/racksdb/schemas/drawings.yml
drawings_schema=/usr/share/racksdb/schemas/drawings.yml
# Name of the infrastructure for the cluster in RacksDB. By default, the
# cluster name is used.
infrastructure=atlas
# List of tags applied to compute nodes in RacksDB database
#
# Default value:
# - compute
tags=
compute
[cache]
# Determine if caching is enabled
enabled=no
# Hostname of Redis cache server
#
# Default value: localhost
host=localhost
# TCP port of Redis cache server
#
# Default value: 6379
port=6379
# Password to connect to protected Redis server. When this parameter is
# not defined, Redis server is accessed without password.
password=SECR3T
# Expiration delay in seconds for Slurm version in cache
#
# Default value: 1800
version=1800
# Expiration delay in seconds for jobs in cache
#
# Default value: 30
jobs=30
# Expiration delay in seconds for invidual jobs in cache
#
# Default value: 10
job=10
# Expiration delay in seconds for nodes in cache
#
# Default value: 30
nodes=30
# Expiration delay in seconds for node in cache
#
# Default value: 10
node=10
# Expiration delay in seconds for partitions in cache
#
# Default value: 60
partitions=60
# Expiration delay in seconds for QOS in cache
#
# Default value: 60
qos=60
# Expiration delay in seconds for reservations in cache
#
# Default value: 60
reservations=60
# Expiration delay in seconds for accounts in cache
#
# Default value: 60
accounts=60