Studio:Desktop Installation: Difference between revisions
(→Perl) |
|||
(12 intermediate revisions by 4 users not shown) | |||
Line 3: | Line 3: | ||
To install and use STRIDE, your Windows-based PC must have the following ''minimum'' configuration: | To install and use STRIDE, your Windows-based PC must have the following ''minimum'' configuration: | ||
* 300 MB hard disk | * 300 MB of available hard disk space | ||
* Windows® XP SP2 or greater | * Windows® XP SP2 or greater | ||
* 512 KB RAM (recommended: 1 GB ) | * 512 KB RAM (recommended: 1 GB or more) | ||
* Pentium 4 CPU 2 GHz (recommended: 3.20 GHz) | * Pentium 4 CPU 2 GHz (recommended: 3.20 GHz) | ||
* 1024 x 768 display (1280 x 1024 recommended) | * 1024 x 768 display (1280 x 1024 recommended) | ||
== Third Party Components == | |||
=== Perl === | |||
Many of our additional test utilities and libraries require perl support on the Windows host computer. In particular, we require: | |||
* Distribution of [http://www.activestate.com/activeperl ActiveState perl] that includes [http://docs.activestate.com/activeperl/5.8/Components/Windows/PerlScript.html PerlScript] engine. As of this writing only '''5.8.8.822''', or a later build of 5.8.x perl (x86) fits that requirement. We '''DO NOT''' support perl version 5.10.x nor 5.12.x at this time due to some bugs in the PerlScript component. | |||
* Several Perl packages, which can be downloaded from publicly-accessible repositories | |||
'''NOTE:''' if you are upgrading (or downgrading) your version of perl to match our requirements, you '''must completely delete your perl directory''' after uninstalling your previous version of perl. This is required because the ActiveState uninstaller does not remove extra packages that were installed with the previous version. These old packages will cause conflicts when you try to install additional packages after installing version 5.8.x, thus they must be manually removed. | |||
=== | |||
===Installing Perl Packages=== | |||
To download and install the required Perl packages, we recommend that you use the [http://docs.activestate.com/activeperl/5.8/faq/ActivePerl-faq2.html Perl Package Manager] (PPM) that comes with the ActiveState Perl distribution. Before continuing, please download and install ActiveState Perl. | |||
'''Note:''' PPM uses HTTP to communicate with repositories -- if your HTTP connections require a proxy server, refer to [http://docs.activestate.com/activeperl/5.8/faq/ActivePerl-faq2.html#ppm_and_proxies the PPM documentation] for information about setting the proxy. | |||
PPM uses a set of configured repositories to locate requested packages. We recommend that the following repositories be added to the PPM's default set: | |||
* http://theoryx5.uwinnipeg.ca/ppms | |||
* http://www.bribes.org/perl/ppm | |||
* http://trouchelle.com/ppm/ | |||
You can add a ppm repository using the command line interface as follows: | You can add a ppm repository using the command line interface as follows: | ||
<source lang="DOS"> | |||
( | C:\> ppm repo add http://www.bribes.org/perl/ppm | ||
</source> | |||
(Change the last argument to specify each repository URL.) | |||
'''Note:''' | '''Note:''' A list of available repositories can be found [http://win32.perl.org/wiki/index.php?title=PPM_Repositories here] | ||
After adding the additional repositories, the following additional perl packages need to be downloaded and installed: | |||
*Win32::API | |||
*Win32::GUI | |||
*Win32::GuiTest | |||
*Win32::ToolHelp | |||
*XML::DOM | |||
*Config::IniFiles | |||
*Getopt::Long | |||
*NET::DNS | |||
*Log::Handler | |||
The simplest way to install these packages is via the command line interface to PPM, e.g | The simplest way to install these packages is via the command line interface to PPM, e.g | ||
<source lang="DOS"> | |||
C:\> ppm install win32-api | |||
</source> | |||
(change the last argument accordingly for each required package) | (change the last argument accordingly for each required package) | ||
'''Note:''' Due to bandwidth issues at ActiveState, PPM attempts may fail intermittently. If so, please re-try. | '''Note:''' Due to bandwidth issues at ActiveState, PPM attempts may fail intermittently. If so, please re-try. | ||
After download and installation, verify all the packages have been installed, again using PPM: | |||
<source lang="DOS"> | |||
C:\> ppm list | |||
</source> | |||
We provide a perl script, | == STRIDE Installation == | ||
STRIDE is usually installed in the '''C:\STRIDE''' directory. Installing the core components will provide everything needed to run STRIDE on the host. | |||
'''Step-by-step instructions:''' | |||
# Exit all other Windows applications prior to beginning the STRIDE installation. | |||
# If you haven't already done so, obtain a current copy of StrideSetup.exe from you project's Basecamp site. | |||
# Select and open '''StrideSetup.exe'''. | |||
# When the Install Wizard appears, click '''Next'''. | |||
# On the '''License Agreement''' screen, click '''I Agree''' if you agree with the terms of the license and to continue the installation.<br> '''Note:''' Clicking '''No''' will terminate the installation process. | |||
# Click '''Install''' to install the Core Components, which provides the full installation of STRIDE. | |||
# When the installation is complete, click '''Finish'''. | |||
== License Activation == | |||
The Stride Studio executable requires a valid license to run. The first time you execute Studio (and any other time a valid license is not found), you will be prompted to enter the activation code supplied by S2 Technologies to perform Internet activation and download of your license. You must be connected to the Internet for this to succeed. Once you have a valid license on your computer, the Internet connection is no longer necessary. | |||
==Verifying Perl Installation== | |||
We provide a perl script, <tt>TestInstallOfPerl.pl</tt>, that can be used to validate the version and packages that you have installed. This script is available in <tt>%STRIDE_DIR%/Scripts</tt> folder. Run this script from a command prompt by typing <tt>perl TestInstallOfPerl.pl</tt>. On a properly configured system, it will produce results like: | |||
************************************************************ | ************************************************************ | ||
Line 71: | Line 99: | ||
You should address any errors that are reported before proceeding. If you prefer to install perl '''after''' installing STRIDE, you '''must''' run this script after both are installed to verify the packages and perform the necessary STRIDE component registrations. | You should address any errors that are reported before proceeding. If you prefer to install perl '''after''' installing STRIDE, you '''must''' run this script after both are installed to verify the packages and perform the necessary STRIDE component registrations. | ||
== Uninstalling Host == | == Uninstalling Host == | ||
Line 118: | Line 122: | ||
# When the uninstall is complete, click '''Close'''. | # When the uninstall is complete, click '''Close'''. | ||
=== Conducting an unattended uninstallation | |||
== Conducting an unattended installation == | |||
The STRIDE installer supports silent (unattended) installation and uninstallation. To silently install STRIDE, complete the following steps: | |||
# Open a DOS window. | |||
# Type start /WAIT /D"C:\TEMP" C:\TEMP\StrideSetup.exe /S | |||
'''Note:''' The statement above assumes that '''StrideSetup.exe''' resides in C:\TEMP; you may need to change this path to match your actual StrideSetup.exe location. | |||
== Conducting an unattended uninstallation == | |||
The STRIDE installer supports silent (unattended) installation and uninstallation. To silently uninstall STRIDE, complete the following steps: | The STRIDE installer supports silent (unattended) installation and uninstallation. To silently uninstall STRIDE, complete the following steps: | ||
Line 125: | Line 138: | ||
[[Category: | [[Category:Studio]] |
Latest revision as of 04:51, 23 May 2010
Getting Started
STRIDE software, which is typically provided either via an FTP site or on a CD, contains STRIDE Studio and the STRIDE Runtime, as well as other software and utilities.
To install and use STRIDE, your Windows-based PC must have the following minimum configuration:
- 300 MB of available hard disk space
- Windows® XP SP2 or greater
- 512 KB RAM (recommended: 1 GB or more)
- Pentium 4 CPU 2 GHz (recommended: 3.20 GHz)
- 1024 x 768 display (1280 x 1024 recommended)
Third Party Components
Perl
Many of our additional test utilities and libraries require perl support on the Windows host computer. In particular, we require:
- Distribution of ActiveState perl that includes PerlScript engine. As of this writing only 5.8.8.822, or a later build of 5.8.x perl (x86) fits that requirement. We DO NOT support perl version 5.10.x nor 5.12.x at this time due to some bugs in the PerlScript component.
- Several Perl packages, which can be downloaded from publicly-accessible repositories
NOTE: if you are upgrading (or downgrading) your version of perl to match our requirements, you must completely delete your perl directory after uninstalling your previous version of perl. This is required because the ActiveState uninstaller does not remove extra packages that were installed with the previous version. These old packages will cause conflicts when you try to install additional packages after installing version 5.8.x, thus they must be manually removed.
Installing Perl Packages
To download and install the required Perl packages, we recommend that you use the Perl Package Manager (PPM) that comes with the ActiveState Perl distribution. Before continuing, please download and install ActiveState Perl.
Note: PPM uses HTTP to communicate with repositories -- if your HTTP connections require a proxy server, refer to the PPM documentation for information about setting the proxy.
PPM uses a set of configured repositories to locate requested packages. We recommend that the following repositories be added to the PPM's default set:
You can add a ppm repository using the command line interface as follows:
C:\> ppm repo add http://www.bribes.org/perl/ppm
(Change the last argument to specify each repository URL.)
Note: A list of available repositories can be found here
After adding the additional repositories, the following additional perl packages need to be downloaded and installed:
- Win32::API
- Win32::GUI
- Win32::GuiTest
- Win32::ToolHelp
- XML::DOM
- Config::IniFiles
- Getopt::Long
- NET::DNS
- Log::Handler
The simplest way to install these packages is via the command line interface to PPM, e.g
C:\> ppm install win32-api
(change the last argument accordingly for each required package)
Note: Due to bandwidth issues at ActiveState, PPM attempts may fail intermittently. If so, please re-try.
After download and installation, verify all the packages have been installed, again using PPM:
C:\> ppm list
STRIDE Installation
STRIDE is usually installed in the C:\STRIDE directory. Installing the core components will provide everything needed to run STRIDE on the host.
Step-by-step instructions:
- Exit all other Windows applications prior to beginning the STRIDE installation.
- If you haven't already done so, obtain a current copy of StrideSetup.exe from you project's Basecamp site.
- Select and open StrideSetup.exe.
- When the Install Wizard appears, click Next.
- On the License Agreement screen, click I Agree if you agree with the terms of the license and to continue the installation.
Note: Clicking No will terminate the installation process. - Click Install to install the Core Components, which provides the full installation of STRIDE.
- When the installation is complete, click Finish.
License Activation
The Stride Studio executable requires a valid license to run. The first time you execute Studio (and any other time a valid license is not found), you will be prompted to enter the activation code supplied by S2 Technologies to perform Internet activation and download of your license. You must be connected to the Internet for this to succeed. Once you have a valid license on your computer, the Internet connection is no longer necessary.
Verifying Perl Installation
We provide a perl script, TestInstallOfPerl.pl, that can be used to validate the version and packages that you have installed. This script is available in %STRIDE_DIR%/Scripts folder. Run this script from a command prompt by typing perl TestInstallOfPerl.pl. On a properly configured system, it will produce results like:
************************************************************ Perl/System prerequisites check ************************************************************ OK: Perl version looks good (5.010000). OK: Package Win32::API looks good. OK: Package Win32::GUI looks good. OK: Package Win32::GuiTest looks good. OK: Package Win32::ToolHelp looks good. OK: Package XML::DOM looks good. OK: Package Config::IniFiles looks good. OK: Package Getopt::Long looks good. OK: Package NET::DNS looks good. OK: Package Log::Handler looks good. OK: Prerequisites validation successful. ************************************************************
Note: For the later 5.8 versions of Perl, you may see several lines of debug code above the line that verifies the NET::DNS package. This debugging code is not a sign of unsuccessful installation and can be ignored.
You should address any errors that are reported before proceeding. If you prefer to install perl after installing STRIDE, you must run this script after both are installed to verify the packages and perform the necessary STRIDE component registrations.
Uninstalling Host
Method 1 (via Control Panel)
- From the Start menu, select Control Panel.
- Double-click Add or Remove Programs.
- Select Stride, then click Change/Remove.
- When prompted, click Yes.
- When the uninstall is complete, click Close.
Method 2 (via STRIDE Program Folder)
- From the Start menu, go to STRIDE 3.0 Program folder.
- Select STRIDE Uninstall.
- When prompted, click Yes.
- When the uninstall is complete, click Close.
Method 3 (via STRIDE Installation Folder)
- Open the STRIDE installation folder (typically C:\STRIDE).
- Go to uninstall folder.
- Select and open STRIDEUninstall.exe.
- When the Install Wizard appears, click Yes.
- When the uninstall is complete, click Close.
Conducting an unattended installation
The STRIDE installer supports silent (unattended) installation and uninstallation. To silently install STRIDE, complete the following steps:
- Open a DOS window.
- Type start /WAIT /D"C:\TEMP" C:\TEMP\StrideSetup.exe /S
Note: The statement above assumes that StrideSetup.exe resides in C:\TEMP; you may need to change this path to match your actual StrideSetup.exe location.
Conducting an unattended uninstallation
The STRIDE installer supports silent (unattended) installation and uninstallation. To silently uninstall STRIDE, complete the following steps:
- Open a DOS window.
- Type start /WAIT /D"C:\STRIDE\uninstall" C:\STRIDE\uninstall\StrideUninstall.exe "/S _?=C:\STRIDE"