Okapi-Pack 

Centre For Interactive Systems Research 
City University 
London EC1V 0BH 


Installing The Software. 

1. Extracting the package files.

  1. Decide where you want to install the system. We will call the pathname of this directory <install_path>
  2. If your machine is running Solaris, download the file okapi-pack.1.02.tar.gz.

    If your machine is running Linux, download the file okapi-pack.1.10.tar.gz.

  3. Place the downloaded file into install_path and gunzip the file.
  4. Extract the contents of the tar file:
    1. on Solaris:        tar -xvf okapi-pack.1.02.tar
      on Linux:        tar -xvf okapi-pack.1.10.tar

    This will create a directory called okapi-pack.

  5. The pathname <install_path>/okapi-pack will be referred to as <OKAPI_ROOT> .
  6. The contents of <OKAPI_ROOT> will (probably) be as listed in Appendix A.

2. Setting up the environment.

The various parts of the system require certain environment variables to be set. Not all of these are required for all parts but there are no conflicting settings so it is possible to set them all up at the same time by adding suitable lines to your .cshrc file. The environment variables to set are described in Appendix B which lists the contents of the file:

<OKAPI_ROOT>/dot-files/dot.cshrc

that could be appended to your .cshrc file.

3. Installing the Indexing and Interface software.

3.1. Modifying the Makefiles

Both GUIs were developed using the following software versions.
Tcl/Tk:  either Tcl 7.4 / Tk 4.0 
or Tcl 7.6 / Tk 4.2. 
gcc:  version 2.7 

You must check that these are installed and determine the full pathnames of the libraries. You then need to modify the following lines of the two Makefiles:

  1. <OKAPI_ROOT>/indexing/src/Makefile
  2. <OKAPI_ROOT>/interface/src/Makefile
as follows:

##     gcc::  set GBASE to the full pathname of the gcc lib and bin directories
GBASE = /vol/gcc-2.7

##     Tcl/Tk set TKTCL_LPATH to the full pathname of the Tcl/Tk libraries (e.g. fot Tcl7.6/Tk4.2
TKTCL_LPATH = /vol/tcl-7.6
TKTCL_IPATH = /vol/tcl-7.6

TCL_LIB = $(TKTCL_LPATH)/lib/libtcl7.6.a
TK_LIB = $(TKTCL_LPATH)/lib/libtk4.2.a

##     X:   set X_PATH to the X11R6 libraries directory
X_PATH = /vol/X11R6

The locations of the libraries is clearly system dependent. We did try using dynamic libraries for the installation but this did prove problematic because of the setup of our systems within City's wider network(s).


3.2. Installing the indexer GUI.

Move into the directory:  <OKAPI_ROOT>/indexing/src and type, at the Unix prompt:

make indexer

Assuming the compilation proceeds without errors this will make a binary called "indexer" in this directory. Move this file into <OKAPI_ROOT>/bin (or wherever).


3.3. Installing the interface GUI.

Move into the directory:   <OKAPI_ROOT>/interface/src and type, at the Unix prompt:

make okapi

Assuming the compilation proceeds without errors this will make a binary called okapi in this directory. Move this file into <OKAPI_ROOT>/bin (or wherever).

There should be no problems compiling these two programs. However, if there is, email Okapi Support and your problem(s) will be dealt with as soon as possible.
 


Okapi-Pack Main Menu  Mail Okapi Support  Registration 


Last modified: 12th November 2001