Installing Gazelle

System Requirements

Gazelle is known to run under Solaris, Linux, and IRIX operating systems. There is no reason to believe, however, that gazelle will not be able to run under other UNIX variants.

Since gazelle can be run as a forking server, the ability to fork a process is necessary, though gazelle may be also be run as an inetd service.

Compiling

Gazelle is distributed as a gzipped tar archive. Unpack it using the command:

# gunzip < gazelle-xx.tar.gz | tar xvf -

where xx is the distribution number. This will create a directory called gazelle. Change directories to gazelle. You should be able to type:

# ./configure

to configure gazelle. If you run into an error, type:

# ./configure --help

to see all the options available.

After configuration, you're ready to make the server. Type:

# make grep

to make a version of gazelle with a "grep" backend. Different types of targets you can make are in the targets/ subdirectory. See Installing a Gazelle Target for more details.

Running Gazelle

If you are running gazelle as a forking server and not an inetd process, then you may wish to start gazelle up during system booting though you can start gazelle from the commandline. Commandline options for gazelle are:

usage: gazelle [-h] [-c <config>] [-d <root directory>] [-p <port>] [-l <logging bitmask>]

-h

This help message

-c

The config file to use. [default: gazelled.xml]

-d

The directory to find the config file. [default: .]

-p

The port for gazelle to listen on. [default: 210]

-l

The bitmask to use for logging. [default: 5]

Platform-Specific Issues

Gazelle was developed under Solaris x86 and Linux using ANSI C and should be compatible on any SVR4 variant of UNIX. Gazelle can run in several modes:

Forking Server

Gazelle continually runs listening on a port and forks a process to handle any requests which are sent.

inetd Service

inetd starts a copy of gazelle whenever there's a request to the port. Check your documentation on inetd (typically "man inetd") for details on how to set up gazelle to run as an inetd service.

Standalone Server

Primarily used for debugging purposes, gazelle will accept one client connection, manage the transaction, and then terminate.