eXtensible Catalog Drupal Toolkit installation profile

This project is a Drupal installation profile and a Drupal distribution based on the eXtensible Catalog Drupal Toolkit modules and theme. It provides site features and functions for a library catalogue type site containing settings of Drupal core, contributed modules, themes, and pre-defined configuration. The profile makes it possible to quickly set up a complex, use-specific site in fewer steps than if installing and configuring elements individually.

It fills Drupal with all necessary settings, so you can start harvesting library metadata after install Drupal with this profile.

Installation

Since the distribution does not contains every piece of the software, we created a shell script which downloads the distribution itself and other parts, like Solr, run patches, and prepares the site for installation. We recommend you download and install the Drupal Toolkit via our installation script which is detailed in the instructions below. It will ask you two questions: where is your web directory, and where to put Solr. If you would like just the distribution itself without the other necessary components, please download the tar.gz file at the bottom of the page.

Prerequisites

• wget or curl command line tools - to automatically download the necessary components.
• patch command line tools
• Java 1.5 or newer version
• To run the XC Drupal Toolkit you also need the PHP Client URL Library installed

Step-by-step guide

Step 1

Create a temp directory. This is where the softwares will be downloaded, and prepared before deploying to the web directory.

Step 2

Download the script

If you do not have wget or curl, download the script plus these files manually into your temp directory:

• http://ftp.drupal.org/files/projects/xc_installation-6.x-1.1-rc3-core.ta...
• http://jquery-ui.googlecode.com/files/jquery.ui-1.6.zip
• http://www.apache.org/dist/lucene/solr/3.3.0/apache-solr-3.3.0.tgz

Step 3

Run the script

Step 4

Create a MySQL database and database user with correct permissions by following the steps outlined http://drupal.org/documentation/install/create-database. Please note the name of the database, username and password you created, because Drupal will ask you to provide them during installation.

Step 5

Go to http://localhost/xc-1.1-test, select the eXtensible Catalog profile, and follow the steps.

Step 6

At the end of the installation process you will see a link to the harvest schedule. We provide a Metadata Services Toolkit demo site, which contains a couple of XC schema records. The installation process setup a harvest schedule, which will import those records into Drupal, create nodes, and index them with Solr. Follow that link (admin/xc/harvester/schedule/1), and click on Harvest tab.

Step 7

When the harvest finished, you can start searching. Click on the site logo, and type a term or * sign into the search box. You can play with the facets and see the results.

Step 8

The installation profile does not contain every settings. There are components like NCIP servers, remote authentication systems or institutional code for Syndetics services, which are different from libraries to libraries. The Toolkit provides you a helper page, a setup checklist, which tells you where to go to record these information. It is available at eXtensible Catalog > Common functions > Setup checklist (admin/xc/common/setup_checklist).

Finally we would suggest you to read the documentation.

Downloads