New

The executive guide to generative AI

Read more

Cluster Update Settings

edit

Cluster Update Settings

edit

Allows to update cluster wide specific settings. Settings updated can either be persistent (applied cross restarts) or transient (will not survive a full cluster restart). Here is an example:

curl -XPUT localhost:9200/_cluster/settings -d '{
    "persistent" : {
        "discovery.zen.minimum_master_nodes" : 2
    }
}'

Or:

curl -XPUT localhost:9200/_cluster/settings -d '{
    "transient" : {
        "discovery.zen.minimum_master_nodes" : 2
    }
}'

The cluster responds with the settings updated. So the response for the last example will be:

{
    "persistent" : {},
    "transient" : {
        "discovery.zen.minimum_master_nodes" : "2"
    }
}'

Cluster wide settings can be returned using:

curl -XGET localhost:9200/_cluster/settings

There is a specific list of settings that can be updated, those include:

Cluster settings

edit

Routing allocation

edit

Awareness

edit
cluster.routing.allocation.awareness.attributes
See Cluster.
cluster.routing.allocation.awareness.force.*
See Cluster.

Balanced Shards

edit
cluster.routing.allocation.balance.shard
Defines the weight factor for shards allocated on a node (float). Defaults to 0.45f.
cluster.routing.allocation.balance.index
Defines a factor to the number of shards per index allocated on a specific node (float). Defaults to 0.5f.
cluster.routing.allocation.balance.primary
defines a weight factor for the number of primaries of a specific index allocated on a node (float). 0.05f.
cluster.routing.allocation.balance.threshold
minimal optimization value of operations that should be performed (non negative float). Defaults to 1.0f.

Concurrent Rebalance

edit
cluster.routing.allocation.cluster_concurrent_rebalance
Allow to control how many concurrent rebalancing of shards are allowed cluster wide, and default it to 2 (integer). -1 for unlimited. See also Cluster.

Disable allocation

edit
cluster.routing.allocation.disable_allocation
See Cluster.
cluster.routing.allocation.disable_replica_allocation
See Cluster.
cluster.routing.allocation.disable_new_allocation
See Cluster.

Throttling allocation

edit
cluster.routing.allocation.node_initial_primaries_recoveries
See Cluster.
cluster.routing.allocation.node_concurrent_recoveries
See Cluster.

Filter allocation

edit
cluster.routing.allocation.include.*
See Cluster.
cluster.routing.allocation.exclude.*
See Cluster.
cluster.routing.allocation.require.* (from 0.90)
See Cluster.

Metadata

edit
cluster.blocks.read_only
Have the whole cluster read only (indices do not accept write operations), metadata is not allowed to be modified (create or delete indices).

Discovery

edit
discovery.zen.minimum_master_nodes
See Zen Discovery

Threadpools

edit
threadpool.*
See Thread Pool

Index settings

edit

Index filter cache

edit
indices.cache.filter.size
See Cache
indices.cache.filter.expire (time)
See Cache

TTL interval

edit
indices.ttl.interval (time)
See _ttl

Recovery

edit
indices.recovery.concurrent_streams
See Indices
indices.recovery.file_chunk_size
See Indices
indices.recovery.translog_ops
See Indices
indices.recovery.translog_size
See Indices
indices.recovery.compress
See Indices
indices.recovery.max_bytes_per_sec
Since 0.90.1. See Indices
indices.recovery.max_size_per_sec
Deprecated since 0.90.1. See max_bytes_per_sec instead.

Store level throttling

edit
indices.store.throttle.type
See Store
indices.store.throttle.max_bytes_per_sec
See Store

Logger

edit

Logger values can also be updated by setting logger. prefix. More settings will be allowed to be updated.