ElasticSearch Installation for AlmaLinux — Step-by-Step XenForo Enhanced S

[Aior]

ElasticSearch ve XenForo — Neden Önemli?​

XenForo'nun yerleşik MySQL tabanlı araması küçük topluluklarda yeterli olsa da binlerce konu, yüz binlerce mesaj barındıran ileri seviyede toplulukların ihtiyaçlarını karşılayamaz. Sorgular yavaşlar, alaka sıralaması zayıflar ve sunucu yükü artar. XenForo Enhanced Search eklentisiyle birlikte kullanılan ElasticSearch, foruma cümle düzeyinde alakalı, milisaniyelik sonuçlar veren bir arama deneyimi kazandırır.

Bu rehberde AlmaLinux 8/9 üzerinde ElasticSearch 8.x kurulumunun pratik adımlarını paylaşıyoruz. Test edilmiş ve bizim AIOR forum altyapımızda da kullandığımız yöntemdir.

Ön Hazırlık​

ElasticSearch JVM tabanlı çalışır, en az 2 GB RAM önerilir; üretim ortamı için 4 GB+ tavsiye edilir. Sunucunuza SSH ile root kullanıcısı olarak bağlanın:

ssh root@sunucu-ip

Sistem paketlerini güncelleyin ve eski kurulumlardan kalan parçaları temizleyin:

sudo dnf update -y
sudo dnf clean all
sudo dnf remove elasticsearch -y

ElasticSearch Repository'sini Ekleme​

Elastic.co resmi GPG anahtarını içe aktarıp yum repo dosyasını oluşturuyoruz:

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

cat > /etc/yum.repos.d/elasticsearch.repo <<EOF
[elasticsearch]
name=Elasticsearch repository for 8.x packages
baseurl=https://artifacts.elastic.co/packages/8.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md
EOF

Kurulum ve İlk Çalıştırma​

Repo'yu etkinleştirip ElasticSearch'i kuruyoruz:

sudo dnf install --enablerepo=elasticsearch elasticsearch -y

Kurulum tamamlandığında üretilen elastic kullanıcı şifresini, kayıt token'ını ve sertifika parmak izini bir yere not edin — daha sonra XenForo arayüzünden bağlantı için gerekecek.

Servisi başlatın ve sistem yeniden başlatıldığında otomatik açılması için etkinleştirin:

sudo systemctl daemon-reload
sudo systemctl enable --now elasticsearch

Servisin sağlıklı çalıştığını doğrulayın:

curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic https://localhost:9200

JSON formatında küme bilgilerini gördüğünüzde kurulum başarılıdır.

Güvenlik ve Erişim Kontrolü​

ElasticSearch asla internete açık olarak çalıştırılmamalıdır. /etc/elasticsearch/elasticsearch.yml dosyasında network.host: 127.0.0.1 olarak ayarlayın; XenForo aynı sunucuda barındırılıyorsa localhost yeterlidir. Farklı sunucudaysa SSH tüneli veya VPN üzerinden erişin.

JVM heap boyutunu sunucu RAM'inin yarısına ayarlayın (/etc/elasticsearch/jvm.options.d/heap.options içinde -Xms2g / -Xmx2g). Çok yüksek değerler garbage collector duraklamalarına neden olur.

XenForo Tarafında Bağlantı​

XenForo Admin > Add-ons menüsünden Enhanced Search eklentisini kurun. Ardından Setup > Options > Enhanced Search altında host, port, kullanıcı adı, şifre ve SSL sertifika parmak izini girin. "Test connection" butonu ile bağlantıyı doğrulayın, sonrasında Tools > Rebuild caches > Rebuild search index adımıyla mevcut tüm konuları yeniden indeksleyin.

Sık Karşılaşılan Sorunlar​

Bind error: 9200 portunun başka bir servis tarafından kullanılmadığından emin olun. SSL hatası: sertifika parmak izini doğru kopyaladığınızdan emin olun. Bellek hatası: vm.max_map_count=262144 kernel parametresini /etc/sysctl.conf dosyasına ekleyin.

AIOR Hosting paketlerinde ElasticSearch ile çalışan XenForo siteleri için VPS ve özel sunucu çözümlerimiz mevcuttur; kurulum desteğini de paket içinde sunuyoruz.

Why ElasticSearch Matters for XenForo​

XenForo's built-in MySQL-based search is sufficient for small communities, but once you grow into the tens of thousands of threads and hundreds of thousands of posts, relevance, latency and server load all suffer. With the XenForo Enhanced Search add-on backed by ElasticSearch, you get sentence-level relevance and millisecond-class results — even on massive forums.

This guide walks through a practical AlmaLinux 8/9 installation of ElasticSearch 8.x. The procedure is the same one we use on our own AIOR community forum.

Prerequisites​

ElasticSearch runs on the JVM and needs at least 2 GB of RAM, with 4 GB recommended for production. Connect to your server as root over SSH:

ssh root@your-server-ip

Update system packages and remove any stale ElasticSearch installs:

sudo dnf update -y
sudo dnf clean all
sudo dnf remove elasticsearch -y

Adding the Repository​

Import Elastic.co's official GPG key and create the yum repo file:

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

