Amazon OpenSearch Service 도메인 업그레이드 - Amazon OpenSearch 서비스
지원되는 업그레이드 경로검증 장애 문제 해결업그레이드 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon OpenSearch Service 도메인 업그레이드

참고

OpenSearch 및 Elasticsearch 버전 업그레이드는 서비스 소프트웨어 업데이트와 다릅니다. OpenSearch 서비스 도메인의 서비스 소프트웨어 업데이트에 대한 자세한 내용은 섹션을 참조하세요Amazon OpenSearch Service의 서비스 소프트웨어 업데이트.

Amazon OpenSearch Service는 OpenSearch 1.0 이상 또는 Elasticsearch 5.1 이상을 실행하는 도메인에 대해 인플레이스 업그레이드를 제공합니다. Amazon Data Firehose 또는 Amazon CloudWatch Logs와 같은 서비스를 사용하여 데이터를 OpenSearch 서비스로 스트리밍하는 경우 마이그레이션 OpenSearch 하기 전에 이러한 서비스가 최신 버전의 를 지원하는지 확인합니다.

지원되는 업그레이드 경로

현재 OpenSearch 서비스는 다음 업그레이드 경로를 지원합니다.

구 버전 새 버전
OpenSearch 1.3 또는 2.x

OpenSearch 2.x

버전 2.3에는 다음과 같은 주요 변경 사항이 있습니다.

  • OpenSearch 2.17은 도메인이 다음과 같은 조건을 충족하는 경우 기본적으로 자동 모드로 동시 세그먼트 검색을 활성화합니다.

    • 이전 동시 검색 설정은 명시적으로 설정되지 않습니다.

    • 모든 데이터 인스턴스(핫 및 웜)는 인스턴스 유형이 2.xl 이상입니다.

    • 1주 이상 데이터 인스턴스(핫 및 웜)의 평균 p90 cpu 사용률은 45% 미만입니다.

      동시 세그먼트 검색 설정에 대한 자세한 내용은 동시 세그먼트 검색 섹션을 참조하세요.

  • 버전 2.0의 모든 OpenSearch API 엔드포인트에서 type 파라미터가 제거되었습니다. 자세한 내용은 주요 변경 사항을 참조하세요.

  • 도메인에 원래 Elasticsearch 6.8에서 생성된 인덱스(핫 UltraWarm또는 콜드)가 포함된 경우 해당 인덱스는 OpenSearch 2.3과 호환되지 않습니다.

    버전 2.3으로 업그레이드하기 전에 호환되지 않는 인덱스를 재인덱싱해야 합니다. 호환되지 않거나 UltraWarm 콜드 인덱스의 경우 핫 스토리지로 마이그레이션하고 데이터를 다시 인덱싱한 다음 웜 또는 콜드 스토리지로 다시 마이그레이션합니다. 또는 인덱스가 더 이상 필요하지 않은 경우 인덱스를 삭제할 수 있습니다.

    이러한 단계를 먼저 수행하지 않고 실수로 도메인을 버전 2.3으로 업그레이드한 경우 호환되지 않는 인덱스를 현재 스토리지 계층에서 마이그레이션할 수 없습니다. 유일한 방법은 삭제하는 것입니다.
OpenSearch 1.x OpenSearch 1.x
Elasticsearch 7.x

Elasticsearch 7.x 또는 OpenSearch 1.x

중요

OpenSearch 1.x는 수많은 중단 변경 사항을 도입합니다. 세부 정보는 Amazon OpenSearch Service 이름 변경 - 변경 사항 요약을 참조하세요.

Elasticsearch 6.8

Elasticsearch 7.x 또는 OpenSearch 1.x

중요

Elasticsearch 7.0 및 OpenSearch 1.0에는 수많은 중단 변경 사항이 포함되어 있습니다. 현재 위치 업그레이드를 시작하기 전에 6.x 도메인의 수동 스냅샷을 찍고 테스트 7.x 또는 OpenSearch 1.x 도메인에서 복원한 다음 해당 테스트 도메인을 사용하여 잠재적 업그레이드 문제를 식별하는 것이 좋습니다. OpenSearch 1.0의 변경 사항 해제는 섹션을 참조하세요Amazon OpenSearch Service 이름 변경 - 변경 사항 요약.

Elasticsearch 6.x와 같이 인덱스에는 하나의 매핑 유형만 포함될 수 있지만 해당 유형의 이름은 _doc여야 합니다. 따라서 특정 에서는 요청 본문(예: _bulk )에 매핑 유형이 더 이상 필요하지 APIs 않습니다API.

