Sebelum meningkatkan versi kluster Alibaba Cloud Elasticsearch, Anda harus melakukan pemeriksaan manual yang diperlukan. Kami juga menyarankan untuk memeriksa status kluster dan kompatibilitas konfigurasi secara manual serta memodifikasi konfigurasi berdasarkan kebutuhan bisnis Anda. Topik ini menjelaskan pemeriksaan manual yang diperlukan, pemeriksaan status kluster, serta kompatibilitas konfigurasi yang direkomendasikan sebelum peningkatan versi. Ini juga menyediakan metode untuk memodifikasi konfigurasi yang tidak kompatibel.
Informasi latar belakang
Untuk informasi lebih lanjut tentang cara meningkatkan versi kluster, lihat Tingkatkan Versi Kluster.
Perintah yang disediakan dalam topik ini dapat dijalankan di konsol Kibana. Untuk informasi lebih lanjut tentang cara masuk ke konsol Kibana, lihat Masuk ke Konsol Kibana.
Lakukan pemeriksaan manual
Sebelum meningkatkan versi kluster Anda, lakukan operasi berikut secara manual:
Jalankan perintah berikut untuk memeriksa apakah kluster Anda menyimpan indeks dalam keadaan tertutup:
GET _cat/indices?v
Jika kluster Anda menyimpan indeks dalam keadaan tertutup, jalankan perintah berikut untuk membuka indeks:
POST test/_openJika ingin memperbarui kernel kluster Anda, periksa apakah ada versi kernel yang lebih baru tersedia. Anda hanya dapat memperbarui kernel kluster jika versi kernel yang lebih baru tersedia untuk kluster tersebut.
Anda dapat mengunjungi halaman Informasi Dasar kluster Anda untuk memeriksa apakah versi kernel yang lebih baru tersedia.

