faster faster_img
Always working to set the federated search speed record.
better better_img
Open source - extensible, extendable, understandable
easier easier_img
Two clicks - one click to find, one click to get
download download_img
Get it now - free!

LibraryFind 0.9.2 uploaded

I posted this update Thursday.  It fixes some problems found in 0.9.1.  The main issue with 0.9.1 was that the svn got foobared a little bit and some files needed for install were left out of the package.  Files that were left out and errors that they caused:

1) migrations 031 & 032 – would cause a method not found error of is_private when adding/editing collections

2) QueryAPI note found – the services directory was left out

3) classic_pagination not found – the classic_pagination plugin was left out


The errors were a bit of suprise because all the files were in the svn, but they had become weirdly locked.  I had to run svn cleanup a few times and then switch branches between the dev and trunk to finally get everything synced up.  But, I’ve had outside confirmation that everything is good now.  So if you were trying to install 0.9.1 and had trouble, pick up 0.9.2.  It should solve your problem. 

You can find it at:



LibraryFind Connectors Database

I'm adding to this all the time, but I've finally been able to get a reference tool up for users wanting to see how to connect to common resources.  This is the first version of the OSU LibraryFind Connector's Database.  It only returns data in XML at the moment (my preference for the data honestly), but I'll include a more formalized web interface.  Anyway, you can find it here:


Installing LF 0.9+

Installing LibraryFind 0.9






LibraryFind 0.9 represents a number of significant changes over LibraryFind 0.8+.  Some of these changes are related to the way that UI interacts with the API, some are related to the actual infrastructure of the application.  The following are a set of step by step instructions for setting up a new LibraryFind installation.





LibraryFind 0.9 implements a number of new technologies, chief among those is Rails 2.2.2 and mod_rails.  The mod_rails module is significant, in that for the first time, LibraryFind can now be managed through apache rather than through the Mongrel webserver.  This has a direct affect on speed and response time, as well as memory management.




Prior to installing LibraryFind, a number of system components need to be made ready.

1)      Install Mysql and Mysql development libraries

2)      Install Yaz and Yaz development libraries

3)      Install libxml2 and libxml2 development libraries

4)      Install ruby 1.8.7+ (not 1.9 due to lack of good rails support for that version)

5)      Install rubygems (current version)

6)      Install Rails 2.2.2

7)      Install gem passenger
Formal install instructions are located at:
After installing the gem, run the following commands:
passenger-install-apache2-module (follow further instructions)

8)      Create a new database
Command: Create database metasearch

After installing the pre-requisites, you are now ready to install the required ruby gems.  As part of the LibraryFind package, most of the required gems necessary to run the LibraryFind application are present within the vendor directory.  These gems will not need to be installed.  However, LibraryFind has four gems that must be installed manually because they must be compiled to link with shared libraries on the system.


Gem installation:


1)      mysql
Command:  gem install mysql
**Note, you may have to include a –lib option to link directly to the mysql directory.

2)      zoom
Command: gem install zoom
** note – if yaz must be installed to enable sharing in order for linking to take place.

3)      Libxml-ruby
Command: gem install libxml-ruby
** note, if libxml2 and development libraries are not installed, linking will not occur

4)      ferret
Command:  gem install ferret

5)      solr-ruby
Command: gem install solr-ruby


Final Install and Configuration:


1)      Run the database migrations
Command:  rake db:migrate

2)      Set the database configurations
Open config/database.yml and set the development and production sections with username and password information.  Set the database for development and test to metasearch

3)      Set config.yml configurations
Open config/config.yml
Options that need to be set – the ferret index location, ILL server, Parser type. 

4)      Set lf.rb configurations
Open config/iterations/lf.rb
Look over the lf.rb.example and make the necessary configuration elements.

To configure LibraryFind with apache, add the following to your apache conf file:


<VirtualHost *:[port]>

    ServerName [your servername]

    ErrorLog  /path/to/rails/app/log/error.log

    CustomLog /path/to/rails/app/log/custom.log common

    DocumentRoot /path/to/rails/app/public

    RailsBaseURI  /



Once configured, LibraryFind can now be started and stopped by restarting apache.



LibraryFind 0.9.1 released

I've posted an update to LibraryFind 0.9, now available for download here:  This fixes a couple display issues and issues related to deduping found in the original 0.9.0 release. 


LibraryFind 0.9: RSS Feed

[Crossposted at:]

During the past development cycle, one of the most often requested items by our students and faculty has been the ability to watch a query for an extended period of time.  In 0.9, this will be possible.  At any point, a user can create an RSS feed of a specific search and add it to their feed reader.  At this point, that output looks like the following: