Zebra Server - Administrators's Guide and Reference: Quick Start

Next Previous Contents

## 3. Quick Start

In this section, we will test the system by indexing a small set of sample GILS records that are included with the software distribution. Go to the `test/gils` subdirectory of the distribution archive. There you will find a configuration file named `zebra.cfg` with the following contents:

> `

>     # Where the schema files, attribute files, etc. are located.
>     profilePath: .:../../tab:../../../yaz/tab

>     # Files that describe the attribute sets supported.
>     attset: explain.att
>     attset: bib1.att
>     attset: gils.att

> `

Now, edit the file and set `profilePath` to the path of the YAZ profile tables (sub directory `tab` of the YAZ distribution archive).

The 48 test records are located in the sub directory `records`. To index these, type:

> `

>     $ ../../bin/zebraidx -t grs.sgml update records

> `

In the command above the option `-t` specified the record type — in this case `grs.sgml`. The word `update` followed by a directory root updates all files below that directory node.

If your indexing command was successful, you are now ready to fire up a server. To start a server on port 2100, type:

> `

>     $ ../../bin/zebrasrv tcp:@:2100

> `

The Zebra index that you have just created has a single database named `Default`. The database contains records structured according to the GILS profile, and the server will return records in either either XML, USMARC, GRS-1, or SUTRS depending on what your client asks for.

To test the server, you can use any Z39.50 client (1992 or later). For instance, you can use the demo client that comes with YAZ: Just cd to the `client` subdirectory of the YAZ distribution and type:

> `

>     $ ./yaz-client tcp:localhost:2100

> `

When the client has connected, you can type:

> `

>     Z> find surficial
>     Z> show 1

> `

The default retrieval syntax for the client is USMARC. To try other formats for the same record, try:

> `

>     Z>format sutrs
>     Z>show 1
>     Z>format grs-1
>     Z>show 1
>     Z>format xml
>     Z>show 1
>     Z>elements B
>     Z>show 1

> `

NOTE: You may notice that more fields are returned when your client requests SUTRS or GRS-1 records. When retrieving GILS records, this is normal - not all of the GILS data elements have mappings in the USMARC record format.

If you've made it this far, there's a good chance that you've got through the compilation OK.

Next Previous Contents