View a markdown version of this page

Meningkatkan domain OpenSearch Layanan Amazon - OpenSearch Layanan Amazon
Jalur peningkatan yang didukungMemecahkan masalah kegagalan validasiMemecahkan masalah peningkatan

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

Meningkatkan domain OpenSearch Layanan Amazon

catatan

OpenSearch dan peningkatan versi Elasticsearch berbeda dari pembaruan perangkat lunak layanan. Untuk informasi tentang memperbarui perangkat lunak layanan untuk domain OpenSearch Layanan Anda, lihatPembaruan perangkat lunak layanan di Amazon OpenSearch Service.

Amazon OpenSearch Service menawarkan peningkatan di tempat untuk domain yang menjalankan OpenSearch 1.0 atau lebih baru, atau Elasticsearch 5.1 atau yang 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 OpenSearch sebelum bermigrasi.

Jalur peningkatan yang didukung

Saat ini, OpenSearch Layanan mendukung jalur pemutakhiran berikut:

Dari versi Ke versi
OpenSearch 1.3, 2. x, atau 3. x

OpenSearch 3. x

Jika Anda menjalankan OpenSearch 1.3 atau 2.x, Anda harus terlebih dahulu meningkatkan ke OpenSearch 2.19 sebelum memutakh irkan ke OpenSearch 3.x.

Saat memutakhirkan dari OpenSearch 2.19 ke OpenSearch 3.x, Anda mungkin perlu mengatasi pengaturan indeks yang tidak kompatibel berikut ini. Ini tidak digunakan lagi sebelumnya di 2.x dan akan menyebabkan kegagalan validasi pemeriksaan peningkatan jika tidak dihapus.

  • index.knn.algo_param.ef_konstruksi

  • index.knn.algo_param.m

  • index.knn.tipe_ruang

  • index.store.hybrid.mmap.ekstensi

Untuk informasi selengkapnya tentang pengaturan indeks yang tidak digunakan lagi dan langkah-langkah untuk memperbaikinya, lihat Pengaturan indeks. Untuk daftar lengkap perubahan besar untuk OpenSearch 3.x, lihat 3. 0.0.

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:

  1. Migrasikan indeks ke penyimpanan panas.

  2. Mengindeks ulang data.

  3. Migrasikan indeks kembali ke penyimpanan hangat atau dingin.

Atau, hapus indeks jika Anda tidak lagi membutuhkannya.

Foto diambil pada OpenSearch 1. x dan pada Elasticsearch 7.10 dan versi sebelumnya tidak kompatibel dengan OpenSearch 3.x.

Untuk repositori snapshot manual, hapus snapshot yang tidak kompatibel ini sebelum memutakhirkan ke OpenSearch 3.x.
OpenSearch 1.3 atau 2. x

OpenSearch 2. x

OpenSearch 2.17 akan mengaktifkan pencarian segmen bersamaan secara default dengan mode otomatis jika domain memenuhi kondisi berikut:

  • Tidak ada pengaturan pencarian bersamaan sebelumnya yang ditetapkan secara eksplisit.

  • Semua instance data (panas dan hangat) memiliki tipe instans.2xl atau lebih.

  • Rata-rata pemanfaatan cpu p90 pada instans data (panas dan hangat) selama lebih dari 1 minggu di bawah 45%.

    Untuk detail selengkapnya tentang pengaturan pencarian segmen bersamaan di sini, lihat Pencarian segmen bersamaan.

Versi 2.3 memiliki perubahan besar berikut:

  • typeParameter telah dihapus dari semua titik OpenSearch akhir API di versi 2.0. Untuk informasi selengkapnya, lihat perubahan yang merusak.

  • Jika domain Anda berisi indeks (panas, UltraWarm, atau dingin) yang awalnya dibuat di Elasticsearch 6.8, indeks tersebut tidak kompatibel dengan 2.3. OpenSearch

    Sebelum Anda memutakhirkan ke versi 2.3, Anda harus mengindeks ulang indeks yang tidak kompatibel. Untuk indeks UltraWarm yang tidak kompatibel atau dingin, migrasikan ke penyimpanan panas, indeks ulang data, lalu migrasikan kembali ke penyimpanan hangat atau dingin. Sebagai alternatif, Anda dapat menghapus indeks jika Anda tidak lagi membutuhkannya.

    Jika Anda secara tidak sengaja memutakhirkan domain ke versi 2.3 tanpa melakukan langkah-langkah ini terlebih dahulu, Anda tidak akan dapat memigrasikan indeks yang tidak kompatibel dari tingkat penyimpanan saat ini. Satu-satunya pilihan Anda adalah menghapusnya.
OpenSearch 1. x OpenSearch 1. x
Pencarian Elastik 7. x

Pencarian Elastik 7. x atau OpenSearch 1. x

