$Id: genelink_install.txt,v 1.7 2004/09/07 14:58:16 umayamla Exp $

This software/database is "United States Government Work" under the
terms of the United States Copyright Act. It was written as part of
the authors' official duties for the United States Government and thus
cannot be copyrighted. This software/database is freely available to
the public for use without a copyright notice. Restrictions cannot
be placed on its present or future use.

Although all reasonable efforts have been taken to ensure the
accuracy and reliability of the software and data, the National
Human Genome Research Institute (NHGRI) and the U.S.  Government
does not and cannot warrant the performance or results that may be
obtained by using this software or data. NHGRI and the U.S.
Government disclaims all warranties as to performance,
merchantability or fitness for any particular purpose.

In any work or product derived from this material, proper
attribution of the authors as the source of the software or
data should be made, using http://research.nhgri.nih.gov/genelink/ 
as the citation.

REQUIREMENTS

NHGRI's implementation of GeneLink is currently running on a Sun 
Sparc 280R with 8 GB RAM and Apache 1.3.31 as its Web server. Disk 
space requirements for any given user will vary, depending on the 
number and size of the data files that will be both imported and 
exported from the system. Perl 5.0 or higher is required, and both 
the Perl DBI and Perl DBD::Sybase modules must be installed; these 
Perl modules can be obtained directly from CPAN (http://www.cpan.org). 
The current GeneLink distribution requires the Sybase 12.5.1 SQL server. 

Users will need a current Web browser in order to work with GeneLink. 
GeneLink has been tested and used with Microsoft Internet Explorer 6.0, 
Netscape 6.0, Mozilla 1.4, and Phoenix on the Linux, Windows, and 
Macintosh platforms. 

INSTALLATION

After unpackaging Genelink, you will need to create a database call cgb_lab_data. 
The file genlink/lib/cgb_lab_data.isql contains the SQL that can be used to create 
the database. There are two configuration files that will need
to be edited. The first file is located of the main genelink/ directory. The 
file titled .htconfig has two values that need to be set up to match your 
webserver. That paths to these directories need to be changed to the correct 
paths on your server. The configuration file that needs to be edited is 
located genelink/lib/DBIx/db_connections/ directory. The file cgb_lab_data is 
the database access configuration file. The file provided works with Sybase. 
The values that need to be changed are the SERVER, USER, PASS values.
.