TPP:Windows Cygwin Installation

From SPCTools

(Difference between revisions)
Jump to: navigation, search
Revision as of 22:52, 8 May 2007
Jtasman (Talk | contribs)
(IIS no longer supported)
← Previous diff		 Revision as of 18:06, 9 May 2007
Jtasman (Talk | contribs)
(note for C:\Inetpub\wwwroot directory bug)
Next diff →
Line 6: Line 6:
# You must be logged on as an Administrator to install these tools. # You must be logged on as an Administrator to install these tools.
# Download the [http://sourceforge.net/project/showfiles.php?group_id=69281&package_id=228457 TPP_Cygwin_Setup.exe installation program]. # Download the [http://sourceforge.net/project/showfiles.php?group_id=69281&package_id=228457 TPP_Cygwin_Setup.exe installation program].
 +# '''note''': a small bug has been discovered; please create the directory "C:\Inetpub\wwwroot" before installing if it does exist. This will automatically occur in the next Cygwin release.
# Follow default installation by clicking "Next" at each installation step, until the installation is completed. Please note: '''cygwin installation directory must be C:\cygwin''' # Follow default installation by clicking "Next" at each installation step, until the installation is completed. Please note: '''cygwin installation directory must be C:\cygwin'''
# '''Reboot the computer''' # '''Reboot the computer'''

Revision as of 18:06, 9 May 2007

Contents

Windows Installation

Overview

This installation will install a Unix environment (Cygwin) on your Windows system. The installation process is automated and not complicated. If you use BioworksBrowser and SequestBrowser, please download and install these tools prior to installing the SPC software. By default the software installs and uses the Apache2 webserver. The Apache2 webserver is configured to answer only on port 1441, so it should not conflict with an existing instance of IIS (the default Windows webserver).

Downloading and Running the Setup.exe Installation Program

  1. You must be logged on as an Administrator to install these tools.
  2. Download the TPP_Cygwin_Setup.exe installation program.
  3. note: a small bug has been discovered; please create the directory "C:\Inetpub\wwwroot" before installing if it does exist. This will automatically occur in the next Cygwin release.
  4. Follow default installation by clicking "Next" at each installation step, until the installation is completed. Please note: cygwin installation directory must be C:\cygwin
  5. Reboot the computer
  6. If everything worked correctly you should be able to now access the TPP web interface

Setup.exe Installation Walkthrough

1. Select to
"Install from the Internet"

2. The default installation will install cygwin to c:\cygwin.
Note: If your Windows OS is installed on a drive letter other than C:, you must CHANGE the path to c:\cygwin, or the software GUI WILL NOT work!
Keep the other options set to default "RECOMMENDED" settings.

3. Select a directory where you want to download the temporary
installation files. If unsure the "Desktop" is a good default.

4. Choose "Direct Connection" to the Internet.

5. Select "http://tools.proteomecenter.org" as the Download Site.

6. All default installation packages should be installed
along with any automatically selected dependencies.

You should not have to select anything manually at this step.

Starting/Stopping Apache

Note: It is not necessary manually start the webserver if the computer was reboot after installation.

  • Open Control Panel → Administrative Tools → Services
  • Start the service cygapache2_stop to STOP Apache2 for cygwin
  • Start the service cygapache2_start to START Apache2 for cygwin
  • Please allow up to a minute for each service to do its job, these services will finish automatically

Installation Troubleshooting

  • Reboot the computer. System environmental variables are not reset until this step occurs!
  • Open Control Panel → System → Advanced → Environment Variables and verify that the following System variables are set:
WEBSERVER_ROOT
Set to "C:\Inetpub\wwwroot\"
WEBSERVER_URL
Set to "http://localhost:1441/"
COMETLINKSFILE
Set to "C:\Inetpub\tpp-bin\cometlinks.def"
PATH
Begins with "C:\cygwin\usr\X11R6\bin;C:\cygwin\bin;"
  • Open Control Panel → Administrative Tools → Services and verify that the following Services are present:
cygserver
Startup Type set to Automatic
cygapache2_start
Startup Type set to Automatic
cygapache2_stop
Startup Type set to Manual

(OPTIONAL!) Running with the IIS webserver instead of Apache

Older installations of the TPP used the Microsoft IIS webserver. While it is possible to install under this configuration, we no longer recommend or support it. The cygwin installation now installs it's own webserver, Apache 2, on port 1441.

Next Steps

Using the TPP web interface ("Petunia")

Example Data Analysis

Author

original author: David Shteynberg

Retrieved from "http://tools.proteomecenter.org/wiki/index.php?title=TPP:Windows_Cygwin_Installation"
Personal tools