Table of Contents

Installation

Here we describe the instructions for setting up local copy of the minimal version of Genome Projector, which only includes working a Escherichia coli K-12 genome. This process requires a web server supporting the execution of Perl-based CGI. Following examples are based on MacOS X 10.5.

License

Genome Projector is available under GNU General Public License v.2.

Download

Obtain the minimal package available at: http://www.g-language.org/data/download/GenomeProjector-1.1.tgz (147MB). Latest version is v.1.1.

Then uncompress and place the contents in your web server directory. 

% wget http://www.g-language.org/data/download/GenomeProjector.tgz
% tar -xzf GenomeProjector.tgz
% mv GenomeProjector /Library/WebServer/Documents/

Allowing .htaccess Override

GenomeProjector directory must be CGI-executable. Since the directory contains its own .htaccess file which defines these settings, you only need to allow the override setting for your document root.

In MacOS X 10.5, edit /etc/httpd/httpd.conf with your favorite text editor, locate the following and change the last line to AllowOverride All. 

#
# This should be changed to whatever you set DocumentRoot to.
#
<Directory "/Library/WebServer/Documents">
    #
    # Possible values for the Options directive are "None", "All",
    # or any combination of:
    #   Indexes Includes FollowSymLinks SymLinksifOwnerMatch ExecCGI MultiViews
    #
    # Note that "MultiViews" must be named *explicitly* --- "Options All"
    # doesn't give it to you.
    #
    # The Options directive is both complicated and important.  Please see
    # http://httpd.apache.org/docs/2.2/mod/core.html#options
    # for more information.
    #
    Options Indexes FollowSymLinks MultiViews

    #
    # AllowOverride controls what directives may be placed in .htaccess files.
    # It can be "All", "None", or any combination of the keywords:
    #   Options FileInfo AuthConfig Limit
    #
    AllowOverride All

Then type the following to restart your web server. 

sudo apachectl restart

Changing the Google Maps Key

First, go to Google Code Website for Google Maps API and obtain a Google Map Key for your website.

Then, open the maps.pl within the GenomeProjector directory, and locate the <script> tag where it reads “YOUR_GOOGLE_MAP_KEY_HERE”, replacing it with the obtained key. 

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" 
                   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">    
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
  <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Google Map View of NC_000913 - generated by G-language GAE</title>
 
    <script src="http://maps.google.com/maps?file=api&v=2.x&key=YOUR_GOOGLE_MAP_KEY_HERE"
            type="text/javascript" charset="utf-8"></script>
    <script type="text/javascript">

Accessing your GenomeProjector

Set up is now finished! Simply access http://localhost/GenomeProjector/ to see it in action.