solr | www.valeriofinazzo.it

VUFIND – Tutorial 5 – Gestione di istanze multiple

admin — Sat, 12 Jul 2014 17:07:31 +0000

Nell’articolo di oggi vediamo come poter gestire istanze multiple di VUFIND e quali sono le soluzioni messe a disposizione dal sistema stesso. Tale necessità può nascere nel momento in cui si desidera dare accesso al sistema a utenti differenti con layout differenti. La casistica più semplice è quella in cui VUFIND presenta istanze differenti, ma un unico database e un unico Solr, ovviamente casistiche più complesse prevedono la presenza di un database per ogni istanza e un Solr per ogni istanza.

Analizziamo il caso più semplice: la creazione di più istanze con database e Solr condivisi.

Per creare più istanze occorre utilizzare il comando

cd $VUFIND_HOME
php install.php --multisite

Ipotizziamo di creare due istanze, site1 e site2, scegliendo l’opzione Directory-Based.

A fine processo includiamo i due file di configurazione

Include c:/vufind/site1/httpd-vufind.conf
Include c:/vufind/site2/httpd-vufind.conf

Se ci limitassimo a fare questo soltanto il secondo sito sarebbe correttamente funzionante, perchè la definizione dell’alias all’interno del file crea un comportamento anomalo sul primo sito.

Per risolvere questa anomalia è sufficiente creare un link simbolico alla cartella public tramite il comando

mklink /D "c:\vufind\site1link" "C:\vufind\public"

e modificare il file c:/vufind/site1/httpd-vufind.conf in questo modo

Alias /site1 C:/vufind/site1link

Se volete usare una istanza diversa di MySql agite sul file config.ini alla sezione

[Database]
database = mysql://root@localhost/vufind

In tal modo separate la gestione delle utenze tra le varie istanze.

Se volete gestire una istanza diversa di solr agite sulla sezione

[Index]
engine = Solr
url = http://localhost:8080/solr
local = /usr/local/vufind/solr
default_core = biblio

In tal modo ogni istanza di VUFIND vedrà un set di dati differente.

The post VUFIND – Tutorial 5 – Gestione di istanze multiple first appeared on www.valeriofinazzo.it.

VUFIND – Tutorial 3 – Importare Record

admin — Sat, 28 Jun 2014 15:34:27 +0000

Nell’articolo di oggi vedremo come popolare la base dati di VUFIND. VUFIND presenta delle utility per il caricamento dati, che si interfacciano con Solr per la creazione del nostro catalogo.

Sono presenti due modalità di caricamenti: tramite file in formato MARC21 oppure tramite file xml con un foglio xsl associato.

Nel caso del formato MARC21 rimando al sito ufficiale. Sostanzialmente si tratta di aver un file MARC21 e di caricarlo tramite il comando

import-marc.bat nomefile.mrc

Per chi non conoscesse MARC21 (ad esempio me) VUFIND da la possibilità di caricare i libri in formato XML associando un foglio di stile xsl che effettui la trasformazione del file nel formato xml supportato da Solr, le cui specifiche sono consultabili qui.

Personalmente preferisco questa seconda soluzione, più abbordabile e alla portata di tutti. Inoltre permette a chiunque abbia un catalogo xml di poterlo caricare sul nostro sistema agevolmente.

Facciamo un caso pratico, l’esempio vale più di 1000 parole. Supponiamo di avere un file xml che contiene il nostro catalogo così fatto:




0000000001
titolo1


0000000002
titolo2


0000000003
titolo3

A questo punto definiamo un foglio xsl che trasforma il file xml nel formato atteso da Solr.













book

Questo file permetterà di trasformare il file xml nel seguente formato atteso da Solr:

<?xml version="1.0" encoding="UTF-8"?><add><doc><fieldname="id">0000000001</field><fieldname="title">titolo1</field><fieldname="recordtype">book</field></doc><doc><fieldname="id">0000000002</field><fieldname="title">titolo2</field><fieldname="recordtype">book</field></doc><doc><fieldname="id">0000000003</field><fieldname="title">titolo3</field><fieldname="recordtype">book</field></doc></add>

Per Solr ogni documento è definito come una sequenza di field, ciascuno con il proprio nome e valore. Il file deve rispettare lo schema definito in solr, in caso contrario il file verrà rifiutato durante l’importazione.

A questo punto non ci resta che caricare il file tramite la direttiva

c:\vufind\import>php import-xsl.php books.xml opac.properties

Tale direttiva processa il file books.xml applicando le regole definite nel file opac.properties che contiene i parametri per invocare il servizio esposto da solr. La configurazione minimale è la seguente:

[General]
xslt = opac.xsl
custom_class[] = VuFind
truncate_custom_class = true

Il parametro xslt indica il file xsl da usare e deve essere disponibile all’interno della directory xsl

C:\vufind\import\xsl

A questo punto se abbiamo operato riceveremo come risposta