penting

OpenSearch 1. x memperkenalkan banyak perubahan yang merusak. Lihat perinciannya di Ganti nama OpenSearch Layanan Amazon - Ringkasan perubahan.

Elasticsearch 6.8

Pencarian Elastik 7. x atau OpenSearch 1. x

penting

Elasticsearch 7.0 dan OpenSearch 1.0 mencakup banyak perubahan besar. Sebelum memulai peningkatan di tempat, kami sarankan untuk mengambil snapshot manual dari 6. domain x, mengembalikannya pada tes 7. x atau OpenSearch 1. domain x, dan menggunakan domain uji tersebut untuk mengidentifikasi potensi masalah peningkatan. Untuk memecahkan perubahan di OpenSearch 1.0, lihatGanti nama OpenSearch Layanan Amazon - Ringkasan perubahan.

Seperti Elasticsearch 6. x, indeks hanya dapat berisi satu jenis pemetaan, tetapi tipe itu sekarang harus diberi _doc nama. Akibatnya, API tertentu tidak lagi memerlukan jenis pemetaan di isi permintaan (seperti API _bulk).

Untuk indeks baru, Elasticsearch yang di-host sendiri 7. x dan OpenSearch 1. x memiliki jumlah pecahan default satu. OpenSearch Domain layanan di Elasticsearch 7. x dan yang lebih baru mempertahankan default sebelumnya dari lima.

Pencarian Elastik 6. x

Pencarian Elastik 6. x

Pencarian Elastik 5.6

Pencarian Elastik 6. x

penting

Indeks dibuat dalam versi 6. x tidak lagi mendukung beberapa jenis pemetaan. Indeks dibuat dalam versi 5. x masih mendukung beberapa jenis pemetaan saat dipulihkan menjadi 6. kluster x. Periksa apakah kode klien Anda hanya membuat satu jenis pemetaan per indeks.

Untuk meminimalkan downtime selama peningkatan dari Elasticsearch 5.6 ke 6. x, OpenSearch Service merubah .kibana indeks ke.kibana-6, menghapus.kibana, membuat alias bernama.kibana, dan memetakan indeks baru ke alias baru.
Pencarian Elastik 5. x Pencarian Elastik 5. x

Proses peningkatan terdiri dari tiga langkah:

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

  2. Snapshot — OpenSearch Layanan mengambil snapshot dari OpenSearch cluster Elasticsearch dan tidak melanjutkan ke langkah berikutnya kecuali snapshot berhasil. Jika pemutakhiran gagal, OpenSearch Layanan menggunakan snapshot ini untuk mengembalikan cluster ke keadaan semula. Untuk mengetahui informasi selengkapnya, lihat Tidak dapat menurunkan versi setelah peningkatan.

  3. 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

Saat Anda memulai peningkatan OpenSearch versi Elasticsearch, OpenSearch Layanan terlebih dahulu melakukan serangkaian pemeriksaan validasi untuk memastikan bahwa domain Anda memenuhi syarat untuk peningkatan. Jika salah satu dari pemeriksaan ini gagal, Anda menerima pemberitahuan berisi masalah spesifik yang harus Anda perbaiki sebelum memutakhirkan domain Anda. Untuk daftar masalah potensial dan langkah-langkah untuk menyelesaikannya, lihatMemecahkan masalah kesalahan validasi.

Memecahkan masalah peningkatan

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 memutakhirkan 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 yang diinstal yang tidak tersedia untuk versi target, permintaan peningkatan 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 cluster Anda saat ini melebihi pengaturan ini, OpenSearch Layanan tidak mengizinkan Anda untuk meningkatkan. Lihat Melampaui batas serpihan maksimum 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 dalam cluster berwarna merah. Untuk langkah-langkah pemecahan masalah, lihat Status klaster merah.
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 Split brain berarti cluster Anda memiliki lebih dari satu node master dan telah terpecah 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. Untuk bantuan pemulihan dari split brain, hubungi Dukungan.
Simpul utama tidak ditemukan OpenSearch Layanan tidak dapat menemukan node master cluster. Jika domain Anda menggunakan multi-AZ, kegagalan Availability Zone mungkin telah menyebabkan klaster kehilangan kuorum dan tidak dapat memilih simpul utama yang baru. Jika masalah tidak teratasi sendiri, hubungi Dukungan.
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.
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.
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, peningkatan 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.
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. Mengindeks 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 OpenSearch Dasbor sebelumnya. Ulangi indeks dan coba lagi.
Status Dasbor Merah OpenSearch Status dasbor berwarna merah. Coba gunakan Dasbor saat peningkatan selesai. Jika status merah tetap ada, selesaikan secara manual, dan coba lagi.
Cross-cluster kompatibilitas

Anda hanya dapat meningkatkan 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.