Koha'da OAI-PMH Protokolü Kurulumu ve Veri Harmanlama

Açık kaynaklı kütüphane otomasyon sistemi Koha, Open Archives Initiative Protocol for Metadata Harvesting (OAI-PMH) standardını destekleyerek kütüphane katalog verilerinin diğer sistemlerle paylaşılmasını ve dış kaynaklardan veri harmanlanmasını sağlar. Kütüphaneler arası bilgi paylaşımı ve üstveri birlikte çalışabilirliği (interoperability), çağdaş kütüphaneciliğin ve bilgi yönetiminin en kritik unsurlarından biridir. Koha otomasyon sistemi, OAI-PMH standartlarına tam uyum sağlayarak katalog kayıtlarının DSpace, Primo, VuFind veya ulusal toplu kataloglar gibi dış sistemlerle sorunsuz entegrasyonunu mümkün kılar. Koha mimarisinde OAI-PMH katmanı hem bir veri sağlayıcı (provider) hem de harmanlama altyapısı rolünü üstlenebilir. Bu durum, kurumun MARC21 veya UNIMARC formatındaki verilerinin standart Dublin Core şablonlarına dönüştürülerek küresel ölçekte erişilebilir olmasını sağlar.

Koha Sistem Tercihlerinde OAI-PMH Yapılandırması

Koha yönetim paneli üzerinden OAI-PMH servislerini aktif hale getirmek kurulumun ilk aşamasını oluşturur. Sistem yöneticisi yetkisiyle panele giriş yapıldıktan sonra Sistem Tercihleri (System Preferences) modülüne geçilmeli ve arama çubuğuna OAI-PMH terimi yazılmalıdır. Bu bölümde karşımıza çıkan temel parametrelerin eksiksiz ve doğru bir şekilde yapılandırılması gerekmektedir.

İlk olarak OAI-PMH tercihi varsayılan olarak kapalı (Disable) gelebilir. Servisin dış dünyaya veri sunabilmesi için bu seçeneğin Enable durumuna getirilmesi zorunludur. Ardından OAI-PMH:archiveID alanı doldurulmalıdır. Bu alan, kurumun uluslararası standartlarda benzersiz olan tanımlayıcısını temsil eder. Örneğin kutuphane.universite.edu.tr veya tr-koha-arsiv şeklinde bir metin dizisi girilmelidir.

Veri aktarım performansını doğrudan etkileyen bir diğer ayar ise OAI-PMH:MaxRecords parametresidir. Bu değer, tek bir OAI sorgusunda istemciye döndürülecek maksimum kayıt sayısını belirler. Sunucu kaynaklarını ve bant genişliğini korumak adına bu değerin 50 ile 100 arasında tutulması tavsiye edilir. Çok yüksek değerler sunucu belleğinde aşırı yüklenmeye ve zaman aşımı hatalarına yol açabilir. Son olarak OAI-PMH:ConfFile parametresinin sunucudaki konfigürasyon dosyasının tam yolunu (genellikle /etc/koha/sites/instance/koha-conf.xml) gösterdiğinden emin olunmalıdır.

Metadata Formatlarının Eşlenmesi ve XSLT Dönüşüm Mantığı

OAI-PMH protokolü gereği tüm veri sağlayıcılar minimum standart olarak Unqualified Dublin Core (oai_dc) formatını desteklemek zorundadır. Ancak akademik kütüphane otomasyon sistemlerinde kataloglama genellikle MARC21 standardı ile yürütülür. Koha, MARC21 verilerini OAI istemcilerine sunarken arka planda XSLT (Extensible Stylesheet Language Transformations) şablonlarını kullanır.

Koha veritabanındaki MARC21 etiketlerinin Dublin Core elemanlarına dönüştürülmesi belirli kurallara dayanır. Örneğin katalog kaydındaki 245$a alt alanı Dublin Core dc:title alanına, 100$a alt alanı dc:creator alanına, 260$c veya 264$c yayın tarihi alanları ise dc:date alanına eşlenir. Bu dönüştürme işlemi koha-oai-marc21-slim2oai_dc.xsl dosyası üzerinden yürütülür.

