docs: update configuration references

Author: rezib

CHANGELOG.md

@@ -46,7 +46,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Replace `standard_{error,input,output}` by `{stderr,stdin,stdout}_expanded`
     in filtered fields of individual job responses from Slurm controler for
     compatibility with v0.0.43 REST API.
-- docs: Update Slurm REST API supported versions section in architecture page.
+- docs:
+  - Update Slurm REST API supported versions section in architecture page.
+  - Update configuration reference documentation.
 
 ### Fixed
 - gateway: Use agent provided version instead of agent minimal version from

docs/modules/conf/examples/agent.ini

@@ -147,15 +147,28 @@ jwt_key=/var/lib/slurm-web/slurmrestd.key
 # _static_.
 jwt_token=None
 
-# Slurm REST API version.
+# List of supported slurmrestd REST API versions to try during discovery,
+# in descending order (newest first).
+#
+# The agent will try each version in order until it finds one that works.
+# This allows the agent to support multiple slurmrestd API versions
+# automatically.
 #
 # 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.41
-version=0.0.41
+# Default value:
+# - 0.0.44
+# - 0.0.43
+# - 0.0.42
+# - 0.0.41
+versions=
+  0.0.44
+  0.0.43
+  0.0.42
+  0.0.41
 
 [filters]
 
@@ -256,15 +269,15 @@ acctjob=
 # - command
 # - cpus
 # - current_working_directory
-# - exclusive
 # - gres_detail
 # - last_sched_evaluation
 # - node_count
 # - partition
+# - shared
 # - sockets_per_node
-# - standard_error
-# - standard_input
-# - standard_output
+# - stderr_expanded
+# - stdin_expanded
+# - stdout_expanded
 # - tasks
 # - tres_per_job
 # - tres_per_node
@@ -277,15 +290,15 @@ ctldjob=
   command
   cpus
   current_working_directory
-  exclusive
   gres_detail
   last_sched_evaluation
   node_count
   partition
+  shared
   sockets_per_node
-  standard_error
-  standard_input
-  standard_output
+  stderr_expanded
+  stdin_expanded
+  stdout_expanded
   tasks
   tres_per_job
   tres_per_node

docs/modules/conf/partials/conf-agent.adoc

@@ -281,7 +281,33 @@ _No default value_
 
 |version
 |str
-|Slurm REST API version.
+|Slurm REST API version (deprecated).
+
+This parameter is deprecated. Use `versions` instead to specify a list of
+supported slurmrestd API versions.
+
+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.
+
+
+WARNING: This parameter is *deprecated* in favor of `[slurmrestd]` > `versions`.
+
+
+
+_No default value_
+
+|-
+
+|versions
+|list[str]
+|List of supported slurmrestd REST API versions to try during discovery,
+in descending order (newest first).
+
+The agent will try each version in order until it finds one that works.
+This allows the agent to support multiple slurmrestd API versions
+automatically.
 
 CAUTION: You SHOULD NOT change this parameter unless you really know what
 you are doing. This parameter is more intented for Slurm-web developers
@@ -292,7 +318,17 @@ the default value only.
 
 
 
-*Default:* `0.0.41`
+*Default:*
+
+
+* `0.0.44`
+
+* `0.0.43`
+
+* `0.0.42`
+
+* `0.0.41`
+
 
 |-
 
@@ -436,8 +472,6 @@ unique job, all other fields are filtered out.
 
 * `current_working_directory`
 
-* `exclusive`
-
 * `gres_detail`
 
 * `last_sched_evaluation`
@@ -446,13 +480,15 @@ unique job, all other fields are filtered out.
 
 * `partition`
 
+* `shared`
+
 * `sockets_per_node`
 
-* `standard_error`
+* `stderr_expanded`
 
-* `standard_input`
+* `stdin_expanded`
 
-* `standard_output`
+* `stdout_expanded`
 
 * `tasks`
 

docs/modules/conf/partials/policy-actions.adoc

@@ -48,4 +48,5 @@ defined reservations.
 |cache-reset
 |Reset cache statistics in settings panel.
 
+
 |===