Elasticsearch:Pemeriksaan upgrade

Periksa indeks yang ditutup

Jalankan perintah berikut untuk menampilkan daftar semua indeks beserta statusnya:

GET _cat/indices?v

Output menampilkan setiap indeks dengan statusnya di kolom status. Jika ada indeks yang menunjukkan status close, buka indeks tersebut sebelum upgrade:

POST test/_open

Periksa ketersediaan versi kernel

Jika Anda berencana memperbarui kernel kluster sebagai bagian dari upgrade, verifikasi bahwa versi kernel yang lebih baru tersedia di halaman Basic Information kluster Anda.

Anda hanya dapat memperbarui kernel jika versi yang lebih baru tercantum.

Periksa kompatibilitas client

Jika client terhubung ke kluster, pastikan versinya kompatibel dengan versi kluster target. Untuk detail kompatibilitas versi, lihat Compatibility. Jika versinya tidak kompatibel, upgrade client terlebih dahulu sebelum melanjutkan.

Pisahkan indeks multi-tipe

V6.X dan versi setelahnya tidak mendukung indeks multi-tipe. Jika kluster memiliki indeks multi-tipe, penulisan ke indeks tersebut tetap berfungsi setelah upgrade, tetapi pembuatan indeks multi-tipe baru di V6.X akan menyebabkan error. Pisahkan setiap indeks multi-tipe menjadi indeks single-tipe sebelum upgrade.

Nonaktifkan pencarian lintas klaster

Jalankan perintah berikut untuk memeriksa apakah pencarian lintas klaster diaktifkan:

GET _cluster/settings

Jika search.remote muncul dalam hasil dengan nilai non-null, berarti pencarian lintas klaster diaktifkan. Nonaktifkan fitur ini sebelum upgrade:

PUT _cluster/settings
{
  "persistent": {
    "search.remote.*": null
  },
  "transient": {
    "search.remote.*": null
  }
}

Setelah upgrade, Anda dapat mengaktifkan kembali pencarian lintas klaster.

Konfigurasi tingkat kluster

Nonaktifkan konfigurasi tidak kompatibel tingkat kluster dengan mengatur nilainya menjadi null.

Pengaturan snapshot:

PUT _cluster/settings
{
  "persistent": {
    "cluster.routing.allocation.snapshot.relocation_enabled": null
  },
  "transient": {
    "cluster.routing.allocation.snapshot.relocation_enabled": null
  }
}

Pengaturan pembatasan kecepatan 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 tingkat indeks

Nonaktifkan konfigurasi tidak kompatibel tingkat indeks dengan mengatur nilainya menjadi null. Ganti test_index dengan nama indeks Anda.

Pengaturan similarity memerlukan penutupan indeks terlebih dahulu. Indeks yang ditutup tidak dapat dibaca atau ditulis. Buka kembali indeks setelah melakukan perubahan.

Tutup indeks:

POST test_index/_close

Perbarui pengaturan:

PUT test_index/_settings
{
  "index.similarity.base.*": null
}

Buka indeks:

POST test_index/_open

Pengaturan shadow replica:

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 kecepatan penyimpanan:

PUT test_index/_settings
{
  "settings": {
    "index.store.throttle.type": null,
    "index.store.throttle.max_bytes_per_sec": null
  }
}

Konfigurasi tingkat templat indeks

Contoh berikut menunjukkan cara memperbaiki konfigurasi tidak kompatibel dalam templat indeks bernama test_template.

1. Ambil templat saat ini:

   GET _template/test_template

   Hasilnya menampilkan konfigurasi yang tidak kompatibel — dalam contoh ini, 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": {}
     }
   }

2. Hapus konfigurasi yang tidak kompatibel dan perbarui templat:

   PUT _template/test_template
   {
      "order": 0,
      "template": "test_*",
      "settings": {
      },
      "mappings": {
        "test_type": {
          "properties": {
            "test_field": {
              "type": "text"
            }
          }
        }
      },
      "aliases": {}
   }