DIENST-ETRDL Installation Guide

This document contains the procedure to install the version 4.1.9E of the DIENST system, which has been modified to meet the requirements of the ERCIM Technical Reference Digital Library (ETRDL) by the addition of new functionalities.
The new functionalities provide a new common user interface (ETRDL-CUI) for searching, browsing and for submitting new documents in the ETRDL collections.
The new version also provides basic administration functions via a WWW interface.

This package comprises a complete digital library system with the above functionalities (Dienst-ETRDL) and a common user interface (ETRDL-CUI) that allows ordinary users and the administrator to interact with the system by means of a WEB browser.


Requirements

To install the ETRDL package you need:
the following items are mandatory

  1. ETRDL_2000.tar.gz package

  2. Perl5.x or later perl interpreter language
    (SunFreeware, The Perl Language Home Page and PERL.COM)

  3. NCSA http server (or equivalent)

  4. CGI.pm library (to download click SHIFT + mouse-left-button)

the following items are optional

  1. GhostScript package
    (Aladdin GhostScript and SunFreeware, GhostScript Home Page)

  2. PBM libraries (optional - NETPBM recommended)
    (SunFreeware, www.acme.com or PBM-Plus for NeXT)

Items 1 and 2 are to manage postscript documents.
You need item 1 if you want to create inline gifs for any page of a postscript document.
You need item 2 if you want to create thumbnails of pages for any postscript document.
Item 2 needs item 1 installed.
If you decide to install item 2 you must copy the file "gs_init.ps" from GhostScript directory to "‹your path›/dienst/LibMgt" directory. This file contains the current version of GhostScript and DIENST searches this information in file "‹your path›/dienst/LibMgt/gs_init.ps". You can perform this copy operation at the end of the installation procedure.

If you do not want to install item 1, you can still use the administration user interface but inline gifs cannot be created and some error messages may occur: ignore them.

The administrator can access the ETRDL administration user interface at the location "http://dienstLoc/AUIscripts/admin/admin_page.pl" where "dienstLoc" is the location of ETRDL on your system. How to configure the administrator user id and password is explained in the section Create "AUI/scripts/admin/.users".


TIPS

  1. Define a "dienst" user on your machine
  2. Login as user "dienst" before starting the installation


Installation steps

You must now edit some configuration files to customize your version of DIENST.
Files to edit are: Be careful because these files have a different syntax. For example if you need to write an e-mail address in "libmgt_config.pl" perl file you MUST write "\@" instead of "@".


Picture 2. Files inside "Config" directory.

Edit "install.config"

To edit this file correctly you have to follow the instructions that you will find included.


Edit "const.config"

Edit this file by setting the right path in the following variables: and then check that all the other paths and the values assigned to all variables are OK.
Attention: words beginning with "$" are variables and must not be changed!


Edit "libmgt_config.pl"

First of all, create the following directories where you prefer: Then you can edit file "libmgt_config.pl".
You have to set the $db_files_group and $tr_librarian_addr variables and then you must set the correct path in the following variables: Continue setting all the paths requested. You must follow the instructions written inside the file you are editing.


Edit "auto_config.pl"

VERY IMPORTANT!
Edit the first line of this file to set the correct path of your perl command interpreter.


Run "auto_config.pl"

This process produces


Create "AUI/scripts/admin/.users"

Define the file AUI/scripts/admin/.users as follows:

Example:

# user file authentication
#
Karl:ercim.cnr.iei
George:ercim.cnr.cnuce


Edit "srm.conf" (DIENST dedicated httpd server)

  1. Login as root user (if httpd runs on port 80 or less than 1024)
  2. Append the "Config/srm_conf.additions" file to the "srm.conf" httpd server that you want to use for DIENST (this is true if you use NCSA http server).


And now RUN!

  1. Run your HTTP as root user (if httpd runs on port 80 or less than 1024)
  2. Run DIENST server as "dienst" user (the command is "‹your path›/dienst/Kernel/dienst.pl &").


    Comments and errata corrige are welcome! Please email them to etrdl@iei.pi.cnr.it