Chapter 3. Tutorial

Table of Contents

1. A first OAI indexing example
2. Searching the OAI database by web service
3. Presenting search results in different formats
4. More interesting searches
5. Investigating the content of the indexes
6. Setting up a correct SRU web service
7. Searching the OAI database by Z39.50 protocol

1. A first OAI indexing example

In this section, we will test the system by indexing a small set of sample OAI records that are included with the Zebra distribution, running a Zebra server against the newly created database, and searching the indexes with a client that connects to that server.

Go to the examples/oai-pmh subdirectory of the distribution archive, or make a deep copy of the Debian installation directory /usr/share/idzebra-2.0.-examples/oai-pmh. An XML file containing multiple OAI records is located in the sub directory examples/oai-pmh/data.

Additional OAI test records can be downloaded by running a shell script (you may want to abort the script when you have waited longer than your coffee brews ..).

     cd data
     ./fetch_OAI_data.sh
     cd ../
    

To index these OAI records, type:

     zebraidx-2.0 -c conf/zebra.cfg init
     zebraidx-2.0 -c conf/zebra.cfg update data
     zebraidx-2.0 -c conf/zebra.cfg commit
    

In case you have not installed zebra yet but have compiled the binaries from this tarball, use the following command form:

     ../../index/zebraidx -c conf/zebra.cfg this and that
    

On some systems the Zebra binaries are instal