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.