How to Install Elastic Search

📚 Why Elasticsearch + Unicode Matters

Traditional search engines struggle with:

• Diacritics (e.g., زبر، زیر)

• Word variations

• Complex scripts like Arabic and Urdu

Elasticsearch, combined with the ICU analyzer, solves this by:

• Normalizing Unicode text

• Ignoring diacritics

• Improving tokenization for non-Latin scripts

👉 Result: Users can search “اسلام”, “الإسلام”, or even slightly misspelled variants and still get accurate results.

---

⚙️ Step 1: Install Elasticsearch

Install Java (Prerequisite)

sudo apt update
sudo apt install openjdk-11-jdk -y

Install Elasticsearch (Compatible Version)

wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.0-amd64.deb
sudo dpkg -i elasticsearch-7.17.0-amd64.deb

---

🌐 Step 2: Configure Elasticsearch

Edit configuration:

sudo nano /etc/elasticsearch/elasticsearch.yml

Add:

cluster.name: koha-cluster
node.name: koha-node-1
network.host: 127.0.0.1
http.port: 9200

---

🌍 Step 3: Enable Unicode Support (ICU Plugin)

This is the most critical step for multilingual libraries.

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install analysis-icu
sudo systemctl restart elasticsearch

🔍 Why ICU?

The ICU plugin enables:

• Unicode normalization

• Proper handling of Arabic/Urdu morphology

• Diacritics-insensitive search

---

🔗 Step 4: Connect Koha with Elasticsearch

Install integration package:

sudo apt install koha-elasticsearch -y

Enable Elasticsearch in Koha:

sudo nano /etc/koha/koha-sites.conf

Add:

elasticsearch: 1

---

🧠 Step 5: Configure Unicode Analyzer in Koha

Edit mapping file:

/etc/koha/sites/library/elasticsearch/mappings/biblios.yaml

Add a custom analyzer:

analyzer:
  my_unicode_analyzer:
    type: custom
    tokenizer: standard
    filter: [lowercase, icu_normalizer]

---

🔄 Step 6: Rebuild Index

sudo koha-elasticsearch --rebuild -v -f library

This step ensures all bibliographic records are indexed with Unicode support.

---

⚡ Step 7: Enable Plack for High Performance

Koha without Plack reloads Perl for every request—this slows everything down.

With Plack:

• Faster OPAC

• Reduced server load

• Persistent processes

Install Plack

sudo apt install libplack-perl -y

Enable Plack

sudo nano /etc/koha/koha-sites.conf

Add:

plack: 1

---

🔧 Step 8: Configure Plack Workers

Edit:

/etc/koha/sites/library/koha-conf.xml

Add:

<plack_workers>5</plack_workers>

---

▶️ Step 9: Start Plack

sudo koha-plack --enable library
sudo koha-plack --start library

Restart everything:

sudo systemctl restart apache2
sudo systemctl restart elasticsearch
sudo koha-plack --restart library

---

🧪 Testing Your Setup

Try searching in OPAC:

• اسلام

• القرآن

• Hadith / حدیث

✔ Expected results:

• Diacritics ignored

• Variants matched

• Faster response

---

⚠️ Common Issues & Solutions

Elasticsearch not responding

curl http://localhost:9200

Unicode search not working

• Check ICU plugin installation

• Rebuild index

Plack not running

sudo koha-plack --status library

---

📈 Performance Optimization Tips

• Set Elasticsearch memory:

/etc/elasticsearch/jvm.options

-Xms1g
-Xmx1g

• Use 4–8 Plack workers depending on RAM

• Schedule regular indexing for large catalogs

---

🔬 Advanced Enhancements

Take your Koha to the next level:

• Synonym filters for Islamic terminology

• Autocomplete using edge-ngram

• Authority control integration

• Relevance ranking (boost title fields)

---

📖 Conclusion

By integrating Elasticsearch with Unicode support and enabling Plack, your Koha becomes:

• Multilingual

• Faster

• More intelligent

This setup is especially critical for institutions dealing with Islamic studies, Arabic, and Urdu collections, where traditional search fails to deliver precision.

---

📚 Further Reading (For Deeper Understanding)

• Multilingual Information Retrieval Systems

• Unicode Normalization and ICU Standards

• Elasticsearch Indexing & Ranking Algorithms

• Koha Architecture (Zebra vs Elasticsearch)

• PSGI/Plack Performance Engineering

---

📑 References

• Koha Community Documentation (Elasticsearch Integration)

• Elasticsearch Official Documentation (Analysis Plugins)

• Unicode ICU Documentation

• PSGI/Plack Perl Framework Guides

---

If you want, I can also prepare:

• A fully optimized Urdu/Arabic biblios.yaml file

• A ready-to-deploy Koha DevOps script

• Or a research paper-style write-up for publication