Skip to content
Find file
Fetching contributors…
Cannot retrieve contributors at this time
161 lines (112 sloc) 4.79 KB
The Generic Genome Browser (GBrowse) is a simple but highly
configurable web-based genome browser. It is a component of the
Generic Model Organism Systems Database project (GMOD).
******* WARNING ******
The HEAD of SVN (including this file) is currently in alpha test. You
are encouraged to give this a try, and to report your experiences to
the mailing lists at
For production, we suggest you use one of the released tarballs, or
check out the "stable" svn branch:
svn co Generic-Genome-Browser
perl Build.PL
./Build distmeta
./Build test
./Build config
./Build demo (optional)
./Build install (will need to become superuser)
./Build apache_conf
Detailed install and configure instructions are available at and we suggest you follow
that. What follows here is a brief synopsis.
1) You will need a bunch of Perl prerequisites:
Module Version
Bio::Perl 1.005002
CGI::Session 4.02
Digest::MD5 0
File::Temp 0
GD 2.07
IO::String 0
perl 5.008
Storable 0
The Build script will tell you if you are missing any
prerequisites. With the exception of BioPerl, all of these are
available on CPAN (, or by using the CPAN shell
("perl -MCPAN -e shell").
- You will need the Bioperl DEVELOPER release (version 1.5.9). It is
quite stable, so you should not need to worry about installing it,
but if you wish, you can set up GBrowse to use a non-installed
version of Bioperl simply by unpacking it in your home directory
or some other convenient location. Download Bioperl here:
2) Run the command:
perl Build.PL
This will create a script named "Build" in the current directory. If you
have downloaded and unpacked, but not installed Bioperl, then you should
specify its location using the -I option:
perl -I /home/fred/build/bioperl-live Build.PL
To install in a custom location, pass the --install_base argument:
perl Build.PL --install_base=/home/fred/software
3) Run the command:
./Build test
This will run a series of tests on the distribution. If one or more tests
fail please inform the author.
4) Run the command:
./Build config
This will ask you a series of questions about where Apache and its support
files are located, and will allow you to choose where to install GBrowse's
configuration files.
If you change your mind and want to reconfigure GBrowse, simply run
"./Build reconfig".
5) Run the command:
./Build demo
This will launch configure an instance of Apache to run on a local port and
give you the URL for a GBrowse demo database. This allows you to try out the
system before you install it.
6) Run the command:
./Build install
You will probably need to be the superuser to do this. If you have "sudo" installed
the invocation will be:
% sudo ./Build install
[sudo] password for jdoe: *****
% su
Password: *****
# ./Build install
7) Run the command:
./Build apache_config
This will print out a fragment of an Apache configuration file that contains
all the information needed to run GBrowse. Cut and paste this into your system's
Apache configuration file and restart the server. Usually you will find GBrowse
running at http://localhost/gbrowse2.
Support is available from the discussion groups and mailing lists at
Lincoln Stein & the GMOD team
October 2008
--- AUTHORS ---
This project has had many authors. Some of the most prominent are:
Scott Cain <>
Ben Faga <>
Vsevolod (Simon) Ilyushchenko <>
Marc Logghe <>
Aaron Mackey <>
Sheldon McKay <>
Nathan O. Siemers <>
Ian Davies <>
Lincoln Stein <>
Special thanks go to the authors of the translations, who include:
Franck Aniere <> (French)
Nansheng Chen <> (Chinese)
Toshiaki Katayama <> (Japanese)
Marc Logghe <> (Dutch)
Marco Mangone <> (Italian)
Linus Taejoon Kwon <linusben <at> bawi <dot> org> (Korean)
Marcela Tello-Ruiz <> (Spanish)
Gudmundur Thorisson <> (Icelandic)
Jump to Line
Something went wrong with that request. Please try again.