Studio:Desktop Installation: Difference between revisions

From STRIDE Wiki
Jump to navigation Jump to search
(New page: == 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...)
 
 
(23 intermediate revisions by 6 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:
* 30 GB 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.  If your company already has a license, then it will also have an internal STRIDE Lead, an employee of your company who is responsible for coordinating access to licenses and the STRIDE installer image (StrideSetup.exe).  Download instructions are provided with all new licenses.


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 ===
== Third Party Components ==
==== Perl ====
=== Perl ===
Many of our additional test utilities and libraries require perl support on the host. In particular, we require:
Many of our additional test utilities and libraries require perl support on the Windows host computer. In particular, we require:
* Distribution of [http://activestate.com/Products/activeperl/ ActiveState perl] '''5.8.8.822''' or newer (download from [http://downloads.activestate.com/ActivePerl/Windows/ here]). This distribution includes the PerlScript engine that is required for use with STRIDE.
* 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.  
* 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.
* Several Perl packages, which can be downloaded from publicly-accessible repositories
**Win32::API
 
**Win32::GUI
'''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.
**Win32::GuiTest
 
**Win32::ToolHelp
===Installing Perl Packages===
**XML::DOM
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.
**Config::IniFiles
 
**Getopt::Long
'''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.
**NET::DNS
 
**Log::Handler
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:
<source lang="DOS">
C:\> ppm repo add http://www.bribes.org/perl/ppm
</source>
(Change the last argument to specify each repository URL.)
 
'''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
  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. You may also try adding a ppm repository:
'''Note:''' Due to bandwidth issues at ActiveState, PPM attempts may fail intermittently. If so, please re-try.  
  CMD> ppm repo add http://www.bribes.org/perl/ppm
(change the last argument by specifying [http://win32.perl.org/wiki/index.php?title=PPM_Repositories any other repository])


'''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.
After download and installation, verify all the packages have been installed, again using PPM:
<source lang="DOS">
C:\> ppm list
</source>


Verify all the packages have been installed via PPM
== STRIDE Installation ==
  CMD> ppm list
STRIDE is usually installed in the '''C:\STRIDE''' directory. Installing the core components will provide everything needed to run STRIDE on the host.


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:
'''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 58: Line 94:
   OK: Prerequisites validation successful.
   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.
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.


== Desktop Installation ==
STRIDE is usually installed in the '''C:\STRIDE''' directory. Installing the default 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.
# Connect to the STRIDE FTP site as directed by your STRIDE lead, or insert the STRIDE CD into your PC's CD drive.
# 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.
# Select the type of installation you want to perform from the list. '''Standard''' installs the most commonly used STRIDE components, but does not install the STRIDE Runtime or other utilities and samples. If you want to install these components, choose '''Custom''' and select the components you want to install.
# Once you have chosen the type of installation you want, click '''Install'''.
# 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.
== Updating Desktop Installation ==
If you have previously installed STRIDE and want to add components (e.g., the STRIDE Runtime, Training, etc.), complete the following steps:
# Exit all other Windows applications prior to beginning the STRIDE update.
# Connect to the STRIDE FTP site as directed by your systems engineer, or insert the STRIDE CD into your PC's CD-ROM drive.
# 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.
# A list of STRIDE components appears with check marks next to components you have already installed; you can now select additional components. When you have checked the components you want, click '''Install'''.
# Your installed copy of STRIDE will be updated. When the update is complete, click '''Finish'''. To open STRIDE immediately, check '''Run Stride 3.0'''.
'''Note:''' If you have previously installed STRIDE and want to '''remove components''' (e.g., the STRIDE Runtime, Training, etc.), you must first uninstall STRIDE, then do a fresh installation with the components you want.


== Uninstalling Host ==
== Uninstalling Host ==
Line 122: 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 129: 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"