Windows Installation Guide
From SPCTools
(Difference between revisions)
| Revision as of 22:56, 3 July 2013 JoeS (Talk | contribs) ← Previous diff |
Current revision Luis (Talk | contribs) |
||
| Line 1: | Line 1: | ||
| - | Intalling the Windows version of the TPP is fairly straightforward. Detailed instructions with lots of screenshots appear below. However, the following brief instructions may be sufficient: | + | =NOTICE!= |
| + | These instructions are meant for versions of TPP 4.8.1 and prior. | ||
| + | |||
| + | If installing TPP 5.0 or newer, please refer to: [[TPP:5.0_Installation]] | ||
| + | |||
| + | |||
| + | =TPP pre-5.0 installation= | ||
| + | Installing the Windows version of the TPP is fairly straightforward. Detailed instructions with lots of screenshots appear below. However, the following brief instructions may be sufficient: | ||
| * '''Make sure that you have rights to install software on your computer''' (i.e. Admin privileges) | * '''Make sure that you have rights to install software on your computer''' (i.e. Admin privileges) | ||
| * Install the latest version of ActivePerl (some versions will not work) | * Install the latest version of ActivePerl (some versions will not work) | ||
| Line 7: | Line 14: | ||
| ===First install ActivePerl=== | ===First install ActivePerl=== | ||
| - | Install the most current version of ActivePerl (we had some issues with 5.9 at some point, but more recent versions seem to work just fine.) | ||
| - | (The instructions below are accurate as of June 13, 2011. Details will change if ActivePerl modifies its website.) | + | Install the most current version of ActivePerl. If you happen to already have ActivePerl installed any versions newer than 5.9 its probable that it will work. Our recommendation however is to upgrade to the latest. |
| - | Go to [http://www.activestate.com/Products/activeperl www.activestate.com/Products/activeperl/downloads] to download the "Community Edition". | + | Go to [http://www.activestate.com/activeperl/downloads www.activestate.com/activeperl/downloads] to download the "Community Edition". On the right side of the page select either the x86 or 64 bit,x64 version and save the download to your desktop. Double-click to install. |
| - | Scroll down to the section for ActivePerl 5.12.3.1204 MSI. Select x86 or 64-bit as appropriate and click "Windows Installer (MSI)" | + | ''(The instructions above are accurate as of November, 2014. Details can change if ActivePerl modifies its website. The latest versions of ActivePerl may not be tested with TPP.)'' |
| - | + | ||
| - | Save to desktop. Double-click to install. | + | |
| ===Next install the MSVC/.Net Frameworks=== | ===Next install the MSVC/.Net Frameworks=== | ||
| - | In order to use ProteoWizard's msconvert program (bundled with TPP) you'll need to also have installed the MSVC 2008 SP1 (x86), and the .NET Framework 3.5 SP1 and 4.0 software packages Microsoft. | + | In order to use ProteoWizard's msconvert program (bundled with TPP) you'll need to also have installed the MSVC 2008/2010 SP1 (x86), and the .NET Framework 3.5/4.0 SP1 software packages Microsoft ''which may already be installed on your system''. Download each of the following to your desktop and run the installers as needed. |
| - | * [http://www.microsoft.com/en-us/download/details.aspx?id=8328 Download and install MSVC 2010 SP1 (x86)] | ||
| * [http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en Download and install MSVC 2008 SP1 (x86)] | * [http://www.microsoft.com/downloads/details.aspx?familyid=A5C84275-3B97-4AB7-A40D-3802B2AF5FC2&displaylang=en Download and install MSVC 2008 SP1 (x86)] | ||
| + | * [http://www.microsoft.com/en-us/download/details.aspx?id=8328 Download and install MSVC 2010 SP1 (x86)] | ||
| * [http://www.microsoft.com/downloads/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en Download and install .NET Framework 3.5 SP1] | * [http://www.microsoft.com/downloads/details.aspx?FamilyID=ab99342f-5d1a-413d-8319-81da479ab0d7&displaylang=en Download and install .NET Framework 3.5 SP1] | ||
| * [http://www.microsoft.com/download/en/details.aspx?id=17851 Download and install .Net Framework 4.0] | * [http://www.microsoft.com/download/en/details.aspx?id=17851 Download and install .Net Framework 4.0] | ||
| ===Now install TPP=== | ===Now install TPP=== | ||
| - | (If you are not currently reading this from the spctools.org website: go to ''www.spctools.org/wiki'', click on TPP in left nav bar, and click Windows Installation.) | ||
| - | =====Download the TPP from its page at the [http://sourceforge.net/projects/sashimi/files/ Sourceforge website]===== | ||
| - | Click "Trans-Proteomic Pipeline (TPP)" | + | ===== Download the TPP from its page at the [http://sourceforge.net/projects/sashimi/files/ Sourceforge website] ===== |
| - | Click "TPP v4.6 (occupy) rev 3" | + | Using your web browser navigate to [http://sourceforge.net/projects/sashimi/ http://sourceforge.net/projects/sashimi/] and click on the download link to download the most current version of the "Trans-Proteomic Pipeline (TPP)" for your platform and save to your desktop. |
| - | Select .exe file and save to desktop | + | Alternatively if you would like to download a different version of TPP or the downlink doesn't recognize your platform select the Files link in the project header. Next select the "Trans-Proteomic Pipeline (TPP)" folder followed by the folder with the version you'd like to download (e.g. TPP v4.7 (polar vortex) rev 0". In this folder you will find a Window's self installing executable and a compressed TAR file containing the source. Go ahead and download the executable to your desktop. |
| - | =====Double-click resulting icon, then select "run"===== | + | =====Double-click resulting icon, then select "run". The installer will launch and take you through a number of screens. During the installation you may also be prompted with dialog boxes and may see a number of temporary Windows open and close. This is normal. It may also launch a 2nd installer used to install the Apache Web Server on your system before installing TPP. ===== |
| [[image:install6-TPP-desktop-icon.png]] | [[image:install6-TPP-desktop-icon.png]] | ||
| - | =====License Agreement - agree===== | + | =====Installer Welcome - The first screen in the installer ===== |
| - | [[image:install7-license-agreement.png]] | + | [[image:install-welcome.png]] |
| + | |||
| + | =====TPP assistance - instructions on where to get help ===== | ||
| + | [[image:install-assistance.png]] | ||
| + | |||
| + | =====License Agreement - click agree to agree to the license ===== | ||
| + | [[image:install-license-agreement.png]] | ||
| + | |||
| + | =====Choose Components - most users should leave the defaults. After selecting next additional windows may open and a installer may be launched asking you to install Apache. It is necessary. ===== | ||
| + | [[image:install-components.png]] | ||
| - | =====Installation typically takes less than a minute===== | + | =====After any components have been installed TPP will then be installed. The installation typically takes less than a minute. ===== |
| - | [[image:install8-installation-in-progress.png]] | + | [[image:install-in-progress.png]] |
| - | =====You will see a welcome install popup -- read and click OK. You will see another popup asking to install and configure a webserver on your computer. This is necessary. If you agree, click OK. Finally you will see an "installation complete" popup -- choose whether to reboot now or later.===== | + | =====Installation complete - it is highly recommended you choose the reboot option and click ok. ===== |
| - | [[image:install9-installation-complete.png]] | + | [[image:install-complete.png]] |
Current revision
[edit]
NOTICE!
These instructions are meant for versions of TPP 4.8.1 and prior.
If installing TPP 5.0 or newer, please refer to: TPP:5.0_Installation
[edit]
TPP pre-5.0 installation
Installing the Windows version of the TPP is fairly straightforward. Detailed instructions with lots of screenshots appear below. However, the following brief instructions may be sufficient:
- Make sure that you have rights to install software on your computer (i.e. Admin privileges)
- Install the latest version of ActivePerl (some versions will not work)
- Download the latest TPP here and install
Here are the detailed instructions. The screenshots are large; don't miss the instructions interspersed between them:
[edit]
First install ActivePerl
Install the most current version of ActivePerl. If you happen to already have ActivePerl installed any versions newer than 5.9 its probable that it will work. Our recommendation however is to upgrade to the latest.
Go to www.activestate.com/activeperl/downloads to download the "Community Edition". On the right side of the page select either the x86 or 64 bit,x64 version and save the download to your desktop. Double-click to install.
(The instructions above are accurate as of November, 2014. Details can change if ActivePerl modifies its website. The latest versions of ActivePerl may not be tested with TPP.)
[edit]
Next install the MSVC/.Net Frameworks
In order to use ProteoWizard's msconvert program (bundled with TPP) you'll need to also have installed the MSVC 2008/2010 SP1 (x86), and the .NET Framework 3.5/4.0 SP1 software packages Microsoft which may already be installed on your system. Download each of the following to your desktop and run the installers as needed.
- Download and install MSVC 2008 SP1 (x86)
- Download and install MSVC 2010 SP1 (x86)
- Download and install .NET Framework 3.5 SP1
- Download and install .Net Framework 4.0
[edit]
Now install TPP
[edit]
Download the TPP from its page at the Sourceforge website
Using your web browser navigate to http://sourceforge.net/projects/sashimi/ and click on the download link to download the most current version of the "Trans-Proteomic Pipeline (TPP)" for your platform and save to your desktop.
Alternatively if you would like to download a different version of TPP or the downlink doesn't recognize your platform select the Files link in the project header. Next select the "Trans-Proteomic Pipeline (TPP)" folder followed by the folder with the version you'd like to download (e.g. TPP v4.7 (polar vortex) rev 0". In this folder you will find a Window's self installing executable and a compressed TAR file containing the source. Go ahead and download the executable to your desktop.
[edit]
Double-click resulting icon, then select "run". The installer will launch and take you through a number of screens. During the installation you may also be prompted with dialog boxes and may see a number of temporary Windows open and close. This is normal. It may also launch a 2nd installer used to install the Apache Web Server on your system before installing TPP.
[edit]
Installer Welcome - The first screen in the installer
[edit]
TPP assistance - instructions on where to get help
[edit]
License Agreement - click agree to agree to the license
[edit]
Choose Components - most users should leave the defaults. After selecting next additional windows may open and a installer may be launched asking you to install Apache. It is necessary.
[edit]
After any components have been installed TPP will then be installed. The installation typically takes less than a minute.
[edit]
Installation complete - it is highly recommended you choose the reboot option and click ok.
