Studio:Desktop Installation: Difference between revisions

From STRIDE Wiki
Jump to navigation Jump to search
 
(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)


=== 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 [mailto:sales@s2technologies.com 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 [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


=== Third Party Components ===
'''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.
==== Perl ====
 
Many of our additional test utilities and libraries require perl support on the host.  In particular, we require:
===Installing Perl Packages===
* Distribution of [http://activestate.com/Products/activeperl/ 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 [http://downloads.activestate.com/ActivePerl/Windows/ ActiveState]). These distributions include the PerlScript engine that is required for use with STRIDE.
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.
* We recommend that the following repositories are added:
 
** http://theoryx5.uwinnipeg.ca/ppms
'''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.
** http://www.bribes.org/perl/ppm
 
** http://theoryx5.uwinnipeg.ca/cgi-bin/ppmserver?urn:/PPMServer58
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:
CMD> ppm repo add http://www.bribes.org/perl/ppm
<source lang="DOS">
(change the last argument by specifying [http://win32.perl.org/wiki/index.php?title=PPM_Repositories any other repository])
C:\> ppm repo add http://www.bribes.org/perl/ppm
</source>
(Change the last argument to specify each repository URL.)


'''Note:''' PPM uses HTTP to communicate with repositories -- if your HTTP connections require a proxy server, refer to [http://aspn.activestate.com/ASPN/docs/ActivePerl/5.8/faq/ActivePerl-faq2.html#ppm_and_proxies the PPM documentation] for information about setting the proxy.
'''Note:''' A list of available repositories can be found [http://win32.perl.org/wiki/index.php?title=PPM_Repositories here]
   
   
* The following additional perl packages, which can all be installed using the [http://aspn.activestate.com/ASPN/docs/ActivePerl/5.8/faq/ActivePerl-faq2.html Perl Package Manager] (PPM) that comes with ActiveState perl.
After adding the additional repositories, the following additional perl packages need to be downloaded and installed:
**Win32::API
*Win32::API
**Win32::GUI
*Win32::GUI
**Win32::GuiTest
*Win32::GuiTest
**Win32::ToolHelp
*Win32::ToolHelp
**XML::DOM
*XML::DOM
**Config::IniFiles
*Config::IniFiles
**Getopt::Long
*Getopt::Long
**NET::DNS
*NET::DNS
**Log::Handler
*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
  CMD> ppm install win32-api
<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.  


Verify all the packages have been installed via PPM
After download and installation, verify all the packages have been installed, again using PPM:
  CMD> ppm list
<source lang="DOS">
C:\> ppm list
</source>


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 <tt>perl TestInstallOfPerl.pl</tt>. On a properly configured system, it will produce results like:
== 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.


== 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'''.
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 | 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:
# 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.


== 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:Installation]]
[[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:

  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"