ghinstall Manual
ghinstall is the Glimpse HTTP installation script. It is only
needed to install Glimpse HTTP, and can be removed after installation.
This manual is intended to 'walk you through' the installation procedure.
Running ghinstall
ghinstall should be made into an executable and readable
file (if the permissions aren't already set) by running the command:
chmod u+rx ghinstall
Then, edit ghinstall (using a text editor such as vi
or emacs) so that the first line:
#!/usr/local/bin/perl
is changed to reflect the path of PERL on your machine. For example,
if PERL is located at /usr/bin/perl, change the first line to be:
#!/usr/bin/perl
Then, run ghinstall.
If the script
cannot find the following programs (using the Unix program which):
- PERL,
- glimpse,
- glimpseindex,
- crontab and
- gunzip,
you will be prompted to enter the location of the programs that the script
could not find.
You will then be prompted for:
- the directory to which you would like the
Glimpse HTTP binaries installed (this will usually be something like
/usr/local/glimpsehttp).
- the directory to which you would like the
Glimpse HTTP cgi-bin scripts installed (this will usually be something
like /usr/local/etc/httpd/cgi-bin or
/usr/local/glimpsehttp/cgi-bin.
- the *relative* URL of the cgi-bin scripts for Glimpse HTTP.
This directory should not have a beginning or terminating '/' in the
directory specification.
For example, if you
set up your http daemon to direct the relative URL /cgi-bin-path/
to the directory to which you have installed the Glimpse HTTP cgi-bin
scripts,
you would enter cgi-bin-path.
After you have entered all of the requested locations, you will be prompted
to review the list, and press RETURN to continue. To restart ghinstall
(if, for instance, one of the paths in incorrect), press ^C, and just rerun
it.
After you press RETURN, ghinstall will copy the files to the
correct directories and set the permissions to appropriate values
(755 for executables and directories, 644 for other files).
After ghinstall is complete, you will probably want to complete
the installation by configuring your server for the cgi-bin to work
correctly. You can also delete ghinstall and the
remaining (empty) cgi-bin directory from your system; installation
is complete. See the Installation page for
more information on the complete installation process.
Return to the Glimpse HTTP home page

Maintained by Michael Smith
glimpse@cs.arizona.edu