(선택 사항) 샤드 할당 비활성화

data 노드를 종료하면 할당 프로세스는 해당 노드의 샤드를 클러스터의 다른 노드로 복제하기 전에 index.unassigned.node_left.delayed_timeout(기본값 1분) 동안 대기하며, 이로 인해 많은 I/O가 발생할 수 있습니다. 노드는 곧 다시 시작될 예정이므로 이 I/O는 불필요합니다. replica 할당을 비활성화한 뒤 data 노드를 종료하여 시간에 쫓기는 상황을 피할 수 있습니다.

				PUT _cluster/settings
					{
  "persistent": {
    "cluster.routing.allocation.enable": "primaries"
  }
}
		

(선택 사항) 필수적이지 않은 인덱싱 중지 및 flush 수행

업그레이드 중에도 인덱싱을 계속할 수 있지만, 필수적이지 않은 인덱싱을 일시적으로 중지하고 flush를 수행하면 샤드 복구가 훨씬 빨라집니다.

				POST /_flush
		

(선택 사항) 활성 머신 러닝 작업 및 datafeed와 연결된 태스크를 일시적으로 중지

업그레이드 중에 머신 러닝 작업을 계속 실행할 수 있지만 클러스터 부하가 증가합니다. 머신 러닝 노드를 종료하면 해당 작업은 자동으로 다른 노드로 이동하고 모델 상태를 복원합니다.

• 업그레이드 모드 설정 API를 사용하여 머신 러닝 작업 및 datafeed와 연결된 태스크를 일시적으로 중지하고 새 작업이 열리지 않도록 합니다.

  				POST _ml/set_upgrade_mode?enabled=true
  		

  업그레이드 모드를 비활성화하면 작업은 자동으로 저장된 마지막 모델 상태를 사용하여 재개됩니다. 이 옵션은 업그레이드 중 활성 작업을 관리하는 오버헤드를 피할 수 있으며, datafeed를 명시적으로 중지하고 작업을 닫는 것보다 빠릅니다.

• 모든 datafeed를 중지하고 모든 작업을 닫습니다. 이 옵션은 닫는 시점의 모델 상태를 저장합니다. 업그레이드 후 작업을 다시 열면 정확히 동일한 모델을 사용합니다. 하지만 최신 모델 상태를 저장하는 데는 업그레이드 모드를 사용하는 것보다 오래 걸리며, 작업이 많거나 모델 상태가 큰 작업이 있는 경우 특히 그렇습니다.

단일 노드 종료

단일 노드를 종료하는 방법은 현재 Elasticsearch를 실행하는 방식에 따라 달라집니다. 예를 들어 systemd 또는 SysV init을 사용하는 경우 아래 명령을 실행합니다.

• systemd로 Elasticsearch를 실행하는 경우:

  sudo systemctl stop elasticsearch.service
  		

• SysV init으로 Elasticsearch를 실행하는 경우:

  sudo -i service elasticsearch stop
  		

종료한 노드의 버전 업그레이드

Debian 또는 RPM 패키지를 사용하여 업그레이드하려면 다음을 수행합니다.

• rpm 또는 dpkg를 사용하여 새 패키지를 설치합니다. 모든 파일은 운영 체제에 적합한 위치에 설치되며 Elasticsearch 구성 파일은 덮어쓰지 않습니다.

zip 또는 압축된 tarball을 사용하여 업그레이드하려면 다음을 수행합니다.

1. zip 또는 tarball을 새 디렉터리에 추출합니다. 외부 config 및 data 디렉터리를 사용하지 않는 경우 특히 중요합니다.

2. ES_PATH_CONF 환경 변수를 설정하여 외부 config 디렉터리와 jvm.options 파일의 위치를 지정합니다. 외부 config 디렉터리를 사용하지 않는 경우 이전 구성을 새 설치 위치로 복사합니다.

3. path.data를 config/elasticsearch.yml에서 외부 데이터 디렉터리를 가리키도록 설정합니다. 외부 data 디렉터리를 사용하지 않는 경우 이전 데이터 디렉터리를 새 설치 위치로 복사합니다.
   

   중요

   모니터링 기능을 사용하는 경우 Elasticsearch를 업그레이드할 때 데이터 디렉터리를 재사용하세요. 모니터링은 데이터 디렉터리에 저장된 영구 UUID를 사용하여 고유한 Elasticsearch 노드를 식별합니다.

4. path.logs를 config/elasticsearch.yml에서 로그를 저장하려는 위치를 가리키도록 설정합니다. 이 설정을 지정하지 않으면 아카이브를 추출한 디렉터리에 로그가 저장됩니다.

종료한 노드의 구성 재정의 병합

업그레이드 대상 버전에 맞게 구성을 조정하려면 필요한 Elasticsearch 구성 변경 사항을 적용합니다. 검토해야 할 가장 일반적인 설정은 다음과 같습니다.

• cluster.initial_master_nodes를 롤링 업그레이드 수행 시 elasticsearch.yml에서 설정하지 않은 상태로 둡니다. 업그레이드된 각 노드는 기존 클러스터에 참여하므로 클러스터 부트스트래핑이 필요하지 않습니다. 모든 노드에 discovery.seed_hosts 또는 discovery.seed_providers 중 하나를 구성해야 합니다.
• Elasticsearch는 버전에 따라 변경될 수 있는 권장 JVM 설정을 jvm.options에 포함하여 제공합니다. 구성 차이가 발생하지 않도록 모든 재정의가 업데이트된 버전의 jvm.options.d 파일에 복사되었는지 확인합니다.
• Elasticsearch는 버전에 따라 변경될 수 있는 권장 로깅 설정을 log4j2.properties에 포함하여 제공합니다. 구성 차이가 발생하지 않도록 모든 재정의가 업데이트된 버전의 파일에 복사되었는지 확인합니다.
• 노드 간 OS 수준 시스템 설정의 차이를 방지합니다. 노드를 추가하거나 다시 구축하면서 OS가 이전 OS의 복사본이 아닌 경우 이런 차이가 발생할 가능성이 가장 큽니다. 일반적인 설정과 적용 방법은 시스템 설정 구성 방법을 참조하세요.

종료한 노드의 모든 플러그인 업그레이드

elasticsearch-plugin 스크립트를 사용하여 설치된 각 Elasticsearch 플러그인의 업그레이드 버전을 설치합니다. 노드를 업그레이드할 때 모든 플러그인도 업그레이드해야 합니다.

업그레이드된 노드 시작

새로 업그레이드된 노드를 시작하고, 로그 파일을 확인하거나 _cat/nodes 요청을 제출하여 클러스터에 참여했는지 확인합니다.

				GET _cat/nodes
		

샤드 할당 다시 활성화

data 노드의 경우 노드가 클러스터에 참여한 후 cluster.routing.allocation.enable 설정을 제거하여 샤드 할당을 활성화하고 노드 사용을 시작합니다.

				PUT _cluster/settings
					{
  "persistent": {
    "cluster.routing.allocation.enable": null
  }
}
		

노드 복구 대기

다음 노드를 업그레이드하기 전에 클러스터가 status: green을 보고하여 샤드 할당을 완료할 때까지 기다립니다. 클러스터 상태 API를 제출하여 진행 상황을 확인할 수 있습니다.

				GET _cluster/health
		

flush되지 않은 샤드는 복구하는 데 더 오래 걸릴 수 있습니다. CAT recovery API를 사용하여 개별 샤드의 복구 상태를 모니터링할 수 있습니다.

				GET _cat/recovery?v=true&expand_wildcards=all&active_only=true
		

인덱싱을 중지했다면 복구가 완료되는 즉시 안전하게 인덱싱을 재개할 수 있습니다.

머신 러닝 작업 재시작

머신 러닝 작업과 연결된 태스크를 일시적으로 중지했다면 업그레이드 모드 설정 API를 사용하여 활성 상태로 되돌립니다.

				POST _ml/set_upgrade_mode?enabled=false
		

업그레이드 전에 모든 머신 러닝 작업을 닫았다면 Kibana에서 또는 작업 열기 및 datafeed 시작 API를 사용하여 작업을 열고 datafeed를 시작합니다.