Dokumen - Elasticsearch - Alibaba Cloud Documentation Center

Atasi error instalasi plug-in kustom

Instalasi plug-in kustom pada Alibaba Cloud Elasticsearch dapat gagal dengan error yang dilaporkan di Konsol, penangguhan pembaruan kluster, atau kegagalan verifikasi. Topik ini membantu Anda mengidentifikasi penyebab dan menyelesaikan setiap jenis kegagalan tersebut.

Sebelum Anda menginstal

Tinjau batasan berikut sebelum mengunggah plug-in kustom. Pelanggaran terhadap batasan ini merupakan penyebab paling umum dari kegagalan instalasi.

Batas ukuran: Paket plug-in harus berukuran kurang dari 50 MB. Paket yang lebih besar dimuat secara lambat dan menyebabkan penangguhan pembaruan kluster.
Tidak boleh ada nama duplikat: Plug-in kustom tidak boleh memiliki nama yang sama dengan plug-in bawaan Alibaba Cloud Elasticsearch. Ganti nama plug-in sebelum mengunggahnya.
Uji terlebih dahulu pada kluster yang dikelola sendiri: Setiap plug-in kustom harus lulus uji instalasi lokal sebelum diunggah ke Alibaba Cloud Elasticsearch. Gunakan perintah berikut untuk menguji:
```
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip
```
Letakkan paket plug-in di direktori plugins di bawah path instalasi kluster Elasticsearch yang dikelola sendiri, restart kluster, lalu jalankan perintah berikut untuk memastikan plug-in telah dimuat:
```
GET /_cat/plugins?v
```
Tidak ada pembaruan rolling: Pembaruan rolling tidak tersedia untuk plug-in kustom.
Batasan kebijakan keamanan: Plug-in yang kebijakan keamanannya mendefinisikan izin tambah, hapus, ubah, dan kueri (misalnya, elasticsearch-analysis-hanlp) tidak dapat diunggah.
Logstash dan Kibana: Plug-in kustom tidak dapat diinstal langsung untuk Logstash atau Kibana. Uji plug-in pada kluster yang dikelola sendiri menggunakan perintah instalasi aslinya, lalu submit a ticket kepada tim dukungan teknis Alibaba Cloud Elasticsearch.

Setelah plug-in berhasil diinstal, lihat log-nya di tab Cluster Log pada Konsol Alibaba Cloud Elasticsearch.

Error yang dilaporkan di Konsol

Penyebab: Plug-in tidak memenuhi persyaratan.

Solusi: Periksa batasan di bagian Sebelum Anda menginstal. Tindakan umum mencakup mengganti nama plug-in atau memodifikasi file konfigurasinya untuk menghapus izin yang tidak diizinkan.

Penangguhan pembaruan kluster

Jika pembaruan kluster ditangguhkan setelah Anda menginstal plug-in, periksa hal-hal berikut:

Periksa ukuran plug-in. Jika paket berukuran 50 MB atau lebih besar, hentikan instalasi, hapus plug-in, dan kurangi ukurannya (misalnya, dengan menghapus kamus token yang tidak diperlukan) hingga di bawah 50 MB. Kemudian unggah ulang dan instal kembali.
Periksa apakah kluster sedang menulis data. Jalankan kueri untuk melihat apakah node data aktif.
- Ya, data sedang ditulis: Tunggu beberapa menit. Instalasi berjalan lambat selama jam sibuk dan akan selesai secara otomatis.
- Tidak ada data yang ditulis: Hentikan instalasi, hapus plug-in, dan uji kembali pada kluster yang dikelola sendiri sebelum mengunggah ulang.

Kegagalan verifikasi

Tabel berikut mencantumkan error verifikasi umum, penyebabnya, dan solusinya.

Error	Penyebab	Perbaikan
Ketidaksesuaian versi Elasticsearch	Versi Elasticsearch dalam deskriptor plug-in tidak sesuai dengan versi kluster Alibaba Cloud Elasticsearch Anda.	Perbarui versi dalam deskriptor plug-in agar persis sesuai dengan versi kluster Anda (misalnya, `7.10.1`). Untuk plug-in seperti Jieba, versi harus sesuai hingga tingkat Patch. Lalu buat ulang paketnya. Untuk informasi lebih lanjut, lihat FAQ.
`plugin-descriptor.properties` tidak ditemukan	File deskriptor tidak ada dalam paket yang diekstraksi, biasanya karena tingkat direktori tambahan dibuat saat pengemasan.	Ekstrak paket secara lokal dan periksa struktur direktorinya. Pastikan tidak terdapat tingkat direktori berlebih setelah ekstraksi. File JAR harus berada pada tingkat direktori yang benar, bukan bersarang di dalam folder tambahan. Jika strukturnya salah, buat ulang paket plug-in tersebut.
Paket plug-in tidak valid	Plug-in tidak dikemas dengan benar. Elasticsearch mengharapkan biner, bukan kode sumber.	Buat ulang paket menggunakan salah satu metode berikut: WinRAR: Klik kanan file JAR, pilih Add to archive, atur format ke ZIP, dan beri nama arsip dengan awalan `elasticsearch` diikuti versinya (misalnya, `elasticsearch-analysis-ik-6.7.0.zip`). Command line: Jalankan `zip -r` untuk mengemas file yang diinginkan.
Masalah keamanan	Kebijakan keamanan plug-in berisi izin sensitif.	Uji plug-in terlebih dahulu pada kluster Elasticsearch yang dikelola sendiri. Lihat prosedur pengujian di bagian Sebelum Anda menginstal.

Setelah menyelesaikan salah satu error di atas, letakkan paket plug-in di direktori plugins dan jalankan perintah berikut untuk menguji ulang pada kluster yang dikelola sendiri:

./bin/elasticsearch-plugins install

Unggah plug-in ke Alibaba Cloud Elasticsearch hanya setelah lulus uji ketersediaan lokal ini. Jika pengujian gagal, periksa pesan error dan ulangi langkah-langkah di atas.