h1. Very simple setup of local zebra server

These instructions are probably incomplete for this release. Please let me know if you find errors.

Install all the dependencies to zcc and confirm that it is working.

Install "zebra":http://www.indexdata.dk/zebra/ If using Debian or RedHat it is suggested that you add the indexdata repositories.

You may have already moved the zebra directory into your .zcc directory. If not do the following:
<pre syntax="ruby">
$ cd ~/.zcc
$ cp -r /var/lib/gems/1.8/gems/zcc-0.0.4/examples/zebra .
</pre>

Now change into the zebra directory:
<pre syntax="ruby>
$ cd zebra
</pre>

Now edit the zebra.cfg file. You must replace 'jason' with your username in all places.

<pre>
$ zebraidx update records
</pre>

If the initial record update goes off without warnings or errors try this to start up the server in daemon mode (silent mode that runs in the background).

<pre syntax="ruby">
$ zebrasrv -D
</pre>

You may see loaded filter module messages and then be returned to a prompt. Now you can try it out:

<pre syntax="ruby">
$ yaz-client localhost:9999/zcc
Z> f @attr 1=4 bicycle
Z> show 1
Sent presentRequest (1+1).
Records: 1
[zcc]Record type: USmarc
00907pam a2200241 a 4500
001 3487522
005 19950117081431.7
008 940606s1994    cauab    b    001 0 eng
035    $9 (DLC)   94026226
906    $a 7 $b cbc $c orignew $d 1 $e ocip $f 19 $g y-gencatlg
955    $a pc05 RUSH to sa00 06-06-94; sj06 06-07-94; sj09 06-07-94; sj04 06-08-94; CIP ver. ta06; to SL 01-17-95
010    $a 94026226
020    $a 0899971741 (pbk.)
040    $a DLC $c DLC $d DLC
050 00 $a GV1044 $b .B88 1994
100 1  $a Butterman, Steve.
245 10 $a Bicycle touring : $b how to prepare for long rides / $c Steve Butterman.
260    $a Berkeley, CA : $b Wilderness Press, $c c1994.
300    $a viii, 88 p. : $b ill., map ; $c 22 cm.
504    $a Includes bibliographical references (p. 78) and index.
650  0 $a Bicycle touring.
650  0 $a Bicycle touring $x Equipment and supplies.
991    $b c-GenColl $h GV1044 $i .B88 1994 $t Copy 1 $w BOOKS
</pre>

If you see a record displayed then it works! Congratulations.

Now you can configure your local zserver in the zcc.yaml file in ~/.zcc. Add (or uncomment) this line if necessary:
<pre>- [localhost,    9999,     zcc, 0]</pre>
My suggestion is to put this server in group 0 (zero) of your zservers to check in see whether you already have an appropriate record.

When you want to add records to the zebra database manually you will need to return to your ~/.zcc/zebra directory and reindex the whole bunk of records. Just drop a UTF-8 encoded MARC21 record (IS02709) anywhere in the directory below ~/.zcc/zebra/records and it will be indexed after running this:

<pre syntax="ruby">$ cd ~/.zcc/zebra
$ zebraidx update records</pre>

To make this the default place to save records choose 'zebra' under save_record_syntax in zcc.yaml. This reindexing could take some time, especially if you have a large number of files, though zebra does index quickly. Right now the database is reindexed after each insertion of a record. Not optimal and I'm looking at other ways to do this (only reindex on quit?) We would like to add extended services for record insert and update to "ruby-zoom":http://ruby-zoom.rubyforge.org/ Currently the C-binding is incomplete. Please let me know if you're a developer willing to do the work (jronallo+zoom@gmail.com).

If you shutdown your computer make sure to restart the zebrasrv!

If port 9999, the default zebrasrv port, is exposed to the world, others may be able to search your database as well.  You may find this a good thing :) or it may be a security risk? You can specify a different port on the command line. See the "zebra docs":http://www.indexdata.dk/zebra/doc/ for more information on changing the port and other configuration options for zebra. What you have been presented with here is just the simplest quickest way of getting I've found for getting zebra for zcc up and running on my Debian systems.