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
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.
To install the ETRDL package you need:
- the following items are mandatory
- ETRDL_2000.tar.gz package
- Perl5.x or later perl interpreter language
(SunFreeware, The Perl Language Home Page and
- NCSA http server (or equivalent)
- CGI.pm library
(to download click SHIFT + mouse-left-button)
- the following items are optional
- GhostScript package
(Aladdin GhostScript and
SunFreeware, GhostScript Home Page)
- 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
You need item 2 if you want to create thumbnails of pages for any
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
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
"dienstLoc" is the location of ETRDL on your
system. How to configure the administrator user id and password is
explained in the section Create
- Define a "dienst" user on your machine
- Login as user "dienst" before starting the installation
You must now edit some configuration files to customize your version of
- Unzip and untar the DIENST99.tar package.
- You will now have the directories shown in the following picture.
Picture 1. Files and directories inside "dienst" directory.
- Change directory to "Config".
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 "@".
- "const.config" ;
Picture 2. Files inside "Config" directory.
To edit this file correctly you have to follow the instructions that you
will find included.
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.
- $dienst_home = "add your path here";
- $database_dir = "add your path here";
- $pbm_directory = "add your path here";
Attention: words beginning with "$" are variables and must not be
First of all, create the following directories where you prefer:
Then you can edit file "libmgt_config.pl".
and under library, create the
and under incoming, create the
following directories where incoming files will be
stored at the time of document submission:
- bib, for the bibliographic records
- ps, for postscript files
- pdf, for files in pdf format
- txt, for text files
- html, for file in html formats
- tiff, for tiff files.
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.
- $bib_directory = "add your path
- $ps_directory = "add your path here/library/incoming/ps";
- $pdf_directory = "add your path
- $txt_directory = "add your path
- $htm_directory = "add your path
- $tiff_directory = "add your path
- $repository_path = "add your path
- $incoming_path = "add your path here/library/incoming".
Edit the first line of this file to set the correct path of your perl
This process produces
- file "AUIlib.pl" containing the definitions of data structures and a
set of perl functions used by other functions.
- ".htaccess" hidden file for the directories "htdocs", "AUI/scripts",
"AUI/scripts/admin" and "AUI/scripts/submit",
according to the definitions of the previous variables.
- "Config/srm_conf.additions" file
Define the file AUI/scripts/admin/.users as follows:
- each line beginning with the "#" symbol is a comment
- each line beginning as: AdminUser:LocalAuthorityName authorises
the user "AdminUser" to admin the
# user file authentication
Edit "srm.conf" (DIENST dedicated httpd
- Login as root user (if httpd runs on port 80 or less than 1024)
- 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
And now RUN!
- Run your HTTP as root user (if httpd runs on port 80 or less than
- Run DIENST server as "dienst" user (the command is "your
Comments and errata corrige are welcome! Please email them to email@example.com