Archivi tag: solr

VUFIND

VUFIND – Tutorial 5 – Gestione di istanze multiple

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

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

A fine processo includiamo i due file di configurazione

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

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

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

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

Se volete gestire una istanza diversa di solr agite sulla  sezione

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

VUFIND

VUFIND – Tutorial 3 – Importare Record

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

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:

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

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

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

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:

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

A questo punto se abbiamo operato riceveremo come risposta

Buon caricamento dati

VUFIND

VUFIND – Tutorial 2 – Abilitare le statistiche

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

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

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

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

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

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

e consultare le nostre statistiche

statistics

VUFIND

VUFIND – Tutorial 1 – Installazione e configurazione

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

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

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

sostituendo il nodo \config\dataDir con le variabili

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

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

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

Alla prossima