c:\vufind\import>php import-xsl.php books.xml opac.properties
2014-06-28T11:21:46-04:00 DEBUG: => POST http://localhost:8080/solr/biblio/
update
2014-06-28T11:21:46-04:00 DEBUG: <= 200 OK
Successfully imported books.xml...

Buon caricamento dati

The post VUFIND – Tutorial 3 – Importare Record first appeared on www.valeriofinazzo.it.

VUFIND – Tutorial 2 – Abilitare le statistiche

admin — Thu, 26 Jun 2014 21:26:51 +0000

Nell’articolo di oggi vedremo come abilitare le statistiche. Per abilitare le statistiche è necessario intervenire sul file di configurazione config.ini agendo sulla sezione

[Statistics]
;mode[] = Solr
;mode[] = File
;mode[] = Db

VUFIND offre tre modalità per salvare le statistiche: solr, file e database. Ogni modalità può essere attivata rimuovendo il commento opportunamente.

Nel caso in cui si scelga Solr, occorre definire l’indirizzo dove è esposto il servizio abilitando la riga

;solr = http://localhost:8080/solr

Nel caso in cui si scelga file, occorre definire il percorso del file abilitando la riga

;file = /usr/local/vufind/local/logs

Nel caso in cui si scelga Db non sono necessarie altre modifiche, VUFIND salverà le statistiche nel proprio database.

VUFIND salva le ricerche effettuate e i record visti, ed è possibile salvare le ricerche in modi diversi tramite la sintassi

;mode[] = Db:Records, Solr:Search

Per consultare le statistiche occorre abilitare il modulo Admin, agendo sulla direttiva

admin_enabled = true

A questo punto possiamo accedere al modulo Admin disponibile all’indirizzo

http://localhost/vufind/Admin/

e consultare le nostre statistiche

The post VUFIND – Tutorial 2 – Abilitare le statistiche first appeared on www.valeriofinazzo.it.

VUFIND – Tutorial 1 – Installazione e configurazione

admin — Tue, 24 Jun 2014 21:35:59 +0000

Iniziamo una serie di articoli dedicati a VUFIND il portale progettato e sviluppato dall’Università di Villanova, orientato alle librerie delle biblioteche. Tale portale consente all’utente di cercare e sfogliare tutte le risorse di una biblioteca e di sostituire il tradizionale OPAC (On-line Public Access Catalogue).

E’ modulare ed essendo rilasciato con licenza open source può essere modificato liberamente per essere adeguato alle nostre esigenze.

VUFIND è stato sviluppato in php ed è basato sul framework ZEND, e si appoggia a Solr, il motore di ricerca basato su Lucene che permette prestazioni eccellenti in ricerca e consente soluzioni scalabili.

Nell’articolo di oggi vedremo come installare e configurare VUFIND su piattaforma Windows.

I requisiti per l’installazione prevedono:

Apache HTTP Server 2.2 or later (2.2.12 or later recommended)
PHP (version 5.2.x with Smarty 2.6.26 for VuFind 1.x, version 5.3.3 or higher for VuFind 2.x)
MySQL 4.1 or later (version 5.1.10 or later recommended for VuFind 2.x)
Java J2SE JDK (version 1.5 or later for VuFind 1.x, version 1.6 or later for VuFind 2.x)

Per piattaforma Windows è disponibile XAMPP, il pacchetto che contiene Apache, Mysql e Php e che permette di configurare agevolmente l’ambiente per rispettare i requisiti richiesti da VUFIND.

Scaricato VUFIND scompattatelo nella directory c:\vufind. Se i requisiti sono soddisfatti potrete lanciare agevolmente il comando php install.php che vi guiderà nella creazione della vostra istanza: all’interno della cartella vufind verrà creata una cartella cotenente i file di configurazione e le eventuali localizzazioni.

A questo punto occorre linkare l’istanza creata su apache, modificando il file httpd.conf dell’istanza Apache includendo questa directory tramite la direttiva

Include c:/vufind/local/httpd-vufind.conf

Ovviamente la direttiva è configurata per una directory che si chiama local.

A questo punto occorre configurare Solr, modificando i file di configurazione

c:/vufind/solr/biblio/conf/solrconfig.xml
c:/vufind/solr/authority/conf/solrconfig.xml
c:/vufind/solr/stats/conf/solrconfig.xml

sostituendo il nodo \config\dataDir con le variabili

c:/vufind/solr/biblio
c:/vufind/solr/authority
c:/vufind/solr/stats

A questo punto se abbiamo fatto tutto correttamente possiamo avviare Solr tramite i comandi

cd \vufind\solr\jetty\
java -Dsolr.solr.home=c:\vufind\solr -Xmx1G -Xms1G -jar start.jar

Non resta che avviare apache e accedere alla nostra istanza Vufind disponibile all’indirizzo

http://localhost/vufind/Install/Home

La maschera vi indicherà se tutto è ok o se manca ancora qualcosa, correggete tramite la procedura guidata e Vufind è pronto.

Alla prossima

The post VUFIND – Tutorial 1 – Installazione e configurazione first appeared on www.valeriofinazzo.it.