Topik ini menjelaskan cara menangani masalah yang mungkin terjadi saat menginstal plug-in kustom. Masalah-masalah tersebut meliputi kesalahan yang dilaporkan di konsol, penangguhan pembaruan kluster, dan kegagalan verifikasi.
Deskripsi masalah
Saat Anda mengunggah dan menginstal plug-in kustom, beberapa masalah dapat terjadi seperti kesalahan yang dilaporkan di konsol, penangguhan pembaruan kluster, dan kegagalan verifikasi.
Solusi umum
Sebelum mengunggah dan menginstal plug-in kustom, letakkan plug-in tersebut di folder plugins di bawah jalur instalasi kluster Elasticsearch yang dikelola sendiri. Kemudian, mulai ulang kluster untuk memuat plug-in. Setelah kluster dimulai ulang, jalankan perintah
GET /_cat/plugins?v untuk memeriksa apakah plug-in telah diinstal. Saat menginstal plug-in, perhatikan hal-hal berikut:- Anda tidak dapat mengunggah plug-in dengan nama yang sama dengan plug-in bawaan yang disediakan oleh Alibaba Cloud Elasticsearch. Jika plug-in yang ingin Anda unggah memiliki nama yang sama dengan plug-in bawaan, ubah nama plug-in sebelum mengunggahnya. Saat menguji instalasi plug-in seperti analisis pinyin atau analisis IK pada kluster Elasticsearch yang dikelola sendiri, hapus terlebih dahulu plug-in asli yang sesuai. Lalu, ubah nama plug-in yang ingin Anda instal dan instal menggunakan perintah instalasi yang digunakan untuk plug-in asli. Jika berhasil, Anda dapat mengunggah dan menginstal plug-in ke kluster Elasticsearch Alibaba Cloud Anda.
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip - Plug-in kustom hanya dapat diunggah dan diinstal ke kluster Elasticsearch Alibaba Cloud setelah diuji pada kluster Elasticsearch yang dikelola sendiri. Plug-in kustom ini diinstal menggunakan perintah instalasi yang digunakan untuk plug-in asli:
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip - Pembaruan bergulir tidak tersedia untuk plug-in kustom.
- Anda tidak diizinkan mengunggah plug-in yang kebijakan keamanannya mendefinisikan izin tambah, hapus, ubah, dan kueri, seperti plug-in elasticsearch-analysis-hanlp.
- Plug-in kustom tidak dapat diinstal untuk Logstash dan Kibana. Jika ingin menginstal plug-in kustom untuk Logstash atau Kibana, instal terlebih dahulu plug-in tersebut pada kluster Elasticsearch yang dikelola sendiri menggunakan perintah instalasi untuk plug-in asli. Setelah plug-in diinstal, ajukan tiket kepada insinyur dukungan teknis Elasticsearch Alibaba Cloud. null Setelah plug-in yang memenuhi persyaratan diinstal, Anda dapat menanyakan log plug-in di tab Log Kluster pada konsol Elasticsearch Alibaba Cloud.
Kesalahan yang dilaporkan di konsol
- Penyebab
Plug-in yang diunggah tidak memenuhi persyaratan.
- Solusi
Ubah informasi plug-in. Untuk informasi lebih lanjut, lihat Solusi Umum. Sebagai contoh, Anda dapat mengganti nama plug-in atau memodifikasi file konfigurasi plug-in.
Penangguhan pembaruan kluster
Jika pembaruan kluster ditangguhkan, lakukan langkah-langkah berikut untuk menyelesaikan masalah:
- Periksa ukuran plug-in. Pastikan ukurannya kurang dari 50 MB.
Jika ukuran plug-in lebih besar dari atau sama dengan 50 MB, plug-in dimuat dengan kecepatan rendah selama instalasi. Dalam kasus ini, hentikan tugas pemuatan dan hapus plug-in. Lalu, modifikasi konfigurasi plug-in. Sebagai contoh, hapus beberapa token yang disediakan oleh plug-in. Pastikan ukuran plug-in kurang dari 50 MB sebelum mengunggah dan menginstal plug-in lagi.
- Periksa apakah sistem sedang menulis data ke node data.
- Ya: Tunggu beberapa menit. Proses instalasi lambat karena instalasi dilakukan selama jam sibuk.
- Tidak: Hentikan instalasi. Lalu, hapus plug-in dan uji kembali ketersediaan plug-in.
Kegagalan verifikasi
Tabel berikut menjelaskan penyebab kegagalan verifikasi dan solusi untuk kegagalan tersebut.
| Masalah | Penyebab | Solusi |
| Versi Elasticsearch yang ditentukan untuk plug-in tidak sesuai dengan versi kluster Elasticsearch Alibaba Cloud Anda. | Versi Elasticsearch yang ditentukan untuk plug-in tidak sesuai dengan versi kluster Elasticsearch Alibaba Cloud Anda. | Ubah versi Elasticsearch yang ditentukan untuk plug-in dan kemas ulang plug-in. Untuk beberapa plug-in seperti Jieba, pastikan bahwa versi Elasticsearch yang ditentukan untuk plug-in sesuai dengan versi kluster Elasticsearch Alibaba Cloud Anda. Untuk informasi lebih lanjut, lihat FAQ. |
| File plugin-descriptor.properties dari plug-in tidak dapat ditemukan. | File plugin-descriptor.properties dari plug-in tidak dapat ditemukan setelah paket plug-in diekstraksi. | Periksa apakah tingkat direktori tambahan dihasilkan setelah paket plug-in diekstraksi. Sebagai contoh, gunakan WinRAR untuk decompress a package on your computer to the current folder. Dalam kasus ini, file yang diperoleh setelah ekstraksi adalah file JAR, dan tingkat direktori file JAR tersebut benar. Jika file JAR berada di folder lain, tingkat direktori file JAR salah. Dalam kasus ini, Anda harus mengemas ulang file JAR. Untuk informasi lebih lanjut tentang metode yang tepat yang dapat digunakan untuk mengemas file JAR, lihat solusi untuk masalah berikutnya. |
| Paket plug-in tidak valid. | Plug-in tidak dikemas berdasarkan persyaratan terkait. Akibatnya, paket yang diperoleh tidak valid. | Gunakan metode yang tepat untuk mengemas ulang plug-in. Anda dapat menggunakan salah satu metode berikut untuk mengemas plug-in:
|
| Plug-in memiliki masalah keamanan. | Kebijakan keamanan plug-in berisi informasi izin sensitif. | Uji instalasi plug-in pada kluster Elasticsearch yang dikelola sendiri sebelum menginstal plug-in pada kluster Elasticsearch Alibaba Cloud Anda. Untuk informasi lebih lanjut, lihat Solusi Umum. |
null Setelah menyelesaikan masalah yang dijelaskan dalam tabel sebelumnya, letakkan paket plug-in di folder plugins dan jalankan perintah
./bin/elasticsearch-plugins install untuk menguji instalasi plug-in pada kluster Elasticsearch yang dikelola sendiri sebelum menginstal plug-in pada kluster Elasticsearch Alibaba Cloud Anda. Jika plug-in gagal diinstal, uji kembali ketersediaan plug-in berdasarkan pesan kesalahan yang muncul. Anda hanya dapat mengunggah dan menginstal plug-in ke kluster Elasticsearch Alibaba Cloud Anda setelah plug-in lulus uji ketersediaan.