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)

Obtaining a license and a copy of STRIDE

STRIDE is a license-controlled product. All users running STRIDE Studio on a Windows PC must have a valid license installed.

If your company is engaged in a VaS or TAGS project with S2 Technologies, current license files, as well as all STRIDE binaries, will be available on your project's Basecamp site.

If you are not yet a customer of S2 and would like to obtain an evaluation license, email S2 Sales or call our offices at 760-635-2345.

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 5.8.8.822, or a later build of 5.8.x perl. We DO NOT support perl version 5.10.x at this time due to some bugs in the script component support in perl 5.10. You can download perl distributions from ActiveState). These distributions include the PerlScript engine that is required for use with STRIDE.
• 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

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.

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.

Once the installation is complete, you must have your license information ready before starting STRIDE. If you have an evaluation or node-locked license, place the license file in C:\STRIDE\lic before launching STRIDE Studio. If you are using a floating license, you will be prompted for the location of the license server when you first start STRIDE. After your license setup is complete, you are ready to begin Integrating STRIDE into your Target environment.

It is highly recommended to run through the Hello Stride Sample after completing the Desktop installation.

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.

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 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"