翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 Service にストリーミングする場合は、移行 OpenSearch する前に、これらのサービスが新しいバージョンの をサポートしていることを確認してください。
サポートされているアップグレードパス
現在、 OpenSearch Service は次のアップグレードパスをサポートしています。
| 元のバージョン | 目的のバージョン |
|---|---|
| OpenSearch 1.3 または 2.x |
OpenSearch 2.x バージョン 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 と同様に、インデックスに含めることができるマッピングタイプは1つだけですが、そのタイプには 新しいインデックスの場合、セルフホスト型の 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 クラスターに復元された場合でも、複数のマッピングタイプをサポートします。クライアントコードによって作成されるマッピングタイプがインデックスごとに 1 種類のみであることを確認します。 Elasticsearch 5.6 から 6.x へのアップグレード中のダウンタイムを最小限に抑えるために、 OpenSearch Service は |
| Elasticsearch 5.x | Elasticsearch 5.x |
アップグレードプロセスには、3 つの手順が含まれます。
-
アップグレード前のチェック — OpenSearch サービスでは、アップグレードをブロックし、これらのチェックが成功しない限り次のステップに進まない問題をチェックします。
-
スナップショット – OpenSearch サービスは OpenSearch または Elasticsearch クラスターのスナップショットを取得し、スナップショットが成功しない限り次のステップに進むことはありません。アップグレードが失敗した場合、 OpenSearch Service はこのスナップショットを使用してクラスターを元の状態に復元します。詳細については、「アップグレード後にダウングレードできない」を参照してください。
-
アップグレード – OpenSearch サービスはアップグレードを開始します。アップグレードが完了するまでに 15 分から数時間かかる場合があります。アップグレードの一部または全部で OpenSearch ダッシュボードが使用できない場合があります。
検証障害のトラブルシューティング
OpenSearch または Elasticsearch バージョンアップグレードを開始すると、 OpenSearch Service はまず一連の検証チェックを実行して、ドメインがアップグレードの対象となることを確認します。これらのチェックのいずれかが失敗した場合、ドメインを更新する前に修正する必要がある特定の問題を含む通知が表示されます。発生する可能性のある問題とその解決手順の一覧については、検証エラーのトラブルシューティング を参照してください。
アップグレードのトラブルシューティング
インプレース アップグレードには、正常なドメインが必要です。ドメインがアップグレードの対象とならなかったり、さまざまな理由でアップグレードに失敗する場合があります。次の表は、最も一般的な問題を示しています。
| 問題 | 説明 |
|---|---|
| オプションのプラグインはサポートされていません |
オプションのプラグインを使用してドメインをアップグレードすると、 OpenSearch Service はプラグインも自動的にアップグレードします。そのため、ドメインのターゲットバージョンは、これらのオプションプラグインもサポートしている必要があります。ターゲットバージョンでは使用できないオプションのプラグインがドメインにインストールされている場合、アップグレードリクエストは失敗します。 |
| ノードあたりのシャードが多すぎます | OpenSearch、および Elasticsearch の 7.x バージョンでは、ノードあたりのデフォルト設定は 1,000 シャード以下です。現在のクラスター内のノードがこの設定を超える場合、 OpenSearch Service ではアップグレードできません。トラブルシューティングのオプションについては、「シャードの最大制限を超えました」を参照してください。 |
| 処理中のドメイン | ドメインは、設定変更中です。オペレーション完了後、アップグレードの適格性を確認します。 |
| 赤のクラスター状態 | クラスター内の 1 つ以上のインデックスが赤です。トラブルシューティングステップについては、「赤のクラスター状態」を参照してください。 |
| 高いエラー率 | クラスターはリクエストの処理を試みましたが、大量の 5xx エラーを返しています。この問題は通常、同時読み取りまたは書き込みリクエストが多すぎることで起こります。クラスターへのトラフィックを減らすか、ドメインのスケーリングを検討してください。 |
| スプリットブレイン | スプリットブレインとは、 クラスターに 1 つ以上のマスターノードがあり、決して独自に再結合することのない 2 つのクラスターに分割されているという意味です。専用マスターノードの推奨値を使用することで、スプリットブレインを回避できます。スプレッドブレインからの復旧方法については、AWS Support |
| マスターノードが見つからない | OpenSearch サービスはクラスターのマスターノードを見つけることができません。ドメインでマルチ AZ を使用している場合、アベイラビリティーゾーンの障害によってクラスターがクォーラムを失い、新しいマスターノードを選択できなくなる可能性があります。問題が自動的に解決されない場合、AWS Support |
| 保留中のタスクが多すぎる | マスターノードに高い負荷がかかっており、たくさんの保留中のタスクがあります。クラスターへのトラフィックを減らすか、ドメインのスケーリングを検討してください。 |
| 障害が発生したストレージボリューム | 1 つ以上のノードのディスクボリュームが正常に機能していません。この問題は、高いエラー率や保留中のタスクが多すぎるなど、他の問題とともに頻繁に発生します。問題が単独で発生し、自動的に解決されない場合は、AWS Support |
| KMS キーの問題 | ドメインの暗号化に使用されるKMSキーにアクセスできないか、欠落しています。詳細については、「保管中のデータを暗号化するドメインのモニタリング」を参照してください。 |
| スナップショットを作成中 | ドメインは現在、スナップショットを作成しています。スナップショットの完了後に、アップグレードの適格性を確認します。手動スナップショットのリポジトリが一覧表示できること、それらのリポジトリ内のスナップショットが一覧表示できること、および手動スナップショットが作成できることも確認してください。Service OpenSearch がスナップショットが進行中かどうかをチェックできない場合、アップグレードは失敗する可能性があります。 |
| スナップショットのタイムアウトまたは障害 | アップグレード前のスナップショットの完了まで時間がかかりすぎたか、失敗しました。クラスター状態を確認して、再度お試しください。問題が解決しない場合は、AWS Support |
| 互換性のないインデックス | 1 つ以上のインデックスがターゲットバージョンと互換性がありません。この問題は、古いバージョンの OpenSearch または Elasticsearch からインデックスを移行した場合に発生する可能性があります。インデックスを再作成して、再試行してください。 |
| 高いディスク使用率 | クラスターのディスク使用率が 90% を超えています。データを削除またはドメインをスケーリングして、再度お試しください。 |
| JVM 使用率が高い | JVM メモリ圧力が 75% を超えています。クラスターへのトラフィックを削減するか、ドメインをスケーリングして、再度お試しください。 |
| OpenSearch ダッシュボードエイリアスの問題 | .dashboards は、すでにエイリアスとして設定されており、互換性のないインデックスにマッピングされています。おそらく、以前のバージョンの OpenSearch Dashboard のインデックスのものです。インデックスを再作成して、再度お試しください。 |
| 赤の Dashboards ステータス | OpenSearch ダッシュボードのステータスは赤色です。アップグレードが完了したら、Dashboards を使用してみてください。赤いステータスが続く場合は、手動で解決してから再度お試しください。 |
| クラスター間の互換性 |
アップグレードできるのは、アップグレード後にソースドメインとデスティネーションドメインの間で、クラスター間の互換性が維持されている場合のみです。アップグレードプロセス中に、互換性のない接続があれば特定されます。続行するには、リモートドメインをアップグレードするか、互換性のない接続を削除します。ドメインでレプリケーションがアクティブな場合は、接続を削除した後でレプリケーションを再開できないことに注意してください。 |
| その他の OpenSearch サービスサービスの問題 | OpenSearch Service 自体に問題があると、ドメインがアップグレードの対象外として表示される可能性があります。前述の条件がドメインに当てはまらず、問題が 1 日以上続く場合は、AWS Support |
