Introduction
The TalisLMS connector is migrating from Groovy/Grails to JRuby. The current implementation uses Rails. Here are the steps needed to get a basic connector up and running.
Preparing your environment
A JDK that supports JRuby is required. This page explains a gotcha in Ubuntu. Sun's JDK or OpenJDK will work fine.
- Install JRuby: download here
- Install somewhere on your system (i.e. /opt/local/jruby) and add /path/to/jruby/bin to your $PATH
- Update gems to most recent version: $ sudo jruby -S gem update --system
- Install the gems needed to run the connector:
- $ sudo jruby -S gem install rails -v 2.3.8
- $ sudo jruby -S gem install rsolr-direct
- $ sudo jruby -S gem install activerecord-jdbc-adapter -v 0.9.4
- $ sudo jruby -S gem install marc jrexml vpim composite_primary_keys cql-ruby glassfish
- Download the Sybase JDBC driver from http://jtds.sourceforge.net/ and place jtds-1.x.x.jar either in $JRUBY_HOME/lib or in your Java classpath.
- Check the Rails-connector branch out of svn: $ svn co http://talislms-jangle.googlecode.com/svn/trunk/ talislms-connector
- Rename talislms-connector/config/database.yml-dist to database.yml and edit it to reflect your Alto Sybase connection.
- Edit talislms-connector/config/connector.yml and change the administrator username and password to something more secure
- $ cd /path/to/talislms-connector
- $ glassfish
- Pour yourself a very large drink or consider going on holiday for a while. The last step takes a while. It's caching your Sybase DB to the embedded Solr cache.
- You can follow along by $ tail -f ./log/development.log
- File a bug report if you run into a problem
- Point an HTTP client at http://connectorhost:3000/connector/resources/ and, hopefully, see the resulting JSON feed.
