FreeBSD Elasticsearch - Cara Mengaktifkan Pencarian Teks Lengkap App Store di NextCloud

Salah satu kemampuan Nextcloud adalah mendukung pencarian melalui antarmuka web dan di klien. Dalam mode ini, pencarian didasarkan pada nama file yang dibandingkan dan konten file tidak dicari. Namun, ada opsi lain yang dapat digunakan untuk menyiapkan pencarian teks lengkap.

Aplikasi Elasticsearch sering digunakan sebagai sarana bagi organisasi atau perusahaan untuk menyajikan informasi dengan cepat dan efisien. Berkat fleksibilitas dan keserbagunaannya, Elasticsearch menjadi salah satu mesin pencari yang paling banyak digunakan dan populer di dunia.

Pada server Nextcloud, Elasticsearch merupakan tulang punggung pencarian teks lengkap. Jika Anda ingin menggunakan Elasticsearch sebagai mesin pencari, Nextcloud dan Elasticsearch harus diinstal secara terpisah atau independen. Elasticsearch adalah mesin pencari berbasis Java, jadi langkah pertama adalah memastikan bahwa Java telah diinstal. Anda harus memeriksa apakah Java telah diinstal pada server FreeBSD Anda.

1. Cara Install Elasticsearch

Pada FreeBSD, proses konfigurasi Elasticsearch sangat sederhana dan proses instalasinya tidak terlalu rumit. Anda hanya perlu menginstal Elasticsearch melalui paket pkg dengan mengetik perintah di bawah ini.

Update Package PKG

root@ns3:~ # pkg update -f
root@ns3:~ # pkg upgrade -f

Install Elasticsearch

root@ns3:~ # pkg install elasticsearch8

Setelah itu, Anda aktifkan elasticsearch7 agar dapat berjalan otomatis saat komputer di-boot ulang.

/etc/rc.conf

root@ns3:~ # ee /etc/rc.conf
elasticsearch_enable="YES"
elasticsearch_user="elasticsearch"
elasticsearch_group="elasticsearch"
elasticsearch_config="/usr/local/etc/elasticsearch"
##elasticsearch_config="/usr/local/etc/elasticsearch/elasticsearch.yml"
elasticsearch_login_class="root"
elasticsearch_java_home="/usr/local/openjdk11"

Kami melanjutkan dengan menginstal Java openjdk17.

/usr/ports/java/openjdk17

root@ns3:~ # cd /usr/ports/java/openjdk17
root@ns3:~ # make install clean

Anda dapat membaca panduan lengkap tentang cara menginstal Java OpenJDK di FreeBSD dalam artikel berikut.

Memasang dan Mengkonfigurasi Java OpenJDK 20 di FreeBSD 14

Karena kita akan menggunakan "Elasticsearch" dengan "Full Text Search" milik Nextcloud, pustaka readline PHP diperlukan untuk menghubungkan Elasticsearch dan Full Text Search. Jalankan perintah berikut untuk menginstal PHP readline.

Install php82-readline

root@ns3:~ # pkg install php82-readline

Langkah selanjutnya adalah mengonfigurasi file elasticsearch.yml. Aktifkan beberapa skrip seperti contoh di bawah ini.

/usr/local/etc/elasticsearch/elasticsearch.yml

root@ns3:~ # ee /usr/local/etc/elasticsearch/elasticsearch.yml
cluster.name: nextcloud2
node.name: node-1
path.data: /var/db/elasticsearch
path.logs: /var/run/elasticsearch
bootstrap.memory_lock: true
network.host: 192.168.5.2
http.port: 9200
discovery.seed_hosts: ["127.0.0.1", "[::1]"]
discovery.type: single-node
xpack.ml.enabled: false
xpack.security.enabled: false
xpack.security.enrollment.enabled: false

Tambahkan plugin penyerapan Elasticsearch.

Install plugin elasticsearch

root@ns3:~ # /usr/local/lib/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Mulai ulang (restart) Elasticsearch.

Restart elasticsearch

root@ns3:~ # service elasticsearch restart

Periksa apakah elasticsearch berjalan atau tidak.

Check elasticsearch

root@ns3:~ # curl -XGET '192.168.5.2:9200/?pretty'

2. Cara Instal Full Text Search Nextcloud

Setelah Anda selesai menginstal Elasticsearch, lanjutkan dengan menginstal Nextcloud Full Text Search. Ikuti perintah di bawah ini untuk menginstal dan mengaktifkan Full Text Search.

Install Full Tetxt Search

root@ns3:~ # occ app:install files_fulltextsearch
root@ns3:~ # occ app:install fulltextsearch
root@ns3:~ # occ app:install fulltextsearch_elasticsearch

Setelah itu Anda aktifkan Pencarian Teks Lengkap.

Enable Full Tetxt Search

root@ns3:~ # occ app:enable files_fulltextsearch
root@ns3:~ # occ app:enable fulltextsearch
root@ns3:~ # occ app:enable fulltextsearch_elasticsearch

Sekarang Anda dapat langsung menghubungkan Nextcloud dengan elastic search. Silakan masuk ke akun Nextcloud Anda, lalu klik menu pengaturan Administrasi dan menu pencarian teks lengkap. Ikuti panduan gambar di bawah ini.

Pada menu "Address of the Servlet", ketik alamat IP elasticsearch, yaitu "http://192.168.5.2:9200/". Pada menu index, ketik juga "nextcloud2", sesuaikan dengan skrip "cluster.name:nextcloud2" pada file elasticsearch.yml.

Setelah itu Anda jalankan Generate search index, struktur search index dilakukan di konsol dengan command line, berikut contoh perintah yang harus Anda jalankan.

Generating the search index

root@ns3:~ # cd /usr/local/www/nextcloud
root@ns3:/usr/local/www/nextcloud # occ fulltextsearch:index

Untuk memastikan pencarian teks lengkap telah diindeks ke "App Store" Nextcloud, jalankan dua baris perintah di bawah ini.

Check and test

root@ns3:/usr/local/www/nextcloud # occ fulltextsearch:check
root@ns3:/usr/local/www/nextcloud # occ fulltextsearch:test

Langkah terakhir adalah menjalankan server web Apache.

Run Apache24

root@ns3:~ # service apache24 restart

Dengan mengatur bagian ini di situs web Nextcloud, kini server Nextcloud Anda telah terhubung dengan elasticsearch. Anda dapat melakukan pencarian secara efisien, aman, dan dengan kinerja tinggi. Tidak hanya itu, elasticsearch juga mampu menganalisis data dengan cepat dan dalam jumlah besar.