새 인덱스의 경우 자체 호스팅 Elasticsearch 7.x 및 OpenSearch 1.x의 기본 샤드 수는 1입니다.Elasticsearch 7.x 이상의 OpenSearch 서비스 도메인은 이전 기본값인 5를 유지합니다.

Elasticsearch 6.x

Elasticsearch 6.x
Elasticsearch 5.6

Elasticsearch 6.x

중요

버전 6.x에서 생성된 인덱스는 더 이상 여러 개의 매핑 유형을 지원하지 않습니다. 버전 5.x에서 생성된 인덱스는 6.x 클러스터로 복원될 때 계속 여러 매핑 유형을 지원합니다. 클라이언트 코드를 통해 인덱스당 매핑 유형 하나만 생성할 수 있는지 확인합니다.

Elasticsearch 5.6에서 6.x 로 업그레이드하는 동안 가동 중지 시간을 최소화하기 위해 OpenSearch 서비스는 .kibana 인덱스를 로 재인덱싱.kibana-6하고, 를 삭제하고.kibana, 라는 별칭을 생성하고.kibana, 새 인덱스를 새 별칭에 매핑합니다.
Elasticsearch 5.x Elasticsearch 5.x

업그레이드 프로세스는 세 단계로 구성됩니다.

  1. 업그레이드 전 확인 - OpenSearch 서비스에서 업그레이드를 차단할 수 있는 문제가 있는지 확인하고 이러한 확인에 성공하지 않는 한 다음 단계로 진행하지 않습니다.

  2. 스냅샷 - OpenSearch 서비스는 OpenSearch 또는 Elasticsearch 클러스터의 스냅샷을 찍고 스냅샷이 성공하지 않는 한 다음 단계로 진행하지 않습니다. 업그레이드가 실패하면 OpenSearch Service는 이 스냅샷을 사용하여 클러스터를 원래 상태로 복원합니다. 자세한 정보는 업그레이드 후 다운그레이드할 수 없음 섹션을 참조하세요.

  3. 업그레이드 - OpenSearch 서비스가 업그레이드를 시작합니다. 업그레이드를 완료하는 데 15분에서 몇 시간이 걸릴 수 있습니다. 업그레이드 중 일부 또는 전부가 진행되는 동안 OpenSearch 대시보드를 사용하지 못할 수 있습니다.

검증 장애 문제 해결

OpenSearch 또는 Elasticsearch 버전 업그레이드를 시작할 때 OpenSearch Service는 먼저 일련의 검증 검사를 수행하여 도메인이 업그레이드에 적합한지 확인합니다. 이러한 검사 중 하나라도 실패하면 도메인을 업그레이드하기 전에 수정해야 하는 특정 문제가 포함된 알림을 받게 됩니다. 잠재적 문제 목록 및 문제 해결 단계는 Troubleshooting validation errors(검증 오류 문제 해결 중)을 참조하세요.

업그레이드 문제 해결

인플레이스 업그레이드는 정상 상태 도메인이 필요합니다. 도메인은 업그레이드 자격이 없거나 매우 다양한 이유로 업그레이드가 실패할 수 있습니다. 다음 표에는 가장 일반적인 문제가 나와 있습니다.

문제 설명
선택적 플러그인은 지원되지 않음

