NOTE: We are working on migrating this site away from MediaWiki, so editing pages will be disabled for now.

Difference between revisions of "GBrowse Windows HOWTO"

From GMOD
Jump to: navigation, search
(Authors)
Line 1: Line 1:
 
__TOC__
 
__TOC__
 +
  
 
==Abstract==
 
==Abstract==
Line 5: Line 6:
 
This HOWTO describes a method for installing [[GBrowse]] on Windows.
 
This HOWTO describes a method for installing [[GBrowse]] on Windows.
  
 +
==Windows Installation==
  
==Authors==
+
Before installing on Windows systems, you will need to install
* [[User:Lstein|Lincoln Stein]]
+
ActiveState Perl and the Apache web server.  You may also wish to
* [[User:Scain|Scott Cain]]
+
install a database management system such as MySQL.
  
==Copyright==
+
===Install ActiveState Perl===
  
This document is copyright Scott Cain, 2006. For reproduction other than personal use please contact [mailto:cain@cshl.edu cain@cshl.edu].
+
Go to [http://www.activestate.com ActiveState.com], and download the product "ActivePerl."  This is a little confusing because web site tries to point you to the commercial product, ASPN Perl.  At the current time, the full download URL for ActivePerl is:
  
==Revision History==
+
[http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl]
  
{| border="1" cellspacing="0" cellpadding="4"
+
Choose the "MSI" package for Windows for Perl version 5.8.  Once downloaded, launch the package, and it will install automatically. Note that due to differences in how ActiveState implemented Perl  between Perl 5.6.1 and 5.8, we can only support Perl 5.8.
|-
+
| Revision 1.0 2006-11-08 [[Scott Cain]]
+
| First version
+
|-
+
|}
+
  
 +
''Please accept the default location for ActiveState Perl; this will make it easier to install GBrowse.''
  
 +
===Install the Apache web server===
  
==Windows Installation==
+
Go to [http://httpd.apache.org/download.cgi http://httpd.apache.org/download.cgi]. Select the most recent version of Apache, and choose the download marked "Win32 Binary (MSI Installer)."  Once downloaded, launch the package and it will install automatically.
  
Download the {{CVS|Generic-Genome-Browser/bin/windows_install.pl}} script. The script works currently on Windows when [http://apache.org Apache] and [http://www.activestate.com ActiveState] Perl 5.8 are already installed using the default locations. Execute the command in the DOS command shell:
+
''Please accept the default location for Apache.''
  
  >perl windows_install.pl
+
===Install the MySQL database (optional)===
  
And answer questions that are presented (the defaults will be acceptable most of the time). Note that it requires the LWP Perl package be installed, but it comes by default with ActiveState Perl 5.8. Also note that this script may work for Linux and MacOS as long as it is run as root (e.g. with sudo). Please see the [[GBrowse]] install doc for more information on what this script is doing.
+
Do this only if you want to run the MySQL backend to GBrowse. You might want to wait until after you've played with the flat-file based implementation a bit and decide you need better performance.
  
==Notes==
+
Go to [http://dev.mysql.com/downloads/mysql http://dev.mysql.com/downloads/mysql].  Select and download the most recent version of the Windows package.  Once the package is downloaded, you will need to unpack it with the WinZip program.  Then launch the installer.
  
You may see warnings like this:
+
After installing MySQL, install DBD::mysql; the easiste way to do that is via the ActiveState ppm utility.
  
WARNING:  Missing NMAKE.err; displaying error numbers without messages.
+
===Install GBrowse and its Perl Dependencies===
  
You can safely ignore these messages.
+
Download the {{CVS|Generic-Genome-Browser/bin/gbrowse_netinstall.pl}} script. The script works best when [http://apache.org Apache] and [http://www.activestate.com ActiveState] Perl 5.8 are already installed using the default locations. Execute the command in the DOS command shell:
  
You may also see a warning message like this:
+
  >perl gbrowse_netinstall.pl
  
Can't return to C:/DOCUME~1/scott/LOCALS~1/Temp/eWlcGUYhvu/Generic-Genome-Browse
+
And answer questions that are presented (the defaults will be acceptable most of the time, but be careful if you've changed the location of ActiveState and/or Apache!). Note that it requires the LWP Perl package be installed, but it comes by default with ActiveState Perl 5.8. Also note that this script also works for Linux and MacOS as long as it is run as root (e.g. with sudo). Please see the [[GBrowse]] install doc for more information on what this script is doing.
r-1.66 from C:\DOCUME~1\scott\LOCALS~1\Temp\eWlcGUYhvu (No such file or directory) at C:/Perl/lib/File/Temp.pm line 914
+
END failed--call queue aborted.
+
  
These are annoying but installation appears to be successful even when they are displayed.
+
==Authors==
 +
* [[User:Lstein|Lincoln Stein]]
 +
* [[User:Scain|Scott Cain]]
 +
 
 +
==Copyright==
 +
 
 +
This document is copyright Scott Cain, 2006. For reproduction other than personal use please contact [mailto:cain@cshl.edu cain@cshl.edu].
 +
 
 +
==Revision History==
 +
 
 +
{| border="1" cellspacing="0" cellpadding="4"
 +
|-
 +
| Revision 1.0 2006-11-08 [[Scott Cain]]
 +
| First version
 +
|-
 +
|}
  
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]

Revision as of 12:45, 17 April 2007


Abstract

This HOWTO describes a method for installing GBrowse on Windows.

Windows Installation

Before installing on Windows systems, you will need to install ActiveState Perl and the Apache web server. You may also wish to install a database management system such as MySQL.

Install ActiveState Perl

Go to ActiveState.com, and download the product "ActivePerl." This is a little confusing because web site tries to point you to the commercial product, ASPN Perl. At the current time, the full download URL for ActivePerl is:

http://www.activestate.com/Products/Download/Download.plex?id=ActivePerl

Choose the "MSI" package for Windows for Perl version 5.8. Once downloaded, launch the package, and it will install automatically. Note that due to differences in how ActiveState implemented Perl between Perl 5.6.1 and 5.8, we can only support Perl 5.8.

Please accept the default location for ActiveState Perl; this will make it easier to install GBrowse.

Install the Apache web server

Go to http://httpd.apache.org/download.cgi. Select the most recent version of Apache, and choose the download marked "Win32 Binary (MSI Installer)." Once downloaded, launch the package and it will install automatically.

Please accept the default location for Apache.

Install the MySQL database (optional)

Do this only if you want to run the MySQL backend to GBrowse. You might want to wait until after you've played with the flat-file based implementation a bit and decide you need better performance.

Go to http://dev.mysql.com/downloads/mysql. Select and download the most recent version of the Windows package. Once the package is downloaded, you will need to unpack it with the WinZip program. Then launch the installer.

After installing MySQL, install DBD::mysql; the easiste way to do that is via the ActiveState ppm utility.

Install GBrowse and its Perl Dependencies

Download the Generic-Genome-Browser/bin/gbrowse_netinstall.pl script. The script works best when Apache and ActiveState Perl 5.8 are already installed using the default locations. Execute the command in the DOS command shell:

 >perl gbrowse_netinstall.pl

And answer questions that are presented (the defaults will be acceptable most of the time, but be careful if you've changed the location of ActiveState and/or Apache!). Note that it requires the LWP Perl package be installed, but it comes by default with ActiveState Perl 5.8. Also note that this script also works for Linux and MacOS as long as it is run as root (e.g. with sudo). Please see the GBrowse install doc for more information on what this script is doing.

Authors

Copyright

This document is copyright Scott Cain, 2006. For reproduction other than personal use please contact cain@cshl.edu.

Revision History

Revision 1.0 2006-11-08 Scott Cain First version