Periksa apakah klien digunakan untuk mengakses kluster. Jika klien digunakan, pastikan bahwa versi klien kompatibel dengan versi kluster. Jika kedua versi tidak kompatibel, tingkatkan versi klien. Untuk informasi lebih lanjut tentang kompatibilitas versi antara klien dan kluster, lihat Kompatibilitas.
Jika ingin meningkatkan versi kluster dari V5.X ke V6.X, Anda juga harus melakukan operasi berikut:
Pisahkan setiap indeks multi-tipe yang disimpan dalam kluster V5.X menjadi beberapa indeks single-tipe.
Kluster V6.X atau yang lebih baru tidak mendukung indeks multi-tipe. Jika kluster V5.X menyimpan indeks multi-tipe, Anda masih dapat menulis data ke indeks setelah versi kluster ditingkatkan ke V6.X. Namun, jika Anda membuat indeks multi-tipe di V6.X, kesalahan akan dilaporkan. Kami menyarankan untuk membagi setiap indeks multi-tipe menjadi indeks single-tipe sebelum peningkatan.
Jalankan perintah berikut untuk memeriksa apakah fitur pencarian lintas kluster diaktifkan untuk kluster. Jika fitur diaktifkan untuk kluster, parameter search.remote ditampilkan dalam hasil pengembalian, dan nilai parameter ini tidak nol.
GET _cluster/settingsJika fitur diaktifkan untuk kluster, jalankan perintah berikut untuk menonaktifkan fitur tersebut. Setelah Anda meningkatkan versi kluster, Anda dapat mengaktifkan fitur tersebut lagi.
PUT _cluster/settings { "persistent": { "search.remote.*": null }, "transient": { "search.remote.*": null } }nullParameter search.remote digunakan untuk mengonfigurasi fitur pencarian lintas kluster di V5.X, sedangkan parameter cluster.remote digunakan di V6.X.
Pemeriksaan status kluster
Saat meningkatkan versi kluster Anda, klik Pra-pemeriksaan untuk memastikan sistem memeriksa apakah status kluster dan beban kluster normal. Versi kluster Anda hanya dapat ditingkatkan jika kluster berada dalam keadaan normal dan bebannya normal. Sebelum meningkatkan versi kluster Anda, Anda juga dapat merujuk pada item yang tercantum dalam tabel berikut untuk melakukan pemeriksaan manual.
Item pemeriksaan | Keadaan normal |
Status kluster | Kluster berada dalam keadaan Normal (ditunjukkan oleh warna hijau). |
Penggunaan memori heap JVM | Penggunaan memori heap JVM kluster kurang dari 75%. |
Penggunaan disk | Penggunaan disk node kurang dari nilai cluster.routing.allocation.disk.watermark.low. |
Shard replika |
|
Snapshots | Sistem membuat snapshot untuk kluster selama satu jam terakhir. |
Plugin kustom | Kluster tidak memiliki plugin kustom yang terpasang. |
Instance ECS (Elastic Compute Service) di zona tempat kluster berada | Zona tempat kluster berada memiliki instance ECS yang cukup. null Saat Anda meningkatkan versi kluster, sistem menambahkan node versi yang lebih baru ke kluster. Kemudian, sistem memigrasikan data yang disimpan pada node asli ke node yang ditambahkan dan menghapus node asli dari kluster. Pastikan bahwa zona tempat kluster berada memiliki instance ECS yang cukup sebelum peningkatan. |
File konfigurasi YML | Kluster versi yang lebih baru kompatibel dengan file konfigurasi YML versi sebelumnya. |
Pemeriksaan kompatibilitas konfigurasi
Saat meningkatkan versi kluster ke V6.X, sistem secara otomatis memeriksa apakah ada konfigurasi yang tidak kompatibel antara versi. Jika Anda tidak memodifikasi konfigurasi yang tidak kompatibel, layanan kluster Anda mungkin terpengaruh setelah peningkatan. Untuk memastikan bahwa versi kluster dapat ditingkatkan, Anda dapat menjalankan perintah GET _cluster/settings dan GET */_settings?flat_settings=true untuk memeriksa apakah konfigurasi yang tercantum dalam tabel berikut dikonfigurasikan untuk kluster Anda sebelum melakukan peningkatan.
Jika template indeks berisi konfigurasi yang tercantum dalam tabel berikut, template tersebut tidak dapat digunakan untuk membuat indeks setelah peningkatan versi.
No. | Tingkat konfigurasi | Kategori konfigurasi | Parameter |
1 | Kluster | Pengaturan snapshot | cluster.routing.allocation.snapshot.relocation_enabled |
2 | Pengaturan pembatasan penyimpanan | indices.store.throttle.type dan indices.store.throttle.max_bytes_per_sec | |
3 | Indeks | Pengaturan kemiripan | index.similarity.base |
4 | Pengaturan replika bayangan | index.shared_filesystem dan index.shadow_replicas | |
5 | Pengaturan penyimpanan indeks | index.store.type | |
6 | Pengaturan pembatasan penyimpanan | index.store.throttle.type dan index.store.throttle.max_bytes_per_sec | |
7 | Pengaturan include_in_all dalam konfigurasi pemetaan indeks | include_in_all null Indeks yang dibuat sebelum peningkatan dari V5.X ke V6.X dan memiliki parameter ini dikonfigurasi masih dapat digunakan setelah peningkatan. Indeks yang dibuat setelah peningkatan tidak mendukung parameter ini. | |
8 | Pengaturan versi untuk pembuatan indeks | index.version.created null Parameter ini menentukan bahwa indeks tidak dapat ditingkatkan melintasi versi utama. Misalnya, Anda tidak dapat langsung meningkatkan indeks yang dibuat di V5.X ke V7.X. Sebelum peningkatan dari V5.X ke V7.X, Anda harus memanggil API reindex untuk memigrasi data dalam indeks ke kluster V7.X. Kemudian, hapus indeks dari kluster V5.X dan tingkatkan versi kluster V5.X. | |
9 | Template indeks | Pengaturan kemiripan | index.similarity.base |
10 | Pengaturan replika bayangan | index.shared_filesystem dan index.shadow_replicas | |
11 | Pengaturan penyimpanan indeks | index.store.type | |
12 | Pengaturan pembatasan penyimpanan | index.store.throttle.type dan index.store.throttle.max_bytes_per_sec | |
13 | Pengaturan include_in_all dalam konfigurasi pemetaan template indeks | include_in_all | |
14 | Pengaturan _all dalam konfigurasi pemetaan template indeks | _all | |
15 | Pengaturan tipe dalam konfigurasi pemetaan template indeks | Tidak ada null Periksa apakah konfigurasi pemetaan dalam template indeks berisi beberapa pengaturan tipe. |
Parameter yang tercantum dalam tabel di atas sudah tidak digunakan lagi di V6.0 dan yang lebih baru. Untuk informasi lebih lanjut, lihat Perubahan Besar dalam 6.0.
Item pemeriksaan di atas adalah item pemeriksaan KRITIS. Jika item pemeriksaan KRITIS dilaporkan, kluster gagal dalam pemeriksaan kompatibilitas, dan versi kluster tidak dapat ditingkatkan. Versi yang lebih baru tidak kompatibel dengan konfigurasi yang ditunjukkan oleh item pemeriksaan KRITIS. Anda harus merujuk ke Modifikasi Konfigurasi yang Tidak Kompatibel untuk memodifikasi konfigurasi yang tidak kompatibel dan melakukan pemeriksaan lagi. Jika item pemeriksaan PERINGATAN dilaporkan, kluster gagal dalam pemeriksaan kompatibilitas, tetapi versi kluster masih dapat ditingkatkan. Konfigurasi yang ditunjukkan oleh item pemeriksaan PERINGATAN diabaikan setelah peningkatan.
Modifikasi konfigurasi yang tidak kompatibel
Bagian ini menyediakan metode untuk memodifikasi konfigurasi yang tidak kompatibel.
Konfigurasi Tidak Kompatibel Tingkat Kluster
Untuk konfigurasi tidak kompatibel tingkat kluster, Anda dapat menonaktifkan konfigurasi tersebut.
Kategori konfigurasi
Perintah untuk menonaktifkan konfigurasi
Pengaturan snapshot
PUT _cluster/settings { "persistent": { "cluster.routing.allocation.snapshot.relocation_enabled": null }, "transient": { "cluster.routing.allocation.snapshot.relocation_enabled": null } }Pengaturan pembatasan penyimpanan
PUT _cluster/settings { "persistent": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null }, "transient": { "indices.store.throttle.type": null, "indices.store.throttle.max_bytes_per_sec": null } }Konfigurasi Tidak Kompatibel Tingkat Indeks
Untuk konfigurasi tidak kompatibel tingkat indeks, Anda dapat menonaktifkan konfigurasi tersebut.
Kategori konfigurasi
Perintah untuk menonaktifkan konfigurasi
Informasi tambahan
Pengaturan kemiripan
PUT test_index/_settings { "index.similarity.base.*": null }Konfigurasi ini hanya dapat dimodifikasi setelah indeks ditutup. Anda tidak dapat membaca data dari atau menulis data ke indeks yang ditutup. Setelah modifikasi, Anda dapat membuka indeks. Contoh berikut menunjukkan cara membuka dan menutup indeks test_index:
Tutup indeks
POST test_index/_closeBuka indeks
POST test_index/_open
Pengaturan replika bayangan
PUT test_index/_settings { "index.shared_filesystem": null, "index.shadow_replicas": null }Pengaturan penyimpanan indeks
PUT test_index/_settings { "index.store.type": null }Pengaturan pembatasan penyimpanan
PUT test_index/_settings { "settings": { "index.store.throttle.type": null, "index.store.throttle.max_bytes_per_sec": null } }Tidak ada.
nullIndeks yang memiliki parameter include_in_all yang dikonfigurasi masih dapat digunakan di versi yang lebih baru. Anda tidak perlu memodifikasi parameter ini.
Konfigurasi Tidak Kompatibel Tingkat Template Indeks
Contoh berikut menunjukkan cara memodifikasi konfigurasi dalam template indeks test_template:
Jalankan perintah
GET _template/test_templateuntuk menanyakan template indeks test_template.Hasil query menunjukkan bahwa template indeks berisi konfigurasi tidak kompatibel berikut: pengaturan penyimpanan indeks, _all, dan include_in_all.
{ "test_template": { "order": 0, "template": "test_*", "settings": { "index": { "store": { "throttle": { "max_bytes_per_sec": "100m" } } } }, "mappings": { "test_type": { "_all": { "enabled": true }, "properties": { "test_field": { "type": "text", "include_in_all": true } } } }, "aliases": {} } }Jalankan perintah berikut untuk menghapus konfigurasi yang tidak kompatibel dan memperbarui template indeks:
PUT _template/test_template { "order": 0, "template": "test_*", "settings": { }, "mappings": { "test_type": { "properties": { "test_field": { "type": "text" } } } }, "aliases": {} }