Managing Zebra

Topic: Managing Zebra

Topic Type: Topic

Kete relies on Zebra for it's search results. Zebra is run as separate computer process from the Kete application. Here are some tips for how to manage it.

Originally written by Walter McGinnis, Kete Project Lead for Katipo Communications, Ltd.

Part of the Installation Guide

Kete needs a running and configured Zebra process in order to work. The Installation Guide outlines how to set up Zebra, but sometimes you may need to do additional maintenance.

For example if, you had to restart the host that runs your Kete site, Zebra will not be started automatically, you will have to do this yourself. Here's how:

If you are using the Simple Installation setup, do this:

$ cd ~/apps/your_app
$ rake zebra:start

Or if you are using Capistrano to manage your deployments, from your development enviroment you can do this:

$ cd ~/apps/your_app
$ cap deploy:zebra:start

As you might expect, the above "start" part of the commands can be replaced with "stop" and do what you would expect.

If you really get yourself in a pickle and mess up your Zebra search indexes there is a way to reset and start from scratch. However, it's a tad convoluted at this stage. Please contact Walter McGinnis and bug him to write it up!

Created by: Walter McGinnis
Last Edited by: Kieran Pilkington
Last Edited: 04/08/2008 23:06

Flag as:

Discuss This Topic

There are 3 comments in this discussion.

Read and join this discussion

Joe Atzberger said Zebra shutdown error

For whatever reason, I get some errors stopping zebra.

kete@kohavm77:~/apps/kete_stable_dev$ sudo rake zebra:stop
(in /home/kete/apps/kete_stable_dev)
Warning: bad ps syntax, perhaps a bogus '-'? See http://procps.sf.net/faq.html

kete@kohavm77:~/apps/kete_stable_dev$ sudo rake zebra:stop
(in /home/kete/apps/kete_stable_dev)
cat: /home/kete/apps/kete_stable_dev/log/zebra.pid: No such file or directory
awk: line 1: syntax error at or near )
awk: line 1: syntax error at or near }
Warning: bad ps syntax, perhaps a bogus '-'? See http://procps.sf.net/faq.html
kill: usage: kill [-s sigspec | -n signum | -sigspec] pid | jobspec ... or kill -l [sigspec]
rm: cannot remove `/home/kete/apps/kete_stable_dev/log/zebra.pid': No such file or directory

The second error seems to indicate that the former operation succeeded.

The errors are the same without sudo.

Tags: Kete, Zebra, error, zebra:start, zebra:stop, rake, ps