Manticore Search

Genel Bakış

Manticore Search, Colpan’ın gelişmiş arama motorudur. Hash-tabanlı index’e ek olarak BM25 relevance ranking sunar.

Temel Özellikler:

• BM25 skorlama (alakalılık sıralaması)
• Full-text search
• Profil bazlı veri izolasyonu
• Otomatik daemon yönetimi

Hash Index vs Manticore

Özellik	Hash Index	Manticore
Bağımlılık	Yok	Embedded daemon
Ranking	Yok (alfabetik)	BM25 (alakalılık)
Karmaşık sorgular	Orta	Hızlı
Offline çalışma	Evet	Evet
Disk kullanımı	Düşük	Orta
Bellek kullanımı	Düşük	Orta-Yüksek

Ne Zaman Hangisi?

Senaryo	Önerilen
Basit aramalar	Hash Index
En alakalı sonuçlar	Manticore
Düşük kaynaklı sistem	Hash Index
Profesyonel kullanım	İkisi birlikte

Daemon Yaşam Döngüsü

Manticore daemon, arka planda çalışan bir servis olarak yönetilir.

Durumlar

Durum	Simge	Açıklama
IDLE	⚫	Çalışmıyor, başlatılmadı
STARTING	🟡	Başlatılıyor, health check bekleniyor
READY	🟢	Çalışıyor, sorgu kabul ediyor
ERROR	🔴	Başlatma başarısız (max 3 deneme)

Durum Çubuğu Göstergesi

Manticore: 🟢 READY | 15.432 belge

Başlatma

Manticore otomatik olarak şu durumlarda başlar:

• Uygulama açıldığında (aktifse)
• İlk Manticore araması yapıldığında
• Manuel olarak “Başlat” tıklandığında

Başlatma Süreci:

1. Config dosyası oluşturulur
2. Daemon process başlatılır
3. Health check yapılır (HTTP 9308)
4. Index yüklenir
5. READY durumuna geçilir

Durdurma

Daemon şu durumlarda durur:

• Uygulama kapandığında (otomatik)
• Manuel olarak “Durdur” tıklandığında
• Hata durumunda (3 deneme sonrası)

Port Kullanımı

Port	Protokol	Kullanım
9308	HTTP	REST API (arama, indexleme)
9306	MySQL	SQL sorguları (opsiyonel)

Port Çakışması: Eğer portlar başka uygulama tarafından kullanılıyorsa:

1. Bilgisayarı yeniden başlatın
2. Veya çakışan uygulamayı kapatın

Profil Bazlı Veri İzolasyonu

Her profil kendi Manticore veritabanına sahiptir.

Yapı:

%TEMP%\Colpan\
├── manticore_data_0\    (Profil 1)
│   ├── binlog\
│   ├── docs_idx\
│   └── manticore.pid
├── manticore_data_1\    (Profil 2)
├── manticore_data_2\    (Profil 3)
├── manticore_data_3\    (Profil 4)
└── manticore_data_4\    (Profil 5)

Profil Değiştirme:

1. Daemon durdurulur
2. Yeni profil data_dir’i ayarlanır
3. Daemon yeniden başlatılır
4. Yeni profilin indexi yüklenir

CQL → Manticore Dönüşümü

Colpan sorguları otomatik olarak Manticore formatına çevrilir.

Dönüşüm Kuralları

CQL	Manticore	Açıklama
ali baba	ali baba	Implicit AND
ali ; baba	ali baba	Explicit AND
ali | baba	ali | baba	OR (aynı)
!ali	-ali	NOT
"tam ifade"	"tam ifade"	Phrase (aynı)
(a | b) c	(a | b) c	Gruplama (aynı)

Örnekler

Basit Dönüşüm:

CQL:       boşanma ; nafaka
Manticore: boşanma nafaka

Karmaşık Dönüşüm:

CQL:       (TOKİ | "Toplu Konut") kamulaştırma !iptal
Manticore: (TOKİ | "Toplu Konut") kamulaştırma -iptal

Indexleme

Otomatik Indexleme

Hash index oluşturulurken Manticore index’i de paralel olarak güncellenir.

İşlem Sırası:

1. UDF dosyası açılır
2. content.xml okunur
3. Hash index güncellenir
4. Manticore’a document eklenir

Manuel Indexleme

1. Dizine sağ tıklayın
2. “Manticore’a İndeksle” seçin
3. Progress dialog açılır
4. Tamamlandığında arama yapılabilir

Bulk Insert

Büyük dizinler için optimize edilmiş toplu ekleme:

• 100 belge grubu halinde
• Tek transaction
• Daha az disk I/O

Arama

Manticore Araması Kullanma

1. Sorgu kutusuna CQL yazın
2. Enter’a basın
3. Sonuçlar BM25 skoruna göre sıralanır

BM25 Skoru:

• 0-100 arası değer
• Yüksek skor = daha alakalı
• Sonuç listesinde görüntülenir

Hibrit Arama

Colpan, Hash ve Manticore sonuçlarını birleştirebilir:

• Hash: Hızlı filtreleme
• Manticore: Ranking
• Sonuç: Alakalılık sıralı hızlı sonuçlar

İstatistikler

Durum çubuğunda görüntülenen bilgiler:

İstatistik	Açıklama
Belge sayısı	Index’teki toplam UDF
Index boyutu	Disk kullanımı
Son güncelleme	Son indexleme zamanı

Sorun Giderme

Daemon başlamıyor

Belirtiler:

• Durum: ERROR
• Log: “Could not bind to port”

Çözümler:

1. Port 9308/9306 kullanımda mı kontrol edin
2. Bilgisayarı yeniden başlatın
3. Antivirüs istisnası ekleyin

Arama sonuç vermiyor

Belirtiler:

• Durum: READY ama sonuç yok

Çözümler:

1. Index’in güncel olduğundan emin olun
2. “Manticore’a İndeksle” yapın
3. Sorgu syntax’ını kontrol edin

Yavaş arama

Belirtiler:

• Arama birkaç saniye sürüyor

Çözümler:

1. Daha spesifik sorgular kullanın
2. Sonuç limitini azaltın
3. RAM’i artırın

Index bozuk

Belirtiler:

• Hatalı sonuçlar
• Beklenmeyen crash

Çözümler:

1. Manticore data dizinini silin:

   %TEMP%\Colpan\manticore_data_N\

2. Uygulamayı yeniden başlatın
3. Tüm dizinleri yeniden indexleyin

Sistem Gereksinimleri

Minimum

Bileşen	Değer
RAM	4 GB
Disk	1 GB boş alan
CPU	2 çekirdek

Önerilen

Bileşen	Değer
RAM	8 GB+
Disk	SSD, 5 GB+ boş
CPU	4+ çekirdek

Devre Dışı Bırakma

Manticore kullanmak istemiyorsanız:

1. Ayarlar > Arama Motoru
2. “Sadece Hash Index” seçin
3. Daemon başlatılmaz

Sonuç:

• Daha düşük kaynak kullanımı
• BM25 ranking olmadan arama
• Offline çalışma garantisi