Studio:Desktop Installation

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:

• 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:

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:

1. Exit all other Windows applications prior to beginning the STRIDE installation.
2. If you haven't already done so, obtain a current copy of StrideSetup.exe from you project's Basecamp site.
3. Select and open StrideSetup.exe.
4. When the Install Wizard appears, click Next.
5. 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.
6. Click Install to install the Core Components, which provides the full installation of STRIDE.
7. 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)

1. From the Start menu, select Control Panel.
2. Double-click Add or Remove Programs.
3. Select Stride, then click Change/Remove.
4. When prompted, click Yes.
5. When the uninstall is complete, click Close.

Method 2 (via STRIDE Program Folder)

1. From the Start menu, go to STRIDE 3.0 Program folder.
2. Select STRIDE Uninstall.
3. When prompted, click Yes.
4. When the uninstall is complete, click Close.

Method 3 (via STRIDE Installation Folder)

1. Open the STRIDE installation folder (typically C:\STRIDE).
2. Go to uninstall folder.
3. Select and open STRIDEUninstall.exe.
4. When the Install Wizard appears, click Yes.
5. 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:

1. Open a DOS window.
2. 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:

1. Open a DOS window.
2. Type start /WAIT /D"C:\STRIDE\uninstall" C:\STRIDE\uninstall\StrideUninstall.exe "/S _?=C:\STRIDE"