TPP:Windows Cygwin Installation
From SPCTools
| Revision as of 16:56, 30 May 2007 Jtasman (Talk | contribs) (setup.exe link is now a direct download) ← Previous diff |
Revision as of 19:50, 30 May 2007 Jtasman (Talk | contribs) (setup.exe now points to direct local download at tools.proteomecenter.org) Next diff → |
||
| Line 5: | Line 5: | ||
| === Downloading and Running the Setup.exe Installation Program === | === Downloading and Running the Setup.exe Installation Program === | ||
| # 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://downloads.sourceforge.net/sashimi/TPP_Cygwin_Setup.exe TPP_Cygwin_Setup.exe installation program]. | + | # Download the [http://tools.proteomecenter.org/software/TPP_Cygwin_Setup.exe 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. | # '''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''' | ||
Revision as of 19:50, 30 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
- You must be logged on as an Administrator to install these tools.
- Download the 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
- Reboot the computer
- If everything worked correctly you should be able to now access the TPP web interface
Setup.exe Installation Walkthrough
 1. Select to |
 2. The default installation will install cygwin to c:\cygwin. |
 3. Select a directory where you want to download the temporary |
 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 |
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
Reininstalling the TPP Software
If you are upgrading, you don't have to do anything special. Just follow the Cygwin installation instructions listed above.
If you encountered a problem, you can do a "clean install" by following the uninstall instructions and then trying the Cygwin installation instructions listed above.
If you want to force the current version to reinstall, run the cygwin installer. When you get to step 6 (in install section above), expancd the "base" section, find the first entry "ISB-MS-Tools", click on "keep" until it changes to reinstall, and proceed.
Uninstalling the TPP
Occasionally it will be necessary to uninstall the software, for example, in the case of an incomplete or broken installation.
- close all cygwin windows
- exit the cygwin X server if you have started it (right click on the "X" in the bottom right toolbar if it is there and choose "exit")
- Stop cygwin services. Note, these may not exist if installation failed. Open Control Panel → Administrative Tools → Services, start "cygapache2_stop" (if it exists), then set all cygapache2 and cygserver services to "disabled"
- deleted the C:\cygwin directory. If you get the warning that files are in use and cannot be deleted, log off and/or restart your machine.
- remove shortcuts from the Start Menu (right-click on TPP group and delete.)
(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.
Old, out-of-date, unsupported IIS configuration instructions can be found here.
Next Steps
Using the TPP web interface ("Petunia")
Example Data Analysis
Author
original author: David Shteynberg
