eXtensible Catalog (XC) Installation Profile

This project is a Drupal installation profile and a Drupal distribution based on the eXtensible Catalog Drupal Toolkit modules and themes. It provides site features and functions for a library catalogue type site containing settings of Drupal core, contributed modules, themes, and pre-defined configuration.

This installation profile makes it possible to quickly set up a complex site for a specific use in fewer steps than installing and configuring elements individually. It also populates the Drupal database with necessary settings, allowing an administrator to begin harvesting library metadata immediately after installing Drupal.

Installation

Since the distribution does not contains every piece of the software, we have included two shell scripts that assist in downloading the distribution itself and other parts (such as Apache Solr), patching files, and preparing the site for a Drupal installation:

• xc_manual_installation.sh
• xc_profile_installation.sh

We recommend downloading and installing all components of the Drupal Toolkit using one of the installation scripts provided and following the instructions below. During the script, you will be asked for the web root directory where the Drupal installation will be located and the directory to place the Solr instance.

Prerequisites

• git command line tools
• wget and cURL command line tools
• patch command line tools
• Java 1.5 or newer version

Keep in mind that to install the Drupal Toolkit, there are other prerequisites, such as the PHP Client URL, SimpleXML, and DOMDocument libraries, as well as some contributed modules.

Step-by-step guide

Step 1

Create a temporary directory where the software will be downloaded and prepared prior to its deployment to the web root directory.

Step 2

Download the installation profile.

Step 3

Run the script of your choice and follow the instructions. For more information, view the quick start guide.

Step 4

Complete the Drupal installation and test your instance. For example, by browsing to: http://localhost/xc-6.x-[XC_VERSION]

Step 5

After installation, you can begin harvesting metadata and using the Drupal Toolkit. With the profile installation, A metadata repository link is created to the demo Metadata Services Toolkit containing a few XC schema records as well as a default harvest schedule for this repository. Harvesting, therefore, will import those records into Drupal, create the appropriate nodes, and index them with Solr.

Step 6

After harvesting, node generation, and indexing, you can start searching. Go to the XC search home page, which may be configured as your default home page after installation. Test by typing a term such as "harry potter" or simply a star ( * ) into the search box. You can also test the faceting functionality and see the results from different searches.

Step 7

The installation profile does not configure every possible or useful setting. There are other components, such as NCIP servers, login forms, and institutional code for Syndetics services which are necessary for other features in the Drupal Toolkit, but not automatically configured because it differs dramtically from library to library.

Instead, the Drupal Toolkit provides a setup checklist that tells you where to go to record these information. It is available by navigating to Administration > eXtensible Catalog > Common functions > Setup checklist (admin/xc/common/setup_checklist).

Finally, we strongly suggest reading the online documentation.

Downloads