github.com/anth0d/nomad@v0.0.0-20221214183521-ae3a0a2cad06/website/content/docs/commands/operator/scheduler/set-config.mdx (about)

     1  ---
     2  layout: docs
     3  page_title: 'Commands: operator scheduler set-config'
     4  description: |
     5    Modify the scheduler configuration.
     6  ---
     7  
     8  # Command: operator scheduler set-config
     9  
    10  The scheduler operator set-config command is used to modify the scheduler
    11  configuration.
    12  
    13  ## Usage
    14  
    15  ```plaintext
    16  nomad operator scheduler set-config [options]
    17  ```
    18  
    19  If ACLs are enabled, this command requires a token with the `operator:write`
    20  capability.
    21  
    22  ## General Options
    23  
    24  @include 'general_options_no_namespace.mdx'
    25  
    26  ## Set Config Options
    27  
    28  - `-check-index` - If set, the scheduler config is only updated if the passed
    29    modify index matches the current server side version. If a non-zero value is
    30    passed, it ensures that the scheduler config is being updated from a known
    31    state.
    32  
    33  - `-scheduler-algorithm` - Specifies whether scheduler binpacks or spreads
    34    allocations on available nodes. Must be one of `["binpack"|"spread"]`.
    35  
    36  - `-memory-oversubscription` - When true, tasks may exceed their reserved memory
    37    limit, if the client has excess memory capacity. Tasks must specify [`memory_max`]
    38    to take advantage of memory oversubscription. Must be one of `[true|false]`.
    39  
    40  - `-reject-job-registration` - When true, the server will return permission denied
    41    errors for job registration, job dispatch, and job scale APIs, unless the ACL
    42    token for the request is a management token. If ACLs are disabled, no user
    43    will be able to register jobs. This allows operators to shed load from automated
    44    processes during incident response. Must be one of `[true|false]`.
    45  
    46  - `-pause-eval-broker` - When set to true, the eval broker which usually runs on
    47    the leader will be disabled. This will prevent the scheduler workers from
    48    receiving new work. Must be one of `[true|false]`.
    49  
    50  - `-preempt-batch-scheduler` - Specifies whether preemption for batch jobs
    51    is enabled. Note that if this is set to true, then batch jobs can preempt any
    52    other jobs. Must be one of `[true|false]`.
    53  
    54  - `-preempt-service-scheduler` - Specifies whether preemption for service jobs
    55    is enabled. Note that if this is set to true, then service jobs can preempt any
    56    other jobs. Must be one of `[true|false]`.
    57  
    58  - `-preempt-sysbatch-scheduler` - Specifies whether preemption for system batch
    59    jobs is enabled. Note that if this is set to true, then system batch jobs can
    60    preempt any other jobs. Must be one of `[true|false]`.
    61  
    62  - `-preempt-system-scheduler` - Specifies whether preemption for system jobs
    63    is enabled. Note that if this is set to true, then system jobs can preempt any
    64    other jobs. Must be one of `[true|false]`.
    65  
    66  ## Examples
    67  
    68  Modify the scheduler algorithm to spread:
    69  
    70  ```shell-session
    71  $ nomad operator scheduler set-config -scheduler-algorithm=spread
    72  Scheduler configuration updated!
    73  ```
    74  
    75  Modify the scheduler algorithm to spread using the check index flag:
    76  
    77  ```shell-session
    78  $ nomad operator scheduler set-config -scheduler-algorithm=spread -check-index=5
    79  Scheduler configuration updated!
    80  ```
    81  
    82  [`memory_max`]: /docs/job-specification/resources#memory_max