INSTALLATION
============

This file is extracted from the main documentation file (docs/INSTRUCTIONS) and
contains basic details on installing the package.

Contact the author, Col Needham <unix@imdb.com>, if you're still having 
problems *after* reading the documentation.

1.1 Requirements
================

This version requires a Un*x like operating system, an ANSI C compiler and 
approximately 150Mb of disk-space for the full standard version. The package 
includes support for compressed database files using 'compress' or 'gzip', 
bringing the requirements down to 30Mb of disk-space. There are options to
reduce the space further by discarding some of the databases that you might
not be interested in, so disk-space requirements can be as low as 20Mb.

You will need an ANSI compatible C compiler to compile the programs. If one 
wasn't supplied with your machine, I recommend the GNU C compiler 'gcc'. 
You can pick up a source code distribution of 'gcc' from ftp.gnu.ai.mit.edu
in pub/gnu which can be installed on a wide range of machines. NOTE FOR
USERS OF SUN MACHINES: the standard Sun C compiler is *not* ANSI compliant
so you will need a copy of 'gcc' to install this package.

An Amiga version is also available both on AMINET (under biz/dbase) and from
the main anonymous FTP sites (see later)

An MS-DOS interface to the same data, but based on different software is also 
available from the FTP sites.


1.2 Installation
================

 (1) The database software is available from the FTP sites:

 uiarchive.cso.uiuc.edu  in  /pub/info/imdb/tools/moviedb-3.4.tar.gz

 ftp.funet.fi in  /pub/culture/tv+film/lists/tools/moviedb-3.4.tar.gz

 ftp.fu-berlin.de  in  /pub/misc/movies/database/tools/moviedb-3.4.tar.gz

 sunsite.mff.cuni.cz  in  /MultiMedia/Movies/Database/tools/moviedb-3.4.tar.gz

 (2) get the file using anonymous FTP and unpack by typing:

       gzip -cd moviedb-3.4.tar | tar -xvf -

     this will install the software in the directory moviedb-3.4, 'cd' into
     the directory to continue.

 (3) since the package includes a program to automatically get the data files
     from the FTP site (and to keep them up to date), you need to give the
     package your e-mail address to use as the password for FTP. Edit the
     file Makefile and change the following line:

	LFETCHOPT = -auto
     
     to 

	LFETCHOPT = -auto -user <address>

     where <address> is your e-mail address.

 (4) follow the comments in the Makefile for further changes that might be
     required for installation on your system. In particular, don't forget to
     set CC and/or CFLAGS to enable ANSI compatible compilation.

     Also, pay close attention to the variables which describe how to handle
     the compressed list files (ZLISTCATCOM etc.) and how to enable support
     for compressed database files (ZDBSCATCOM etc.)

     The variables AUTOUNCOMPRESS and KEEPLISTS affect the amount of disk 
     space used by the package if your resources are limited. Please refer
     to section 12.2 for more information.

 (5) to compile all the programs, fetch the list files and create the 
     databases run:

	make install

     See section 12 if anything goes wrong with this process.

     NOTE: the database generation process does require quite a bit memory 
     and processing power to run. I've arranged to have ready made data
     files available on the FTP sites for people who have problems generating
     them locally. See section 12.1 for more details.

 (6) the search programs will be installed in the moviedb-3.4/bin directory,
     therefore you need to either add this directory to your path or run
     all the programs from this directory.

The package is now installed and you're ready to try it out, see the next
section for a quick introduction.

Section 12.2 has details on the one line command that you can use to ensure
the database is always up to date with respect to the FTP site.

If you do not have direct access to anonymous FTP or you have some special
configuration requirements, see section 12 for more details on a customized
set-up procedure and on fixing general problems.