cat > /etc/yum.repos.d/elasticsearch.repo <<EOF
[elasticsearch]
name=Elasticsearch repository for 8.x packages
baseurl=https://artifacts.elastic.co/packages/8.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=0
autorefresh=1
type=rpm-md
EOF

Install and First Run​

Enable the repo and install ElasticSearch:

sudo dnf install --enablerepo=elasticsearch elasticsearch -y

When the installer finishes it prints the generated elastic superuser password, the enrolment token and the HTTP certificate fingerprint. Note all three — you will need them shortly when connecting XenForo.

Start the service and enable it on boot:

sudo systemctl daemon-reload
sudo systemctl enable --now elasticsearch

Verify the service is healthy:

curl --cacert /etc/elasticsearch/certs/http_ca.crt -u elastic https://localhost:9200

A JSON cluster info response means the install succeeded.

Security and Access​

ElasticSearch must never be exposed to the public internet. In /etc/elasticsearch/elasticsearch.yml set network.host: 127.0.0.1; if XenForo lives on the same server, localhost is enough. For a separate server, tunnel over SSH or VPN.

Set the JVM heap to roughly half of physical RAM via /etc/elasticsearch/jvm.options.d/heap.options (-Xms2g / -Xmx2g). Going too high triggers long garbage-collector pauses that hurt search latency.

Connecting From XenForo​

Install the Enhanced Search add-on in XenForo Admin > Add-ons. Then go to Setup > Options > Enhanced Search and supply host, port, username, password and the SSL certificate fingerprint. Hit "Test connection" to confirm, then run Tools > Rebuild caches > Rebuild search index to reindex existing content.

Common Pitfalls​

Port bind error: make sure nothing else listens on 9200. SSL error: re-copy the certificate fingerprint carefully. Memory error on startup: add vm.max_map_count=262144 to /etc/sysctl.conf (kernel mapping limit).

For XenForo communities backed by ElasticSearch, AIOR Hosting offers VPS and dedicated server plans with installation support included.

 

[Aior]

Now we are ready to install Elasticsearch to Almalinux

sudo rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Use Nano again to edit the file with code:

nano /etc/yum.repos.d/elasticsearch.repo

Change the file with the codes below:

[elasticsearch]
name=Elastic repository for 8.x packages
baseurl=https://artifacts.elastic.co/packages/8.x/yum
gpgcheck=1
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch
enabled=1
autorefresh=1
type=rpm-md

Output must be like below:




Then prepare installation

sudo yum clean all
sudo yum makecache

Then complate installation:

sudo dnf install --enablerepo=elasticsearch elasticsearch

After installation you can check the installation status with:

rpm -qi elasticsearch

Output should look like below:



Then configure elastic search with nano:

nano /etc/elasticsearch/elasticsearch.yml

and be sure that you have the options as below:

cluster.name: mycluster
node.name: node-1
path.data: /var/lib/elasticsearch
network.host: 127.0.0.1

Start elasticsearch on everyboot :

sudo systemctl enable elasticsearch
sudo systemctl start elasticsearch

Check if elastic search is running or not:

systemctl status elasticsearch.service

You can leave the screen with Ctrl + C combination.

If you want to use elasticsearch at xenforo here is the next steps.

Go to Xenforo Admin Panel Setup --> Enhanced Search




Toggle advenced options and type your password. Username is elastic; to see the passwords type the code below:

cd /usr/share/elasticsearch/
sudo bin/elasticsearch-setup-passwords auto

You will get several passwords and users just choose elastic user and copy the password and type the password to Xenforo:

Finally, you will be able to connect Elasticsearch and results will be like:



Enjoy your Elastic Search

Please write for any question.

 

[Aior]

When you install elastic search note the output below for resetting elastic user:

--------------------------- Security autoconfiguration information ------------------------------

Authentication and authorization are enabled.
TLS for the transport and HTTP layers is enabled and configured.

The generated password for the elastic built-in superuser is : OaReYd2lERsl06e8o+Gw

If this node should join an existing cluster, you can reconfigure this with
'/usr/share/elasticsearch/bin/elasticsearch-reconfigure-node --enrollment-token <token-here>'
after creating an enrollment token on your existing cluster.

You can complete the following actions at any time:

Reset the password of the elastic built-in superuser with
'/usr/share/elasticsearch/bin/elasticsearch-reset-password -u elastic'.

Generate an enrollment token for Kibana instances with
 '/usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s kibana'.

Generate an enrollment token for Elasticsearch nodes with
'/usr/share/elasticsearch/bin/elasticsearch-create-enrollment-token -s node'.

-------------------------------------------------------------------------------------------------
### NOT starting on installation, please execute the following statements to configure elasticsearch service to start automatically using systemd
 sudo systemctl daemon-reload
 sudo systemctl enable elasticsearch.service
### You can start elasticsearch service by executing
 sudo systemctl start elasticsearch.service

Couldn't write '1' to 'vm/unprivileged_userfaultfd', ignoring: No such file or directory

[/usr/lib/tmpfiles.d/elasticsearch.conf:1] Line references path below legacy directory /var/run/, updating /var/run/elasticsearch → /run/elasticsearch; please update the tmpfiles.d/ drop-in file accordingly.

  Verifying        : elasticsearch-8.7.0-1.x86_64                                                                                                                          1/1

Installed:
  elasticsearch-8.7.0-1.x86_64

Complete!