System Requirements
===================
Unix
Perl 
tar and gzip utilities 

Make sure the machine on which the software is installed has the following 
1> Capability to run a webserver
2> No other dienst.pl server running on the machine
3> The port on which teh server is configured should be free.

Run the Setup.cgi script in the present directory.

By reading this file, you have already done the first step: extracting the system files.
The directories generated are:
<root dir.>/nasa_server, <root dir.>/public_html/tool and <root dir.>/public_html/publish
where <root dir.> is the directory under which you extracted the system

When prompted for the type of webserver choose NCSA.

When prompted for the path of the webserver directory type in the directory 
<root dir>/nasa_server/apache.




Look below for installing the system by hand.

NOTE: you have  EITHER run Setup.cgi OR Do the configuration by hand not both of it. 

Installtions Instructions
==========================

.
Before using the system you HAVE TO follow the following steps to configure the system:

NOTE : The permissions for the files are expected to be 755 in all directories.      
1- In the file: <root dir.>/nasa_server/dienst/Config/install.config
--------------------------------------------------------------------
a) change all /research/dli to <root dir.>
b) change localhost to the machine which you intend to run the system on.
   e.g. res-ups.cs.odu.edu
c) Optional: change localport to whatever port you plan to use. 
   e.g. 8888 (the default setting)
   We recommend you stick to the current setting.
   PS. port numbers that are less than 1024 will require that a system administrator starts the system.
d) change maintainer to the email of the person who will maintain the system.
e) change home_page_url to the URL of your digital library.
f) add the default printer name in the printers section. The format is: <printer name>domain</printer name>
   e.g. <cookie>cs.odu.edu</cookie>

install.config is self explanatory and properly documented. We mentioned above the necessary steps. All the other settings are properly configured.

2- Run the following two commands to auto configure dienst:
-----------------------------------------------------------
a) cd <root dir.>/nasa_server/dienst/Config/
b) auto_config.pl
   this program will do the necessary path adjustments in your dienst code.
   when prompted about intializing the database now: answer NO
   when prompted about registering the handles: answer NO
   when prompted about the web server type: answer NCSA
   when prompted about the web server location: answer <root dir.>/nasa_server/apache

3- In the file <root dir.>/nasa_server/apache/conf/httpd.conf:
--------------------------------------------------------------
a) change all /research/dli to <root dir.>
b) change all 8888 to the port number you chose in step 1-c) above (if you did change the port number).
c) change ServerAdmin from kholief@cs.odu.edu to the new administrator's email.

4a- In the file <root dir.>/nasa_server/apache/conf/srm.conf:
------------------------------------------------------------
a) change all /research/dli to <root dir.>

4b- In the file <root dir.>/nasa_server/apache/conf/access.conf:
------------------------------------------------------------
a) change all /research/dli to <root dir.>

5- In the file <root dir.>/public_html/tool/conf/directory.conf
---------------------------------------------------------------
a) change all /research/dli to <root dir.>
b) change all res-ups.cs.odu.edu to your machine name (the local host of your choice in step 1-b) above.
c) change all 8888 to the port number you chose in step 1-c) above (if you did change the port number).


6- In the file .htaccess in the <root dir.>/public_html/tool/creation , <root dir.>/public_html/tool/administration , <root dir.>/public_html/tool/management/
===============================================================================
 a)change all /research/dli to <root dir.>

 
Startup Instructions:
=====================
change all the /research/dli to <root dir> in script <root dir>/nasa_server/ncstrlplus_start.
 

On the host machine of your choice (specified in 1-b) in the installation instructions) run the following shell script:

<root dir.>/nasa_server/ncstrlplus_start
It will start all the necessary servers.

As an alternative, you can run the following Unix commands:
% cd <root dir.>/nasa_server/dienst/Kernel
% dienst.pl &
% cd <root dir.>/nasa_server/apache
% httpd -f conf/httpd.conf
% cd <root dir.>/nasa_server/wais/wais-bin
% waisserver -p 3000 -d <root dir.>/nasa_server/wais/wais-index -l 0 &
 
where <root dir.> is the directory under which you extracted the tar file.

Important note : The creation tool works only on the netscape browser.The management tool administration tool and the search interface work with both netscape and internet explorer