Gecko 2 Instructions

Please read the COPYRIGHT file for important notes concerning redistribution.

Unpacking:

Gecko 2 is distributed in the file 'gecko2.tar'. Use the tar command to unpack this file:

> tar -xf gecko2.tar

This will create a subdirectory 'gecko2' will all files needed to build the gecko package.

Compiling:

Gecko 2 is intended to compile on the Linux Operating System. It has been tested with Red Hat Linux 5 and Red Hat Linux 6.

The entire Gecko 2 system may be built by using the 'make' command.

Installing Squid

Gecko 2 requires Squid (or a similar proxy server) to serve as a back-end for fetching and caching html documents. Please follow the instructions included with the proxy server.

Running the Gecko Server

You must specify the name and port of the proxy server when running gecko. For example, assuming you are running squid on your local machine at port 3128:

> gecko2 -proxyname localhost -proxyport 3128

Two other options may be useful: -debug to enable debugging information, and -detach to detach the gecko server from the console.

Mounting Gecko from a Client Machine

We suggest adding a line similar to the following to your /etc/fstab file:

gecko_machine:web /mnt nfs noauto,user,exec,nosuid,timeo=20,intr,rsize=4096

In the above, 'gecko_machine' is the name of the machine running the gecko server. '/mnt' is the mountpoint where you wish to mount gecko. Change these as necessary for your particular system.

The gecko user manual is contained in the file geckoclient.html.