RepositoryManager.properties Config

This page serves as a walkthrough for editing RepositoryManager.properties for X-Server OSID configuration and provides a sample file as an example. Jump to the sample below.

Walkthrough

File location

Open RepositoryManager.properties at:

<sakai_root>/xserver-osid/xserver-osid-impl/src/bundle/data/RepositoryManager.properties

Properties

There are two properties that need to be changed to create a search category:

  • repository_X_displayName - the name that users see
  • repository_X_id - the id(s) for the search source(s) included in this search category
    • if there are multiple ids, they should be comma delimited - this will result in all search sources being searched simultaneously when this search category is selected.

The following properties must be left unchanged:

  • osid_20_Id_Implementation=org.sakaiproject.component.osid.id
  • repository_X_searchtype_0_authority=sakaibrary
  • repository_X_searchtype_0_domain=search
  • repository_X_searchtype_0_keyword=asychMetasearch
  • repository_X_searchtype_0_typeDescription=Sakaibrary Asynchronous Metasearch

The value of the following properties are currently unused (they should be left in the file, but their values do not matter):

  • repository_X_description
  • repository_X_searchtype_0_query

Additional Guidelines

  • There should be at least one repository defined (repository_0_...).
  • Search categories should have consecutively increasing repository numbers: repository_0_..., repository_1_..., repository_2_..., etc.
  • There is no limit to the number of repositories defined.

Finding Search Source Ids

To determine the ids of your local search sources, you can use the MetaLib Management Interface:

  1. login to the MetaLib Management Interface at http://<metalib instance root>/M:
    http://metalib.mySchool.edu/M
  2. choose "Find Resource"
  3. search for the resource
  4. the results will contain a "Resource ID" column - this is the id to be used

Sample

I have two search categories I'd like to configure:

  1. General Interest - consists of three databases: ProQuest, InfoTrac and ISI Web of Science - these provide a broad coverage of issues from news, business, humanities and science.
  2. Zoological Record - consists of the single database, Zoological Record, for content relating to zoology.

I have found Resource IDs through the MetaLib Management Interface for ProQuest, InfoTrac and ISI Web of Science - they are UMI01559, UMI00433 and UMI01738, respectively.

I have found Zoological Record's Resource ID through the MetaLib Management Interface - it is UMI00320.

My RepositoryManager.properties file will look like the following:

osid_20_Id_Implementation=org.sakaiproject.component.osid.id

repository_0_displayName=General Interest
repository_0_description=Provides a broad coverage of issues from news, business, humanities and science.
repository_0_id=UMI01559,UMI00433,UMI01738
repository_0_searchtype_0_query=http://searchtools.lib.umich.edu/X
repository_0_searchtype_0_authority=sakaibrary
repository_0_searchtype_0_domain=search
repository_0_searchtype_0_keyword=asynchMetasearch
repository_0_searchtype_0_typeDescription=Sakaibrary Asynchronous Metasearch

repository_1_displayName=Zoological Record
repository_1_description=Provides content relating to zoology.
repository_1_id=UMI00320
repository_1_searchtype_0_query=http://searchtools.lib.umich.edu/X
repository_1_searchtype_0_authority=sakaibrary
repository_1_searchtype_0_domain=search
repository_1_searchtype_0_keyword=asynchMetasearch
repository_1_searchtype_0_typeDescription=Sakaibrary Asynchronous Metasearch