INSTALL

Database Advisor
Last Updated: 3/17/2000
Copyright (c) 1998 - 2000 Regents of the University of California

Info about the program, licensing, contact info etc. is in README.

Maintenance:

This package is no longer actively maintained. It is excepted that SearchLight (http://searchlight.cdlib.org/cgi-bin/searchlight), part of the California Digital Library (http://www.cdlib.org/) will replace the functionality of DBA.

Installation:

  1. Make sure you have the required Perl modules

    DBA requires perl, version 5.004_01 or later. You can get the lastest version of perl and the modules listed below from: www.perl.com. You need these modules: CGI.pm and the LWP (formerly known as "libwww") Module (this includes: HTTP::Request; LWP::UserAgent; URI::URL). Note that LWP has its own dependencies which are documented when you download and install it. These perl modules are also available by going to the www.perl.com site above. These LWP prerequisites include: MIME-Base64, HTML-Parser, libnet, and Digest-MD5.

  2. Compile zlcient

    DBA requires the Z39.50 API zclient software for Z39.50 connections. You can obtain the code from Stanford:

    http://lindy.stanford.edu/~hrf/z3950/www_gateway.html

    The most recent version (as of 3/17/2000) is included in the z39 directory.

  3. Run installation script:
    $ perl DBA-Install.pl

    This Perl script will ask you a series of questions about your local environment, change the DBA programs and config files accordingly, and install the DBA programs, cgi-bin scripts, and html files.

  4. Edit config files to match your environment/perferences:

    Once you have installed DBA, check the following config files and change them to suit your environment (the filenames assume you installed DBA in /usr/local/dba):

    /usr/local/dba/dbaLocal.pl

    This file has unviersal settings, and will reflect the info you supplied to the install program.

    /usr/local/dba/Configure.pl

    This file has per-library/population settings, and will reflect the info you supplied to the install program. If you have multiple user groups and would like to customize DBA to each group, add the group customizations to this file.

    /usr/local/dba/ip.acl

    This has the list of IP addresses that are allowed access to deep links into databases. It ships with dummy IP addresses as examples, so no one will be allowd to see the deep links unless you change this.

    /usr/local/dba/Display.pl

    This controls the main formatting of DBA's results page (including the email addresses, colors, header and footer, etc.

    /usr/local/dba/dbfiles/*

    Each file corresponds to a database. Several of the databases (AFSA.db, ASFA_ARCHIVE.db, ASTA.db, Compendex.db, Compendex70.db, Compendex80.db, EGLI.db, EMA.db, ERIC.db, LLBA.db, METADEX.db, SocAbstracts.db, and ZOO.db) have had passwords, local cgi front-end scripts, or other UCSD-specific details replaced with ***. These databases will not work unless you supply your passwords, etc.

    /usr/local/dba/dbfiles/subjects.db

    This database controls which databases are available to each user population. The Library Id must match the LIBID variable passed from the HTML form, and must have corresponding entries in /usr/local/dba/Configure.pl.