7-3-1. Changing Settings Dynamically

Many settings in Elasticsearch are dynamic and can be modified through the API. Configuration changes that force a node (or cluster) restart are strenuously avoided. And while it’s possible to make the changes through the static configs, we recommend that you use the API instead.

Elasticsearch의 많은 설정은 동적이고, API를 통해 변경될 수 있다. node나 cluster를 강제로 다시 시작해 구성을 변경하는 것은 절대로 피해야 한다. 그리고, 정적 구성을 통해 변경하는 것도 가능하지만, API를 사용하는 것을 추천한다.

The cluster-update API operates in two modes:

cluster-update API는 두 가지 모드로 동작한다.

Transient(일시적인)

These changes are in effect until the cluster restarts. Once a full cluster restart takes place, these settings are erased.

이들 변경은 cluster가 다시 시작할 때까지만 유효하다. 전체 cluster가 다시 시작하면, 이 설정은 제거된다.

Persistent(영구적인)

These changes are permanently in place unless explicitly changed. They will survive full cluster restarts and override the static configuration files.

이들 변경은 명시적으로 변경하지 않는 한, 영구적이다. 전체 cluster가 다시 시작해도 그대로 남아, 정적 구성 파일을 대체한다.

Transient versus persistent settings are supplied in the JSON body:

transient과 persistent 설정은 JSON body에 지정된다.

PUT /_cluster/settings
{
    "persistent" : {
        "discovery.zen.minimum_master_nodes" : 2 
    },
    "transient" : {
        "indices.store.throttle.max_bytes_per_sec" : "50mb" 
    }
}

	persistent 설정은 전체 cluster가 다시 시작해도 그대로 남는다.
	transient 설정은 전체 cluster가 다시 시작한 후에 제거된다.

A complete list of settings that can be updated dynamically can be found in the online reference docs.

동적으로 업데이트될 수 있는 설정의 완벽한 목록은 online reference docs에서 참고할 수 있다.