Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memutakhirkan domain OpenSearch Layanan Amazon
<a name="version-migration"></a>

**catatan**  
OpenSearch dan peningkatan versi Elasticsearch berbeda dari pembaruan perangkat lunak layanan. Untuk informasi tentang memperbarui perangkat lunak layanan untuk domain OpenSearch Layanan Anda, lihat[Pembaruan perangkat lunak layanan di Amazon OpenSearch Service](service-software.md).

Amazon OpenSearch Service menawarkan peningkatan di tempat untuk domain yang menjalankan OpenSearch 1.0 atau yang lebih baru, atau Elasticsearch 5.1 atau versi lebih baru. Jika Anda menggunakan layanan seperti Amazon Data Firehose atau Amazon CloudWatch Logs untuk mengalirkan data ke OpenSearch Layanan, periksa apakah layanan ini mendukung versi yang lebih baru sebelum bermigrasi. OpenSearch 

## Jalur pemutakhiran yang didukung
<a name="supported-upgrade-paths"></a>

Saat ini, OpenSearch Layanan mendukung jalur pemutakhiran berikut:


| Dari versi | Ke versi | 
| --- | --- | 
| OpenSearch 1.3, 2. x, atau 3. x | OpenSearch 3. *x*<br />Jika Anda menjalankan OpenSearch 1.3 atau 2.x, Anda harus terlebih dahulu meningkatkan ke OpenSearch 2.19 *sebelum* memutakhirkan ke 3.x. OpenSearch<br />Saat memutakhirkan dari OpenSearch 2.19 ke OpenSearch 3.x, Anda mungkin perlu mengatasi pengaturan indeks yang tidak kompatibel berikut. Ini tidak digunakan lagi sebelumnya di 2.x dan akan menyebabkan kegagalan validasi pemeriksaan pemutakhiran jika tidak dihapus.[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html)<br />[Untuk informasi selengkapnya tentang setelan indeks yang tidak digunakan lagi dan langkah-langkah untuk memulihkannya, lihat Pengaturan indeks.](https://docs.opensearch.org/2.6/search-plugins/knn/knn-index/#index-settings) Untuk daftar lengkap perubahan yang melanggar untuk OpenSearch 3.x, lihat [3.0.0](https://docs.opensearch.org/latest/breaking-changes/#300).<br />Jika domain Anda berisi indeks yang dibuat di OpenSearch 1.3, Elasticsearch 7.10, atau versi sebelumnya, Anda harus mengindeks ulang mereka sebelum memutakhirkan ke 3.x. OpenSearch OpenSearch 3.x tidak mendukung indeks lama ini, terlepas dari apakah mereka berada di penyimpanan panas, UltraWarm, atau dingin. Untuk mengindeks ulang indeks yang tidak kompatibel UltraWarm atau dingin:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html)<br />Atau, hapus indeks jika Anda tidak lagi membutuhkannya. | 
| OpenSearch 1.3 atau 2. x | OpenSearch 2. *x*<br />OpenSearch 2.17 akan mengaktifkan pencarian segmen bersamaan secara default dengan mode auto jika domain memenuhi kondisi berikut:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html)<br />Versi 2.3 memiliki perubahan melanggar berikut:[See the AWS documentation website for more details](http://docs.aws.amazon.com/id_id/opensearch-service/latest/developerguide/version-migration.html) | 
| OpenSearch 1. x | OpenSearch 1. x | 
| Elasticsearch 7. x | Elasticsearch 7. *x* atau OpenSearch 1. *x* OpenSearch 1. *x* memperkenalkan banyak perubahan yang melanggar. Lihat perinciannya di [Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan](rename.md).  | 
| Elasticsearch 6.8 | Elasticsearch 7. *x* atau OpenSearch 1. *x* Elasticsearch 7.0 dan OpenSearch 1.0 mencakup banyak perubahan yang melanggar. Sebelum memulai peningkatan di tempat, kami sarankan untuk [mengambil snapshot manual dari 6](managedomains-snapshots.md). *x* domain, memulihkannya pada tes 7. *x* atau OpenSearch 1. *x* domain, dan menggunakan domain uji itu untuk mengidentifikasi potensi masalah peningkatan. Untuk melanggar perubahan di OpenSearch 1.0, lihat[Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan](rename.md). <br />Seperti Elasticsearch 6. *x*, indeks hanya dapat berisi satu jenis pemetaan, tetapi tipe itu sekarang harus diberi nama. `_doc` Akibatnya, API tertentu tidak lagi memerlukan jenis pemetaan di isi permintaan (seperti API `_bulk`). <br />Untuk indeks baru, Elasticsearch 7 yang dihosting sendiri. *x* dan OpenSearch 1. *x* memiliki jumlah pecahan default satu. OpenSearch Domain layanan di Elasticsearch 7. *x* dan kemudian mempertahankan default sebelumnya dari lima.  | 
| Elasticsearch 6. *x* | Elasticsearch 6. *x* | 
| Elasticsearch 5.6 | Elasticsearch 6. *x* Indeks dibuat dalam versi 6. *x* tidak lagi mendukung beberapa jenis pemetaan. Indeks dibuat dalam versi 5. *x* masih mendukung beberapa jenis pemetaan saat dikembalikan ke 6. *x* gugus. Periksa apakah kode klien Anda hanya membuat satu jenis pemetaan per indeks. <br />Untuk meminimalkan waktu henti selama pemutakhiran dari Elasticsearch 5.6 ke 6. *x*, OpenSearch Service mengindeks ulang `.kibana` indeks ke`.kibana-6`, menghapus, membuat alias bernama `.kibana``.kibana`, dan memetakan indeks baru ke alias baru.  | 
| Elasticsearch 5. x | Elasticsearch 5. x | 

Proses peningkatan terdiri dari tiga langkah:

1. **Pre-upgrade pemeriksaan** — OpenSearch Layanan memeriksa masalah yang dapat memblokir peningkatan dan tidak melanjutkan ke langkah berikutnya kecuali pemeriksaan ini berhasil.

1. **Snapshot** — OpenSearch Layanan mengambil snapshot dari cluster OpenSearch atau Elasticsearch dan tidak melanjutkan ke langkah berikutnya kecuali snapshot berhasil. Jika pemutakhiran gagal, OpenSearch Service menggunakan snapshot ini untuk mengembalikan cluster ke keadaan semula. Untuk mengetahui informasi selengkapnya, lihat [Tidak dapat menurunkan versi setelah peningkatan](handling-errors.md#troubleshooting-upgrade-snapshot).

1. **Upgrade** - OpenSearch Layanan memulai peningkatan, yang dapat memakan waktu dari 15 menit hingga beberapa jam untuk menyelesaikannya. OpenSearch Dasbor mungkin tidak tersedia selama beberapa atau semua peningkatan.

## Memecahkan masalah kegagalan validasi
<a name="upgrade-validation"></a>

Saat Anda memulai pemutakhiran versi OpenSearch atau Elasticsearch, OpenSearch Layanan terlebih dahulu melakukan serangkaian pemeriksaan validasi untuk memastikan bahwa domain Anda memenuhi syarat untuk peningkatan. Jika salah satu pemeriksaan ini gagal, Anda menerima pemberitahuan yang berisi masalah spesifik yang harus Anda perbaiki sebelum memutakhirkan domain Anda. Untuk daftar potensi masalah dan langkah-langkah untuk menyelesaikannya, lihat[Memecahkan masalah kesalahan validasi](managedomains-configuration-changes.md#validation).

## Memecahkan masalah peningkatan
<a name="upgrade-failures"></a>

In-place upgrade membutuhkan domain yang sehat. Domain Anda mungkin tidak memenuhi syarat untuk peningkatan atau gagal ditingkatkan karena berbagai alasan. Tabel berikut menunjukkan masalah yang paling umum.


| Masalah | Deskripsi | 
| --- | --- | 
| Plugin opsional tidak didukung | Ketika Anda meng-upgrade domain dengan plugin opsional, OpenSearch Layanan secara otomatis meningkatkan plugin juga. Oleh karena itu, versi target untuk domain Anda juga harus mendukung plugin opsional ini. Jika domain memiliki plugin opsional diinstal yang tidak tersedia untuk versi target, permintaan upgrade gagal. | 
| Terlalu banyak serpihan per simpul | OpenSearch, serta 7. x versi Elasticsearch, memiliki pengaturan default tidak lebih dari 1.000 pecahan per node. Jika node di kluster Anda saat ini melebihi pengaturan ini, OpenSearch Service tidak mengizinkan Anda untuk meningkatkan. Lihat [Melampaui batas serpihan maksimum](handling-errors.md#troubleshooting-shard-limit) untuk opsi pemecahan masalah. | 
| Domain sedang diproses | Domain sedang di tengah-tengah perubahan konfigurasi. Periksa kelayakan peningkatan setelah operasi selesai. | 
| Status klaster merah | Satu atau lebih indeks di cluster berwarna merah. Untuk langkah-langkah pemecahan masalah, lihat [Status klaster merah](handling-errors.md#handling-errors-red-cluster-status). | 
| Tingkat kesalahan tinggi | Cluster mengembalikan sejumlah besar kesalahan 5 xx saat mencoba memproses permintaan. Masalah ini biasanya merupakan hasil dari terlalu banyaknya permintaan baca atau tulis secara bersamaan. Pertimbangkan untuk mengurangi lalu lintas ke klaster atau menskalakan domain Anda. | 
| Split brain | Otak terbelah berarti bahwa cluster Anda memiliki lebih dari satu simpul master dan telah dibagi menjadi dua cluster yang tidak akan pernah bergabung kembali dengan sendirinya. Anda dapat menghindari split brain dengan menggunakan jumlah yang direkomendasikan untuk [simpul utama terdedikasi](managedomains-dedicatedmasternodes.md). Untuk bantuan pemulihan dari split brain, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Simpul utama tidak ditemukan | OpenSearch Layanan tidak dapat menemukan simpul master cluster. Jika domain Anda menggunakan [multi-AZ](managedomains-multiaz.md), kegagalan Availability Zone mungkin telah menyebabkan klaster kehilangan kuorum dan tidak dapat memilih [simpul utama](managedomains-dedicatedmasternodes.md) yang baru. Jika masalah tidak teratasi sendiri, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Terlalu banyak tugas yang tertunda | Simpul utama berada di bawah beban berat dan memiliki banyak tugas yang tertunda. Pertimbangkan untuk mengurangi lalu lintas ke klaster atau menskalakan domain Anda. | 
| Volume penyimpanan yang terganggu | Volume disk dari satu atau lebih simpul tidak berfungsi dengan benar. Masalah ini sering terjadi bersamaan dengan masalah lainnya, seperti tingkat kesalahan yang tinggi atau terlalu banyak tugas yang tertunda. Jika terjadi dalam isolasi dan tidak teratasi sendiri, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Masalah kunci KMS | Kunci KMS yang digunakan untuk mengenkripsi domain tidak dapat diakses atau hilang. Untuk informasi selengkapnya, lihat [Memantau domain yang mengenkripsi data saat tidak digunakan](encryption-at-rest.md#monitoring-ear). | 
| Snapshot sedang berlangsung | Domain saat ini sedang mengambil snapshot. Periksa kelayakan peningkatan setelah snapshot selesai. Juga periksa apakah Anda dapat mencantumkan repositori snapshot manual, mencantumkan snapshot dalam repositori tersebut, dan mengambil snapshot manual. Jika OpenSearch Layanan tidak dapat memeriksa apakah snapshot sedang berlangsung, pemutakhiran dapat gagal. | 
| Waktu habis atau kegagalan snapshot | Snapshot pra-peningkatan terlalu lama untuk diselesaikan atau gagal. Periksa kesehatan klaster, dan coba lagi. Jika masalah berlanjut, hubungi [Dukungan](https://console.aws.amazon.com/support/home). | 
| Indeks yang tidak kompatibel | Satu atau lebih indeks tidak kompatibel dengan versi target. Masalah ini dapat terjadi jika Anda memigrasikan indeks dari versi lama OpenSearch atau Elasticsearch. Indeks ulang indeks dan coba lagi. | 
| Penggunaan disk yang tinggi | Penggunaan disk untuk klaster di atas 90%. Hapus data atau skalakan domain, dan coba lagi. | 
| Penggunaan JVM yang tinggi | Tekanan memori JVM di atas 75%. Kurangi lalu lintas ke klaster atau skalakan domain, dan coba lagi. | 
| OpenSearch Masalah alias dasbor | .dashboardssudah dikonfigurasi sebagai alias dan memetakan ke indeks yang tidak kompatibel, kemungkinan dari versi Dasbor sebelumnya. OpenSearch Reindex dan coba lagi. | 
| Status Dasbor Merah | OpenSearch Status dasbor berwarna merah. Coba gunakan Dasbor saat pemutakhiran selesai. Jika status merah tetap ada, selesaikan secara manual, dan coba lagi. | 
| Cross-cluster kompatibilitas | Anda hanya dapat memutakhirkan jika kompatibilitas lintas cluster dipertahankan antara domain sumber dan tujuan setelah pemutakhiran. Selama proses peningkatan, koneksi apa pun yang tidak kompatibel akan diidentifikasi. Untuk melanjutkan, tingkatkan domain jarak jauh atau hapus koneksi yang tidak kompatibel. Perhatikan bahwa jika replikasi aktif di domain, Anda tidak dapat melanjutkannya setelah Anda menghapus koneksi.  | 
| Masalah OpenSearch layanan layanan lainnya | Masalah dengan OpenSearch Layanan itu sendiri dapat menyebabkan domain Anda ditampilkan sebagai tidak memenuhi syarat untuk peningkatan. Jika tidak ada syarat sebelumnya yang berlaku untuk domain Anda dan masalah berlanjut selama lebih dari satu hari, hubungi [Dukungan](https://console.aws.amazon.com/support/home). |