Child pages
  • post-2.4 Configuration Instructions
Skip to end of metadata
Go to start of metadata

Table of Contents

Comparison to 2.4 Configuration

Citations configuration in Sakai 2.5 and Citations Helper post-2.4 is the same and is largely compatible with the older 2.4.x release. Common values in and the XML configuration files continue to have the same meanings - you can use your existing 2.4 XML files with 2.5.

Given that, much of the Citations Helper 2.4 configuration documentation on the Sakaibrary wiki is still valid.

What's new?

  1. In Sakai 2.5, the Citations functionality is enabled by default. Citations can be "turned off" using the XML or mechanisms shown below.
  2. The XML configuration files are stored in the Resources area of a dedicated "Citations Admin" site. Previously these were maintained in the file system.
  3. Additional configuration elements can be controlled using the XML configuration files.

XML configuration files for 2.5

Handling the XML configuration files as standard Sakai resources has several benefits:

  1. You can update your Citations configuration on-the-fly, without restarting Tomcat. If you're running a cluster, the updated configuration is available cluster-wide.
  2. An administrator can delegate responsibility for maintaining the Citations configuration.
  3. In this new scheme, configuration content is cached, and the cache is updated only when new configuration files become available.

Setting up the new administration site

In you'll specify a "citations administration" site ID and a folder to house your configuration files:

  • adminSiteName@org.sakaiproject.citation.api.ConfigurationService=LibraryAdmin
  • configFolder@org.sakaiproject.citation.api.ConfigurationService=config

You also specify one or two configuration files:

  • configXmlCache@org.sakaiproject.citation.api.ConfigurationService=config.xml
  • databaseXmlCache@org.sakaiproject.citation.api.ConfigurationService=categories.xml

This example reflects the default, out-of-the-box names for these files. The categories.xml file isn't required if you don't use the "library search" feature.

At startup time, the administration site will be created, if it doesn't already exist. The admin site will have the title "Citations Admin".

Initial setup

To initially set up the Citations Helper:

  1. Login as admin
  2. Go to the "Citations Admin" site
  3. Create a folder to hold your configuration files ("config" in our case)
  4. Go to "config" and upload your "config.xml" and "categories.xml" files.

New XML configuration elements

Adding these to your config.xml file is optional. As in Sakai 2.4.x, these can all be controlled using property values in If you do provide these values in config.xml, the XML values take precedence.

Sakai Properties

Template and config.xml files are shown below:
Sample definitions (minimal, more could be added)

Sample config.xml file

The following file illustrates all of the configuration elements for the post-24 and 2.5 releases.

  • No labels