Kurum içi özel gereksinimler söz konusu olduğunda, bu XSLT dosyası düzenlenerek yerel alanlar OAI çıktısına dahil edilebilir. Örneğin, katalogcuların 500 genel notlar alanına yazdığı özel verilerin OAI çıktısında dc:description olarak görünmesi isteniyorsa, XSLT şablonuna ilgili XPath sorguları eklenebilir. Böylece harmanlayıcı (harvester) sistemler veriyi herhangi bir kayıp olmadan kendi veritabanlarına çekebilir.

OAI-PMH Sunucu Servisinin Test Edilmesi ve Sorgu Parametreleri

Yapılandırma adımları tamamlandıktan sonra OAI-PMH servisinin doğru çalışıp çalışmadığı web tarayıcısı veya cURL araçları yardımıyla test edilmelidir. Koha otomasyon sisteminin OAI uç noktası genel olarak http://kutuphane.kurum.edu.tr/cgi-bin/koha/oai.pl adresinde yer alır.

OAI-PMH protokolü altı temel fiil (verb) ile çalışır. Kurulumun doğrulanması için bu fiiller sırasıyla çağrılmalıdır:

• Identify: Sunucunun temel bilgilerini, depo adını ve desteklenen OAI sürümünü döndürür. Test için /cgi-bin/koha/oai.pl?verb=Identify adresi ziyaret edilmelidir.
• ListMetadataFormats: Sunucunun desteklediği üstveri biçimlerini listeler. Yanıtta oai_dc ve marcxml biçimlerinin yer aldığı teyit edilmelidir.
• ListSets: Kütüphane içindeki koleksiyon veya sınıflama yapılarına karşılık gelen OAI kümelerini listeler.
• ListIdentifiers: Belirli kriterlere göre süzülen kayıtların yalnızca OAI üstveri kimliklerini getirir.
• ListRecords: Tüm üstverileri detaylı olarak çeker. Örnek kullanım: /cgi-bin/koha/oai.pl?verb=ListRecords&metadataPrefix=oai_dc
• GetRecord: Tek bir benzersiz kimliğe sahip kaydın detayını almak için kullanılır.

Sunucu Tarafında İndeksleme ve Performans Optimizasyonu

Yüz binlerce kayda sahip geniş kütüphane kataloglarında, canlı OAI sorgularının doğrudan ana veritabanı üzerinden yanıtlanması ciddi performans kayıplarına yol açabilir. Koha bu sorunu önlemek amacıyla OAI verilerini önceden işleyen özel bir indeksleme mekanizmasına sahiptir.

Linux sunucu terminalinde koha-oai-indexer servisi aktif edilerek değişikliklerin OAI tablolarına anlık veya periyodik aktarımı sağlanır. Arka planda çalışan cron işleri (cronjobs) sayesinde katalogda yeni oluşturulan, güncellenen veya silinen materyal kayıtları OAI dizinine eklenir.

Sistem yöneticileri Linux kabuğunda şu komutları çalıştırarak OAI indeksleyicisini kontrol edebilir:

sudo koha-oai-indexer --enable koha_instance_adi

Ayrıca /etc/cron.d/koha-common yapılandırma dosyası incelenerek indeksleme sıklığı optimize edilebilir. Büyük ölçekli veri güncellemelerinin sunucu trafiğinin düşük olduğu gece saatlerinde yürütülmesi, kullanıcı deneyimini korumak açısından kritiktir.

Koha OAI-PMH Kurulum ve Kontrol Listesi

OAI-PMH protokolü kurulumunu eksiksiz tamamlamak için aşağıdaki adımları kontrol listenizden doğrulayabilirsiniz:

1. Sistem Tercihi: Koha yönetim panelinde OAI-PMH seçeneği 'Enable' konumuna getirildi mi?
2. Archive ID: Kuruma özgü benzersiz OAI tanımlayıcısı belirlendi mi?
3. Max Records: Tek seferde dönecek maksimum kayıt sayısı (önerilen: 50-100) ayarlandı mı?
4. Endpoint Doğrulama: Web tarayıcısında verb=Identify çağrısı geçerli bir XML yanıtı veriyor mu?
5. Format Desteği: ListMetadataFormats sorgusunda oai_dc ve marcxml çıktıları görülüyor mu?
6. XSLT Eşleme: Yerel MARC21 alanlarının Dublin Core karşılıkları kontrol edildi mi?
7. Cron Servisi: Linux tarafında koha-oai-indexer servisi çalışıyor mu?
8. Güvenlik ve Firewall: Dış harmanlayıcı kurumların IP adreslerine 80/443 portlarında erişim izni verildi mi?