선택적 플러그인을 사용하여 도메인을 업그레이드하면 OpenSearch Service는 플러그인도 자동으로 업그레이드합니다. 따라서 도메인의 대상 버전도 이러한 선택적 플러그인을 지원해야 합니다. 대상 버전에서 사용할 수 없는 선택적 플러그인이 도메인에 설치된 경우 업그레이드 요청이 실패합니다.
노드당 샤드가 너무 많음 OpenSearch는 7.x 버전의 Elasticsearch와 함께 노드당 샤드가 1,000개 이하인 기본 설정을 갖습니다. 현재 클러스터의 노드가 이 설정을 초과하는 경우 OpenSearch 서비스에서 업그레이드할 수 없습니다. 문제 해결 옵션은 최대 샤드 제한 초과 섹션을 참조하세요.
처리 중 상태의 도메인 도메인이 구성 변경 도중에 있습니다. 작업이 완료된 후 업그레이드 자격을 확인하세요.
빨간색 클러스터 상태 클러스터에서 하나 이상의 인덱스가 빨간색입니다. 문제 해결 단계는 빨간색 클러스터 상태 섹션을 참조하세요.
높은 오류율 클러스터가 요청을 처리하려고 시도할 때 다수의 5xx 오류를 반환합니다. 이 문제는 일반적으로 너무 많은 동시 읽기 또는 쓰기 요청의 결과입니다. 클러스터로 가는 트래픽을 줄이거나 도메인을 확장할 것을 고려하세요.
브레인 분할 브레인 분할은 클러스터가 여러 개의 프라이머리 노드를 가지고 자체적으로는 절대로 다시 조인되지 않는 2개의 클러스터로 분할되어 있다는 의미입니다. 권장 수의 전용 프라이머리 노드를 사용하면 브레인 분할을 방지할 수 있습니다. 브레인 분할로부터 복구하기 위해 도움이 필요하면 AWS Support에 문의하세요.
프라이머리 노드가 없음 OpenSearch 서비스가 클러스터의 마스터 노드를 찾을 수 없습니다. 도메인에서 다중 AZ를 사용하는 경우 가용 영역 장애로 인해 클러스터가 쿼럼을 상실하고 새 프라이머리 노드를 선택하지 못할 수 있습니다. 문제가 자체적으로 해결되지 않을 경우 AWS Support에 문의하세요.
대기 중 작업이 너무 많음 프라이머리 노드에 부하가 너무 높아 대기 중 작업이 많습니다. 클러스터로 가는 트래픽을 줄이거나 도메인을 확장할 것을 고려하세요.
손상된 스토리지 볼륨 하나 이상의 노드의 디스크 볼륨이 제대로 기능하지 않습니다. 이 문제는 흔히 높은 오류율, 대기 작업이 너무 많음 등 다른 문제와 함께 발생합니다. 이 문제가 단독으로 발생하고 자체적으로 해결되지 않을 경우 AWS Support에 문의하세요.
KMS 키 문제 도메인을 암호화하는 데 사용되는 KMS 키는 액세스할 수 없거나 누락되었습니다. 자세한 내용은 저장된 데이터를 암호화하는 도메인 모니터링 단원을 참조하십시오.
진행 중인 스냅샷 도메인이 현재 스냅샷을 생성하고 있습니다. 스냅샷이 완료된 후 업그레이드 자격을 확인하세요. 또한 수동 스냅샷 리포지토리를 나열하고, 해당 리포지토리에서 스냅샷을 나열하고, 수동 스냅샷을 생성할 수 있는지도 확인하세요. OpenSearch 서비스가 스냅샷이 진행 중인지 확인할 수 없는 경우 업그레이드가 실패할 수 있습니다.
스냅샷 시간 초과 또는 실패 업그레이드 전 스냅샷 생성이 너무 오래 걸렸거나 실패했습니다. 클러스터 상태를 확인한 후 다시 시도하세요. 문제가 지속될 경우 AWS Support에 문의하세요.
호환되지 않는 인덱스 하나 이상의 인덱스가 대상 버전과 호환되지 않습니다. 이전 버전의 OpenSearch 또는 Elasticsearch에서 인덱스를 마이그레이션한 경우 이 문제가 발생할 수 있습니다. 인덱스를 다시 생성한 후 다시 시도하세요.
높은 디스크 사용량 클러스터의 디스크 사용량이 90%를 초과합니다. 데이터를 삭제하거나 도메인을 확장한 후 다시 시도하세요.
JVM 사용량 높음 JVM 메모리 압력이 75%를 초과합니다. 클러스터로 가는 트래픽을 줄이거나 도메인을 확장한 후 다시 시도하세요.
OpenSearch 대시보드 별칭 문제 .dashboards 는 이미 별칭으로 구성되어 있으며 이전 버전의 OpenSearch Dashboards와 같이 호환되지 않는 인덱스에 매핑됩니다. 다시 인덱싱한 후 다시 시도하세요.
빨간색 Dashboards 상태 OpenSearch 대시보드 상태는 빨간색입니다. 업그레이드가 완료되면 Dashboards를 사용해보세요. 상태가 지속될 경우 수동으로 해결한 후 다시 시도하세요.
클러스터 간 호환성

업그레이드 후 소스 도메인과 대상 도메인 간 교차 클러스터 호환성이 유지되는 경우에만 업그레이드할 수 있습니다. 업그레이드 프로세스 중에 호환되지 않는 모든 연결이 식별됩니다. 계속하려면 원격 도메인을 업그레이드하거나 호환되지 않는 연결을 삭제하세요. 도메인에서 복제가 활성 상태인 경우 연결을 삭제한 후에는 복제를 재개할 수 없다는 점을 참조하세요.
기타 OpenSearch 서비스 서비스 문제 OpenSearch 서비스 자체에 문제가 있으면 도메인이 업그레이드에 적합하지 않은 것으로 표시될 수 있습니다. 도메인에 상기 조건이 하나도 적용되지 않지만 문제가 하루를 넘게 지속될 경우 AWS Support에 문의하세요.