view release on metacpan or  search on metacpan

README.ACEBROWSER  view on Meta::CPAN

AceBrowser Version 3.1
September 20, 2001

The AcePerl distribution now includes a collection of CGI scripts that
run on top of AcePerl to provide a simple browsable interface to ACEDB
databases.  Some of the code has been tuned for the C. elegans
database, but most of it is fully generic.

Demos are running at http://stein.cshl.org/elegans/.

REQUIREMENTS:

1. AcePerl 1.76 or higher (available at http://stein.cshl.org/AcePerl/)
2. Perl 5.6.0 or higher
3. CGI.pm 2.77 or higher (available at http://stein.cshl.org/WWW/software/CGI)
4. A Web server
5. sgifaceserver 4.8c or higher.  For best results, use the version of
   sgifaceserver available at http://www.acedb.org/.
   The socket server is generally a better choice than the older RPC-based
   server.

INSTALLATION:

1. Read README first.  This describes how to install AcePerl.  

2. During the installation, you will be asked whether you wish to
install AceBrowser.  Answer "yes."  

3. You will be asked for the installation locations for several groups
of files.  The answers depend on the configuration of your web server
The install script will attempt to create any directories that do not
already exist.

  a. Site-specific configuration file directory

	Acebrowser needs access to one or more configuration files.
	Each file describes a data source and how information from
	the data source is to be rendered.  All configuration files
	are stored in a directory at the location indicated here.

	The default is /usr/local/apache/conf/ace/.

  b. Acebrowser CGI script directory

        The core of Acebrowser is a set of CGI scripts.  This is the
	directory that will contain them.  Choose a directory that will
	be recognized by the web server as containing CGI script.  If
	you are using Apache/mod_perl, select a directory under the 
	control of Apache::Registry.

        The default is /usr/local/apache/cgi-bin/ace/

  c. Acebrowser HTML files and images

	Acebrowser uses a small number of static HTML files and images.
	This is the directory that will contain them.  Choose a directory
	that is located under the web server's document root.

	The default is /usr/local/apache/htdocs/ace/

Depending on the permissions of your web server directories, you may
have to be root in order to create some of these directories.

4. Run "make", "make test" and "make install" as described in the main
README.  If this is successful, run "make install-browser".  This will
copy the acebrowser files into the directories chosen in step (3).
Depending on the permissions of your web server directories, you may
have to be root in order to complete this step.

5. If you installed the CGI scripts in their default location, you
should now be able to search the C. elegans database by fetching the
following URL:

	http://your.host/cgi-bin/ace/searches/text

You can then follow the links to browse the database.  A slightly more 
sophisticated search allows you to search a subset of object classes: